تتبع التحويل

الشكل 1: نظرة عامة على ميزة "تتبُّع الإحالات الناجحة"

ملخّص

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

لإكمال عملية الدمج، عليك إكمال ما يلي:

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

جمع rwg_token وتخزينها

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

مجموعة الرموز المميّزة

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

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

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

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

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

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

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

ضَع ما يلي في الاعتبار عند اختيار مكان تخزين rwg_token.

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

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

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

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

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

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

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

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

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

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

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

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

عرض القيمتَين rwg_token وmerchant_change

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

• الإنتاج: https://www.google.com/maps/conversion/collect
• الإصدار التجريبي: https://www.google.com/maps/conversion/debug/collect

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

يجب أن يكون نص 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`;

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

ملاحظة: نوع محتوى MIME المقبول الوحيد هو text/plain. لا تضبط أي Content-Type آخر في العنوان. في حال إجراء ذلك، ستظهر لك رسالة خطأ متعلّقة بسياسة مشاركة الموارد المتعددة المصادر (CORS).

تحذير: تأكَّد من عدم إرسال معلومات تحديد هوية المستخدِم الشخصية (PII) إلى Google كجزء من بيانات الإحالات الناجحة.

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

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

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

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

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

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

اختبِر ميزة تتبُّع الإحالات الناجحة وتأكَّد من صحتها.

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

1. إكمال حجز باستخدام رابط إجراء فقط
   • من المفترض ألا يؤدي الحجز المباشر بدون إحالة أو رموز مخزّنة سابقة إلى إرسال أي طلب إلى Google.
2. أكمِل عملية حجز باستخدام رابط يحتوي على rwg_token مرفق.
   • تأكَّد من نجاح الطلب وإرساله بالقيمة rwg_token و merchant_change التي تبلغ 2.
   • تأكَّد من تخزين rwg_token لمدة 30 يومًا.
3. أكمِل حجزًا جديدًا مع التاجر نفسه باستخدام rwg_token جديد.
   • تأكَّد من نجاح الطلب وإرساله بالقيمة الجديدة rwg_token و merchant_change التي تبلغ 2.
   • تأكَّد من تعديل فترة تخزين الإحالة الخاصة بالرمز المميّز لمدة 30 يومًا.
4. انتقِل مباشرةً إلى صفحة الحجز للتاجر الذي تختبره وأحجز موعدًا جديدًا بدون إضافة rwg_token.
   • تأكَّد من إرسال الطلب باستخدام rwg_token المخزّنة سابقًا وقيمة merchant_change هي 2.

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

1. انتقِل إلى صفحة الحجز الخاصة بالتاجر باستخدام رابط يحتوي على رمز rwg_token، ثم انتقِل إلى تاجر آخر واحرِص على إجراء حجز.
   • تأكَّد من إرسال الطلب باستخدام قيمة rwg_token و merchant_change‏ 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

استخدِم الرمز المميّز التالي للاختبارات التي تتطلّب رموزًا مميّزة إضافية.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

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

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

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

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

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

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

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

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

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

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