تتبع التحويل

الشكل 2: نظرة عامة على تتبُّع الإحالات الناجحة

نظرة عامة

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

لإكمال عملية الدمج، اتّبِع الخطوات التالية:

  1. تحليل rwg_token وتخزينه
  2. تحليل معلومات التاجر وتخزينها
  3. عرض قيمتَي rwg_token وmerchant_changed
  4. اختبِر ميزة تتبُّع الإحالات الناجحة وتأكَّد من صحتها.
.

تحليل rwg_token وتخزينه

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

تحليل الرمز المميّز

عندما يتم توجيه مستخدم إلى صفحة الحجز، تتم إضافة rwg_token جديد إلى عنوان URL المقدَّم. في صفحة الحجز، عليك تحليل قيمة الرمز المميّز.

يوضّح المثال التالي كيفية تحليل rwg_token للتتبّع على مستوى الجهاز من خلال متصفّح.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

تخزين الرمز المميّز

عند تخزين rwg_token، يمكنك تنفيذ ميزة تتبُّع الإحالات الناجحة على مستويَين مختلفَين:

  • على مستوى الجهاز
  • على مستوى المستخدم

يمكنك تخزين الرمز المميّز على أي مستوى، ولكن يجب تخزين الرمز المميّز لمدة 30 يومًا بعد الإحالة الأولية.

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

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

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

التخزين على مستوى الجهاز

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

  • تغيير الجهاز الذي يستخدمه
  • يمحو التخزين المحلي أو ملفات تعريف الارتباط.
  • استخدام متصفّح خاص أو متصفّح متخفٍّ

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

التخزين على مستوى المستخدم

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

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

إعادة تحميل الرمز المميّز

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

يُرجى الاطّلاع على متطلبات تحديد مصدر الإحالات الناجحة للحصول على مزيد من التفاصيل.

تحليل معلومات التاجر وتخزينها

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

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

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

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

عرض قيمتَي rwg_token وmerchant_changed

عندما يُكمل مستخدم حجزًا يبدأ من إحالة action_link، عليك إرسال طلب HTTP POST إلى نقطة نهاية الإحالة الناجحة. هناك نوعان من نقاط النهاية:

  • بيئة الإنتاج: https://www.google.com/maps/conversion/collect
  • بيئة "الصندوق الرمّل": https://www.google.com/maps/conversion/debug/collect

عند إرسال حدث إحالة ناجحة، يجب تضمين rwg_token المخزّنة وقيمة merchant_changed‏ 1 أو 2. لمزيد من التفاصيل حول merchant_changed، يُرجى الاطّلاع على عرض قيمة تغيير التاجر.

يجب أن يكون نص POST عنصرًا مُشفَّرًا بتنسيق JSON على النحو التالي:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

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

يتضمّن المثال التالي عملية تتبُّع الإحالات الناجحة على مستوى الجهاز باستخدام ملفّ تعريف ارتباط على جهاز المستخدم، وهو مكتوب بلغة JavaScript:

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

عرض قيمة تغيير التاجر

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

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

  • المتطلب: عندما يغادر المستخدِم الموقع الإلكتروني للتاجر الأصلي ويكمل عملية شراء من خلال منصتك مع تاجر آخر.
    • قيمة تغيير التاجر: 1
  • المتطلب: عندما يُكمل المستخدم معاملة من خلال التاجر الأصلي
    • قيمة تغيير التاجر: 2

اختبار ميزة تتبُّع الإحالات الناجحة والتحقّق منها

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

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

حالة الاختبار وصف الاختبار مسار المستخدِم النتيجة المتوقّعة
1 إكمال مستخدم لحجز لم يبدأ على Google ينتقل المستخدم مباشرةً إلى صفحة الحجز بدون أن تُحيله Google أو بدون إحالة حالية. من المفترض ألا يؤدّي ذلك إلى أيّ حدث إحالة ناجحة. ما مِن حدث إحالة ناجحة لأنّ المستخدِم لم يسبق له زيارة صفحة الحجز أو لم يتمّ توجيهه من قِبل Google.
2 يُكمِل مستخدِم حجزًا تمّ إنشاؤه على Google. يعثر مستخدم على التاجر من خلال Google، ويتم توجيهه إلى صفحة الحجز الخاصة بك ويُجري حجزًا. سيتم إرسال حدث إحالة ناجحة باستخدام الرمز المميّز (أ) وقيمة تاجر تم تغييره‏ 2 لأنّ Google قد أحالت المستخدم إلى صفحة الحجز.
3 يبدأ مستخدم (من Google) عملية الحجز، ولكنه يغادر الجلسة قبل اكتمال الحجز.

ملاحظة: يجب إبقاء هذه الجلسة مفتوحة للاختبارَين 4 و5.		 يتم توجيه مستخدم إلى صفحة الحجز ولكن تنتهي الجلسة بدون إكمال عملية حجز. ما مِن إحالة ناجحة لأنّ المستخدم لم يُكمِل حجزًا، ولكن يجب تخزين الرمز المميّز (ب) لمدة 30 يومًا.
4 يعود المستخدم إلى صفحة الحجز بدون أن يكون مصدره Google ويُكمل عملية حجز.

ملاحظة: يجب ألا يتضمّن عنوان URL الخاص بعملية الحجز مَعلمة rwg_token.		 يعود مستخدم إلى صفحة الحجز بعد الاختبار 4. يجب تخزين الرمز المميّز (ب) لمدة 30 يومًا، ويجب أن تؤدي أي إحالة ناجحة خلال هذه الأيام الثلاثين إلى عرض حدث إحالة ناجحة. سيتم إرسال حدث إحالة ناجحة باستخدام الرمز المميّز (ب) وقيمة تاجر تم تغييره‏ 2 لأنّ المستخدم يعود إلى صفحة الحجز بعد إحالة سابقة من Google.
5 يُكمِل مستخدم حجزًا جديدًا مصدره Google بعد الاختبار 4. إذا عاد مستخدم إلى صفحة الحجز باستخدام إحالة من Google بعد إحالة سابقة من Google، تتم إعادة ضبط فترة التخزين التي تبلغ 30 يومًا ويحلّ الرمز المميّز الجديد الرمز المميّز ج محل الرمز المميّز القديم الرمز المميّز ب. وسيتمّ بعد ذلك إسناد جميع الإحالات الناجحة المستقبلية إلى الرمز المميّز ج. سيتم إرسال حدث إحالة ناجحة باستخدام الرمز المميّز ج وقيمة الحساب التجاري الذي تم تغييره التي تبلغ 2 لأنّ المستخدم أكمل الحجز واستبدل الرمز المميّز الجديد الرمز المميّز المخزّن سابقًا.

إذا كانت منصتك تتيح للمستخدمين الدفع من خلال تاجر مختلف، يمكنك اختبار ما يلي:

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

أثناء الاختبار، أرسِل طلب HTTP POST إلى نقطة نهاية التحويل. هناك نقطتا نهاية:

  • بيئة الإنتاج: https://www.google.com/maps/conversion/collect
  • بيئة وضع الحماية: https://www.google.com/maps/conversion/debug/collect

الرموز الاختبارية

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

الرمز المميّز (أ):

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

العنصر B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

الرمز المميّز ج:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

عند إرسال أحداث الإحالات الناجحة، يمكنك الاطّلاع عليها مجمّعة في "مركز الإجراءات" ضمن لوحة بيانات تتبُّع الإحالات الناجحة.

conversion-tracking-dashboard

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

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

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

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

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

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

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

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

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