نظرة عامة
يتألف تنفيذ ميزة "تتبُّع الإحالات الناجحة" من جزأين: تخزين rwg_token وعرضها. تظل هذه العناصر كما هي ولكن بهدف التوافق مع الإصدار 2 من
"تتبع الإحالات الناجحة"، يتعين عليك الآن عرض قيمة جديدة: merchant_change.
التغييرات على الرمز المميّز المستمر
عند الاحتفاظ بالرمز المميّز، سيُطلب منك الآن تخزين التاجر المرتبط برابط الإجراء. يتم ذلك عادةً من خلال مطابقة التاجر مع السمة merchant_id المناسبة.
في ما يلي مثال على تتبُّع الإحالات الناجحة على مستوى الجهاز، وتخزين هذه القيم في متصفّح ويب باستخدام ملف تعريف ارتباط للطرف الأول. يفترض هذا المثال أنّك حلّلت قيمة الرمز المميّز في متغيّر ونفّذت عملية تخزين merchant_id. لاستخدام هذا المثال، عليك تحديث rootdomain بنطاقك. قد لا يناسب هذا النهج المتَّبع الجميع، لذلك يتملك الشركاء حرية تعديل أو تنفيذ منطقهم الخاص على النحو الملائم.
<script>
if (typeof rwg_token !== 'undefined') {
merchant_id = // Write your own logic here assigning the merchant id value
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
</script>
التغييرات في إرسال بيانات الإحالات الناجحة
عندما يُكمل المستخدم حدث إحالة ناجحة، يجب أن يكون نص المشاركة كائنًا بترميز JSON
وذات قيمة منطقية جديدة merchant_change.
{
"conversion_partner_id": <partnerId>,
"rwg_token": <rwg_token_val>
"merchant_changed": 1|2
}
تُستخدَم السمة merchant_id المخزَّنة سابقًا لتحديد ما إذا كان التاجر الذي
بدأ حدث الإحالة الناجحة مختلفًا عن التاجر الأصلي. بعد التأكّد مما إذا كان التاجر قد غيّر ما إذا كان قد تم تغيير القيمة أم لا، ستعرض قيمة merchant_change المناسبة باستخدام الجدول التالي.
| قيمة تغيير التاجر | المطلوب للحصول على الشارة |
|---|---|
| 1 | يجب استخدام هذه القيمة عندما يغادر المستخدم الموقع الإلكتروني الأصلي للتاجر ويكمل عملية شراء على منصتك لدى تاجر آخر. |
| 2 | يجب استخدام هذه القيمة عندما يُكمل العميل معاملة باستخدام الكيان الأصلي (التاجر). |
عليك تقديم قيمة rwg_token صالحة عند إرسال حدث إحالة ناجحة.
لأغراض الاختبار، استخدِم الرمز المميّز التالي للاختبار في كلتا البيئتين حتى تكون مستعدًا للإطلاق:
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
عند تقديم الطلب، استخدِم نقاط النهاية التالية التي تتوافق مع بيئتك:
- مرحلة الإنتاج: https://www.google.com/maps/conversion/collect
- وضع الحماية: https://www.google.com/maps/conversion/debug/collect
متطلبات تحديد مصدر الإحالات الناجحة
إنّ المعيار المطلوب من Google لتحديد مصدر الإحالات الناجحة هو مهلة 30 يومًا لأي تفاعل مع رابط مكان في أي متجر.
تعني فترة تحديد المصدر هذه أنّ Google تتوقّع أن يتم إرسال حدث إحالة ناجحة في أيٍّ من السيناريوهات التالية:
- يتّبع أحد المستخدمين رابط إجراء مستند إلى المكان ويقدِّم طلبًا للتاجر نفسه في الجلسة نفسها(قيمة تغيير التاجر = 2).
- يتبع المستخدم رابط الإجراء المخصّص للمكان، ثم يعود من قناة مختلفة خلال فترة 30 يومًا لتقديم طلب للتاجر نفسه. ( قيمة تغيير التاجر = 2 )
- يتّبع المستخدم رابطًا لاتخاذ إجراء، ثم يقدّم طلبًا في متجر مختلف، إما خلال الجلسة نفسها أو في جلسة مختلفة خلال فترة 30 يومًا. ( قيمة تغيير التاجر = 1 )
إضافةً إلى ذلك، تتوقّع Google إرسال أحداث الإحالات الناجحة من جميع مساحات العرض التي يمكن أن يصل إليها المستخدِم من خلال رابط إجراء المكان. بما في ذلك:
- تطبيقات الويب على أجهزة الكمبيوتر المكتبي أو الأجهزة الجوّالة
- تطبيقات الأجهزة الجوّالة، إمّا من خلال رابط لموضع معيّن في التطبيق أو هدف مسجَّل في نطاقك
إذا تم تخزين الرمز المميّز على مستوى المستخدم (اطّلِع على الرمز المميّز الدائم)، من المتوقّع أن تقدّم عملية تحديد مصدر على جميع الأجهزة. وهذا يعني أنّ المستخدم الذي يتّبع رابط إجراء من جهاز الكمبيوتر المكتبي ثم يُكمل المعاملة على الجهاز الجوّال (باستخدام حساب المستخدم نفسه)، عليه بدء حدث إحالة ناجحة.
إذا كان الرمز المميّز مخزَّنًا حصريًا على مستوى الجهاز، كما هو الحال في ملفات تعريف ارتباط المتصفِّح، من غير المتوقّع أن توفّر عملية تحديد المصدر على جميع الأجهزة. في هذه الحالة، سيكون لكل جهاز رمز مميّز منفصل إذا كان المستخدم قد اتّبع رابط إجراء على ذلك الجهاز، وسيتّبع كل جهاز قواعد تحديد المصدر بشكل منفصل.