الأسئلة المتكررة بشأن ملحق Meta للأعمال

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

No, please see the updated Developer Documentation for the latest permissions.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

يرجى التأكد من تمكين مربع الاختيار 'تمكين الكتالوج' ضمن علامة التبويب لوحة المطوّر > إعداد بملحق FBE في لوحة معلومات التطبيق.

يمكن للأنشطة التجارية/البائعين تكوين ميزات النشاط التجاري في عرض الإدارة، ولكن لن يكونوا قادرين على تحديث أصول Facebook المرتبطة بملحق FBE، مثل مدير الأعمال والحساب الإعلاني والصفحة والبيكسل والكتالوج، وما إلى ذلك. وبدلًا من ذك، يمكن للأنشطة التجارية/البائعين تعديل الإعدادات في دفق إعداد ملحق FBE لربط الأصول المختلفة.

بناءً على احتياجات نشاطك التجاري، يمكنك اختيار إعداد دفق واحد أو أكثر من عمليات الدفق التالية من خلال تكوين القيمة المناسبة ضمن إعداد > قناة:

• الدفق الافتراضي (لا توجد معلمات مطلوبة للقناة) - يمكن للبائعين إعداد بيكسل Facebook وصفحة Facebook والحساب الإعلاني والكتالوج للإعلانات الديناميكية.
• COMMERCE — يمثل دفقًا يسمح للبائعين بإنشاء حساب معاملات تجارية من خلال متجر Facebook وقناة التسوق على Instagram من خلال إتمام الشراء داخل الموقع. ويوفر أيضًا خيارًا لاختيار متاجر خارج الموقع ضمن الدفق.
• COMMERCE_OFFSITE - يمثل دفقًا يسمح للبائعين بإنشاء حساب معاملات تجارية من خلال متجر Facebook خارج الموقع والتسوق على Instagram خارج الموقع.
• FEED - يمثل دفقًا يتيح لبائعي التجزئة مزامنة تحديثات الكتالوج لديهم. ويوصى به فقط للشركاء الذين لديهم إمكانات قائمة المنتجات/الكتالوج وليس لديهم إمكانية استضافة موقع الويب.
• MARKETPLACE - يمثل دفقًا خاصًا بالأسواق التي تندمج مع ملحق FBE. ويوصى به للشركاء الذين يحتاجون فقط إلى خطوات الصفحة ومدير الأعمال في دفق إعداد ملحق FBE، ثم يستفيدون من استخدام عرض إدارة ملحق FBE لإعداد الإعلانات التعاونية.
• SIGNALS - يمثل دفقًا يتيح للمستخدمين تشغيل أحداث بيكسل Facebook وواجهة API التحويلات. ولا يدعم هذا الدفق كتالوج Facebook باعتباره أصلًا. ويوصى به فقط للشركاء الذين لديهم إمكانات استضافة موقع الويب، وليس لديهم إمكانات الكتالوج.

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

ستكون الصفحة متوفرة لتحديدها:

• إذا لم تكن الصفحة المحددة مملوكة بواسطة أي مدير أعمال، فستتم المطالبة بالصفحة بواسطة مدير الأعمال المحدد
• إذا كانت الصفحة المحددة مملوكة من قبل مدير أعمال آخر وليست صفحة أساسية تابعة لمدير الأعمال هذا، فسيتم نقل الصفحة إلى مدير الأعمال المحدد

لن تكون الصفحة متوفرة لتحديدها:

• إذا كانت الصفحة مملوكة بواسطة مدير أعمال وكانت أيضًا صفحة أساسية لمدير أعمال آخر
• إذا كانت الصفحة مملوكة بواسطة مدير أعمال تم تعطيله، فعلى سبيل المثال، بسبب انتهاكات السياسة

يمكن للشركاء طلب الحصول على الميزة Page Public Metadata Access لتطبيقاتهم بحيث يمكن للتطبيق الاستعلام عن الحقول العامة للصفحة. وتعرف على المزيد حول هذه الميزة في هذا المستند وهنا أيضًا.

إذا لم يتم تضمين الحقل instagram_profiles، فيعني ذلك أن الإذن المتعلق بـ Instagram (فعلى سبيل المثال، instagram_basic) غير مُضمن في رمز الوصول و/أو أن النشاط التجاري لم يربط أي ملفات أنشطة تجارية على Instagram بملحق FBE. ولمزيد من المعلومات حول واجهة API تثبيت ملحق FBE، راجع هذا المستند.

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

ندعم معظم العملات الموجودة في هذه القائمة باستثناء الدولار الجاميكي والليف البلغاري والروبل البلاروسي والهريفنا الأوكرانية والكيب اللاوي والروبية السريلانكية.

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

تأكد من أنك تتمتع بإمكانية وصول المسؤول في مدير الأعمال من Facebook المرتبط باتصال ملحق FBE الحالي، بالإضافة إلى إمكانية وصول المسؤول إلى صفحة Facebook للأعمال لديك أو ملف النشاط التجاري على Instagram. واتبع هذه التعليمات المتعلقة بكيفية إضافة مسؤول إلى مدير الأعمال من Facebook لديك.

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

Please reach out to your partner manager or engineering contact.

This is a closed beta. Please reach out to your Meta partner manager for more information.

يستخدم ملحق Facebook للأعمال (FBE) بالإصدار 2 الكتالوج لاستيعاب مخزون النشاط التجاري. ويتم استخدامه لتشغيل ميزات متنوعة، مثل الإعلانات الديناميكية والمتاجر وبطاقة خدمات الصفحة. ويُعد هذا جزءًا اختياريًا من عملية الدمج، ولكنه مطلوب لتشغيل هذه الميزات.

راجع وثائق واجهة API الكتالوج لملحق FBE للحصول على تفاصيل حول التنفيذ والحقول المدعومة.

سيحتاج تطبيقك إلى الحصول على إذن كتالوج مُعتمد (catalog_management) عبر عملية مراجعة التطبيقات قبل الانتقال إلى وضع البث المباشر.

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

أرسل طلبًا لإجراء مراجعة التطبيقات بمجرد توفير عرض توضيحي عملي يمكنك استخدامه لتسجيل الشاشة وتوضيح كيفية قيامه بما يلي:

• يلزم توفير إذن الكتالوج خلال دفق الإعداد
• يتم دفع المخزون إلى الكتالوج المرتبط
• يتم تمكين الميزات المدعومة بواسطة الكتالوج بعد مزامنة الكتالوج

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

يرجى زيارة دليل نتائج رفض عملية مراجعة التطبيقات للحصول على نصائح حول كيفية إجراء عملية مراجعة تطبيقات ناجحة وكيفية إبلاغ مدير الشريك في Facebook لديك بحالة الرفض للحصول على مزيد من المساعدة

عملية تحديد الأصول هي عملية متداخلة ولها عدة أسباب لفشل الأهلية. وقد ترجع بعض الأسباب إلى أن:

• صفحتك المحددة مرتبطة بالفعل بكتالوج مختلف
• الكتالوج لديك مرتبط بحساب معاملات تجارية مختلف
• في حالة استخدام الكتالوج لديك مع التطبيق الاختباري ولا يمكنك استخدام الكتالوج نفسه في مرحلة الإنتاج

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

لا. بالنسبة لدردشة Messenger، يمكن لمنصات الشركاء تمكينها عن طريق تعيين messenger_chat لدى business_config في تسجيل دخول النشاط التجاري. وبالنسبة لمتجر الصفحة، يجب على الأنشطة التجارية/البائعين تمكينه في عرض الإدارة بعد انتهاء الترحيل.

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

لا. يتم الآن إيقاف هذين المكونين الإضافيين من عرض إدارة ملحق FBE. وتُعد دردشة Messenger هي المكون الإضافي الوحيد المدعوم اعتبارًا من 2021.

يكون HTTPS مطلوبًا للنطاقات الموجودة ضمن قائمة السماح في Messenger. يجب على الشركاء التحقق من صحة عناوين URL لحقول النطاقات من خلال معرف البروتوكول، أي https://‎

تعرف على المزيد حول كيفية تكوين الكائن FBEMessengerChatConfigData.

قد يكون الشركاء في وضع أفضل لضمان صلاحية نطاق Messenger وإزالة المتاعب التي تواجه الأنشطة التجارية/البائعين عند إعداد النطاقات. ويمكن للشركاء تعيين messenger_chat.domains في business_config لدى تسجيل دخول النشاط التجاري بملحق FBE وتعيين messenger_chat.enabled=false

يمكن للأنشطة التجارية/البائعين لاحقًا تمكين المكون الإضافي لـ Messenger في عرض الإدارة، أو يمكن للشركاء توفير طريقة للأنشطة التجارية/البائعين لإجراء ذلك على المنصات عبر واجهة API تكوين الميزات.

مراجعة الدمج هي العملية التي يتحقق فيها Facebook من دمج ملحق FBE. وبمجرد نجاح عملية مراجعة دمج التطبيق لديك، سيصبح تطبيقك متوفرًا لعامة المستخدمين (أي مستخدمي الأنشطة التجارية والبائعين).

يمكنك طلب إجراء عملية مراجعة الدمج في علامة التبويب لوحة المطوّر > نظرة عامة لدى ملحق FBE في تطبيقك بمجرد تنفيذ كل المتطلبات. وللمساعدة في تسريع عملية المراجعة، يجب عليك أيضًا مشاركة فيديو توضيحي شامل مع المراجعين لدينا أو ممثلي FB يوضح جميع ميزات ملحق FBE التي تم تنفيذها.

لن يتمكّن سوى مسؤولي ومطوّري تطبيقك من بدء دفق ملحق FBE حتى يكمل تطبيقك عملية المراجعة بنجاح.

• تعرف على مزيد من التفاصيل حول تقييدات لوحة مطوّر ملحق FBE

Please reach out to your Meta partner manager, or submit a new integration review.

نعم، يتم دعم ملحق FBE على متصفحات m-browsers ويمكن أيضًا تشغيله باستخدام طرق عرض الويب من خلال تطبيق Android / iOS الأصلي لديك. وتعرف على المزيد حول تشغيل ملحق FBE في الهاتف المحمول.

يلزم توفير رموز الوصول لإجراء استدعاءات واجهة Graph API. ويتم توضيح أنواع رموز الوصول المختلفة هنا.

يمكنك استدعاء تسجيل دخول فيسبوك للحصول على الرمز access_token قبل بدء استخدام عرض الإدارة، ثم استخدام الرمز access_token هذا لاستدعاء واجهة API تكوين الميزات.

عينة من الرمز البرمجي:

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === 'connected') {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log('User cancelled login or did not fully authorize.');
        }
      }, {});
    }
  });

لاستخدام التسوق على Instagram لعمليات الدفق خارج الموقع أو داخله، يلزم توفر حساب Instagram للأعمال. ويكون حساب Instagram الشخصي غير مؤهل. وإذا كان حساب Instagram للأعمال لديك لا يتمتع بحضور ثابت أو لا يبيع سلع مؤهلة، فقد لا يكون حسابك مؤهلًا ويمكنك طلب إعادة التحقق في غضون ستة (6) أشهر. ويرجى مراجعة متطلبات الأهلية.

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

عملية تحديد الأصول هي عملية متداخلة وتتوفر عدة أسباب لفشل الأهلية. وتتضمن بعض الأسباب ما يلي:

• لا يتمتع المستخدم بدور المسؤول في النشاط التجاري الذي يمتلك الصفحة
• الصفحة مرتبطة بمدير أعمال مختلف

استخدم أداة الدعم المباشر في مدير الأعمال للحصول على المساعدة مباشرة من خلال فريقنا:

• بالنسبة لشركاء المواعيد والحجوزات وطلب الطعام: استخدم الموضوع ملحق Facebook للأعمال المخصص للخدمات
• بالنسبة للشركاء التجاريين: استخدم الموضوع شريك التسويق: الدعم الفني أو اتصل بمدير شريك Facebook مباشرة.

إذا تعذر عليك العثور على الموضوع المطلوب ضمن القائمة المنسدلة الدعم المباشر، فيرجى الاتصال بممثل مدير شريك Facebook لديك عبر البريد الإلكتروني للحصول على إمكانية الوصول.

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

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.