الخطوة 3: تتبُّع الإحالات الناجحة

التنفيذ

ملخّص

هناك ثلاثة عناصر لتنفيذ ميزة تتبُّع الإحالات الناجحة:

1. جمع rwg_token من الصفحة المقصودة / نقطة دخول التطبيق
2. إبقاء rwg_token محفوظًا لفترة تحديد المصدر المناسبة
3. إرسال حدث إحالة ناجحة عند الدفع

لا يتطلّب تنفيذ ميزة تتبُّع الإحالات الناجحة هذا استخدام "إحصاءات Google" أو أيّ لغة JavaScript أخرى تابعة لجهة خارجية.

قبل بدء العمل على تنفيذ ميزة تتبُّع الإحالات الناجحة، عليك تحديد ما إذا كنت ستتتبّع الإحالات الناجحة على مستوى الجهاز أو مستوى المستخدِم:

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

جمع rwg_token

في كل مرة يعرض فيها محرّك بحث Google action_link قدّمته من خلال الخلاصات، سيتم تعديل عنوان URL هذا لتضمين مَعلمة طلب بحث فريدة: rwg_token. قيمة rwg_token هي سلسلة مشفّرة تحتوي على بعض البيانات الوصفية عن الرابط الذي نقر عليه المستخدِم. ستخزّن هذا الرمز المميّز، وستعيد إرساله كجزء من حدث الإحالة الناجحة.

في كل صفحة مقصودة أو نقطة دخول إلى التطبيق، عليك تحليل القيمة التي تم ضبطها للمَعلمة rwg_token query وتخزينها. يتم وصف متطلبات تخزين هذه المَعلمة في الخطوة تخزين rwg_token.

في ما يلي مثال على كيفية تحليل هذا الرمز المميّز للتتبُّع على مستوى الجهاز من خلال browser. بدلاً من ذلك، يمكنك جمع هذا الرمز المميّز على جهة الخادم عند الردّ على الطلب:

<script>
  var query = location.search.substring(1);
  var params = query.split('&');
  var rwgToken = undefined;
  for (var i = 0; i < params.length; ++i) {
    var pair = params[i].split('=');
    if (pair[0] == 'rwg_token') {
      rwgToken = decodeURIComponent(pair[1]);
      break;
    }
  }
</script>

الاحتفاظ بـ rwg_token

سيُطلب منك الاحتفاظ بمَعلمة عنوان URL rwg_token التي ستتم إضافتها إلى جميع روابط الإجراءات التي تقدّمها، وذلك لمدة إجمالية تبلغ 30 يومًا. يجب تخزين قيمة rwg_token وعرضها بدون أي تعديلات. إذا كان هناك رمز ترويجي حالي محفوظ من زيارة سابقة، يجب استبداله، ويجب إعادة ضبط مهلة التخزين التي تبلغ 30 يومًا.

عند الاحتفاظ بالرمز المميّز، يمكنك تخزينه على مستوى الجهاز أو على مستوى المستخدم:

• يشمل مستوى الجهاز استخدام ملفات تعريف الارتباط للمتصفح أو مساحة التخزين المحلية أو مساحة التخزين المحلية للتطبيق أو أي طريقة أخرى يمكنها الاحتفاظ بالرمز المميّز خلال فترة تحديد المصدر التي تبلغ 30 يومًا.
• يشمل مستوى المستخدِم الاحتفاظ بها في قاعدة بيانات تطبيقك، من خلال نظام إحصاءات من جهة الخادم أو أنظمة أخرى من جهة الخادم.

في ما يلي مثال على تتبُّع الإحالات الناجحة على مستوى الجهاز، ويتمثل في تخزين هذا الرمز المميّز في متصفّح ويب من خلال ملف تعريف ارتباط تابع لطرف أول. يفترض هذا المثال أنّك قد عالجت قيمة الرمز المميّز في متغيّر كما هو موضّح في المثال أعلاه. لاستخدام هذا المثال، عليك تعديل "rootdomain" إلى نطاقك.

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

عند استخدام ميزة تتبُّع الإحالات الناجحة على مستوى المستخدِم، يجب تخزين rwg_token على الخادم وربطه بالمستخدِم.

إرسال بيانات الإحالات الناجحة

عندما يُكمل المستخدِم معاملة يمكن تحديد مصدرها على أنّه رابط إجراء في "مكان على Google"، يجب إرسال طلب HTTP POST إلى نقطة نهاية الإحالة الناجحة. هناك نقطتا نهاية، إحداهما لبيئة الإنتاج والأخرى لبيئة وضع المحاكاة.

• الإنتاج: https://www.google.com/maps/conversion/collect
• وضع الحماية: https://www.google.com/maps/conversion/debug/collect

يجب أن يكون نص المشاركة عنصرًا بترميز JSON بالشكل التالي:

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

في كلّ من بيئة المحاكاة وبيئة الإنتاج، سيُطلب منك تقديم rwg_token صالح عند إرسال حدث إحالة ناجحة. لأغراض الاختبار في بيئة "الصندوق الرمزي"، يمكنك استخدام رمز الاختبار التالي.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

في ما يلي مثال كامل على تتبُّع الإحالات الناجحة على مستوى الجهاز (باستخدام ملف تعريف ارتباط على جهاز المستخدم) في JavaScript لكيفية إجراء طلب POST هذا:

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal
    })
  });
}

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

متطلبات تحديد مصدر الإحالات الناجحة

المعيار المطلوب من Google لتحديد مصدر الإحالات الناجحة هو فترة تحديد مصدر تبلغ 30 يومًا لأي تفاعل مع رابط مكان في أي متجر.

تعني فترة تحديد المصدر هذه أنّنا نتوقع إرسال حدث إحالة ناجحة في أيٍّ من السيناريوهات التالية:

• يتبع المستخدِم رابط إجراء مكان ويقدّم طلبًا في الجلسة نفسها.
• يتبع أحد المستخدِمين رابط إجراء مرتبط بمكان، ثم يعود من قناة مختلفة في غضون فترة 30 يومًا لتقديم طلب.
• يتبع المستخدِم رابط إجراء مكان، ثم يقدّم طلبًا في متجر مختلف، إما خلال الجلسة نفسها أو في جلسة مختلفة خلال فترة 30 يومًا.

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

• تطبيقات الويب على أجهزة الكمبيوتر المكتبي أو الأجهزة الجوّالة
• التطبيقات المتوافقة مع الأجهزة الجوّالة، إما من خلال رابط لصفحة في التطبيق أو نية استخدام تطبيق مسجَّلة لنطاقك

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

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