إعداد Marketplace في ملحق FBE

يتيح ملحق فيسبوك للأعمال للبائعين تشغيل الإعلانات بسهولة عبر مجموعة تطبيقات فيسبوك من خلال ربط أصول فيسبوك الموجودة مثل صفحة فيسبوك أو مدير الأعمال أو من خلال إنشاء أصول جديدة بالكامل. يمكن استخدام ملحق FBE للمساعدة في إعداد بائعي Marketplace بسلاسة لاستخدام حلول Meta.

فيما يلي خطوات أساسية محددة لدفق Marketplace. نوصي باستخدام هذه الخطوات جنبًا إلى جنب مع مستندات المطوّر الأساسية.

دفق Marketplace في ملحق FBE

الشريك = Marketplace

FBE = ملحق فيسبوك للأعمال (واجهة مستخدم يملكها فيسبوك)

قبل البدء

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

الإذن الخاص
1. manage_business_extension — هذا إذن خاص يُلزم ممثل Meta بإضافة تطبيقك إلى قائمة السماح.
الأذونات العامة (يحتاج Marketplace إلى طلبها من خلال عملية مراجعة التطبيقات).
1. business_management — مطلوب لاستعادة معرف مدير الأعمال الذي تم إنشاؤه عبر ملحق FBE ولاستخدام واجهة API مدير الأعمال لإدارة أصول النشاط التجاري.
2. ads_management — مطلوب لإدارة إعلانات البائع نيابة عن العميل.

الخطوات الأساسية لملحق FBE وواجهة API الإعلانات التعاونية

يعمل البائع (العلامة التجارية) على تشغيل شاشة إعداد ملحق FBE المنبثقة عبر موقع ويب Marketplace
يمر البائع بدفق إعداد ملحق FBE ويكمل إعداد الأصول الأساسية (مدير الأعمال والصفحة، وما إلى ذلك)
يُرجع ملحق FBE ما يفيد بأن البائع قد أعد معرفات الأصل بنجاح (عبر API أو Webhook). بمجرد تلقي Marketplace المعرفات، يمكن إنشاء/مشاركة شريحة الكتالوج عبر API أو واجهة المستخدم (باستخدام أداة مركز المساهمة ضمن مدير الأعمال).
يعمل البائع على تشغيل عرض إدارة ملحق FBE، حيث يمكنه عرض حالة شريحة الكتالوج التي تم إنشاؤها وقبول شروط الخدمة، (إذا كانت هذه هي المرة الأولى التي يستقبل البائع فيها طلب شريحة كتالوج من Marketplace).
يعمل Marketplace على إعادة توجيه البائع إلى دفق إنشاء الإعلانات (دفق المنتج الموجود - مدير الإعلانات، وما إلى ذلك.)

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

الإضافات

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

الحقل	النوع	الوصف
`setup`	الإعداد	مطلوب إعداد Facebook الخاص بالبائع، مثل المعرف الفريد الخاص به (`external_business_id`) أو عملة الكتالوج الخاصة به (`currency`). راجع تفاصيل كائن الإعداد.
`business_config`	business_config	مطلوب كائن التكوين الذي يستخدمه ملحق Facebook للأعمال لتكوين سير عمل ملحق Facebook للأعمال. راجع `business_config`تفاصيل الكائن.
`repeat`	boolean (قيمة منطقية)	مطلوب يمكنك تعيين هذه القيمة إلى `false`.

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 (تعداد)	مطلوب. المجال المرتبط بالنشاط التجاري في Marketplace هو `ECOMMERCE`
نوع `merchant_settings_id` : string (سلسلة)	اختياري يتم استخدامه عند الترقية من الإصدار 1 لملحق فيسبوك للأعمال. تواصل مع ممثل فيسبوك إذا كنت تحاول الترحيل من الإصدار 1 إلى الإصدار 2.
نوع `channel` : enum (تعداد)	مطلوب. يوفر طريقة للشريك للتعبير عن نيته للمستخدم فيما يتعلق بالميزات التي تتطلب خطوات أو قيودًا إضافية: ملاحظة: قناة `channel` المحددة لدفق ملحق FBE لدى Marketplace هي `MARKETPLACE`. يُرجى التأكد من إدخال ذلك في الحقل `channel`.
نوع `business_manager_id` : string (سلسلة)	اختياري. معرف مدير الأعمال لمدير الأعمال الخاص بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
نوع `page_id` : string (سلسلة)	اختياري. معرف الصفحة لصفحة فيسبوك الخاصة بالعميل الموجود الذي يمكن للشريك إدخاله ليحدد المستخدم مسبقًا في دفق الإعداد.

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

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

الحقل	الوصف
`business` FBEBusinessPropertiesConfigData	مطلوب. يمثل معلومات حول النشاط التجاري لدى المستخدم النهائي
`messenger_chat` FBEMessengerChatConfigData	اختياري ميزات دردشة Messenger على صفحة فيسبوك للمستخدم النهائي، مثل `enabled` و`domains`
`catalog_feed_scheduled` FBECatalogFeedConfigData	اختياري يحدد ما إذا كان يجب على ملحق فيسبوك للأعمال أن يستخدم نهج قائمة المنتجات والذي يتم من خلاله الحصول على عناصر الكتالوج من `feed_url`
`page_cta` FBEPageCtaConfigData	اختياري. زر الدعوة لاتخاذ إجراء (CTA) على صفحة المستخدم النهائي، مثل `cta_button_text` و`cta_button_url`، وما إلى ذلك.
`ig_cta` FBEIGCtaConfigData	اختياري. الميزات اللازمة لتوفير ميزة زر الدعوة لاتخاذ إجراء في Instagram، مثل `enabled` و`cta_button_text` و`cta_button_url`، وما إلى ذلك.
`messenger_menu` FBEMessengerMenuConfigData	اختياري. ميزات القائمة الثابتة في Messenger، مثل `cta_button-text` و`cta_button_url`

بعد التثبيت

يمكنك الحصول على معرفات الأصول، والتحقق من إشعارات Webhook وأحداث البيكسل.
بمجرد تلقي معرفات الأصول، يمكنك إنشاء/مشاركة شريحة الكتالوج عبر واجهة API أو واجهة المستخدم (باستخدام أداة مركز المساهمة ضمن مدير الأعمال).
بمجرد نجاح استدعاء API إنشاء شريحة الكتالوج، تحقق من هنا للحصول على تفاصيل حول تشغيل عرض إدارة ملحق FBE المنبثق لجعل البائع يوافق على شرائح الكتالوج المشتركة وإكمال عملية الإعداد.

قم بتشغيل عرض إدارة ملحق FBE بعد إكمال إعداد ملحق FBE وسيتم إرجاع معرفات الأصول بنجاح عبر أحداث Webhooks / واجهات API.