‏ملحق Meta للأعمال‏

إعداد بيكسل MBE وواجهة API التحويلات

يسمح دفق البيكسل وواجهة API التحويلات في ملحق Meta للأعمال (MBE) للمستخدمين بإنشاء مدير الأعمال والصفحة وبيكسل Meta أو تحديدهم. يوصى باستخدام هذا الدفق للشركاء الذين لديهم إمكانات استضافة مواقع الويب. وباستخدام البيكسل الذي تم إرجاعه بعد إكمال هذا الدفق، بإمكان الشركاء إرسال الأحداث إلى Facebook نيابة عن العملاء عبر المتصفح أو واجهة API التحويلات. لا يتمتع هذا الدفق بإمكانات الكتالوج.

قبل البدء

  1. يجب أن يكون تطبيقك مملوكًا بواسطة مدير أعمال يمثل نشاطًا تجاريًا تم التحقق منه. تعرف على المزيد حول كيفية التحقق من نشاطك التجاري.

  2. يلزم توفير تطبيق Facebook بمستوى الوصول والميزة والأذونات التالية:

التكوينات المطلوبة

الإضافات

الحقلالنوعالوصف

setup

الإعداد

مطلوب

إعداد Facebook الخاص بالبائع، مثل المعرف الفريد الخاص به (external_business_id) أو عملة الكتالوج الخاصة به (currency). راجع تفاصيل كائن الإعداد.

business_config

business_config

مطلوب

كائن التكوين الذي يستخدمه ملحق Facebook للأعمال لتكوين سير عمل ملحق Facebook للأعمال. راجع business_configتفاصيل الكائن.

repeat

boolean (قيمة منطقية)

مطلوب

يمكنك تعيين هذه القيمة إلى false.

الإعداد

يمكنك استخدام هذا الكائن لتحديد إعدادات حضور المستخدم النهائي على فيسبوك

الحقلالوصف

external_business_id
string (سلسلة)

مطلوب
معرف نشاط تجاري فريد لتمثيل نشاط عميلك التجاري. ونستخدم ذلك كمعرف فريد. فعلى سبيل المثال، إذا كانت شركة البائع هي "Fubar"، فقد يكون "fubar-123" هو معرف external_business_id.

timezone
string (سلسلة)

اختياري
المنطقة الزمنية التي يتواجد فيها النشاط التجاري. راجع قيم المنطقة الزمنية المحتملة.

currency
string (سلسلة)

اختياري
رمز العملة لمعيار ISO المكوّن من ثلاثة أحرف للعملة الافتراضية المستخدمة لعناصر كتالوج النشاط التجاري. راجع رموز العملة المدعومة.

business_vertical
enum (تعداد)

مطلوب
المجال المرتبط بالنشاط التجاري
القيمة:ECOMMERCE

merchant_settings_id
string (سلسلة)

اختياري
يتم استخدامه عند الترقية من ملحق Facebook للأعمال، بالإصدار 1. تواصل مع ممثل Facebook إذا كنت تعمل على الترحيل من الإصدار 1 إلى الإصدار 2.

domain
string (سلسلة)

مطلوب لقنوات COMMERCE وCOMMERCE_OFFSITE
النطاق المُستخدم للاعتماد اليدوي في Instagram. على سبيل المثال: https://exampleshop.partnersite.com.

channel
enum (تعداد)

مطلوب
يوفر طريقة للشريك يمكنه من خلالها تكوين دفق واجهة API التحويلات لملحق FBE. بالنسبة لدفق واجهة API التحويلات، يجب أن تكون هذه القيمة CONVERSIONS_API.

  • CONVERSIONS_API — دفق يسمح للمستخدمين النهائيين بإنشاء كائنات مدير الأعمال والحساب الإعلاني وبيكسل Meta أو تحديدهم. يعمل إنشاء هذه الكائنات على تمكين المستخدم النهائي من إرسال الأحداث من موقع الويب إلى فيسبوك عبر واجهة API التحويلات أو بيكسل المتصفح.

business_manager_id
string (سلسلة)

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

ad_account_id
string (سلسلة)

اختياري
معرف الحساب الإعلاني لحساب المستخدم الإعلاني الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

page_id
string (سلسلة)

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

ig_profile_id
string (سلسلة)

اختياري
معرف ملف النشاط التجاري على Instagram لملف النشاط التجاري على Instagram الخاص بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

pixel_id
string (سلسلة)

اختياري
معرف البيكسل لبيكسل المستخدم الموجود الذي يمكن لشريك ما إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

catalog_id
string (سلسلة)

اختياري
معرف الكتالوج لكتالوج المستخدم الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

تكوين النشاط التجاري

استخدم هذا الكائن لتكوين إعدادات النشاط التجاري للمستخدم النهائي. ويتضمن ذلك أزرار الدعوة لاتخاذ إجراء (CTA) والمزيد. يتضمن كل حقل "نوعًا" مرتبطًا بالجداول المعنية أدناه.

الحقلالوصف

نوع business
: FBEBusinessPropertiesConfigData

مطلوب
يمثل معلومات حول النشاط التجاري لدى المستخدم النهائي

messenger_chat
النوع: FBEMessengerChatConfigData

اختياري
ميزات دردشة Messenger على صفحة Facebook للمستخدم النهائي، مثل enabled وdomains.

catalog_feed_scheduled
النوع: FBECatalogFeedConfigData

اختياري
يمكن تحديد ما إذا كان يجب على ملحق Facebook للأعمال أن يستخدم نهج قائمة المنتجات والذي يتم من خلاله الحصول على عناصر الكتالوج من عنوان feed_url.

page_cta
النوع: FBEPageCtaConfigData

اختياري
زر الدعوة لاتخاذ إجراء (CTA) على صفحة المستخدم النهائي، مثل cta_button_text وcta_button_url إلخ.

ig_cta
النوع: FBEIGCtaConfigData

اختياري
الميزات المتوفرة لميزة زر الدعوة لاتخاذ إجراء (CTA) في Instagram، مثل enabled وcta_button_text وcta_button_url وما إلى ذلك.

messenger_menu
النوع: FBEMessengerMenuConfigData

اختياري
ميزات لميزة القائمة الثابتة لـ Messenger، مثل cta_button-text وcta_button_url