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

التنفيذ

ملخّص

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

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

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

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

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

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

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

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

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

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