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

التنفيذ

ملخّص

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

• جمع rwg_token وmerchant_id من الصفحة المقصودة أو التطبيق نقطة دخول متعددة.
• الاستمرار في استخدام rwg_token وmerchant_id لتحديد المصدر المناسب نافذة.
• المقارنة بين السمتَين merchant_id وmerchant_id المستمرتَين في وقت الإحالة الناجحة (اكتمل الحجز).
• إرسال حدث إحالة ناجحة في وقت الإحالة الناجحة (اكتمل الحجز).

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

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

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

جارٍ جمع rwg_token

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

في كل صفحة مقصودة أو نقطة دخول للتطبيق، يجب تحليل القيمة التي تم تعيينها مَعلمة طلب البحث rwg_token وتخزينها. متطلبات تخزين هذا في الخطوة، وهي مواصلة rwg_token.

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

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;
  }
}

جارٍ جمع merchant_id

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

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

يجب أن يكون merchant_id هذا هو نفسه الذي شاركته مع Google على خلاصتك.

الاستمرار في rwg_token وmerchant_id

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

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

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

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

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

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

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

عند استخدام تتبُّع الإحالات الناجحة على مستوى المستخدم، يجب ضبط 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
}

مثال (لم يتم تغيير رمز التاجر الذي يستخدم الرمز المميّز التجريبي للشريك 20123456):

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": 2
}

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

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

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

لإجراء اختبار في Sandbox، عليك إضافة مَعلمة عنوان URL التالية يدويًا إلى روابط Sandbox:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

مثال كامل لتتبُّع الإحالات الناجحة على مستوى الجهاز (باستخدام ملف تعريف ارتباط على عنوان URL الخاص بالمستخدم جهاز) في 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 أن يتم إرسال أحداث الإحالات الناجحة من جميع مساحات العرض يمكن للمستخدم الوصول إليها من رابط إجراء مكاني. بما في ذلك:

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

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

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