وثائق TikTok Pixel & CAPI
كل ما تحتاجه لتثبيت وتكوين والتحقق من تتبع TikTok دقيق من المتصفح والخادم على Shopify.
نظرة عامة
يربط TikTok Pixel & CAPI متجر Shopify بـ TikTok لتتبع التحويلات وإسناد الإعلانات. يُطلق بكسل TikTok من جهة المتصفح ويرسل أحداثًا مطابقة من جهة الخادم عبر واجهة برمجة التحويلات، مع مشاركة معرّف حدث كي يزيل TikTok تكرارها — ملتقطًا التحويلات حتى بعد حاجبات الإعلانات وعلى عمليات الدفع عند الاستلام أو الخارجية. التطبيق مجاني ومدمج بالكامل في لوحة تحكم Shopify.
بكسل المتصفح و CAPI من جهة الخادم لكل حدث.
معرّف حدث مشترك يتيح لـ TikTok احتساب كل تحويل مرة واحدة.
Purchase من جهة الخادم لطلبات الدفع عند الاستلام و TikTok Shop.
بلا فوترة ولا تسجيل دخول خارجي — يعيش داخل لوحة تحكم Shopify.
البدء
يمكنك بدء التتبع خلال دقائق. ثبّت التطبيق، فعّل التضمين، أضف بكسلًا، وتحقّق من أحداثك.
-
1
تثبيت التطبيق
أضف TikTok Pixel & CAPI من Shopify App Store وافتحه من لوحة تحكم Shopify — لا حساب منفصل لإنشائه.
-
2
تفعيل تضمين القالب
في محرّر القالب، فعّل تضمين TikTok Pixel & CAPI كي يُحمَّل بكسل المتصفح على متجرك.
-
3
إضافة بكسلك الأول
أدخِل معرّف بكسل TikTok، وللتتبع من جهة الخادم رمز الوصول، ثم اختر الصفحات والأحداث المراد تتبّعها.
-
4
تفعيل البكسل
بدّل البكسل إلى نشط كي يبدأ بإطلاق أحداث المتصفح والخادم.
-
5
التحقق بأدوات TikTok
استخدم TikTok Pixel Helper و Events Manager للتأكد من وصول الأحداث وإزالة تكرارها بشكل صحيح.
إضافة بكسل
يُكوَّن كل بكسل بشكل مستقل، فيمكنك تشغيل عدة بكسلات بإعدادات مختلفة من تطبيق واحد.
معرّف بكسل TikTok من TikTok Events Manager — وهو يشغّل بكسل المتصفح.
تسمية تساعدك على تمييز البكسلات المتعددة في لوحة المعلومات.
رمز وصول TikTok يُولَّد في Events Manager، مطلوب لإرسال أحداث واجهة برمجة التحويلات من جهة الخادم.
رمز اختياري يوجّه الأحداث إلى تدفق اختبار معزول أثناء تحقّقك من الإعداد.
اختر كل الصفحات أو أنواع صفحات محددة، وفعّل كل حدث أو أوقفه.
فعّل البكسل أو أوقفه مؤقتًا في أي وقت دون حذف إعداداته.
يحتاج بكسل المتصفح إلى معرّف البكسل فقط؛ أضف رمز الوصول لفتح التتبع من جهة الخادم عبر CAPI.
الأحداث المتتبَّعة
يتتبع التطبيق أحداث TikTok الستة القياسية عبر رحلة التسوّق. يمكن تفعيل كل حدث لكل بكسل.
يُطلَق عند تحميل زائر لصفحة متتبَّعة.
يُطلَق عند عرض صفحة منتج.
يُطلَق عند إضافة عنصر إلى السلة.
يُطلَق عند بدء العميل عملية الدفع.
يُطلَق عند إدخال معلومات الدفع.
يُطلَق عند إتمام الطلب — من جهة الخادم للدفع عند الاستلام والدفع الخارجي.
CAPI من جهة الخادم وإزالة التكرار
يرسل الإرسال المزدوج كل حدث من المتصفح ومن خادمك، ثم يعتمد على معرّف حدث مشترك للاحتساب الدقيق.
-
1
يُطلَق بكسل المتصفح
يسجّل امتداد web pixel الحدث في المتصفح ويرسل إشارة إلى خلفية التطبيق.
-
2
يرسل الخادم إلى CAPI
ترسل الخلفية الحدث نفسه إلى نقطة نهاية واجهة برمجة تحويلات TikTok، مع بيانات العميل المجزّأة.
-
3
يزيل TikTok التكرار
لأن الإرسالين يتشاركان معرّف حدث، يدمجهما TikTok ويحتسب التحويل مرة واحدة فقط.
يستمر مسار الخادم بالعمل عند حجب بكسل المتصفح، فتُبلَّغ التحويلات دائمًا.
الدفع الخارجي والدفع عند الاستلام
عندما يحدث الدفع خارج متجرك — الدفع عند الاستلام أو طرف ثالث مثل TikTok Shop — لا يستطيع بكسل المتصفح إطلاق Purchase، فيتولّاه التطبيق من جهة الخادم.
فعّل تتبع Purchase من جهة الخادم للدفع عند الاستلام والدفع الخارجي من الإعدادات.
يُطلَق حدث Purchase من خطّاف orders/paid في Shopify عند تعليم الطلب مدفوعًا.
يُرسَل كل طلب مدفوع إلى TikTok، رغم أن المتسوّق لم يصل إلى صفحة الشكر لديك.
هذه أكثر طريقة موثوقة لتتبع التحويلات لمتاجر الدفع عند الاستلام وبائعي TikTok Shop.
الإعدادات
اضبط بدقة كيفية بناء الأحداث وإرسالها عبر بضعة إعدادات بلا برمجة.
اختر ما إذا كانت معرّفات المحتوى تستخدم معرّف المتغيّر (مُوصى به) أو معرّف المنتج، لتطابق كتالوج TikTok لديك.
أطلِق أحداثًا عند نقر الزوّار على عنصر تستهدفه بمحدّد CSS — بلا برمجة.
اضبط المنطقة الزمنية لمتجرك كي تتوافق أعداد لوحة المعلومات والتقارير مع يومك.
فعّل تجزئة SHA-256 للبريد الإلكتروني والهاتف والمعرّف الخارجي لكل معامل لتحسين جودة المطابقة.
التحقق واستكشاف الأخطاء
تأكّد من وصول الأحداث وإزالة تكرارها، واستخدم صفحة التقارير لتشخيص ما لا يعمل.
استخدم امتداد المتصفح للتأكد من تحميل البكسل وإطلاق الأحداث على متجرك.
تحقّق من الأحداث الواردة، واستخدم رمز الحدث الاختباري لفحصها أولًا في تدفق معزول.
يظهر كل حدث بحالة في الطابور أو أُرسِل أو فشل أو تُخطّي، مع سجلات أخطاء لتوضيح حالات الفشل.
تواصل مع فريق الدعم من الرابط في الشريط الجانبي — نردّ عادةً خلال دقائق.
إذا كانت أحداث الخادم فاشلة، أعد فحص رمز الوصول؛ وإذا كانت أحداث المتصفح مفقودة، تأكّد من تفعيل تضمين القالب.
ابدأ بالتقاط كل تحويل من TikTok اليوم
كل ما تحتاجه لتثبيت وتكوين والتحقق من تتبع TikTok دقيق من المتصفح والخادم على Shopify.
أضف إلى Shopify