إصلاح مشاكل التنسيق الشائعة للمعلمات المخصصة

لتوفير طريقة عرض شاملة وموحَّدة لجماهيرك وتبسيط إدارة الجمهور وعمليات التحسين، ستلاحظ التحسينات التالية في "إعلانات Google":

إعداد تقارير الجمهور بشكلٍ جديد
أصبح الآن إعداد التقارير التفصيلية عن الخصائص الديمغرافية للجمهور وشرائحه واستبعاداته، مُدمجًا في مكان واحد. انقر على رمز الحملات وافتح علامة التبويب "شرائح الجمهور والكلمات الرئيسية والمحتوى"، ثمّ انقر على شرائح الجمهور. ويمكنك أيضًا إدارة جماهيرك بسهولة من خلال صفحة إعداد التقارير هذه. اطّلِع على مزيد من المعلومات في المقالة لمحة عن إعداد تقارير الجمهور.
المصطلحات الجديدة
نستخدِم الآن مصطلحات جديدة في تقرير الجمهور وكذلك في جميع أقسام "إعلانات Google". على سبيل المثال، يُشار الآن إلى "أنواع شرائح الجمهور" (التي تشمل شرائح الجمهور المخصّصة وشرائح الجمهور الذي ينوي الشراء وشرائح الجمهور ذي الاهتمامات المشتركة) باسم "شرائح الجمهور"، كما يُشار الآن إلى "تجديد النشاط التسويقي" باسم "بياناتك". مزيد من المعلومات عن التعديلات الجديدة على المصطلحات والعبارات المتعلّقة بالجمهور

تتناول هذه المقالة كيفية تنسيق المعلمات المخصّصة، وتحديد المشاكل المرتبطة بكيفية إضافة علامتك إلى موقعك وحلّها. وتشمل تعليمات حول إضافة شفرة جافا سكريبت وبدائلها إلى موقعك على الويب، والطرق الشائعة التي يمكن حدوث اختلاط للشفرة من خلالها.

قبل البدء

للبدء في استخدام المعلمات المخصّصة، يجب أولاً قراءة كيفية وضع علامات على موقعك الإلكتروني لتجديد النشاط التسويقي الديناميكي.

ملاحظة حول علامات الإضافة (&)

يجب ترميز علامات الإضافة بالشكل "‎&‎" ضمن رمز HTML (في سمة ‎<img> src)، لكن ليس ضمن رمز JavaScript. تتوقع الكثير من العلامات والحاويات التي تسمح بترابط علامات البكسل (مثل Floodlight) ألا تكون عناوين URL بترميز HTML. هذا كثيرًا ما يؤدي إلى أخطاء الترميز المزدوج لعلامات العطف والتي تؤدي إلى التتبع غير السليم. وتأكد من استخدام عنوان URL الصحيح وفقًا للسياق. إذا كنت غير متأكد، استخدم إضافة Chrome،‏ Google Tag Assistant، للتحقق من صحة التنفيذ.

استخدام برنامج "إدارة العلامات من Google"

يمكنك استخدام إدارة العلامات من Google بدلاً من إضافة علامات تجديد النشاط التسويقي الديناميكي إلى موقعك. يُرسل هذا الخيار بيانات العلامات من خلال جهة خارجية (Google).

تنسيق المعلمات المخصّصة

بالنسبة للصفحات التي تحتوي على معرّفات متعددة، مثل صفحات سلة التسوق، استخدم الأقواس لتجميع المعرّفات. مثال: flight_destid: ["123", "456"]
استخدم علامات الاقتباس المفردة أو المزدوجة لسلسلة المعلمات المخصصة. ويمكن استخدام علامات الاقتباس المفردة أو المزدوجة على حد السواء، ولكن يجب الثبات على استخدام أيٍ منهما. مثال: إذا اخترت أن تستخدم علامات الاقتباس المفردة، فاستخدمها لجميع القيم.
لا تستخدم علامات الاقتباس للمعلمات المخصصة الرقمية. مثال: flight_totalvalue : 200.99
الفصل بين المعلمات بفواصل. إذا لم يتم تضمين علامة الفاصلة، فلن تعمل العلامة بشكلٍ صحيح.
لا تحتوي المعلمات المخصصة إلا على أحرف، وأرقام، وشرطات سفلية. ينبغي أن لا تبدأ المعلمات المخصصة بأرقام أو تتضمن مسافات.
من أجل إعداد أمثل، استخدم القيم المقترحة في هذه المقالة، لأن هذه القيم ستشكل شرائح أنشأها "إعلانات Google" لك من قبل عند إعداد حملة تجديد النشاط التسويقي الديناميكي. ويمكن استخدام قيم إضافية لتحديد صفحات أخرى معينة لموقعك.

أمثلة للمعلمات المخصصة

في ما يلي مثال لموقع على الويب لشركة طيران تم فيه تنفيذ جميع المعلمات المخصصة الأساسية.

قسم الموقع	نموذج لعلامة المعلمات المخصصة	ملاحظات
الصفحة الرئيسية	`<script type="text/javascript"> var google_tag_params = { flight_destid: "", flight_pagetype: "home", flight_totalvalue: }; </script>`	على الصفحة الرئيسية، هناك معلومات حول نوع الصفحة. على الرغم من عدم وجود أي معلومات متعلقة بالمنتج أو الخدمة على هذه الصفحات، سيظل بإمكان "إعلانات Google" سحب المنتجات والخدمات من خلاصتك استنادًا إلى ما يُحتمل أن يحقّق أفضل أداء.
صفحة نتائج البحث	`<script type="text/javascript"> var google_tag_params = { flight_destid: "", flight_pagetype: "searchresults", flight_totalvalue: }; </script>`	على صفحة نتائج البحث، هناك معلومات حول نوع الصفحة.
صفحة تفاصيل العرض	`<script type="text/javascript"> var google_tag_params = { flight_destid: "123", flight_pagetype: "offerdetail", flight_totalvalue: 99.00 }; </script>`	على صفحة تفاصيل العرض، يمكنك كتابة معلومات حول المنتج أو الخدمة المعروضة ديناميكيًا. استخدم الرقم التعريفي ذاته من الخلاصة.
صفحة سلة التسوق	وجهة واحدة `<script type="text/javascript"> var google_tag_params = { flight_destid: "123", flight_pagetype: "cart", flight_totalvalue: 120.00 }; </script>` وجهات متعددة `<script type="text/javascript"> var google_tag_params = { flight_destid: ["SFO", "SJC", "NYC", "LAX"], flight_pagetype: "cart", flight_totalvalue: [120.00, 300.00, 500.00, 900.00] }; </script>`	على صفحة سلة التسوق، ينبغي إرسال جميع العناصر التي لديك في سلة التسوق. وعند وجود قيم متعددة في إحدى المعلمات، استخدم مصفوفة جافا سكريبت (أقواس). في المعلمة "xxxxxxxx_totalvalue"، ينبغي إرسال مجموع القيم في سلة التسوق.
صفحة الشراء	وجهة واحدة `<script type="text/javascript"> var google_tag_params = { flight_destid: "123", flight_pagetype: "purchase", flight_totalvalue: 120.00 }; </script>` وجهات متعددة `<script type="text/javascript"> var google_tag_params = { flight_destid: ["SFO", "SJC", "NYC", "LAX"], flight_pagetype: "purchase", flight_totalvalue: [120.00, 300.00, 500.00, 900.00] }; </script>`	يجب أن تحتوي صفحة تأكيد الشراء على جميع المنتجات التي اشتراها الشخص. في المعلمة "xxxxxxxx_totalvalue"، ينبغي إرسال مجموع القيم في سلة التسوق أو على صفحة التحويل.
جميع الصفحات الأخرى	`<script type="text/javascript"> var google_tag_params = { flight_destid: "", flight_pagetype: "other", flight_totalvalue: }; </script>`	على جميع الصفحات الأخرى، استخدم علامات أخرى للمعلمة xxxxxxxx_pagetype. على الرغم من عدم وجود أي معلومات متعلقة بالمنتج أو الخدمة على هذه الصفحات، سيظل بإمكان "إعلانات Google" سحب المنتجات والخدمات من خلاصتك استنادًا إلى ما يُحتمل أن يحقّق أفضل أداء.

الأخطاء الشائعة عند إعداد المعلمات المخصصة

في ما يلي بعض الأخطاء الشائعة التي يقع فيها الأشخاص عند تنفيذ المعلمات المخصصة، وذلك من خلال مثال موقع الويب لشركة الطيران. إذا كنت تستخدم Tag Assistant، فسيمكنك تحديد معظم هذه الأخطاء الشائعة.

1- عدم وجود علامات اقتباس حول قيم السلاسل. على سبيل المثال:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "234",

      flight_pagetype: purchase,

      flight_totalvalue: 120.99

      };

      </script>

يجب أن يتم تغييرها إلى:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "234",

      flight_pagetype: "purchase",

      flight_totalvalue: 120.99

      };

      </script>

علامات الاقتباس الفردية تعمل أيضًا، طالما أنه يتم استخدامها بشكل ثابت.

2- لا يتم فصل المعلمات المخصصة بفاصلة (","). على سبيل المثال:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "234"

      flight_pagetype: "purchase"

      flight_totalvalue: 120.99

      };

      </script>

يجب أن يتم تغييرها إلى:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "234",

      flight_pagetype: "purchase",

      flight_totalvalue: 120.99

      };

      </script>

لا تحتاج آخر معلمة مخصصة إلى علامة "," بعدها. ولكن في حالة وجودها فلن تكون هناك مشكلة.

3- تحتوي المعلمة على مسافة أو أحرف غير ASCII. الأحرف المسموح بها فقط هي [a-z]‏[0-9] و"_". على سبيل المثال:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "234",

      flight pagetype: "purchase",

      flight_totalvalue: 120.99

      };

      </script>

يجب أن يتم تغييرها إلى:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: 234,

      flight_pagetype: "purchase",

      flight_totalvalue: 120.99

      };

      </script>

4- قيم متعددة في إحدى المعلمات دون أقواس. على سبيل المثال:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "123,"234",

      flight_pagetype: "cart",

      flight_totalvalue: 100,50

      };

      </script>

يجب أن يتم تغييرها إلى:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: ["123","234"],

      flight_pagetype: "cart",

      flight_totalvalue: [100,50]

      };

      </script>

5- معلمة دون أي قيمة. على سبيل المثال:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: ,

      flight_pagetype: "other",

      flight_totalvalue:

      };

      </script>

يجب أن يتم تغييرها إلى:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "0",

      flight_pagetype: "other",

      flight_totalvalue: 0

      };

      </script>

أو ببساطة:

<script type="text/javascript">

      var google_tag_params = {

      flight_pagetype: "other"

      };

      </script>

6- نظام تسمية غير صحيحة للمعلمات المخصصة. على سبيل المثال:

<script type="text/javascript">

      var google_tag_params = {

      destid: "234",

      pagetype: "purchase",

      totalvalue: 120.99

      };

      </script>

يجب أن يتم تغييرها إلى:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "234",

      flight_pagetype: "purchase",

      flight_totalvalue: 120.99

      };

      </script>

استخدام علامات بخلاف JavaScript

نوصي باستخدام علامة JavaScript على علامة صورة بخلاف JavaScript لأنها تؤدي إلى عدد أقل من أخطاء التنفيذ وتعالج العديد من أهداف HTML. يتم التعامل مع علامة صورة لا تعتمد على JavaScript كصورة. ونظرًا لأن بعض متصفحات الويب تحتفظ بالصور في ذاكرة التخزين المؤقت لتسريع وقت تحميل الصفحة، لن يتم تنشيط العلامة إلا في أول مرة يزور فيها الشخص موقعك الإلكتروني ولكن ليس خلال الزيارات اللاحقة. وتعالج نسخة جافا سكريبت من العلامة هذه المشكلة.

‏‫يمكنك استخدام هذه التعليمات إذا كنت ترغب في استخدام الجزء الذي لا يتضمن جافا سكريبت من العلامة (الذي يُعرف أيضًا باسم علامة الصورة) أو إذا كنت ترغب في نسخة أقصر من العلامة. ولا تتطلب علامة الصورة مكتبة JavaScript ‏(conversion.js)، وسيتم تحميل الصورة بالتزامن مع تحميل الصفحة.

يلزمك تخصيص الجزء الذي لا يتضمّن JavaScript من علامة Google بحيث يظل من الممكن إرسال القيَم. ويجب ترميز البيانات يدويًا.

استخدم العلامة التي أنشأتها للتو. ومن المفترض أن تبدو العلامة كالمثال التالي:

<script type="text/javascript">

      var google_tag_params = {

      flight_destid: "REPLACE_WITH_STRING_VALUE",

      flight_pagetype: "REPLACE_WITH_STRING_VALUE",

      flight_totalvalue: REPLACE_WITH_NUMBER_VALUE

      };

      </script>

      <script type="text/javascript">

      /* <![CDATA[ */

      var google_conversion_id = XXXXXXXXXX;

      var google_custom_params = window.google_tag_params;

      var google_remarketing_only = true;

      /* ]]> */

      </script>

      <script type="text/javascript" src="//www.googleadservices.com/pagead/conversion.js">

      </script>

      <noscript>

      <div style="display:inline;">

      <img height="1" width="1" style="border-style:none;" alt="" src="//googleads.g.doubleclick.net/pagead/viewthroughconversion/XXXXXXXXXX/?value=0&amp;guid=ON&amp;script=0&amp;data.flight_destid=101&amp;

      data.flight_destid=102

      &amp;data.flight_pagetype=purchase"/>

      </div>

      </noscript>

النص المميّز هو العلامة التي لا تتضمّن JavaScript. اتّبِع الخطوات التالية لإرسال المَعلمات المخصَّصة من خلال علامة Google:

1- ‏‫إعداد المعلمات المخصصة (يُطلق عليها أيضًا المفتاح/القيم) التي ترغب في إرسالها إلى إعلانات Google. ويجب إرسال المفتاح/القيم بالتنسيق التالي:

data.key1=val1&data.key2=val2&data.key2=val3...

على سبيل المثال، إذا كنت تريد إرسال flight_desId=100 وflight_pagetype=purchase كمعلمات مخصصة، يجب ترتيبها على النحو التالي:

data.flight_destid=100&data.flight_pagetype=purchase

إذا كان مفتاح معين يحتوي على قيم متعددة، على سبيل المثال، أرقام تعريفية متعددة لمنتجات أو خدمات على صفحة سلة التسوق، فأضف data.flight_destid= آخر لكل قيمة إضافية.

data.flight_destid=101&data.flight_destid=102&data.flight_pagetype=cart

2- إلحاق المقطع إلى بكسل عنوان URL كمعلمات، ثم تحول HTML رمز & إلى &

3- بعد إجراء التغيير، سيبدو img src النهائي كالآتي:

//googleads.g.doubleclick.net/pagead/viewthroughconversion/XXXXXXXXXX/?value=0&guid=ON&script=0&amp;data.flight_destid%3D101&data.flight_destid=102

      &data.flight_pagetype=purchase

4- في ما يلي علامة الصورة النهائية، والتي يمكنك وضعها على موقعك. وتقدم لك الوظيفة نفسها كنسخة JavaScript من العلامة.

<img height="1" width="1" style="border-style:none;" alt="" src="//googleads.g.doubleclick.net/pagead/viewthroughconversion/XXXXXXXXXX/?value=0&amp;guid=ON&amp;script=0&amp;data=flight_destid%3D101%2C102

      %3Bflight_pagetype%3Dpurchase"/>

روابط ذات صلة

وضع علامات على موقعك لتجديد النشاط التسويقي الديناميكي

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟

إصلاح مشاكل التنسيق الشائعة للمعلمات المخصصة

قبل البدء

ملاحظة حول علامات الإضافة (&)

استخدام برنامج "إدارة العلامات من Google"

تنسيق المعلمات المخصّصة

أمثلة للمعلمات المخصصة

الأخطاء الشائعة عند إعداد المعلمات المخصصة

استخدام علامات بخلاف JavaScript

روابط ذات صلة

هل كان ذلك مفيدًا؟

هل تحتاج إلى مزيد من المساعدة؟

جرِّب الخطوات التالية: