TikTok Events API: الأحداث من الخادم وإزالة التكرار
لديك TikTok Pixel يعمل، والطلبات تصل إلى متجرك، لكن TikTok يعرض عددًا أقل مما تراه في سجلاتك. السؤال: هل تضيف Events API، وما الذي تخاطر به إن أضفته دون تخطيط؟
الخطر حقيقي. مسار البيانات الثاني قد يُكمل الصورة، وقد يجعل كل عملية شراء تُسجَّل مرتين. والفارق بين الحالتين يتوقف على حقل واحد.
ما هو Events API
البكسل شيفرة تعمل داخل متصفح الزائر. أما Events API فهو اتصال من خادم إلى خادم: متجرك أو خادمك أو أداة مربوطة به ترسل الأحداث إلى TikTok مباشرة. تصفه وثائق TikTok بأنه يعمل بجانب البكسل، ويغطي مصادر غير الموقع مثل التطبيقات والمبيعات خارج الإنترنت وأنظمة CRM.
للمتجر الإلكتروني المعنى العملي بسيط: لم يعد وصول الحدث مرهونًا ببقاء سكربت حيًا في المتصفح. يمكن إرساله من سجل الطلب في اللحظة التي تختارها.
لماذا لا يكفي البكسل وحده
حدث المتصفح قد يفشل لأسباب عادية: سكربت محجوب، أو تبويب أُغلق، أو اتصال بطيء، أو اختيار خاص بالموافقة. عندها يكون الطلب موجودًا في متجرك وغائبًا عن TikTok. فتبدو الحملة أضعف مما هي، وتتعلم المنصة من مشتريات حقيقية أقل.
والرد المعتاد أن تُفعَّل قناة الخادم دون خطة لمطابقة المسارين، وهكذا تنتهي متاجر كثيرة بأرقام متضخمة.
- بكسل المتصفحيعمل داخل متصفح الزائر
- Events APIيُرسل من خادمك أو أداة مربوطة
إذا وصل مسار واحد فقط يُحتسب وحده. وإذا وصل المساران بحقول متطابقة فإنهما يندمجان.
قاعدة إزالة التكرار
تنص صفحة المساعدة في TikTok عن إزالة تكرار الأحداث على أنك تحتاج إلى تمرير قيمة `event_id` نفسها عبر البكسل وعبر Events API. ويجب أن يحمل الحدثان اسم الحدث نفسه ومعرّف البكسل نفسه. وإزالة التكرار تخص الأحداث المتداخلة، أي حين يبلّغ المساران عن الإجراء نفسه، لا حين يبلّغان عن إجراءين مختلفين.
النتائج العملية:
- أنشئ المعرّف مرة واحدة لكل إجراء، ثم مرّر القيمة نفسها إلى حدث المتصفح وحدث الخادم. في الشراء يصلح رقم الطلب لأنه ثابت.
- لا تدع كل مسار يولّد معرّفًا عشوائيًا خاصًا به. معرّفان مختلفان يبدوان عمليتي شراء مختلفتين.
- اجعل أسماء الأحداث متطابقة في المسارين، فاسم مختلف لن يُقرن بالحدث الآخر.
- تذكر TikTok أيضًا ملف الارتباط الأول `_ttp` كعنصر موصى به للمطابقة. راجع الوثائق الحالية لمعرفة كيفية استخدامه.
المنطق نفسه ينطبق على Meta، ويشرح مقال تكرار حدث الشراء: الأسباب وكيف تعمل إزالة التكرار نمط الخلل بتفصيل أكبر.
مثال محسوب
شريط 360 محدود بالعرض الكامل، وهو يساوي 180% من الطلبات الحقيقية.
متجر لديه 200 طلب حقيقي في أسبوع. افترض أن البكسل التقط 164 منها وأن الخادم أرسل 196. حينها يصل 160 طلبًا من المسارين معًا، و4 من المتصفح فقط، و36 من الخادم فقط، فالمجموع 160 + 4 + 36 = 200.
- مع تطابق معرّفات الأحداث، يستطيع TikTok دمج المتداخل فيقترب العدد من 200.
- مع عدم تطابقها، يستلم 164 + 196 = 360 عملية شراء، أي 180% من الواقع.
أضف الإنفاق إلى الحساب. بمتوسط طلب 150 ريالًا وإنفاق إعلاني 6,000 ريال، تعطي 200 طلبًا نسبة إيراد إلى إنفاق = 30,000 / 6,000 = 5.0. أما 360 المتضخمة فتعطي 54,000 / 6,000 = 9.0. لم يتغير شيء في الحملة، تغيّر العدّ فقط. ورقم مثل 9.0 قد يدفعك إلى رفع الميزانية على نتيجة غير موجودة.
المقايضات ومتى تتغير التوصية
- حجم منخفض. إن كنت تبيع عددًا قليلًا من الطلبات أسبوعيًا فالفجوة الناتجة عن فقد أحداث المتصفح صغيرة بالأرقام المطلقة، وقد يكفي إعداد أخف، وجهدك أفضل في موضع آخر.
- تكامل جاهز أو بناء مخصص. قد تقدم منصات المتاجر وأدوات الوسوم تكاملًا مع TikTok يرسل أحداث الخادم. تحقق مما يرسله فعلًا وهل يشارك معرّف الحدث مع البكسل قبل أن تثق به. والبناء المخصص يمنح تحكمًا ويكلّف صيانة.
- أحداث مختلفة في كل مسار. إن أرسل البكسل أحداث الصفحات والسلة وأرسل الخادم الشراء فقط، فالتداخل قليل وإزالة التكرار أقل أهمية. اتخذ هذا القرار عن قصد لا بالصدفة.
- الدفع عند الاستلام. الطلب المُنشأ ليس طلبًا مُسلَّمًا. يتيح مسار الخادم إرسال الشراء لاحقًا بعد التأكيد. وهل يناسب ذلك حملتك؟ هذا قرار منفصل عن الإعداد التقني.
- الموافقة. الإرسال من الخادم لا يلغي التزامك باحترام اختيار الزائر. تأكد مما ينطبق عليك لدى الجهة المختصة أو مستشارك.
خطوات التنفيذ
- اجمع الأحداث التي يرسلها بكسلك الآن بالفحوص الواردة في إعداد TikTok Pixel للمتاجر: الأحداث والمعاملات والفحوص.
- قرر أي الأحداث سيرسلها الخادم أيضًا، وابدأ بالشراء.
- اختر مكان إنشاء معرّف الحدث مرة واحدة، واجعل المسارين يقرآنه.
- أرسل القيمة والعملة وبيانات العميل التي توثقها TikTok، مع اتباع قواعد التشفير والتنسيق عندها.
- اختبر بأدوات اختبار الأحداث من TikTok وتأكد أن كل إجراء تجريبي يظهر مرة واحدة.
- بعد أسبوع قارن عدد المشتريات في TikTok بسجل طلباتك. قد يوجد فرق، لكن إن زاد عدد Ads Manager عن طلباتك الحقيقية فاستقصِ السبب.
ما لا تخبرك به البيانات
العدد النظيف بعد إزالة التكرار يخبرك أن TikTok سجّل الشراء، لا أن TikTok هو من تسبب فيه. تبقى نوافذ الإسناد والمشاهدات والعملاء الذين رأوا إعلانات أخرى. أحداث الخادم تحسّن الاكتمال ولا تثبت السببية. وللمشكلة الأوسع انظر لماذا تختلف مبيعات متجرك عن نتائج Meta وGoogle Ads؟، ولنظير هذا الإعداد في Meta اقرأ Meta Conversions API: ما الذي تضيفه إلى البكسل.
الخطوة التالية
افتح تقرير أحداث TikTok وقائمة طلبات متجرك لأسبوع واحد. إن اختلف العددان في أي اتجاه فافحص معرّفات الأحداث قبل أن تلمس الحملة. وإن أردت إعداد مسار المتصفح ومسار الخادم وإزالة التكرار والاختبار والتحقق منها معًا، فخدمة إعداد التتبع تغطي هذه السلسلة.