أدلة الميزات

    TikTok Pixel في ڤاريونس للمتاجر الإلكترونية في مصر

    TikTok Pixel في ڤاريونس يربط متجرك الإلكتروني ببكسل TikTok حتى تُرسَل أحداث الواجهة الأمامية (مثل PageView وAddToCart وCompletePayment) إلى TikTok Events Manager دون لصق سكربت يدوي في كل صفحة.

    آخر تحقق: 2026-09-17

    ڤاريونس منصة تجارة إلكترونية للشركات التي تبيع أونلاين في مصر. TikTok Pixel ميزة تسويق مدمجة ضمن صفحة «التتبع والبكسلات» في لوحة التحكم، بجانب Meta Pixel وGA4 وGTM ومزوّدين آخرين.

    ما الذي يحلّه؟ كثير من التجار المصريين يكتشف عملاؤهم المنتجات عبر TikTok ثم يتحوّلون إلى متجر إلكتروني أو صفحة منتج. بدون بكسل مربوط، يصعب قياس الإضافة للسلة وإتمام الطلب وتحسين الحملات داخل TikTok Ads.

    كيف يعمل التدفق فعلياً؟ التاجر يفتح /dashboard/tracking، يضغط «اتصال» على بطاقة TikTok Pixel، يدخل Pixel ID (ثمانية أحرف كبيرة أو أرقام على الأقل وفق تحقق الخادم)، ثم يحفظ. يُخزَّن السجل في MongoDB كنموذج TrackingIntegration بالمزوّد tiktok. واجهة المتجر تقرأ التكاملات المتصلة عبر GET /api/public/tracking وتحقن سكربت TikTok analytics مع تحميل المعرف وتتبع PageView.

    أحداث التجارة تُرسَل عبر emitMarketingEvent ومسارات صفحة الشكر: ViewContent، AddToCart، InitiateCheckout، وعند الشراء CompletePayment (اسم حدث TikTok وليس Purchase الخاص بـ Meta). في صفحة الشكر يُستدعى أيضاً CompletePayment مباشرة عبر window.ttq عند توفر الدالة.

    الربط مناسب لمتاجر الأزياء والتجميل والمتاجر التي تعتمد الاكتشاف عبر الفيديو القصير في مصر، ويمكن تشغيله مع Meta Pixel في نفس المتجر لأن كل مزوّد له سجل TrackingIntegration منفصل.

    خطوات الإعداد في ڤاريونس

    1. افتح التتبع والبكسلات

      من لوحة تحكم التاجر، ادخل إلى /dashboard/tracking. الصفحة تتطلب صلاحية عرض التتبع للموظفين، وللتجار يجب أن تسمح الخطة بصفحة التسويق/التتبع.

    2. اختر بطاقة TikTok Pixel واضغط اتصال

      من شبكة مزودي التتبع، افتح بطاقة TikTok Pixel. وصف الواجهة: تتبع الأحداث وتحسين حملات إعلانات TikTok.

    3. أدخل Pixel ID من TikTok Events Manager

      انسخ Pixel ID من TikTok Events Manager. التحقق في الخادم يتطلب أحرفاً كبيرة وأرقاماً بطول 8 على الأقل (النمط ^[A-Z0-9]{8,}$). الصق المعرف ثم اضغط اتصال.

    4. خيار الإدارة عبر GTM (اختياري)

      حوار الربط يعرض خيار «إدارة عبر GTM فقط» ويُحفظ في settings.viaGTMOnly. منطق حقن المتجر الحالي يتجاوز أساساً حقن GA4 المباشر عند وجود GTM؛ بطاقة TikTok ما زالت تُحقن سكربت TikTok ما لم تُفصل التكامل.

    5. تحقق من الأحداث على المتجر

      بعد اتصال ناجح تصبح الحالة connected. افتح واجهة المتجر العامة (وليس لوحة التحكم) واختبر PageView ثم AddToCart أو إتمام طلب، وراجع الأحداث في TikTok Events Manager. التحميل يتم عبر TenantTrackingProvider وGET /api/public/tracking.

    6. افصل البكسل عند الحاجة

      زر فصل يؤكد ثم يحذف سجل TrackingIntegration لمزوّد tiktok. بعد الحذف يتوقف حقن TikTok عند إعادة جلب تكاملات التتبع العامة.

    الأحداث التي يرسلها المتجر إلى Meta

    • PageView
    • ViewContent
    • AddToCart
    • InitiateCheckout
    • CompletePayment
    • ViewItemList
    • SelectItem
    • RemoveFromCart
    • ViewCart

    أسئلة شائعة

    هل يدعم ڤاريونس TikTok Pixel؟

    نعم. التاجر يربط Pixel ID من /dashboard/tracking، ويُحقن سكربت TikTok على واجهة المتجر للتكاملات ذات الحالة connected.

    ما الفرق بين حدث الشراء في TikTok وMeta داخل ڤاريونس؟

    لمسار الشراء عبر emitMarketingEvent وصفحة الشكر: Meta يستقبل Purchase (وLead عند وجود بريد)، بينما TikTok يستقبل CompletePayment.

    ما صيغة TikTok Pixel ID المقبولة في ڤاريونس؟

    أحرف كبيرة وأرقام بطول 8 على الأقل وفق pages/api/tracking/[provider].js. أي صيغة أخرى تُرفض.

    هل يمكن تشغيل Meta Pixel وTikTok Pixel معاً؟

    نعم. كل مزوّد له سجل منفصل بفهرس فريد (tenantId + provider)، ويمكن ربط الاثنين من نفس صفحة التتبع والبكسلات.

    هل TikTok Pixel يغيّر الطلبات أو المخزون؟

    لا. يخزّن إعداد التتبع ويحقن سكربتات على المتجر فقط.

    هل يوجد إرسال أحداث TikTok من خادم ڤاريونس (Events API)؟

    من مراجعة الكود الحالي: التتبع المعتمد لـ TikTok على المتجر عبر window.ttq في المتصفح. لم يُتحقق وجود Events API من الخادم.

    استكشاف الأخطاء

    إذا لم تظهر الأحداث في TikTok: 1) تأكد أن الحالة connected وأن Pixel ID يطابق نمط الأحرف الكبيرة/الأرقام (8+). 2) اختبر واجهة المتجر العامة وليس لوحة التحكم. 3) عطّل أدوات حجب التتبع أثناء الاختبار. 4) بعد الربط، أعد تحميل المتجر لإعادة جلب /api/public/tracking. 5) لحدث إتمام الدفع راجع CompletePayment وليس اسم Purchase الخاص بـ Meta.

    حدود مهمة

    • تتبّع TikTok هنا من الواجهة الأمامية (ttq)، وليس Events API من الخادم. • خيار «إدارة عبر GTM فقط» يُحفظ لكن منطق التخطي الحالي يستهدف أساساً حقن GA4 المباشر عند وجود GTM. • وضع الموافقة (Consent Mode) في حوار الربط متاح لـ GA4 وليس لبطاقة TikTok. • الواجهة الحالية لا تعرض تبديلاً لـ loadOnStorefront؛ الافتراضي عند الربط هو التحميل على المتجر. • فصل التكامل يحذف السجل نهائياً لمزوّد tiktok.

    روابط ذات صلة

    تواصل معنا على واتساب