تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

التنفيذ

ملخّص

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

第 2 步：Feed

第 4 步：小规模测试和发布