التركية
الإنجليزية
الإسبانية
العربية
الروسية
الإجابة المختصرة
ربط بكسل تيك توك مع Events API يعني إرسال أحداث متجرك، مثل الشراء والإضافة إلى السلة، عبر قناتين معًا: البكسل من متصفح الزائر، وواجهة Events API من خادمك أو منصتك. توصي TikTok بإبقاء البكسل وإضافة Events API إليه، مع إرسال الحدث نفسه بالاسم نفسه ومُعرِّف الحدث event_id نفسه، ثم التحقق عبر اختبار الأحداث في مدير الأحداث.
أهم النقاط
- لا تحذف البكسل: الإعداد الذي توصي به TikTok هو البكسل مع Events API معًا وإزالة التكرار مفعّلة.
- لإزالة التكرار يجب أن يتطابق اسم الحدث وقيمة event_id في القناتين؛ وتحتفظ TikTok بأول حدث يصلها خلال 48 ساعة.
- في سلة وزد يتم الربط من تطبيقات المنصة بإدخال معرّف البكسل ثم رمز الوصول (Access Token) الخاص بـ Conversion API.
- منذ 1 مايو 2025 أصبح اسم CompletePayment هو Purchase؛ اعتمد Purchase في أي إعداد جديد.
- في Events API لا يُرسَل عنوان IP ووكيل المستخدم تلقائيًا؛ أضفهما مع ttclid وقيمة ملف _ttp لرفع جودة المطابقة.
المحتويات
ما هو TikTok Events API وما الفرق بينه وبين البكسل؟
TikTok Events API (وتسميه منصات مثل سلة وزد «TikTok Conversion API») هو اتصال من خادم إلى خادم يرسل أحداث التحويل من متجرك أو منصتك مباشرة إلى TikTok، بدل الاعتماد على متصفح الزائر. أما البكسل فهو شيفرة JavaScript تعمل داخل المتصفح. القناتان لا تتنافسان، بل تكمل إحداهما الأخرى.
نقطة ضعف البكسل أنه مرتبط بالمتصفح: مانع الإعلانات، وقيود ملفات تعريف الارتباط، وبطء تحميل صفحة الشكر، أو إغلاق العميل للنافذة بعد الدفع، كلها أسباب قد تمنع وصول حدث الشراء. أما سجل الطلب الذي ينشأ على الخادم فلا يتأثر بهذه العوائق. ولهذا لا يطلب منك دليل TikTok الرسمي إزالة البكسل، بل إضافة Events API قناةً ثانية وتفعيل إزالة تكرار الأحداث.
بكسل TikTok (المتصفح)
- يعمل بشيفرة تُضاف إلى الموقع، وتركيبه سريع
- يتأثر بمانعات الإعلانات وقيود ملفات الارتباط
- يشارك عنوان IP ووكيل المستخدم افتراضيًا
- ينشئ ملف الارتباط _ttp بنفسه
Events API (الخادم)
- يُرسَل من خادمك أو من منصة متجرك
- لا تؤثر فيه عوائق المتصفح
- ينقل بيانات الطلب الفعلية مثل رقم الطلب وقيمته
- عليك أنت إضافة IP ووكيل المستخدم وttclid وقيمة _ttp
الفكرة نفسها تنطبق على Meta، لذلك إن كنت تدير الحملات على المنصتين فستلاحظ أن منطق الإعداد متشابه إلى حد كبير، وإن اختلفت أسماء الحقول والأدوات.
أي طريقة ربط تناسب متجرك: سلة، زد، Shopify أم ربط مباشر؟
إذا كان متجرك على منصة جاهزة مثل سلة أو زد أو Shopify أو WooCommerce، فابدأ بالتكامل الرسمي داخل المنصة؛ وإذا كان لديك نظام خاص، فأمامك الربط المباشر مع الواجهة البرمجية أو حل وسم من جهة الخادم. تقسم TikTok هذه الطرق إلى شركاء التجارة، وشركاء البيانات، والتكامل المباشر.
| الطريقة | لمن تناسب | الميزة | ما يجب الانتباه إليه |
|---|---|---|---|
| تطبيق المنصة (سلة، زد، Shopify، WooCommerce) | المتاجر المبنية على منصة جاهزة | بدون برمجة؛ البكسل وEvents API يعملان من مكان واحد | الأحداث والمعلمات المرسلة محدودة بما يدعمه التطبيق |
| شريك بيانات (مدير وسوم، منصة بيانات عملاء، وسم من جهة الخادم) | فرق التسويق ذات الخبرة التقنية | طبقة بيانات واحدة ترسل إلى أكثر من منصة إعلانية | قد تظهر تكلفة استضافة أو اشتراك؛ ومطابقة event_id مسؤوليتك |
| تكامل مباشر مع الواجهة البرمجية | العلامات التي لديها فريق تطوير | تحكم كامل في كل حدث وحقل | أعلى عبء في التطوير ومراقبة الأخطاء وإدارة رمز الوصول |
الربط في سلة وزد
في زد، يوضح مركز المساعدة أن الربط يتم على مرحلتين من لوحة التحكم: من سوق التطبيقات > تتبع الحملات > TikTok Pixel تُدخل معرّف البكسل وتضغط تفعيل، ثم من سوق التطبيقات > تتبع الحملات > TikTok Conversion API تلصق رمز الوصول الذي أنشأته من إعدادات البكسل في TikTok. وفي سلة يتوفر تطبيق «TikTok Conversion API» في متجر التطبيقات، وتُدخل في صفحة تفعيله القيمتين نفسيهما: معرّف البكسل ورمز الوصول المستخرجين من حسابك في مدير إعلانات TikTok.
قاعدة القرار: إذا فعّلت البكسل من تطبيق المنصة، فلا تضف شيفرة بكسل ثانية يدويًا في القالب أو عبر Google Tag Manager. سيصل الحدث نفسه من مصدرين بمعرّفات event_id مختلفة، ولن تتمكن TikTok من دمجهما.
مستويات مشاركة البيانات في Shopify
في تطبيق TikTok على Shopify ثلاثة مستويات لمشاركة البيانات، وEvents API يعمل في اثنين منها فقط:
- Standard (قياسي): البكسل فقط، وقد تؤثر مانعات الإعلانات في جمع البيانات.
- Enhanced (مُحسَّن): البكسل + Events API + المطابقة المتقدمة.
- Maximum (أقصى): ما سبق مع واجهات Shopify البرمجية والدفع داخل التطبيق (وتصفه TikTok بأنه تجريبي وغير متاح لجميع المعلنين).
إذا ظهر لك المستوى «Standard»، فانقله إلى «Enhanced» أولًا؛ لكثير من المتاجر يكفي هذا الإعداد قبل التفكير في تكامل خادم منفصل.
كيف تربط بكسل تيك توك وEvents API خطوة بخطوة؟
يبدأ الإعداد بإنشاء بكسل في مدير الأحداث (Events Manager)، ثم تربط أحداث المتصفح عبر شيفرة البكسل، وأحداث الخادم عبر رمز الوصول (Access Token). إذا كنت تستخدم تطبيق منصة فتكفيك غالبًا الخطوات 1 و2 و5 (مع الخطوة 3 في سلة وزد لأنهما تطلبان رمز الوصول)؛ أما في التكامل المباشر فكل الخطوات عليك.
- أنشئ البكسل في مدير إعلانات TikTok اذهب إلى الأدوات > مدير الأحداث (Events Manager) > ربط مصدر بيانات (Connect Data Source) > الويب، ثم أدخل رابط متجرك. سمِّ البكسل باسم نطاق متجرك.
- اختر طريقة الربط عبر شريك مثل Shopify أو Google Tag Manager، أو الإعداد اليدوي بشيفرة مخصصة (وهي الطريقة التي يطلبها دليل زد لنسخ معرّف البكسل).
- أنشئ رمز الوصول من إعدادات البكسل، في قسم Events API، اضغط Generate Access Token. لا تضع الرمز في شيفرة المتصفح أو في مستودع عام؛ احفظه على الخادم كمتغير بيئة.
- أرسل أحداث الخادم مع كل حدث: اسم الحدث، وevent_time بصيغة Unix، وevent_id، ورابط الصفحة، ومفاتيح المطابقة (ttclid، و_ttp، والبريد والهاتف بعد التجزئة، وIP، ووكيل المستخدم).
- اختبر ثم أطلق من تبويب اختبار الأحداث (Test Events) راقب أحداث المتصفح والخادم كلًّا على حدة، ثم تأكد في النظرة العامة أن طريقة الاتصال تظهر «server & browser».
ما الأحداث القياسية التي يجب أن يرسلها متجرك؟
الحد الأدنى لأي متجر إلكتروني هو ViewContent وAddToCart وInitiateCheckout وPurchase، مع معلمات القيمة والعملة. وقائمة الأحداث القياسية الحالية في TikTok تسرد حدث الشراء باسم Purchase.
| الحدث | متى يُطلَق | المعلمات المقترحة |
|---|---|---|
| ViewContent | عند فتح صفحة المنتج | content_ids, content_type, value, currency |
| AddToCart | عند الضغط على «أضف إلى السلة» | content_ids, content_type, quantity, value, currency |
| InitiateCheckout | عند بدء خطوة الدفع | value, currency (مستحسن) |
| AddPaymentInfo | عند إدخال بيانات الدفع | اختياري |
| Purchase | عند تأكيد الطلب | content_ids, content_type, quantity, value, currency |
| Search | عند البحث داخل المتجر | search_string |
قد تجد في الإعدادات القديمة أحداثًا باسم CompletePayment أو PlaceAnOrder، وهذه الأسماء غير موجودة في القائمة القياسية الحالية. فمنذ 1 مايو 2025 غيّرت TikTok اسم CompletePayment إلى Purchase (وSubmitForm إلى Lead)، وتحوّل الأسماء القديمة تلقائيًا في الخلفية وتعرضها في التقارير بالأسماء الجديدة، لذا تستمر الشيفرة الحالية في العمل. أما ClickButton وPlaceAnOrder فمدعومان بالكامل حتى 2027 ثم يتوقف العمل بهما. استخدم Purchase في أي إعداد جديد، وخطط مبكرًا للانتقال إن كنت تعتمد على PlaceAnOrder.
إذا كنت تستخدم إعلانات الكتالوج، فيجب أن تطابق قيمة content_ids معرّف المنتج في الكتالوج حرفيًا، وإلا فقد يُنسب الحدث إلى الإعلان دون أن يرتبط بالمنتج. وحدد مرة واحدة هل تشمل قيمة value الشحن وضريبة القيمة المضافة أم لا، وطبّق القاعدة نفسها في كل القنوات؛ فحساب العائد على الإنفاق الإعلاني يعتمد عليها (راجع ما هو ROAS). أرسل العملة برمز ISO الصحيح: SAR للريال السعودي، وAED للدرهم الإماراتي، وEGP للجنيه المصري، وUSD للدولار.
كيف يعمل event_id في إزالة تكرار الأحداث؟
عندما يرسل البكسل وEvents API عملية الشراء نفسها باسم الحدث نفسه وقيمة event_id نفسها، تحسبهما TikTok تحويلًا واحدًا وتسجّل أول حدث يصلها. إذا غاب event_id أو اختلف بين القناتين، فسيظهر الطلب الواحد مرتين في التقارير.
بحسب مركز مساعدة TikTok: الأحداث المتطابقة في الاسم وevent_id القادمة من البكسل وحده أو من Events API وحده تُزال تكراراتها خلال 48 ساعة من أول حدث. أما عند التداخل بين البكسل وEvents API، فتذكر TikTok أنها تدمج الأحداث المتطابقة التي تصل بعد 5 دقائق من الحدث الأول وخلال 48 ساعة منه. عمليًا: حتى لو تأخر حدث الخادم قليلًا، يبقى الدمج ممكنًا ما دمت ترسله في اليوم نفسه.
مثال: الطلب رقم 10482
عميل في الرياض أتمّ طلبًا بقيمة 450 ريالًا سعوديًا (SAR). يجب أن يتطابق حدث البكسل في صفحة الشكر مع الحدث الذي يرسله خادمك عند إنشاء الطلب هكذا:
- البكسل: event = Purchase، event_id =
order_10482، value = 450، currency = SAR - Events API: event = Purchase، event_id =
order_10482، value = 450، currency = SAR
الاعتماد على رقم الطلب هو الطريق الأكثر أمانًا، لأن المتصفح والخادم يعرفان القيمة نفسها. وإذا كنت تولّد معرّفًا عشوائيًا، فعليك إنشاؤه في المتصفح ونقله إلى الخادم (عبر حقل مخفي أو طبقة البيانات مثلًا). وللأحداث التي تسبق الطلب، مثل الإضافة إلى السلة، يفيد دمج معرّف السلة مع الطابع الزمني.
كيف ترفع جودة مطابقة الأحداث (EMQ)؟
درجة جودة مطابقة الأحداث (Event Match Quality) في مدير الأحداث هي متوسط مرجَّح لتغطية مفاتيح المطابقة التي ترسلها؛ كلما زادت المفاتيح في عدد أكبر من الأحداث ارتفعت الدرجة. وتظهر الدرجة لكل نوع حدث على حدة.
مفاتيح المطابقة التي تذكرها TikTok لـ Events API هي: مُعرِّف النقرة (ttclid)، وملف الارتباط الطرف الأول _ttp، والبريد الإلكتروني والهاتف (المطابقة المتقدمة)، وexternal_id (معرّفك الخاص مثل رقم العميل)، وعنوان IP، ووكيل المستخدم. البكسل يشارك IP ووكيل المستخدم تلقائيًا، أما في Events API فعليك إضافتهما يدويًا.
- أزل المسافات من البريد الإلكتروني وحوّله إلى أحرف صغيرة، ثم جزّئه بـ SHA-256.
- اكتب الهاتف بالصيغة الدولية بلا مسافات أو شرطات أو صفر بادئ: 0551234567 تصبح +966551234567 في السعودية، و050 123 4567 تصبح +971501234567 في الإمارات، و01012345678 تصبح +201012345678 في مصر، ثم جزّئه.
- أرسل رقم العميل مجزّأً في external_id؛ فهو مفيد جدًا في المتاجر التي تعتمد تسجيل الدخول.
- أرسل ttclid وقيمة _ttp كما هي دون تجزئة.
- أضف إلى حدث الخادم IP الزائر الحقيقي ووكيل المستخدم الخاص به، لا عنوان خادمك.
- فكّر في تفعيل المطابقة المتقدمة التلقائية في البكسل؛ فهي تجزّئ البريد والهاتف من حقول النماذج داخل المتصفح.
في القطاعات الحساسة مثل الصحة والتمويل، تعدّ المطابقة اليدوية خيارًا أكثر أمانًا لأنك تتحكم في كل حقل يُرسَل. وراجع مع مستشارك القانوني أن سياسة الخصوصية لديك تغطي هذه المشاركة وفق القانون المطبّق في سوقك، مثل نظام حماية البيانات الشخصية في السعودية، وقانون حماية البيانات الشخصية الاتحادي في الإمارات، وقانون حماية البيانات الشخصية في مصر، وأن البكسل لا يُطلَق قبل موافقة الزائر حيث يلزم ذلك.
كيف تختبر الربط، وما الأخطاء الأكثر شيوعًا؟
استخدم معًا تبويب اختبار الأحداث (Test Events) في مدير الأحداث، وإضافة TikTok Pixel Helper للمتصفح، وتبويب التشخيص (Diagnostics). يوفر اختبار الأحداث بيئة مباشرة تتيح لك فصل أحداث المتصفح عن أحداث الخادم.
- افتح تبويب اختبار الأحداث وأضف رمز الاختبار (test_event_code) إلى طلبات الخادم.
- نفّذ رحلة شراء حقيقية: صفحة منتج، ثم إضافة إلى السلة، ثم الدفع وطلب تجريبي.
- تأكد أن كل حدث يصل من المتصفح ومن الخادم، وأن قيم event_id متطابقة.
- بعد الإطلاق راقب في النظرة العامة طريقة الاتصال («browser only» أو «server only» أو «server & browser»)، ودرجة EMQ، ووقت آخر استلام.
- عند ظهور مشكلة في التشخيص، يعرض رابط «Learn more» أثرها وخطوات إصلاحها وأمثلة من الأحداث المتأثرة.
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
| المشتريات تظهر مضاعفة | event_id مفقود أو مختلف بين القناتين | اجعل رقم الطلب هو event_id في القناتين |
| طريقة الاتصال «browser only» | أحداث الخادم لا تصل أو رمز الوصول غير صالح | أعد إنشاء الرمز وسجّل رموز استجابة الخادم |
| درجة EMQ منخفضة | لا بريد ولا هاتف، وIP ووكيل المستخدم مفقودان | أضف المفاتيح الواردة في قائمة التحقق |
| value = 0 أو عملة خاطئة | القيمة تُرسَل نصًا أو بالهللة/القرش | أرسل رقمًا ورمز ISO مثل SAR أو AED أو EGP |
| الحدث «No recent activity» | لم يُستلم أي حدث خلال آخر 7 أيام | افحص المشغّل وتغييرات القالب أو التطبيق |
حتى مع إعداد صحيح، لن يتطابق عدد المشتريات في TikTok مع عدد الطلبات في متجرك تمامًا؛ فنافذة الإسناد والتحويلات بعد المشاهدة تفسّر الفرق. ولمقارنة القنوات في جدول واحد، تعرض شاشة تحليل التحويلات في Marpany بيانات TikTok وMeta وGoogle جنبًا إلى جنب مع طلبات المتجر.
ماذا تفعل في الأسبوع الأول بعد الربط؟
هدف الأسبوع الأول هو التأكد من تدفق البيانات وربط تحسين الحملات بالحدث الصحيح؛ أجّل تعديلات العروض والميزانيات إلى ما بعد هذا التحقق.
- اليوم 1: تحقّق في اختبار الأحداث من وصول الأحداث الأساسية من القناتين وتطابق event_id.
- اليوم 2–3: قارن عدد Purchase في TikTok بعدد طلبات الأيام نفسها في متجرك؛ هل هناك احتساب مزدوج؟
- اليوم 3–5: أكمل المفاتيح الناقصة في أنواع الأحداث ذات درجة EMQ المنخفضة.
- اليوم 7: تأكد أن حملات تحويلات الويب تستخدم Purchase حدثًا للتحسين.
- باستمرار: أعد فحص اختبار الأحداث بعد أي تحديث للقالب أو صفحة الدفع أو تطبيق المنصة.
وإذا أردت مراجعة هيكل الحملات والاستهداف والمحتوى الإبداعي على المنصة، فـدليل إعلانات تيك توك نقطة انطلاق جيدة، ولتحويل الأرقام إلى قرارات ميزانية يفيدك دليل مؤشرات أداء الإعلانات.
الأسئلة الشائعة
هل يجب حذف بكسل تيك توك عند استخدام Events API؟
لا. توصي TikTok بإضافة Events API إلى جانب البكسل كقناة ثانية. عندما ترسل القناتان الحدث نفسه بقيمة event_id نفسها، تزيل TikTok التكرار وتحسبه تحويلًا واحدًا.
كيف أربط تيك توك بكسل مع متجر زد أو سلة؟
أنشئ البكسل من مدير الأحداث في TikTok وانسخ معرّفه، ثم أنشئ رمز الوصول من إعدادات البكسل. في زد تلصق المعرّف في تطبيق TikTok Pixel والرمز في تطبيق TikTok Conversion API ضمن متجر التطبيقات، وفي سلة تُدخل القيمتين في صفحة تفعيل تطبيق TikTok Conversion API. لا تضف شيفرة بكسل ثانية يدويًا حتى لا تتضاعف الأحداث.
ما فائدة event_id في تيك توك؟
event_id معرّف فريد يُستخدم لربط نسختي الحدث القادمتين من البكسل ومن Events API. الأحداث المتطابقة في الاسم وevent_id تُزال تكراراتها خلال نافذة 48 ساعة ويُسجَّل أول ما يصل منها. رقم الطلب هو أسهل مصدر لـ event_id في حدث الشراء.
هل أستخدم CompletePayment أم Purchase؟
استخدم Purchase في الإعدادات الجديدة. منذ 1 مايو 2025 غيّرت TikTok اسم CompletePayment إلى Purchase وتحوّل الاسم القديم تلقائيًا، لذا تستمر الشيفرة الحالية في العمل. المهم أن ترسل الاسم نفسه من البكسل ومن Events API.
كيف أرفع درجة جودة المطابقة EMQ في تيك توك؟
ترتفع الدرجة كلما أرسلت مفاتيح مطابقة أكثر: البريد والهاتف وexternal_id بعد تجزئتها بـ SHA-256، مع ttclid وملف _ttp وعنوان IP ووكيل المستخدم. تذكّر أن Events API لا يضيف IP ووكيل المستخدم تلقائيًا.
كيف أعرف أن بكسل تيك توك يعمل؟
إضافة TikTok Pixel Helper لمتصفح Chrome تعرض الأحداث التي تُطلَق في الصفحة. وفي مدير الأحداث يتيح لك تبويب اختبار الأحداث متابعة أحداث المتصفح والخادم مباشرة، بينما يعرض تبويب التشخيص الأخطاء وخطوات إصلاحها.
المصادر
- TikTok Ads Manager – إزالة تكرار الأحداث (Event Deduplication) ads.tiktok.com
- TikTok Ads Manager – كيفية اعتماد الأحداث القياسية المحدّثة على TikTok ads.tiktok.com
- TikTok Ads Manager – How to set up matching events with Events API ads.tiktok.com
- TikTok For Business – Data Sharing on TikTok App on Shopify ads.tiktok.com
- زد – الربط مع TikTok Pixel وTikTok Conversion API help.zid.sa
- TikTok Ads Manager – Diagnostic and monitoring tools in TikTok Events Manager ads.tiktok.com
