جمع حدث الشراء من Snapchat Pixel في المتصفح ومن Conversions API في الخادم يزيد القدرة على رصد أخطاء النقل، لكنه يفرض مسؤولية منع احتساب الواقعة مرتين. تحتاج كل واقعة إلى معرف ثابت، كما تحتاج بيئة اختبار لا تختلط فيها الطلبات التجريبية بطلبات العملاء.
تشرح وثائق Snapchat الرسمية لإزالة التكرار طريقة استخدام معرف الحدث لمطابقة الإرسال عبر Pixel وConversions API. وتوضح وثائق MDN للدالة randomUUID إنشاء UUID عشوائيًا في سياق HTTPS. توليد المعرّف خطوة صغيرة؛ تصميم دورة حياته وحفظه وإعادة استخدامه هو ما يمنع الازدواج.
ما الذي يجب أن يمثله event_id؟
يجب أن يمثل event_id واقعة واحدة محددة: إضافة معينة إلى السلة، بدء دفع معين، أو شراء طلب معين. لا تستخدم معرف الجلسة لكل الأحداث، لأن الجلسة قد تحتوي عدة إضافات وشراء واحد. ولا تستخدم معرف العميل، لأنه يعبر عن شخص لا عن فعل، وقد يكشف معلومة لا حاجة لها.
عندما ترسل الواقعة نفسها من المتصفح والخادم، استخدم المعرف ذاته ونوع الحدث المتوافق. وعندما تعيد إرسال محاولة خادم بعد خطأ موثق، احتفظ بالمعرف الأصلي. إنشاء UUID جديد لكل محاولة يحول الإعادة إلى حدث جديد من منظور المطابقة.
أين تولد المعرف وتحفظه؟
في أحداث الطلب، يكون الخادم عادة المكان الأكثر ثباتًا لأنه يملك سجل الطلب. أنشئ المعرف عند إنشاء الطلب واحفظه في حقل داخلي، ثم مرره إلى صفحة التأكيد ليستخدمه Pixel. في أحداث تسبق الطلب، يمكن للمتصفح إنشاء UUID عبر crypto.randomUUID() ثم إرساله مع طلب السلة أو الدفع ليحفظه الخادم.
لا تجعل صفحة الشكر تنشئ المعرف عند كل تحميل. إذا عاد العميل إلى الصفحة أو أعاد تحميلها، يجب قراءة القيمة المحفوظة. واستخدم قناة آمنة لنقلها؛ المعرف ليس سرًا بحد ذاته، لكنه لا ينبغي أن يحتوي بريدًا أو هاتفًا أو رقمًا يكشف حجم الطلبات.
خطوات اختبار Pixel وConversions API
- أنشئ حدثًا تجريبيًا باسم واضح داخل بيئة اختبار أو طلب مميز بأنه تجريبي.
- ولّد
event_idمرة واحدة واحفظه مع سجل الاختبار. - أرسل حدث Pixel من متصفح حقيقي، وسجل وقت الإرسال ونوع الحدث من دون بيانات عميل حقيقية.
- أرسل حدث Conversions API بالقيمة نفسها ونوع الحدث نفسه وفق الحقول المطلوبة في وثائق Snapchat.
- راجع أداة التحقق أو التشخيص في المنصة، وتأكد من وصول المسارين ومطابقتهما بدل ظهورهما كواقعتين مستقلتين.
- اختبر إعادة تحميل الصفحة وإعادة مهمة الخادم، وتحقق من بقاء المعرف ثابتًا.
- بعد نجاح الاختبار، ألغ الطلب التجريبي ونظف أي قواعد اختبار قبل تشغيل أحداث الإنتاج.
يمكن مراجعة تنفيذ الأساس عبر خدمة ربط Snapchat Pixel. ولرؤية منهجية اختبار مكملة على منصة أخرى، اقرأ كيف تختبر أحداث TikTok Pixel بأداة المساعد؟.
مثال افتراضي
مثال افتراضي: ينشئ متجر طلب اختبار ويحفظ المعرف snap_evt_c8.... ترسله صفحة التأكيد مع حدث الشراء في Pixel، ثم يستخدم عامل الخادم القيمة نفسها في Conversions API. يتعطل اتصال العامل بعد الإرسال ولا يصل الرد. يسجل النظام الحالة uncertain ولا يولد معرفًا جديدًا. عند المراجعة، يبحث المسؤول عن المعرف نفسه في أدوات التشخيص قبل تقرير إعادة المحاولة.
في تطبيق غير منضبط، تنشئ صفحة التأكيد UUID كلما حُمّلت، بينما ينشئ الخادم UUID آخر. قد تظهر ثلاثة أحداث لطلب واحد بعد إعادة تحميل الصفحة. الإصلاح هو جعل سجل الطلب مالك المعرّف وإعادة القيمة نفسها لكل مسار متعلق بالواقعة.
كيف تفصل الاختبار عن الإنتاج؟
استخدم منتجات أو طلبات اختبار معروفة ولا تضع بيانات شخصية حقيقية. سجّل معرفات الاختبار ووقت إنشائها حتى تستطيع حذف آثارها من تقاريرك الداخلية. لا تغيّر اسم حدث الإنتاج إلى اسم عشوائي إذا كانت المنصة تتطلب نوعًا قياسيًا؛ استخدم آلية الاختبار التي توثقها Snapchat أو علامة داخل نظامك لا تغيّر معنى الحدث.
نفّذ اختبارًا لكل نوع مهم: عرض المحتوى، الإضافة للسلة، بدء الدفع، والشراء. لكن لا تفترض أن وصول حدث واحد يثبت صحة بقية الأحداث، لأن نقطة التشغيل والحقول تختلف. افحص العملة والقيمة ومعرف المنتج فقط عندما تكون مطلوبة وصحيحة من المصدر.
معالجة الأخطاء والإيصالات
احفظ طلبًا منقحًا لا يحتوي أسرارًا، وحالة الإرسال، والرد الحقيقي من المزود. ميّز بين rejected برد واضح وuncertain بانقطاع الاتصال. لا تعتبر قبول API دليلًا على أن إعلانًا نُشر أو أن نتيجة تسويقية تحققت؛ هو إيصال لاستلام الحدث وفق الرد فقط.
ضع قفلًا يمنع عاملين من إرسال المهمة نفسها بالتوازي. وعند وجود رد رفض، أصلح الحقول المحددة وأعد المحاولة بالمعرف نفسه إذا كانت الواقعة نفسها. إذا كان المستخدم نفذ فعلًا جديدًا مستقلًا، أنشئ معرفًا جديدًا.
قائمة مراجعة قبل التشغيل
- هل لكل واقعة
event_idواحد محفوظ؟ - هل Pixel والخادم يستخدمان النوع والمعرف نفسيهما؟
- هل إعادة تحميل الصفحة تقرأ المعرف بدل توليده؟
- هل إعادة المهمة تحتفظ بالمعرف الأصلي؟
- هل أحداث الاختبار خالية من بيانات العملاء؟
- هل اختبرت كل نوع حدث مهم على حدة؟
- هل تحفظ رد المزود وحالة الانقطاع؟
- هل يوجد قفل يمنع الإرسال المتزامن؟
نجاح الاختبار يعني أن بإمكانك تتبع الواقعة من نشأتها إلى مساري الإرسال وإيصال المزود. هذه السلسلة الواضحة تمنع التخمين عندما تختلف الأرقام أو ينقطع الرد.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك