5 دقائق قراءةالعربية

ربط Conversions API بشوبيفاي خطوة بخطوة (2026)

فعّل Conversions API من ميتا في متجر شوبيفاي بدون برمجة، وتأكد أنها تعمل، وأصلح أشهر 4 مشاكل في التتبّع.

ربط Conversions API بشوبيفاي

Read this in English →

الإجابة المختصرة

ثبّت تطبيق Facebook & Instagram في شوبيفاي، واربط حساب الأعمال والحساب الإعلاني والبيكسل، ثم افتح Share data settings وفعّل مشاركة البيانات واختر Maximum. بعدها تأكد في Events Manager أن حدث Purchase يصل من Browser وServer معاً، واحذف أي كود بيكسل قديم من الثيم حتى لا تتكرر المشتريات.

أغلب متاجر شوبيفاي التي أراجعها فيها بيكسل ميتا، لكنها تخسر جزءاً كبيراً من أحداث الشراء بسبب حاجبات الإعلانات، وإعدادات الخصوصية في iOS، والتتبّع المكرر. الحل هو Conversions API (واجهة التحويلات أو CAPI)، وهي ترسل الأحداث من خوادم شوبيفاي إلى ميتا مباشرة بدل الاعتماد على متصفح الزائر فقط. في شوبيفاي تفعّلها بدون أي برمجة. هذا الدليل يشرح الخطوات، وكيف تتأكد أنها تعمل، والمشاكل التي تفسدها.

في هذا المقال
  1. ماذا تفعل Conversions API بالضبط؟
  2. قبل أن تبدأ
  3. خطوات تفعيل CAPI في شوبيفاي
  4. كيف تتأكد أنها تعمل؟
  5. المشاكل الأربع التي أراها في كل متجر تقريباً
  6. وماذا عن متاجر Hydrogen (Headless)؟
  7. قائمة تحقق سريعة
  8. الأسئلة الشائعة

ماذا تفعل Conversions API بالضبط؟

بيكسل ميتا يعمل داخل متصفح العميل. إذا حجب المتصفح البيكسل، يضيع الحدث، وتتعلم حملاتك من بيانات ناقصة.

Conversions API ترسل نفس الأحداث (ViewContent وAddToCart وInitiateCheckout وPurchase) من خوادم شوبيفاي إلى خوادم ميتا، وحاجبات الإعلانات لا تقدر توقفها. بعدها تطابق ميتا الحدث القادم من المتصفح مع الحدث القادم من الخادم وتحتفظ بواحد فقط، وهذا اسمه إزالة التكرار (Deduplication).

النتيجة: مشتريات أكثر تُنسب لإعلاناتك، وجودة مطابقة أعلى، وحملات تتحسّن على بيانات حقيقية.

قبل أن تبدأ

  • صلاحية مدير على متجر شوبيفاي.
  • حساب أعمال في ميتا (Business Portfolio) يملك صفحتك وحسابك الإعلاني والبيكسل (Dataset).
  • صلاحية مدير على البيكسل نفسه.
  • عدم وجود كود بيكسل آخر في الثيم. هذا السبب رقم 1 للمشاكل، وأشرحه بالأسفل.

فحص سريع قبل البدء: مرّر رابط متجرك على فاحص بيكسل ميتا المجاني لتكتشف أي بيكسل مكرر.

خطوات تفعيل CAPI في شوبيفاي

1. ثبّت تطبيق Facebook & Instagram

من لوحة تحكم شوبيفاي افتح متجر التطبيقات وثبّت تطبيق Facebook & Instagram من ميتا. سيظهر تحت قنوات البيع (Sales channels).

2. اربط حساباتك في ميتا

افتح التطبيق واربط حساب فيسبوك وحساب الأعمال والصفحة والحساب الإعلاني والبيكسل. استخدم حساب الأعمال الذي يملك البيكسل، وليس حساباً شخصياً أُعطي صلاحية فقط.

3. فعّل مشاركة البيانات

اذهب إلى Sales channels ← Facebook & Instagram ← Settings ← Share data settings، وفعّل خيار Enable data-sharing في قسم مشاركة بيانات العملاء.

4. اختر مستوى Maximum

المستوى ماذا يرسل
Standard البيكسل فقط (من المتصفح)
Enhanced البيكسل + Conversions API
Maximum البيكسل + Conversions API + أحدث تقنيات ميتا الإعلانية

اختر Maximum. مستوى Enhanced يستخدم CAPI أيضاً، لكن Maximum يرسل أكبر قدر من البيانات، وهو ما توصي به ميتا لجودة المطابقة.

5. اختر البيكسل وأكّد

اختر البيكسل الذي تريده واضغط Confirm. انتهى الإعداد.

كيف تتأكد أنها تعمل؟

لا تفترض أنها تعمل. أجد باستمرار متاجر فيها الخيار مفعّل لكن لا تصل أي أحداث من الخادم.

  • Events Manager ← البيكسل ← Overview: افتح حدثاً مثل Purchase. تحت طريقة الاتصال يجب أن ترى Browser وServer معاً.
  • تبويب Test Events: افتح متجرك في نافذة عادية، اعرض منتجاً وأضفه للسلة. يجب أن تظهر الأحداث خلال دقيقة أو دقيقتين.
  • إزالة التكرار: في تفاصيل الحدث تعرض ميتا هل يتم دمج أحداث المتصفح والخادم. إذا كانت المشتريات ضعف الطلبات الحقيقية تقريباً، فالدمج لا يعمل (راجع المشكلة 1).
  • جودة مطابقة الأحداث (EMQ): كل حدث يأخذ درجة من 10. أحداث الشراء على Maximum تأخذ درجة جيدة عادةً لأن شوبيفاي يرسل البريد والجوال مشفّرين. الدرجة المنخفضة تعني أن بيانات العميل لا تصل.
  • أعطها بضع ساعات: أحداث الخادم قد تتأخر قليلاً بعد التفعيل أول مرة.

المشاكل الأربع التي أراها في كل متجر تقريباً

المشكلة 1: بيكسل مكرر

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

الحل: ابحث في كود الثيم عن fbq( وconnect.facebook.net، وراجع وسوم ميتا في GTM، وراجع Settings ← Customer events بحثاً عن بيكسلات مخصصة. أبقِ مصدراً واحداً فقط: التطبيق. التفاصيل الكاملة في دليل إصلاح المشتريات المكررة (بالإنجليزية).

المشكلة 2: البيكسل الخطأ مربوط

المتاجر التي غيّرت وكالة التسويق غالباً عندها بيكسلان أو ثلاثة. التطبيق مربوط بواحد، والإعلانات تعمل على آخر.

الحل: في Ads Manager تأكد أي Dataset تستخدمه حملاتك، وأنه نفس البيكسل المختار في التطبيق.

المشكلة 3: سكربتات صفحة الدفع القديمة

نقل شوبيفاي صفحة الدفع إلى نظام Checkout Extensibility. أكواد البيكسل التي كانت في Additional scripts بصفحة حالة الطلب لم تعد تعمل في صفحات الدفع المحدّثة.

الحل: احذف السكربتات القديمة واعتمد على حدث الشراء من التطبيق، أو بيكسل مخصص في Customer events للحالات الخاصة.

المشكلة 4: إعدادات الموافقة على الكوكيز

إذا كنت تبيع في أوروبا أو بريطانيا أو مناطق فيها قوانين خصوصية، قد يوقف شريط الموافقة البيكسل حتى يوافق الزائر. هذا متوقع وقانوني، فلا تحاول «إصلاحه» بإجبار البيكسل على العمل. CAPI تساعد هنا ضمن حدود إعدادات الخصوصية.

وماذا عن متاجر Hydrogen (Headless)؟

تطبيق Facebook & Instagram يغطي المتجر العادي فقط. في متجر Headless مبني بـ Hydrogen أو واجهة مخصصة، أحداث المتصفح تأتي من كودك أنت، فتحتاج ترسل أحداث الخادم بنفسك (من Oxygen أو خادم Node أو إعداد Server-side tagging)، مع نفس event_id من المتصفح والخادم لإزالة التكرار. هذا عمل مخصص، وهو من الأشياء التي أنفذها كثيراً.

قائمة تحقق سريعة

  • تطبيق Facebook & Instagram مثبّت ومربوط بحساب الأعمال الذي يملك البيكسل.
  • مشاركة البيانات مفعّلة على مستوى Maximum.
  • مصدر واحد فقط للبيكسل: لا كود في الثيم، ولا تكرار في GTM، ولا بيكسل مخصص منسي.
  • Events Manager يعرض Browser وServer لحدث Purchase.
  • إزالة التكرار تعمل، والمشتريات ليست مضاعفة.
  • الإعلانات تستخدم نفس البيكسل المربوط بالتطبيق.

إذا كنت تبيع في الخليج، لا تنسَ بيكسل سناب شات وتيك توك أيضاً. هما مهمان هنا بقدر ميتا. ولو لم تختر منصتك بعد، اقرأ مقارنتي بين شوبيفاي وسلة وزد.

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

هل أحتاج تطبيقاً مدفوعاً لربط Conversions API بشوبيفاي؟

لا. تطبيق Facebook & Instagram الرسمي من ميتا يفعلها مجاناً في المتاجر العادية. التطبيقات المدفوعة تفيد في حالات خاصة مثل عدة بيكسلات أو أحداث مخصصة.

هل Conversions API هي نفسها بيكسل ميتا؟

لا. البيكسل يتتبّع من المتصفح، وCAPI ترسل الأحداث من الخادم. استخدم الاثنين معاً، وميتا تزيل التكرار بينهما.

متى تظهر أحداث الخادم بعد التفعيل؟

عادةً خلال دقائق، وأحياناً بعد بضع ساعات من التفعيل الأول. إذا لم تظهر بعد يوم كامل، راجع المشكلتين 1 و2.

لماذا يظهر في مدير الإعلانات مشتريات أكثر من طلبات شوبيفاي؟

غالباً بسبب بيكسل مكرر: كود في الثيم أو في GTM يعمل مع التطبيق في نفس الوقت. أبقِ التطبيق فقط، وتأكد أن إزالة التكرار تعمل في Events Manager.

بقلم

مطوّر ويب رئيسي في عمّان، الأردن. أبني متاجر شوبيفاي وHydrogen وووكومرس، وأضبط تتبّع ميتا وجوجل لعلامات تجارية في أمريكا والخليج. كل ما أكتبه هنا من مشاريع حقيقية لعملاء.