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

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

قبل البدء

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

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

يجب تشفير علامات الإضافة بالشكل "‎&amp;‎" ضمن شفرة HTML (في سمة ‎<img> src)، لكن ليس ضمن شفرة جافا سكريبت. تتوقع الكثير من العلامات والحاويات التي تسمح بترابط علامات البكسل (مثل 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>

استخدام علامات بخلاف جافا سكريبت

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

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

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

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

<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 goog_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>

النص المميز هو العلامة التي لا تتضمن جافا سكريبت. ‏‫اتبع الخطوات التالية لإرسال معلماتك المخصصة من خلال علامة تجديد النشاط التسويقي:

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

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

على سبيل المثال، إذا كنت تريد إرسال flight_destid=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 رمز & إلى &amp;

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- في ما يلي علامة الصورة النهائية، والتي يمكنك وضعها على موقعك. وتقدم لك الوظيفة نفسها كنسخة جافا سكريبت من العلامة.

<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"/>‬
هل كان ذلك مفيدًا؟
كيف يمكننا تحسينها؟