إعداد التجارة في ملحق Meta للأعمال

يحتوي هذا الدليل على المتطلبات الأساسية لدفق التجارة في ملحق MBE إلى جانب نظرة عامة عالية المستوى حول الخطوات المطلوبة لإكمال العملية.

يتيح ملحق Meta للأعمال (MBE) للأنشطة التجارية إعداد الأدوات بسهولة لإدارة إعلانات فيسبوك وإعداد متاجر فيسبوك وInstagram. ويمكن استخدام دفق إعداد التجارة في ملحق MBE لكل من المتاجر التجارية خارج وداخل الموقع.

يكمن الاختلاف الرئيسي بين المتاجر الموجودة خارج الموقع وداخل الموقع في أن عملية إتمام الشراء للمتاجر خارج الموقع تتم إعادة توجيهها إلى موقع ويب البائع وعملية إتمام الشراء للمتاجر داخل الموقع تحدث ضمن تطبيق فيسبوك أو Instagram.

يتيح دفق إعداد التجارة للأنشطة التجارية إعداد ما يلي أو دمجه:

بيكسل Meta
الكتالوج
الحساب الإعلاني
متجر صفحة فيسبوك
متجر Instagram
دردشة Messenger (اختياري)
مدير الأعمال
مدير المعاملات التجارية

لاستخدام التسوق على Instagram لعمليات الدفق خارج الموقع أو داخله، يلزم توفر حساب Instagram للأعمال. ويجب أن يلبي الحساب متطلبات الأهلية.

مثال — دفق الإعداد من جهة الشريك (تسجيل دخول النشاط التجاري)

قبل البدء

عمليات دفق إعداد المتاجر حاليًا تتوفر فقط لشركاء محددين في الإصدار التجريبي المُغلق. وإذا كنت مهتمًا بالحصول على إمكانية الوصول في المستقبل، فيرجى التواصل مع ممثل فيسبوك.

يمكنك التسجيل كمطوّر Meta للوصول إلى أدوات المطوّرين وإنشاء تطبيقات فيسبوك.
إذا لم تقم بذلك حتى الآن، فأنشئ تطبيق فيسبوك.
يجب أن يكون تطبيق فيسبوك مملوكًا بواسطة مدير الأعمال المتمثل في نشاط تجاري تم التحقق منه. تعرف على المزيد حول كيفية التحقق من نشاطك التجاري.
يمكنك إنشاء تطبيق اختباري من تطبيق الإنتاج/وضع البث المباشر لاستخدامه في إجراء كل عمليات التطوير والاختبار الجديدة.
الأذونات الخاصة: manage_business_extension — هذا إذن خاص يتطلب من ممثل فيسبوك إضافة تطبيقك إلى قائمة السماح. وبمجرد منح هذه الإمكانية لتطبيقك، يمكنك العثور على لوحة مطوّر ملحق FBE ضمن المنتجات.
يمكنك طلب الأذونات التالية عبر عملية مراجعة التطبيقات لتطبيق Facebook:
- catalog_management — يتيح للمستخدم الذي يمتلك حقوق المسؤول إنشاء كتالوجات المنتجات التي يملكها النشاط التجاري وقراءتها وتحديثها وحذفها. وبدلاً من ذلك، يمكنك طلب الإذن ads_management إذا كنت تريد أيضًا إدارة الإعلانات نيابة عن البائعين الذين يستخدمون التطبيق.
- business_management — مطلوب لاستخدام واجهة API مدير الأعمال لإدارة أصول النشاط التجاري.
- Instagram_basic - هذا مطلوب عند استخدام التسوق على Instagram. ويتيح الإذن instagram_basic لتطبيقك قراءة المعلومات والوسائط الخاصة بالملف الشخصي لحساب Instagram.
- pages_read_engagement — مطلوب لإنشاء رمز وصول الصفحة لاحقًا.
- [داخل الموقع] commerce_manage_accounts (القراءة/الكتابة) أو commerce_account_read_settings (القراءة فقط) — هذه الأذونات التفصيلية مطلوبة من خلال عملية مراجعة التطبيقات لإدارة حساب المعاملات التجارية.
- [داخل الموقع] commerce_account_manage_orders (القراءة/الكتابة) أو commerce_account_read_orders (القراءة فقط) — هذه الأذونات التفصيلية مطلوبة لسرد الطلبات أو عرضها أو تحديثها عبر حساب معاملات تجارية.
- [داخل الموقع] commerce_account_read_reports — يسمح لتطبيقك بقراءة بيانات التقارير المالية لإنشاء تقارير حول التسوية الضريبية والنقدية والسداد لحساب المعاملات التجارية.
قد يتطلب التسوق على Instagram الخضوع لعملية التحقق من النطاق إذا لم يتم التحقق من نطاق البائع بالفعل. تعرف على كيفية التحقق من النطاق.
يمكنك إعداد المصادقة بالتكوينات المطلوبة وتشغيل دفق إعداد ملحق FBE عبر تسجيل دخول النشاط التجاري أو App Store Facebook.

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

الإضافات

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

الحقل	النوع	الوصف
`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 (تعداد)	مطلوب المجال المرتبط بالنشاط التجاري القيمة:`ECOMMERCE`
`merchant_settings_id` string (سلسلة)	اختياري يتم استخدامه عند الترقية من ملحق Facebook للأعمال، بالإصدار 1. تواصل مع ممثل Facebook إذا كنت تعمل على الترحيل من الإصدار 1 إلى الإصدار 2.
`domain` string (سلسلة)	مطلوب لقنوات COMMERCE وCOMMERCE_OFFSITE النطاق المُستخدم للاعتماد اليدوي في Instagram. على سبيل المثال: `https://exampleshop.partnersite.com`.
`channel` enum (تعداد)	مطلوب يوفر طريقة للشريك للتعبير عن نيته للمستخدم فيما يتعلق بالميزات التي تتطلب خطوات أو قيودًا إضافية: `COMMERCE` و`COMMERCE_OFFSITE`. `COMMERCE` — دفق يسمح للبائعين بإنشاء حساب معاملات تجارية من خلال متجر الصفحة وإنشاء قناة تسوق على Instagram من خلال عملية إتمام الشراء داخل الموقع، كما يتوفر خيار تحديد إتمام الشراء خارج الموقع أيضًا في هذا الدفق. `COMMERCE_OFFSITE` — دفق يسمح للبائعين بإنشاء حساب معاملات تجارية بمتجر Facebook خارج الموقع والتسوق على Instagram خارج الموقع. ملاحظة: على الشركاء طلب الحصول على الإذن `instagram_basic` لكل عمليات دفق التجارة (`COMMERCE` و`COMMERCE_OFFSITE`). الإذن `instagram_basic` مطلوب لتطبيق لدعم سياسة وصول الإعداد/البائع على Instagram. يتطلب هذا الإذن الخضوع لعملية مراجعة التطبيقات.
`business_manager_id` string (سلسلة)	اختياري معرف مدير الأعمال لمدير الأعمال الخاص بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`ad_account_id` string (سلسلة)	اختياري معرف الحساب الإعلاني لحساب المستخدم الإعلاني الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`page_id` string (سلسلة)	اختياري معرف الصفحة لصفحة فيسبوك الخاصة بالعميل الموجود الذي يمكن لشريك ما إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`ig_profile_id` string (سلسلة)	اختياري معرف ملف النشاط التجاري على Instagram لملف النشاط التجاري على Instagram الخاص بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`pixel_id` string (سلسلة)	اختياري معرف البيكسل لبيكسل المستخدم الموجود الذي يمكن لشريك ما إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`catalog_id` string (سلسلة)	اختياري معرف الكتالوج لكتالوج المستخدم الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

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

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

الحقل	الوصف
`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	اختياري الميزات اللازمة لتوفير ميزة زر الدعوة لاتخاذ إجراء في Instagram، مثل `enabled` و`cta_button_text` و`cta_button_url`، وما إلى ذلك.
`messenger_menu` FBEMessengerMenuConfigData	اختياري يمثل ميزات زر الدعوة لاتخاذ إجراء (CTA) في Messenger عندما يعمل المستخدم على مراسلة النشاط التجاري، مثل `cta_button_text` و`cta_button_url`.

بعد التثبيت

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