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

التنفيذ

ملخّص

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

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

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

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

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

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

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

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

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

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

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

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