انتقل إلى المحتوى
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويقالعودة للمتجر
القائمة

تمايز / معلومات تهمك

كيف تمنع تكرار أحداث TikTok بين Pixel وEvents API باستخدام event_id؟

شرح عملي لمنع تكرار أحداث TikTok عند إرسال الحدث من Pixel وEvents API، مع بناء event_id ثابت واختبار المطابقة قبل الإطلاق.

إرسال الحدث نفسه من المتصفح والخادم يساعد على استمرار القياس عندما يتعذر أحد المسارين، لكنه قد يضاعف الأرقام إذا لم يستطع TikTok معرفة أن الرسالتين تمثلان التحويل نفسه. الحل هو تصميم معرف event_id ثابت وفريد للعملية الواحدة، ثم إرسال الاسم والمعرف نفسيهما من Pixel وEvents API.

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

متى تحتاج إلى منع تكرار أحداث TikTok؟

تحتاجه عندما يرسل المتجر الحدث نفسه عبر TikTok Pixel في المتصفح وعبر Events API من الخادم. مثال ذلك Purchase الذي يطلق بعد صفحة النجاح، ثم يرسله الخادم بعد اعتماد الطلب. المساران مفيدان، لكنهما يجب أن يحملا هوية واحدة للعملية نفسها.

تشرح وثائق TikTok الرسمية لإزالة التكرار أن TikTok يقارن اسم الحدث ومعرف event_id عند استقبال نسختين من الحدث. لذلك لا يكفي أن يكون رقم الطلب موجودًا في حقل آخر، ولا يكفي تطابق الوقت التقريبي.

صمم event_id حول العملية لا حول الجلسة

المعرف الجيد يجيب عن سؤال: ما العملية التجارية المحددة التي يمثلها الحدث؟ لحدث Purchase يمكن أن يكون معرف الطلب الداخلي بعد تحويله إلى قيمة لا تكشف معلومات العميل. لحدث SubmitForm قد يكون معرف إرسال ينشئه الخادم مرة واحدة. لا تستخدم البريد أو الهاتف أو اسم العميل في المعرف.

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

خطوات تنفيذ Pixel وEvents API

  1. أنشئ المعرف عند نقطة مؤكدة: ولّد event_id عندما ينشأ الطلب أو يُعتمد الإرسال، واحفظه مع السجل حتى يستطيع المتصفح والخادم قراءته.
  2. أرسل الاسم والمعرف نفسيهما: إذا أرسل Pixel حدث Purchase بالمعرف نفسه، فيجب أن يرسل Events API حدث Purchase بالمعرف ذاته للعملية، مع اختلاف قناة الإرسال فقط.
  3. اختبر قبل التوسع: استخدم أدوات الاختبار والتشخيص في TikTok Events Manager، ونفذ عملية اختبار واحدة، ثم تحقق من وصول المسارين ومن تعامل النظام معها كحدث واحد.

يقدم دليل TikTok الرسمي للبدء مع Events API مسار الإعداد والاختبار. اقرأ التعليمات الحالية داخل الحساب أيضًا لأن الحقول المتاحة قد تختلف حسب نوع التكامل.

راقب التوقيت وإعادة المحاولة

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

راقب الفرق بين عدد الطلبات المؤكدة وعدد أحداث Purchase المستلمة، لكن لا تتوقع تطابقًا حسابيًا كاملًا في كل لحظة؛ التأخير، الموافقات، الحظر، والاسترداد قد تؤثر في القراءة. الهدف من الاختبار هو كشف التكرار أو الفقد الواضح، وليس إثبات أداء إعلاني.

مثال افتراضي

متجر افتراضي أنشأ الطلب رقم 81025 وولد له معرفًا داخليًا مثل order_81025 بعد تأكيد الطلب. مرر صفحة النجاح المعرف إلى Pixel، وأرسل الخادم Purchase عبر Events API بالمعرف نفسه. عند فشل الاتصال أعاد الخادم المحاولة بالمعرف ذاته، فلم ينشئ هوية جديدة للعملية.

في اختبار آخر، ضغط العميل زر الشراء مرتين لكن النظام أنشأ طلبًا واحدًا فقط؛ بقي event_id واحدًا لأن الحدث التجاري واحد. أما طلب لاحق للعميل نفسه فأخذ معرفًا مختلفًا. هكذا لا تختلط هوية العميل بهوية الحدث.

علامات الخلل الشائعة

ظهور عمليتي Purchase لطلب واحد يشير غالبًا إلى اختلاف event_id أو اسم الحدث بين المسارين. غياب حدث الخادم قد يرتبط ببيانات اعتماد أو نقطة نهاية أو تنسيق غير صحيح. أما دمج طلبات متعددة فقد ينتج عن إعادة معرف ثابت عالميًا. راجع عينات محددة مرتبطة بطلبات اختبار بدل النظر إلى الإجمالي وحده.

قائمة مراجعة قبل الإطلاق

  • [ ] الحدث نفسه يرسل من Pixel وEvents API بالاسم نفسه.
  • [ ] event_id فريد لكل عملية وثابت عبر إعادة المحاولة.
  • [ ] المعرف لا يحتوي بريدًا أو هاتفًا أو بيانات حساسة.
  • [ ] المعرف محفوظ في الطلب أو سجل العملية.
  • [ ] أداة الاختبار أظهرت وصول المسارين.
  • [ ] سجل الخادم يحفظ النتيجة من دون أسرار.
  • [ ] حالات الإلغاء والاسترداد لها منطق منفصل.
  • [ ] لا توجد مشغلات متعددة في صفحة النجاح ترسل Pixel مرتين.

المراجع والمصادر

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

نسمعك

اكتب سؤالك أو ملاحظتك. يُنشر التعليق بعد المراجعة، ويبقى البريد خاصًا.