تتبع التحويل

التنفيذ

ملخّص

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

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

لا يتطلّب تنفيذ عملية تتبُّع الإحالات الناجحة هذه استخدام "إحصاءات 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`

ملاحظة: إنّ الاحتفاظ بمعرّف 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==

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

في ما يلي مثال كامل على تتبُّع الإحالات الناجحة على مستوى الجهاز (باستخدام ملف تعريف ارتباط على جهاز المستخدِم) بلغة 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
    })
  });
}

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

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

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

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

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

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

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

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

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

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