An annual plan saves you roughly two monthsBrowse plans
Cloud markitمنصة التجار

تثبيت TikTok Pixel + Events API على متجرك (دليل تقني)

الـ Pixel + Events API هما العمود الفقري لقياس إعلانات TikTok. الدليل المركّز على التركيب والاختبار والـ debugging.

~18 دقيقة•5 خطوات•بقلم محمد سمير•تحديث: مايو ٢٠٢٦
TikTok Events Manager dashboard مع Pixel نشط + الأحداث الواردة
الخطوة 1 من 5•~4 دقيقة

إنشاء Pixel + احصل على Pixel ID

TikTok Events Manager - Create Pixel flow
TikTok Events Manager

الخطوات

  1. اختار Connect Data Source → Web
  2. اختار TikTok Pixel + اكتب اسم (مثلاً "Store Production Pixel")
  3. اختار طريقة التركيب: Manual Setup (CloudMarkit يعمل الباقي تلقائياً)
  4. هيظهر Pixel ID برقم 20 خانة — انسخه
الخطوة 2 من 5•~3 دقيقة

اختار طريقة التركيب الصحيحة

مقارنة الـ 3 طرق: Manual / Partner / GTM

الـ 3 طرق

  • Manual (recommended): CloudMarkit يحقن الـ Pixel كود تلقائياً + يبعت الأحداث القياسية. أنت بس بتحط الـ Pixel ID. هذه الطريقة المتبعة في معظم المتاجر.
  • Partner Integration: لو متجرك Shopify / WooCommerce — TikTok يعرض integration partner واضح. لـ CloudMarkit، الـ Manual أبسط.
  • Google Tag Manager: لو عندك GTM موجود من قبل وعايز تجمع كل tracking فيه. أكتر تعقيد + احتمال أخطاء.
الخطوة 3 من 5•~4 دقيقة

إضافة Pixel ID + Events API Token في CloudMarkit

CloudMarkit settings page - TikTok Pixel form
على CloudMarkit: لوحة التحكم → Website Settings → Integrations → TikTok Pixel
  • Pixel ID: الرقم 20 خانة من الخطوة 1
  • Access Token (Events API): هتحصل عليه في الخطوة الجاية
  • Test Event Code: اتركه فاضي للـ production (للتجربة فقط)
  • Bot Filtering: فعّل (يمنع events وهمية من botnets)

الحصول على Events API Token

  1. في Events Manager → الـ Pixel بتاعك → Settings → Events API
  2. اضغط Generate Access Token
  3. هيظهر token طويل يبدأ بـ e. — انسخه
  4. الصقه في CloudMarkit + احفظ
الخطوة 4 من 5•~4 دقيقة

اختبار الأحداث في Test Events tab

TikTok Test Events tab تعرض الأحداث الواردة في real-time

قبل أي إعلان، اختبر

  1. Events Manager → الـ Pixel بتاعك → Test Events
  2. افتح متجرك من تبويب جديد
  3. تنقّل بين الصفحات — لازم تشوف PageView يظهر
  4. افتح منتج — ViewContent يظهر
  5. أضف للسلة — AddToCart يظهر
  6. اعمل checkout — InitiateCheckout
  7. أكمل order تجريبي — CompletePayment (= Purchase)

الأحداث القياسية اللي يبعتها CloudMarkit تلقائياً

  • PageView — كل صفحة
  • ViewContent — صفحة منتج
  • Search — بحث في المتجر
  • AddToCart — إضافة للسلة
  • InitiateCheckout — بدء الـ checkout
  • AddPaymentInfo — اختار طريقة دفع
  • CompletePayment — أكمل الدفع (= Purchase)
الخطوة 5 من 5•~3 دقيقة

TikTok Pixel Helper — الـ debugging السريع

TikTok Pixel Helper Chrome extension يعرض events

ادوات Test Events tab مفيدة لكن تتطلب فتح dashboard. TikTok Pixel Helperextension للـ Chrome يخلّيك تشوف الأحداث + الأخطاء وأنت بتتصفّح متجرك.

TikTok Pixel Helper - Chrome Web Store

طريقة الاستخدام

  1. ثبّت الـ extension
  2. افتح متجرك
  3. اضغط أيقونة TikTok في شريط Chrome
  4. هتشوف:
    • الـ Pixel ID المُكتشَف
    • كل event نشّط أثناء جلستك
    • parameters كل event (value, currency, content_id)
    • أخطاء validation لو فيه

أخطاء شائعة الـ Pixel Helper بيكشفها

  • Pixel firing twice: double-tagging — احذف أحد المصدرين
  • Missing required parameter: Purchase event بدون value — لازم value مع currency
  • Invalid value type: value يجب أن يكون رقم (250)، مش string ("250 EGP")
  • Event not in standard list: custom event بدون validation
جاهز تطبّق هذه الخطوة على متجرك؟
CloudMarkit يعمل لك تثبيت TikTok Pixel + Events API في دقيقة بدون كود.
ابدأ مجاناً 14 يوماً
جاهز تطبّق هذه الخطوة على متجرك؟
ابدأ مجاناً 14 يوماً
باقي الدروس التعليمية