تتبُّع الإحالات الناجحة

التنفيذ

ملخّص

هناك ثلاثة أقسام لتنفيذ تتبُّع الإحالات الناجحة:

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

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

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

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

جارٍ جمع rwg_token

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

في كل صفحة مقصودة / نقطة إدخال تطبيق، عليك تحليل القيمة المحدّدة لمعلَمة طلب البحث rwg_token وتخزينها. ويتم توضيح متطلبات تخزين هذه المَعلمة في الخطوة مواصلة استخدام rwg_token.

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

<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 يومًا.
  • أمّا مستوى المستخدم، فيتضمّن الاحتفاظ بالبيانات في قاعدة بيانات التطبيق، من خلال نظام إحصاءات من جهة الخادم أو أنظمة أخرى من جهة الخادم.

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

<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 صالحة عند إرسال حدث إحالة ناجحة. لأغراض الاختبار في بيئة وضع الحماية، يمكنك استخدام الرمز المميز للاختبار التالي. 

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

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

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 يومًا.

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

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

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

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