توحيد معرّف الحدث بين Snap Pixel وConversions API

الإجابة العملية

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

خطوات التطبيق

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

مثال تطبيقي افتراضي

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

أخطاء تستحق الانتباه

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

كيف تتحقق من التنفيذ؟

• راجع مطابقة القيم بين حقول التكامل الفعلية التي ترسل العملية نفسها.
• تأكد أن عملية ثانية لا تعيد استعمال معرّف العملية الأولى وأن المحاولة المتكررة لا تغيره.