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

التنفيذ

ملخّص

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

  • جارٍ جمع rwg_token من الصفحة المقصودة أو نقطة دخول التطبيق.
  • استمرار استخدام rwg_token لفترة الإحالة المناسبة
  • إرسال حدث إحالة ناجحة عند الدفع

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

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

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

جمع rwg_token

في كل مرة يعرض فيها Google actions_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 وعرضها بدون أي تعديلات.

بالإضافة إلى rwg_token، ستحتاج إلى تخزين merchant_id المرتبط برابط الإجراء.

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

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

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

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

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

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

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

عندما يُكمل أحد المستخدمين معاملة تعود إلى رابط إجراء من أماكن 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>
  "merchant_changed": 1|2
}

تُستخدَم القيمة Merchant_changed لتحديد ما إذا كان قد تم تغيير التاجر من موقع إعادة التوجيه الأولي. هناك قيمتان يمكن تمريرهما

قيمة تغيير التاجر المطلوب للحصول على الشارة
1 يجب استخدام هذه القيمة عندما يغادر المستخدم الموقع الإلكتروني للتاجر الأصلي ويكمل عملية شراء من خلال منصتك لدى تاجر آخر
2 يجب استخدام هذه القيمة عندما يُكمل العميل معاملة من خلال الكيان الأصلي (التاجر).

في كلّ من بيئتي وضع الحماية والإنتاج، يُطلب منك تقديم 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,
      Merchant_changed: merchantChanged
    })
  });
}

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

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

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

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

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

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

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

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

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

السابق
الخلاصات
التالي
مراجعة عملية الدمج