جميع الإضافات
analytics

Marketing Pixels (Meta + TikTok)

بكسلا Meta وTikTok الإعلانيان مع أحداث شراء من الخادم وضبط للموافقة

ماذا تفعل

تتعلّم المنصات الإعلانية أي النقرات تتحول إلى مبيعات من شيفرات تتبّع صغيرة في موقعك، بينما تحجب المتصفحات ومانعات الإعلانات هذه الإشارات أكثر فأكثر. تثبّت هذه الإضافة بكسل Meta وبكسل TikTok في صفحاتك العامة بمجرد إدخال معرّفَي البكسلين لا غير. وهي تُبلغ عن مشاهدات الصفحة وعن أحداث المتجر ViewContent وAddToCart وInitiateCheckout وPurchase، وتعرفها TikTok باسم CompletePayment. وبعد تنفيذ الطلب المدفوع يرسل خادمك الشراء أيضًا إلى Conversions API لدى Meta وإلى Events API لدى TikTok، فتُحتسب البيعة حتى لو بقي المتصفح صامتًا. ويمكن لكلا البكسلين انتظار موافقة الزائر أولًا.

لمن يناسب

أصحاب المتاجر الذين يشغّلون إعلانات مدفوعة على Meta أو TikTok أو عليهما معًا، ويريدون أن ترى المنصتان أي الحملات تُنتج طلبات. تحتاج إلى بكسل من Meta Events Manager أو TikTok Events Manager، وإلى رمز وصول إن أردت أحداث شراء من جانب الخادم. وهي مناسبة حين تبيع لمشترين أوروبيين أو بريطانيين، لأن معالجة الموافقة مدمجة فيها. وإن كنت لا تعلن على أيٍّ من المنصتين فيمكنك تجاهلها.

كيف تعمل

  1. افتح إعدادات الإضافة واملأ تبويب Meta أو تبويب TikTok أو كليهما. الصق معرّف البكسل، وفعّل البكسل، وأضف رمز الوصول إن أردت أحداث شراء من جانب الخادم. ثم احفظ.

  2. في كل صفحة عامة يضيف VeloCMS الشيفرة الأساسية لكل بكسل مفعّل، لكن فقط إذا اجتاز معرّفه فحص الصيغة. وعند تفعيل الموافقة تنتظر الشيفرة في الصفحة ولا تعمل بعد.

  3. يقبل الزائر الموافقة في الشريط، أو يكون خارج الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية والمملكة المتحدة، فتُحمَّل البكسلات. وعند إيقاف الموافقة تُحمَّل البكسلات فورًا ولا يظهر أي شريط للزائر. ومنذ ذلك الحين يُبلغ المتصفح عن مشاهدات الصفحة ومشاهدات المنتجات والإضافة إلى السلة وبدء الدفع والشراء في صفحة تأكيد الطلب لديك.

  4. عند تنفيذ طلب مدفوع يرسل خادمك حدث Purchase واحدًا إلى Meta وحدث CompletePayment واحدًا إلى TikTok، مع قيمة الطلب والعملة وبنود المنتجات وبريد إلكتروني مجزَّأ. وتقرن Meta وTikTok كلتاهما هذا الحدث بحدث المتصفح عبر معرّف حدث مشترك مبني من معرّف طلبك، فتُحتسب البيعة مرة واحدة.

الإعدادات التي تضبطها

تفعيل بكسل Meta، وتفعيل بكسل TikTok
كلاهما معطّل إلى أن تفعّله بنفسك. بكسل Meta يضيف الشيفرة الأساسية لـ Meta ويسمح بحدث Purchase من جانب الخادم، وبكسل TikTok يضيف الشيفرة الأساسية لـ TikTok ويسمح بحدث CompletePayment من جانب الخادم.
معرف بكسل Meta
رقم من 15 أو 16 خانة من Meta Events Manager. أي صيغة أخرى تُرفض قبل الحفظ.
رمز الوصول لواجهة التحويلات (CAPI)
لازم فقط لأحداث الشراء من جانب الخادم. يُحفظ مشفّرًا ويظهر نقاطًا مخفية بعد الحفظ. وترك الحقل فارغًا لا يرسل أي حدث Meta من جانب الخادم.
معرف بكسل TikTok
من 15 إلى 25 خانة من الأحرف الكبيرة والأرقام، من TikTok Events Manager.
رمز الوصول لواجهة Events API
لازم فقط لأحداث الشراء من جانب الخادم. يُحفظ مشفّرًا ولا يُعرض مجددًا بعد الحفظ.
رمز حدث الاختبار
حقل اختياري واحد لكل منصة، يُنسخ من أداة Test Events فيها. اتركه فارغًا في الإنتاج، لأن الأحداث المرسلة برمز اختبار تُستبعد من التقارير.
طلب الموافقة قبل تحميل البكسلات
مفعّل افتراضيًا، في تبويب «الموافقة». يرى الزوار من الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية والمملكة المتحدة، أو من بلد غير معروف، شريطًا، ولا تُحمَّل البكسلات إلا بعد قبولهم. وإن أوقفته حُمِّلت البكسلات لكل زائر، ولم تعد الإضافة تطلب عرض شريط موافقة.
نص شريط الموافقة
اختياري، في تبويب «الموافقة» من إعدادات الإضافة. نص عادي حتى 300 حرف، وتُزال منه وسوم HTML. اتركه فارغًا لاستخدام الرسالة القياسية بلغة الزائر. ولا يظهر الشريط إلا ما دامت الموافقة مطلوبة وبكسل واحد على الأقل مفعّل بمعرّف صالح.

ما تستطيع الوصول إليه

تقرأ الإضافة طلبات متجرك لتتمكن من الإبلاغ عن الشراء المدفوع، ولا تتصل إلا بـ Graph API لدى Meta وواجهة TikTok للأعمال، وكلاهما من خادمك. وترسل قيمة الطلب والعملة ومعرّفات المنتجات وكمياتها، مع بريد إلكتروني يُجزَّأ أولًا ولا يُرسل أبدًا بصيغته الأصلية. وتُشفَّر رموز الوصول عند الحفظ ولا تُعاد إلى المتصفح. وتضيف قسم إعدادات إلى لوحة التحكم.

الأذونات

  • Read products and orders
  • Make external HTTP requests to: graph.facebook.com, business-api.tiktok.com

خطّافات دورة الحياة

  • afterOrderCreate

الوصول إلى الشبكة الخارجية

ترسل هذه الإضافة طلبات إلى النطاقات التالية:

  • graph.facebook.com
  • business-api.tiktok.com

الإمكانات

  • commerce:read
  • network:fetch

لقطات الشاشة

Marketing Pixels admin settings panel with Meta, TikTok, and Consent tabs for configuring pixel IDs and server-side event tokens
اضبط معرّفات Meta Pixel وTikTok Pixel مع تتبّع الأحداث من جانب الخادم، تبويبًا تلو الآخر.

حدود نذكرها بصراحة

  • أحداث الخادم تغطي الشراء فقط. أما مشاهدات الصفحة ومشاهدات المنتجات والإضافة إلى السلة وبدء الدفع فيُبلَّغ عنها من متصفح الزائر، فتضيع حين يمنع مانع إعلانات أو رفضٌ للموافقة تحميل البكسل.

  • تُطابَق مشتريات الخادم باستخدام بريد إلكتروني مجزَّأ والطلب. ولا يتوافر عنوان IP ولا تفاصيل المتصفح حين يُنفَّذ الطلب في الخلفية، لذا قد تكون جودة المطابقة أدنى منها في شراء يُتتبَّع داخل المتصفح.

  • تعمل إزالة التكرار للمشتريات وحدها، باستخدام معرّف حدث مبني من معرّف طلبك في المتصفح وعلى الخادم. وبعد طلب تجريبي تحقق من Events Manager في كل منصة لتتأكد أن البيعة نفسها تظهر فيها مرة واحدة فقط.

  • تصميم الشريط وأزراره قياسيان، وتشمل قائمة بلدانه الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية والمملكة المتحدة. ويحصل الزوار في غيرها على البكسلات فورًا. تأكد أن هذا يوافق القواعد المنطبقة على جمهورك. والرسالة المخصصة نص عادي يُعرض كما كُتب بكل اللغات، لذا ينبغي لموقع ثنائي اللغة أن يصوغها بما يناسب اللغتين معًا.

  • Meta وTikTok فقط مدعومان. أما بكسلات الإعلانات الأخرى، مثل Pinterest أو Snapchat، فليست جزءًا من هذه الإضافة.

الأسئلة الشائعة

أين أجد معرّف البكسل ورمز الوصول؟

معرّف البكسل في Meta Events Manager ضمن Data Sources، أو في TikTok Events Manager ضمن Assets وEvents. ويُنشأ رمز Conversions API في إعدادات Conversions API لدى Meta، ورمز Events API في إعدادات Events API لدى TikTok.

هل تُحتسب البيعة مرتين إذا أبلغ عنها المتصفح والخادم معًا؟

لا. في المنصتين يحمل تقرير الشراء من المتصفح وتقريره من الخادم معرّف الحدث نفسه المبني من معرّف طلبك، وتدمجهما المنصة. وتحقق من Events Manager في كل منصة بعد طلب تجريبي لتتأكد من ذلك.

هل يظهر رمز الوصول بعد حفظه؟

لا. يُشفَّر قبل تخزينه وتعرض صفحة الإعدادات بعدها نقاطًا مخفية. اترك الحقل كما هو للإبقاء على الرمز المحفوظ، أو الصق رمزًا جديدًا لاستبداله.

هل أستطيع فحص الإعداد قبل وصول الزيارات الحقيقية؟

نعم. ضع رمز حدث الاختبار من Meta أو TikTok في حقله وراقب شاشة Test Events. وأزل الرمز قبل الإطلاق، وإلا بقيت الأحداث خارج تقاريرك.

المواصفات

الفئة
analytics
السعر
مضمَّن
الإصدار
1.0.0
المصدر
من الطرف الأول

تصفّح المزيد من التكاملات

57 تكامل أصلي مجاني متاح.

عرض جميع التكاملات