دليل تنفيذ Facebook Conversions API لعام 2026

بقلم Marcus Chen

خبراء في أداء التسويق تمت المراجعة بواسطة كبار مشتري الوسائط

إجابة سريعة من الذكاء الاصطناعي

اختبر أكثر من 15 نسخة إبداعية أسبوعيًا مقابل مصفوفة خطاف خاضعة للتحكم، وقم بالتحديث فور ظهور علامات الإرهاق في معدل الخطاف، واترك لمنصة DCO إعادة دمج الفائزين. سرعة التنويع تتفوق على اللمسة النهائية للاستوديو في كل موضع من وسائل التواصل الاجتماعي المدفوعة والبحث المدفوع الذي قمنا بقياسه. تدير Unled منصة الاختبار وخط الإنتاج كعملية واحدة.

نُشر في 10 يوليو 2026

قراءة لمدة 12 دقيقة · إعداد

إن واجهة تحويلات Facebook (CAPI) هي الرفيق من جانب الخادم لبكسل المتصفح. بعد أن دمر iOS 14.5 التتبع القائم على المتصفح، أصبحت CAPI هي الطريقة الوحيدة لاستعادة التحويلات التي كانت Meta تفقدها. في عام 2026، المعلنون الذين يعملون بإعدادات Pixel فقط يتركون 30-60% من التحويلات المنسوبة على الطاولة. يغطي هذا الدليل تثبيت CAPI نظيفًا من البداية إلى النهاية.

ما الذي تفعله CAPI بالفعل

ترسل CAPI أحداث التحويل مباشرة من خادمك إلى Meta، متجاوزة المتصفح بالكامل. هذا يعني أن الأحداث تصل حتى عندما يتم حظر بكسل المتصفح، أو عندما يحد جهاز iOS الخاص بالمستخدم من التتبع، أو عندما تؤدي ظروف الشبكة إلى تعطل البكسل.

• استعادة تحويلات iOS. لا يزال المستخدمون المقيدون بـ ATT يقومون بتشغيل أحداث الخادم.
• تجاوز مانعي الإعلانات. لا يتم حظر الأحداث من خادم إلى خادم.
• جودة بيانات أعلى. يمكن أن تتضمن أحداث الخادم معرفات الطرف الأول (البريد الإلكتروني المشفر، الهاتف، معرف العميل) لمطابقة أقوى.
• إلغاء تكرار أفضل. عند إقرانه مع Pixel باستخدام event_id، تقوم Meta بإلغاء التكرار وحساب كل تحويل مرة واحدة.

ثلاثة مسارات للتثبيت

1. تكاملات المنصات الأصلية (الأسهل)

جميع منصات Shopify وWooCommerce وBigCommerce وMagento وWix وSquarespace لديها موصلات Meta CAPI أصلية. قم بالتمكين في لوحة إدارة المنصة، والصق رمز الوصول، وانتهى الأمر. الأفضل للفرق غير التقنية.

2. مدير العلامات من جانب الخادم (موصى به)

استخدم Stape أو Google Tag Manager Server-Side لإطلاق أحداث CAPI من حاوية sGTM. تحصل على تحكم كامل في الأحداث، وإلغاء التكرار، والمطابقة المتقدمة دون كتابة كود خادم. المعيار الصناعي للمشغلين الجادين.

3. تكامل API المباشر (أقصى تحكم)

أرسل طلبات POST مباشرة إلى https://graph.facebook.com/v18.0/{pixel_id}/events من الواجهة الخلفية الخاصة بك. الأفضل لـ SaaS والتطبيقات المخصصة وأي شيء غير مبني على منصة تجارية رئيسية.

خطوة بخطوة: تنفيذ API المباشر

1. إنشاء رمز وصول CAPI. Events Manager → البكسل الخاص بك → الإعدادات → Conversions API → إنشاء رمز وصول.
2. اختيار الأحداث التي سيتم إرسالها من جانب الخادم. أرسل دائمًا Purchase وLead وCompleteRegistration. اختياري: ViewContent وAddToCart وInitiateCheckout لمطابقة أغنى.
3. بناء حمولة الحدث. المطلوب: event_name وevent_time وaction_source ("website") وevent_id (لإلغاء التكرار) وuser_data (البريد الإلكتروني/الهاتف/external_id المشفر).
4. تجزئة جميع حقول user_data باستخدام SHA-256. البريد الإلكتروني والهاتف والاسم والمدينة والولاية والرمز البريدي، كلها مجزأة وأحرف صغيرة ومقلمة.
5. إرسال POST إلى نقطة نهاية Graph API. قم بتضمين رمز الوصول كمعامل استعلام أو رأس.
6. إعداد منطق إعادة المحاولة. يجب إعادة محاولة طلبات POST الفاشلة (أخطاء 5xx) مع تراجع أسي يصل إلى 3 مرات.
7. تسجيل كل حدث للتدقيق. قم بتخزين حمولة الحدث واستجابة Meta حتى تتمكن من تصحيح الإسناد لاحقًا.

إلغاء تكرار الأحداث: التفاصيل الحاسمة

• قم بإنشاء event_id فريد لكل تحويل (على سبيل المثال، معرف الطلب الخاص بك).
• أرسل نفس event_id في كل من استدعاء بكسل المتصفح وحدث CAPI.
• تأكد من تطابق event_name تمامًا، "Purchase" وليس "purchase".
• تأكد من أن event_time ضمن دقيقة واحدة بين الحدثين لإلغاء تكرار نظيف.
• استخدم تقرير إلغاء التكرار في Events Manager للتحقق من صحة النسب (يجب أن تكون الأحداث المتطابقة بين المتصفح والخادم هي المجموعة المهيمنة).

المطابقة المتقدمة: لماذا تهم المعرفات المجزأة

تتيح لك CAPI تمرير معرفات المستخدم (البريد الإلكتروني المشفر، الهاتف، الاسم، المدينة، إلخ) في كل حدث. تستخدمها Meta لمطابقة التحويل مرة أخرى مع المستخدم الذي نقر على الإعلان، حتى لو كانت ملفات تعريف الارتباط الخاصة بالمتصفح قد اختفت.

• البريد الإلكتروني (em): المعرف الأكثر تأثيرًا على الإطلاق. قم بتمريره في كل حدث يمكنك.
• الهاتف (ph): الرقم، بدون تنسيق، مع رمز الدولة (مثل 14155551234).
• الاسم الأول (fn) واسم العائلة (ln): أحرف صغيرة.
• المدينة (ct) والولاية (st) والرمز البريدي (zp) والدولة (country): كلها أحرف صغيرة، بدون مسافات.
• المعرف الخارجي (external_id): معرف العميل الداخلي الخاص بك، مجزأ. ممتاز لمطابقة المشترين المتكررين.
• معرف النقرة (fbc) ومعرف المتصفح (fbp): التقط من ملفات تعريف الارتباط الخاصة بالمتصفح وقم بتمريرها في كل حدث خادم لمطابقة أقوى.

التحقق من أن CAPI تعمل

1. Events Manager → علامة التبويب Diagnostics. يجب ألا تظهر أي تحذيرات حرجة.
2. Events Manager → جودة الحدث / جودة مطابقة الحدث. استهدف 7+ على مقياس من 10 نقاط.
3. Events Manager → مخطط شريطي للأحداث المستلمة. تأكد من أن أشرطة Browser وServer ممتلئة.
4. اختبار الأحداث. قم بإنشاء test_event_code، وقم بتشغيل تحويل حقيقي، وشاهده يصل في الوقت الفعلي.
5. بعد 7 أيام: قارن التحويلات المنسوبة في Ads Manager قبل وبعد CAPI. تؤكد الزيادة بنسبة 20%+ في التحويلات المنسوبة أن CAPI تستعيد البيانات.

لم تعد CAPI اختيارية. المعلنون الذين يديرون إعدادات Pixel فقط في عام 2026 يتنافسون ويد واحدة مقيدة خلف ظهورهم. اختر مسار التثبيت الذي يتناسب مع مجموعتك، وقم بإلغاء التكرار بشكل صحيح، وتحقق من جودة مطابقة الحدث. يومان من العمل يؤتي ثماره بشكل دائم.