لو انت شغال تيك توك ادز وبتعتمد على البكسل لوحده، فانت بتقيس على قناة تيك توك نفسها بتقول عليها انها بتضيع تحويلات. وده مش استنتاج مني، ده مكتوب في صفحة المساعدة بتاعتهم.
المقال ده بيشرح الـEvents API من التوثيق الرسمي بس: هو بيعمل ايه، ليه بيتشغل جنب البكسل مش بدله، والشرط الواحد اللي لو غلطت فيه هتقيس كل تحويل مرتين.
شرح TikTok Events API: هو ايه في كلام تيك توك
صفحة الـEvents API في مساعدة تيك توك للاعلانات بتوصفه بانه «اتصال موثوق بين تيك توك وبيانات المعلن التسويقية». والصفحة بالانجليزي.
الفرق الجوهري عن البكسل: البكسل بيشتغل من متصفح المستخدم، والـEvents API بيشتغل من السيرفر بتاعك. يعني الحدث بيمشي من السيرفر لتيك توك على طول، من غير ما يعتمد على ان المتصفح سمح بيه او خلّص تحميله.
والتوثيق بيقول انه مش للويب بس. الصفحة بتذكر تلات قنوات: الويب، والتطبيق، والاوفلاين زي الفروع وانظمة الـCRM. ودي نقطة بتتنسى: نفس القناة اللي بتبعت بيها الـPurchase من الموقع تقدر تبعت بيها بيعة حصلت في الفرع.
وحاجة عملية من نفس الصفحة: اعداد البكسل او الـEvents API شرط اساسي لاستخدام هدف Web Conversions في مدير الاعلانات. يعني ده مش تحسين اختياري في كل الحالات.
ليه البكسل لوحده بيضيع تحويلات
تيك توك بتذكر سببين في صفحتها: مشاكل الاتصال connectivity problems، وتفاوت المتصفحات browser inconsistencies. والجملة التانية دي هي اللي تستحق تفصيل، لان ورا كلمة «تفاوت» في حاجة موثقة اكبر من كده بكتير.
سفاري نشرت في اعلان 24 مارس 2020 عن الحجب الكامل لكوكيز الطرف الثالث ان كوكيز الموارد العابرة للمواقع بقت محجوبة بشكل افتراضي بالكامل. والمقال بالانجليزي.
والاهم للقياس في نفس الاعلان: سقف سبعة ايام على التخزين اللي بيكتبه السكريبت. سفاري بتمسح التخزين القابل للكتابة بالسكريبت لموقع معين بعد سبعة ايام من استخدام سفاري من غير تفاعل من المستخدم مع الموقع ده. والاعلان بيعدد اللي بيتأثر: IndexedDB وLocalStorage ومفاتيح الميديا وSessionStorage وتسجيلات Service Worker وكاشاتها. والكوكيز اللي بيكتبها السكريبت كانت اتسقّفت على سبعة ايام من فبراير 2019.
ترجمة ده لحسابك: اي معرّف بيعيش في المتصفح ممكن يتبخر خلال اسبوع. فالبكسل مش بيكدب عليك، هو بيقولك اللي قدر يشوفه. والـEvents API مش بيحل المشكلة دي من جذورها كمان، بس بيخلي الحدث نفسه مش مربوط بحياة المتصفح.
والمنطق ده نفسه ينطبق على ميتا وجوجل، وفصلته قبل كده في شرح التتبع من جانب السيرفر.
التوصية الرسمية: الاتنين مع بعض، مش واحد بدل التاني
ده اكبر لبس بشوفه. ناس كتير بتشغل الـEvents API وبتشيل البكسل، فاكرة انها بتنضف الاعداد. التوثيق بيقول العكس حرفياً: «للاتصالات الخاصة بالمواقع، احنا بنوصي بوجود تكامل Events API مع تكامل البكسل الحالي عندك».
والسبب منطقي. البكسل بيشوف حاجات السيرفر مش شايفها، زي سلوك المستخدم جوه الصفحة. والسيرفر بيشوف حاجات المتصفح مش شايفها، زي بيعة اتأكدت بعد يومين او اتعملت بتحويل بنكي. القناتين مش بديلتين، هما مصدرين مختلفين.
والصفحة بتعدد تلات توصيات بالترتيب: نوع الاتصال، يعني البكسل والـEvents API مع بعض مع منع التكرار. والاحداث والمعاملات، يعني تبعت الاحداث بشكل متسق في القناتين على طول رحلة المستخدم. ومفاتيح المطابقة، يعني تمرر كل مفاتيح المطابقة المتعلقة عشان ترفع نسبة المطابقة.
منع التكرار: الشرط الواحد والنوافذ بالظبط
لو بعتت نفس الحدث من القناتين وانت مش ظابط منع التكرار، تيك توك هتحسب كل بيعة مرتين، والمزايدة هتتعلم على رقم مش حقيقي. صفحة منع التكرار في مساعدة تيك توك بتحدد الشرط في جملة واحدة: «لازم تشارك Event ID كمعامل من خلال البكسل والـEvents API الاتنين». والصفحة بالانجليزي.
والنوافذ الموثقة في نفس الصفحة:
| الحالة | النافذة | اللي بيتحفظ |
|---|---|---|
| تكرار جوه البكسل لوحده | نفس الحدث ونفس event_id خلال 48 ساعة من اول حدث | اول حدث يوصل |
| تكرار جوه الـEvents API لوحده | نفس النافذة، 48 ساعة | اول حدث يوصل |
| تكرار بين البكسل والـEvents API | الاحداث المتطابقة اللي بتوصل بعد 5 دقايق وخلال 48 ساعة | اول حدث يوصل |
الصفحة بتقول بالنص انها «هتسجل اول حدث يوصل للقياس والتقارير»، وبتقول كمان انها «بتحفظ وتُثري» اول حدث، من غير ما تشرح الاثراء ده بيعمل ايه. وده حد في التوثيق مش حد في فهمي، وذكرته عشان متبنيش عليه.
والنقطة اللي بتوقع الناس: الـevent_id لازم يتولد من نفس المصدر للحدث الواحد. لو السيرفر بيولد ID والمتصفح بيولد ID تاني لنفس البيعة، فالاتنين مختلفين، ومنع التكرار مش هيشتغل حتى لو انت مفعّله. ومشكلة التكرار نفسها شرحتها على ميتا في مشكلة تكرار احداث البكسل، والمنطق هو هو.
امتى منع التكرار مش مطلوب اصلاً
الصفحة واضحة في النقطة دي وبتريح ناس كتير: منع التكرار مطلوب بس لما نفس الحدث يتشارك من القناتين مع تقاطع. ومش مطلوب لما تبعت احداث مختلفة من قنوات مختلفة.
والمثال المذكور في التوثيق: AddToCart من البكسل وPurchase من الـEvents API. دول حدثين مختلفين، فمفيش تكرار يتمنع.
الترتيب ده بيستخدمه ناس عشان يبسطوا الاعداد، وهو مشروع. بس خد بالك من التكلفة: لو الـPurchase بييجي من السيرفر بس، فانت فقدت قدرة البكسل على ربط البيعة بسلوك الصفحة. المقايضة دي قرار مش مبدأ.
مفاتيح المطابقة، والحد اللي تيك توك حطته بنفسها
تيك توك بتوصي بتمرير كل مفاتيح المطابقة المتعلقة عشان ترفع نسبة المطابقة. ومنطق ده ان الحدث اللي جاي من السيرفر مش معاه معرّف المتصفح، فلازم حاجة تربطه بالمستخدم.
وفي نفس الوقت، الصفحة بتقول ان المعلن «بيحتاج يشارك البيانات المطلوبة بس لتحقيق اهدافه التسويقية». يعني التوصية مش «ابعت كل حاجة عندك»، هي «ابعت المتعلق».
والفرق بين الجملتين دي مسافة قانونية كاملة. ارفع نسبة المطابقة بالمفاتيح اللي ليها علاقة بالاستهداف والقياس، لا بكل عمود في قاعدة بياناتك.
والاخطاء المتكررة في اعداد القناة السيرفر سايد مش مختلفة كتير بين المنصات، وجمعتها قبل كده في اخطاء اعداد Conversions API.
ترتيب التنفيذ
1. سيب البكسل شغال زي ما هو. متشيلوش.
2. حدد الاحداث اللي فعلاً محتاجة تمشي من السيرفر. غالباً البيعة والليد المؤكد، مش كل حدث.
3. ولّد event_id واحد لكل حدث في مكان واحد، وخلي القناتين تقراه من نفس المكان ده.
4. مرر مفاتيح المطابقة المتعلقة، وبس.
5. شغّل وقارن الارقام اسبوع كامل قبل ما تغير مزايدة. التغيير في العدد مش دليل تحسن لوحده، لان جزء منه ممكن يكون تكرار مش تحويل جديد.
والخطوة التالتة دي شغل تقني في السيرفر بتاعك لا في مدير الاعلانات، وتكلفتها الحقيقية غالباً اكبر من المتوقع. الناحية الهندسية لربط نظامين بالـAPI كتبها فريق رفل في تكامل الـAPI بين نظامين وتكلفته الحقيقية، والمقال بالانجليزي ومكتوب لحد بيقرر يبني الحاجة دي بنفسه ولا لأ.
الحدود بصراحة
مفيش رقم منشور من تيك توك لتأثير التشغيل. اي نسبة بتتداول عن زيادة التحويلات المقيسة بعد تشغيل الـEvents API مش موجودة في التوثيق اللي قريته، وجاية عادةً من جهة بتبيع ادوات تتبع وبتقيس على حالاتها. مش هنقل رقم من النوع ده.
التوثيق التقني الكامل مش في صفحات المساعدة. الحدود والمعاملات بالتفصيل في بوابة المطورين، وهي محتاجة دخول وما قدرتش اقراها دلوقتي. فاللي فوق ده من صفحتين مساعدة عامتين، ولو انت بتنفذ فعلاً راجع بوابة المطورين لاسماء الحقول والنسخة.
صفحات مساعدة تيك توك ليها نسخ متعددة. النسخة اللي قريتها بتقول ان الدمج بين البكسل والـAPI بيحصل للاحداث اللي بتوصل بعد 5 دقايق وخلال 48 ساعة. في صياغات تانية متداولة بتتكلم عن 5 دقايق بس. اللي فوق هو اللي قريته، وراجعه في حسابك قبل ما تبني عليه قرار.
والاهم: الـEvents API مش بيصلح استهداف غلط. هو بيحسن اللي تيك توك شايفه، مش بيحسن الحملة. لو الكرياتيف مش بيجيب نقرة، فقناة قياس اضافية هتوريك الصفر بدقة اعلى.
أسئلة شائعة
ايه الفرق بين TikTok Events API والبكسل؟
البكسل بيشتغل من متصفح المستخدم، والـEvents API بيشتغل من السيرفر بتاعك فبيبعت الحدث لتيك توك من غير اعتماد على المتصفح. وتيك توك بتذكر في صفحتها ان تحويلات البكسل ممكن تضيع بسبب مشاكل الاتصال وتفاوت المتصفحات. والتوثيق بيوصي بتشغيل الاتنين مع بعض لا بواحد بدل التاني، لان كل قناة بتشوف حاجات التانية مش شايفاها.
ازاي امنع تكرار الاحداث بين البكسل والـEvents API؟
بشرط واحد صريح في توثيق تيك توك: تبعت نفس Event ID كمعامل من خلال البكسل والـEvents API الاتنين. ولازم الـevent_id يتولد من مصدر واحد للحدث الواحد، لان لو كل قناة ولّدت ID مختلف لنفس البيعة فمنع التكرار مش هيشتغل حتى لو مفعّل.
ايه نوافذ منع التكرار الموثقة؟
جوه قناة واحدة، بكسل لوحده او Events API لوحده: الاحداث المتطابقة في الحدث وفي event_id بتتشال لو وصلت خلال 48 ساعة من اول حدث. وبين البكسل والـEvents API: الاحداث المتطابقة اللي بتوصل بعد 5 دقايق وخلال 48 ساعة بتتدمج. وفي كل الحالات تيك توك بتسجل اول حدث يوصل للقياس والتقارير.
هل لازم امنع التكرار دايماً؟
لا. توثيق تيك توك بيقول ان منع التكرار مطلوب بس لما نفس الحدث يتشارك من القناتين مع تقاطع، ومش مطلوب لما تبعت احداث مختلفة من قنوات مختلفة. والمثال المذكور في التوثيق نفسه: AddToCart من البكسل وPurchase من الـEvents API.
هل تشغيل الـEvents API هيزود تحويلاتي؟
هيزود اللي تيك توك قادرة تشوفه وتنسبه، وده مش نفس زيادة البيع. ومفيش رقم منشور من تيك توك لحجم الفرق، فاي نسبة محددة بتتداول مش من التوثيق. وجزء من الزيادة في العدد بعد التشغيل ممكن يكون تكرار مش تحويل جديد، فقارن اسبوع كامل قبل ما تغير مزايدة.
المصادر
- صفحة Events API في مساعدة تيك توك للاعلانات. المقتبس منها: وصفه بانه «a reliable connection between TikTok and advertiser’s marketing data»، وتغطيته للويب والتطبيق والاوفلاين زي الفروع والـCRM، والتوصية الصريحة «For website connections, we recommend having an Events API integration with your existing Pixel integration»، وان تحويلات البكسل ممكن تضيع بسبب connectivity problems وbrowser inconsistencies، والتوصيات التلاتة عن نوع الاتصال والاحداث والمعاملات ومفاتيح المطابقة، وان المعلن بيشارك البيانات المطلوبة بس لتحقيق اهدافه، وان اعداد البكسل او الـEvents API شرط لهدف Web Conversions.
- صفحة About event deduplication في مساعدة تيك توك. المقتبس منها: «You must share Event ID (event_id) as a parameter through both Pixel and Events API»، وان التكرار جوه قناة واحدة بيتشال للاحداث المتطابقة في الحدث وفي event_id خلال 48 ساعة من اول حدث، وان التكرار بين البكسل والـAPI بيتدمج للاحداث المتطابقة اللي بتوصل بعد 5 دقايق وخلال 48 ساعة، وان تيك توك «will record the first event received for measurement and reporting» وانها «keep and enrich» اول حدث من غير شرح الاثراء، وان منع التكرار مش مطلوب لما تتبعت احداث مختلفة من قنوات مختلفة بمثال AddToCart من البكسل وPurchase من الـEvents API.
- اعلان WebKit بتاريخ 24 مارس 2020 عن Full Third-Party Cookie Blocking and More. المقتبس منه: «Cookies for cross-site resources are now blocked by default across the board»، وسقف السبعة ايام على التخزين القابل للكتابة بالسكريبت وان سفاري بتمسحه بعد سبعة ايام من استخدام سفاري من غير تفاعل المستخدم مع الموقع، وقايمة اللي بيتأثر: IndexedDB وLocalStorage ومفاتيح الميديا وSessionStorage وتسجيلات Service Worker وكاشاتها، وان الكوكيز اللي بيكتبها السكريبت اتسقّفت على سبعة ايام من فبراير 2019.