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