Meta Business Extension – FAQs

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.

Achte darauf, dass das Kontrollkästchen „Katalog aktivieren“ auf dem FBE-Tab Developer Panel > Einrichtung im App-Dashboard aktiviert ist.

Unternehmen/Verkäufer können Unternehmensfunktionen in der Management-Ansicht konfigurieren, aber sie können keine Facebook-Assets im Zusammenhang mit FBE, wie Business Manager, Werbekonto, Seite, Pixel, Katalog usw., aktualisieren. Alternativ können Unternehmen/Verkäufer Einstellungen im FBE-Setup-Vorgang bearbeiten, um eine Verbindung mit anderen Assets herzustellen.

Je nach geschäftlichen Anforderungen kannst du einen oder mehrere der folgenden Vorgänge einrichten, indem du den entsprechenden Wert unter Einrichtung > Kanal: konfigurierst.

• Standardvorgang (kein Parameter für Kanal erforderlich): Verkäufer können Facebook-Pixel, Facebook-Seite, Werbekonto und Katalog für Dynamic Ads einrichten.
• COMMERCE: Vorgang, über den die Verkäufer ein Commerce-Konto in Facebook Shop und Instagram Shopping-Kanal mit Onsite-Checkout erstellen können. Auch die Auswahl von Offsite-Shops innerhalb des Vorgangs ist eine Option.
• COMMERCE_OFFSITE: Vorgang, mit dem Verkäufer ein Commerce-Konto mit Offsite-Facebook Shop und Offsite Instagram Shopping erstellen können.
• FEED: Vorgang, der es Einzelhändlern ermöglicht, ihre Katalog-Updates zu synchronisieren. Wird nur Partnern empfohlen, die über Feed-/Katalogfunktionen verfügen und keine Website hosten.
• MARKETPLACE: Vorgang, der sich speziell an Marketplaces richtet, die in FBE integriert werden. Empfohlen für Partner, die nur die Schritte für Seiten und Business Manager im FBE-Setup-Vorgang benötigen und anschließend auf Grundlage der FBE-Management-Ansicht Collaborative Ads einrichten.
• SIGNALS: Der Vorgang ermöglicht Benutzern die Auslösung von Facebook-Pixeln und von Conversions API-Events. Dieser Vorgang unterstützt Facebook-Katalog nicht als Asset. Wird nur Partnern empfohlen, die eine Website hosten und nicht über Katalogfunktionen verfügen.

Unten sind einige Szenarien aufgeführt, die bei der Auswahl von Seiten beim FBE-Unternehmens-Login auftreten können. In den Tooltips im FBE-Vorgang ist der genaue Grund dafür angegeben, warum du ein Asset nicht auswählen kannst. Der Grund kann je nach Szenario unterschiedlich sein.

Eine Seite steht zur Auswahl zur Verfügung:

• Wenn sich die ausgewählte Seite nicht im Besitz eines BM befindet, wird sie vom ausgewählten BM in Anspruch genommen.
• Wenn sich die ausgewählte Seite im Besitz eines anderen BM befindet und keine primäre Seite des BM ist, wird die Seite an den ausgewählten BM übertragen.

Eine Seite steht nicht zur Auswahl zur Verfügung:

• Wenn sich eine Seite im Besitz eines anderen BM befindet und auch dessen primäre Seite ist
• Wenn sich eine Seite im Besitz eines BM befindet, der aufgrund von Richtlinienverstößen oder aus anderen Gründen deaktiviert wurde

Partner können die Funktion Page Public Metadata Access für ihre App anfordern, damit die App öffentliche Seitenfelder abfragen kann. Mehr zu dieser Funktion erfährst du in diesem Dokument und hier.

Ist das instagram_profiles-Feld nicht enthalten, bedeutet dies, dass die Instagram-bezogene Berechtigung (zum Beispiel instagram_basic) nicht im Zugriffsschlüssel enthalten ist und/oder dass das Unternehmen kein Instagram Business-Profil mit FBE verbunden hat. Weitere Informationen zur FBE-Installations-API findest du in diesem Dokument.

Das bedeutet, dass in der App einige Berechtigungen fehlen. Die wichtigste Berechtigung für Aktionen im Zusammenhang mit Business Manager ist business_management.

Wir unterstützen die meisten Währungen auf dieser Liste – mit folgenden Ausnahmen: JMD, BGN, BYN, UAH, KIP und LKR.

Warnung: FBE kann nicht installiert werden, wenn nicht unterstützte Währungen in den Konfigurationseinstellungen für die Login-URL angegeben werden. Wir empfehlen unseren Partnern zu prüfen, ob deren Verkäufer unterstützte Währungen nutzen, bevor sie ihnen den Start von FBE erlauben.

Sorge dafür, dass du zusätzlich zum Admin-Zugriff auf deine Facebook Business-Seite bzw. dein Instagram Business-Profil auch Admin-Zugriff in dem mit der aktuellen FBE-Verbindung verknüpften Facebook Business Manager hast. Befolge diese Anweisungen zum Hinzufügen eines Administrators zu deinem Facebook Business Manager.

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 Business Extension (FBE) v2 erfasst den Bestand eines Unternehmens mithilfe eines Katalogs. Der Katalog unterstützt verschiedene Features wie Dynamic Ads, Shops und Karten mit Seiten-Services. Er ist ein optionaler Bestandteil der Integration, für diese Features jedoch erforderlich.

Informationen zu den Implementierungsdetails und zu unterstützten Feldern findest du in der Katalog-API-Dokumentation zu FBE.

Deine App kann erst live gehen, wenn deine Katalogberechtigung (catalog_management) mittels App Review genehmigt wird.

Füge dem Parameter „scope“ in deiner Unternehmens-Login-Implementierung die Berechtigung catalog_management hinzu, damit deine App zum Erstellen, Lesen, Aktualisieren und Löschen von Katalogen, die sich im Besitz des Unternehmens befinden, genutzt werden kann.

Sende eine App Review-Anforderung, sobald du mit einer Funktions-Demo per Screencast zeigen kannst, wie …

• die Katalogberechtigung im Onboarding-Vorgang angefordert wird
• der Bestand zum verknüpften Katalog übertragen wird
• die Katalogfunktionen nach der Synchronisierung des Katalogs aktiviert werden

Unser App Review-Team testet und prüft auf der Grundlage der Anweisungen und der von dir bereitgestellten Screencasts die Facebook-Integration deiner App für den Katalog. Lies dir im Fall einer Ablehnung das Feedback durch, um dir den Grund für die Ablehnung klar zu machen. Reiche deinen Antrag anschließend erneut mit zusätzlichen Details für die Prüfer ein.

In unserem Leitfaden zu App Review-Ablehnungen findest du Tipps für erfolgreiche App Review und darüber, wie du deinen Facebook-Partnermanager über die Ablehnungen informierst, wenn du weitere Hilfe benötigst.

Die Asset-Auswahl ist mehrfach verknüpft. Daher kann es verschiedene Gründe haben, wenn eine Bewertung nicht möglich ist. Mögliche Gründe sind unter anderem:

• Deine ausgewählte Seite ist bereits mit einem anderen Katalog verknüpft
• Dein Katalog ist mit einem anderen Commerce-Konto verknüpft
• Dein Katalog wird mit der Test-App genutzt und du kannst denselben Katalog nicht auch für die Produktion nutzen

In FBE 2.0 kann eine Verbindung zwischen einer Facebook-Seite bzw. einem Instagram Business-Profil und mehreren Partnerplattformen hergestellt werden (auf der Basis der App-ID). Ein Profil kann jedoch nur einmal für die Verbindung zu einer bestimmten Partnerplattform genutzt werden.

Nein. Der Messenger-Chat kann auf Partnerplattformen durch Einrichtung des messenger_chat von business_config beim Unternehmens-Login aktiviert werden. Der Seiten-Shop muss von den Unternehmen/Verkäufern nach der Migration in der Management-Ansicht aktiviert werden.

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.

Nein. Diese beiden Plugins werden in der FBE-Management-Ansicht nicht mehr unterstützt. Das einzige 2021 unterstützte Plugin ist der Messenger-Chat.

HTTPS ist für die Domains auf der Positivliste des Messengers erforderlich. Partner müssen die URLs des Felds „domains“ mit Protokoll-ID, d. h. „https://“, validieren

Mehr zur Konfiguration des FBEMessengerChatConfigData-Objekts.

Partner können unter Umständen besser dafür sorgen, dass die Domain „Messenger“ gültig ist, und Unternehmen/Verkäufer von der Einrichtung der Domains entlasten. Partner können messenger_chat.domains in der business_config des FBE-Unternehmens-Logins festlegen und messenger_chat.enabled=false bestimmen.

Später können Unternehmen/Verkäufer das Messenger-Plugin in der Management-Ansicht aktivieren oder Partner geben den Unternehmen/Verkäufern über die Feature Configuration API die Möglichkeit, das über ihre Plattformen zu erledigen.

Bei der Integrationsprüfung prüft Facebook deine FBE-Konfiguration. Nach dem erfolgreichen Abschluss der Integrationsprüfung steht deine App öffentlichen Nutzern (d. h. Unternehmensnutzer und Verkäufer) zur Verfügung.

Du kannst die Integrationsprüfung auf der FBE-Registerkarte Developer Panel > Übersicht deiner App anfordern, nachdem alle Anforderungen implementiert wurden. Zur Beschleunigung des Prozesses solltest du auch mit unseren Prüfern oder deinem FB-Verantwortlichen ein umfassendes Funktionsdemo-Video aller implementierten FBE-Funktionen bereitstellen.

Nur Administratoren und Entwickler deiner App können den FBE-Vorgang initiieren, bis deine App die Integrationsprüfung bestanden hat.

• Weitere Details zu den Beschränkungen des FBE Developer Panel

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

Ja, FBE wird auf mobilen Browsern unterstützt und kann auch mit Webansichten über deine native Android- bzw. iOS-Anwendung gestartet werden. Mehr über den Start von FBE auf Mobilgeräten erfahren.

Für Graph API-Aufrufe sind Zugriffstokens erforderlich. Die verschiedenen Arten von Zugriffstokens werden hier erläutert.

Du kannst Facebook Login aufrufen, um den access_token vor dem Start der Management-Ansicht abzurufen, und dann mit dem access_token die Feature Configuration API aufrufen.

Beispielcode:

  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 Shopping für Offsite- und Onsite-Vorgänge ist nur mit einem Instagram Business-Konto möglich. Ein persönliches Instagram-Konto ist nicht berechtigt. Wenn dein Instagram Business-Konto keine etablierte Präsenz aufweist oder dort keine qualifizierten Waren verkauft werden, ist dein Konto unter Umständen nicht berechtigt. Du kannst jedoch in sechs (6) Monaten erneut eine Überprüfung beantragen. Die Anforderungen für die Berechtigung findest du hier.

Ein Commerce-Konto kann entweder Offsite- oder Onsite-Shops aufweisen. Du kannst auch Onsite- in Offsite-Shops umwandeln oder umgekehrt. Wenn dein Unternehmen sowohl Offsite- als auch Onsite-Shops benötigt, brauchst du zwei Onboarding-Vorgänge mit unterschiedlichen Assets.

Die Asset-Auswahl ist mehrfach verknüpft. Daher kann es verschiedene Gründe haben, wenn eine Bewertung nicht möglich ist. Dazu gehören unter anderem:

• Der Nutzer ist kein Admin des Unternehmens, das sich im Besitz der Seite befindet
• Die Seite ist mit einem anderen Business Manager verknüpft

Über das Direct Support-Tool in Business Manager erhältst du Hilfe direkt von unserem Team:

• Partner für Termine, Reservierungen und Essensbestellungen: siehe Thema Facebook Business Extension für Services
• Marketingpartner für den Handel: siehe Thema Marketing Partner: Technischer Support oder wende dich direkt an deinen Partnermanager bei Facebook.

Wenn du im Dropdown-Menü Direct Support nicht das gewünschte Thema findest, wende dich per E-Mail an deinen Partnermanager bei Facebook und bitte ihn um Zugriff.

Direct Support ist stark in Business Manager integriert. Vergiss nicht, alle Teammitglieder, die das Direct Support-Tool nutzen, hinzuzufügen, damit sie als Nutzer des Business Managers deines Unternehmens Fragen stellen und Fehler melden können. Wie das funktioniert, wird hier erläutert.

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.