Meta Business Extension

Onboarding für MBE Commerce

In diesem Leitfaden werden die wesentlichen Voraussetzungen für den MBE Commerce-Vorgang erläutert und die nötigen Schritte für den Prozess kurz vorgestellt.

Mit der Meta Business Extension (MBE) können Unternehmen mühelos Tools zur Verwaltung ihrer Facebook-Werbeanzeigen sowie zur Einrichtung von Instagram und Facebook Shops einrichten. Der Onboarding-Vorgang für MBE Commerce kann für den Handel außerhalb und innerhalb von Shops verwendet werden.

Ein wesentlicher Unterschied zwischen Offsite- und Onsite-Shops besteht darin, dass der Kaufabschluss bei Offsite-Shops auf die Webseite des*der Verkäufer*in umgeleitet wird, während der Kaufabschluss bei Onsite-Shops innerhalb der Facebook- oder Instagram-App erfolgt.

Der Onboarding-Vorgang für FBE Commerce bietet Unternehmen die Möglichkeit, Folgendes einzurichten oder zu integrieren:

  • Meta-Pixel
  • Katalog
  • Werbekonto
  • Shop auf Facebook-Seite
  • Instagram-Shop
  • Messenger-Chat (optional)
  • Business Manager
  • Commerce Manager

Instagram Shopping für Offsite- und Onsite-Vorgänge ist nur mit einem Instagram Business-Konto möglich. Das Konto muss die Qualifizierungskriterien für Commerce erfüllen.

Beispiel – Onboarding-Vorgang der Partneroberfläche (Unternehmens-Login)


Bevor du beginnst

Onboarding-Vorgänge für Shops stehen derzeit nur ausgewählten Partnern in einem geschlossenen Beta-Programm zur Verfügung. Wenn du daran interessiert bist, künftig Zugriff zu erhalten, wende dich an deine*n Facebook-Ansprechpartner*in.

  1. Registriere dich als Meta-Entwickler*in, um auf unsere Entwicklungstools zuzugreifen und Facebook-Apps zu erstellen.
  2. Erstelle eine Facebook-App, wenn du noch keine erstellt hast.
  3. Deine Facebook-App muss einem Business Manager gehören, der ein verifiziertes Unternehmen ist. Erfahre mehr darüber, wie du dein Unternehmen verifizieren kannst.
  4. Erstelle eine Test-App aus deiner Live-/Produktions-App und führe damit alle neuen Entwicklungs- und Testaufgaben aus.
  5. Private Berechtigungen: manage_business_extension. Hierbei handelt es sich um eine private Berechtigung, die voraussetzt, dass dein*e Facebook-Ansprechpartner*in deine App der Positivliste hinzufügt. Sobald diese Funktion für deine App bereitgestellt wurde, findest du das FBE Developer Panel unter Produkte.

  6. Fordere die folgenden Berechtigungen über App Review für deine Facebook-App an:

    • catalog_management: Ermöglicht einem Nutzer mit Administratorrechten das Erstellen, Lesen, Aktualisieren und Löschen von Produktkatalogen, die dem Unternehmen gehören. Alternativ kannst du die Berechtigung ads_management anfordern, wenn du auch Anzeigen im Auftrag von Verkäufern verwalten möchtest, die deine App nutzen.
    • business_management: Voraussetzung für die Nutzung der Business Manager API zum Verwalten von Unternehmenselementen.
    • Instagram_basic. Diese Berechtigung ist bei Verwendung von Instagram Shopping erforderlich. Mit der Berechtigung instagram_basic kann deine App die Informationen und Medien in einem Instagram-Kontoprofil lesen.
    • pages_read_engagement: Wird benötigt, um später einen Seiten-Zugriffsschlüssel zu generieren.
    • [Onsite] commerce_manage_accounts (lesen/schreiben) oder commerce_account_read_settings (nur lesen): Diese granularen Berechtigungen werden über App Review zur Verwaltung eines Commerce-Kontos benötigt.
    • [Onsite] commerce_account_manage_orders (lesen/schreiben) oder commerce_account_read_orders (nur lesen): Diese granularen Berechtigungen werden zum Auflisten, Anzeigen oder Aktualisieren von Bestellungen über ein Commerce-Konto benötigt.
    • [Onsite] commerce_account_read_reports: Erlaubt deiner App das Lesen von Finanzberichterstattungsdaten, um benutzerdefinierte Steuer-, Kassenabstimmungs- und Rückerstattungsberichte für ein Commerce-Konto zu erstellen.

  7. Für Instagram Shopping ist unter Umständen die Domainbestätigung erforderlich, wenn die Domain des Verkäufers noch nicht bestätigt wurde. Erfahre mehr darüber, wie du deine Domain bestätigst.

  8. Richte die Authentifizierung mit den erforderlichen Konfigurationen ein und starte den FBE-Onboarding-Vorgang über Unternehmens-Login oder den Facebook App Store.

Erforderliche Konfigurationen

Extras

FeldTypBeschreibung

setup

setup

Erforderlich

Die Facebook-Einrichtung des Verkäufers, etwa seine eindeutige ID (external_business_id) oder die Währung seines Katalogs (currency). Siehe Details zum Objekt „setup“.

business_config

business_config

Erforderlich

Konfigurationsobjekt, mit dem die Facebook Business Extension den Facebook Business Extension-Workflow konfiguriert. Siehe Details zum Objekt business_config.

repeat

Boolean

Erforderlich

Lege diesen Wert auf false fest.

Setup

FeldBeschreibung

external_business_id
string

Erforderlich
Eindeutige Unternehmens-ID für das Unternehmen deines Kunden. Wir verwenden dies als eindeutige ID. Wenn das Unternehmen des Verkäufers beispielsweise „Fubar“ heißt, könnte die external_business_id „fubar-123“ lauten.

timezone
String

Erforderlich
Die Zeitzone, in der sich das Unternehmen befindet. Siehe mögliche Zeitzonenwerte.

currency
String

Erforderlich
ISO-Währungscode mit drei Buchstaben für die Standardwährung, die von den Katalogartikeln des Unternehmens verwendet wird. Siehe unterstützte Währungscodes.

business_vertical
Enum

Erforderlich
Branche des Unternehmens
Wert:ECOMMERCE

merchant_settings_id
string

Optional
Wird beim Upgrade von Facebook Business Extension, v1 verwendet. Wende dich an deine*n Facebook-Ansprechpartner*in, wenn du von v1 zu v2 migrierst.

domain
string

Erforderlich für die Kanäle COMMERCE und COMMERCE_OFFSITE
Domain, die für die manuelle Instagram-Genehmigung verwendet wird. Zum Beispiel: https://exampleshop.partnersite.com.

channel
enum

Erforderlich
Bietet dem Partner die Möglichkeit, die Absicht für den Nutzer hinsichtlich Funktionen auszudrücken, die weitere Schritte oder Beschränkungen erfordern: COMMERCE und COMMERCE_OFFSITE.

  • COMMERCE: Vorgang, mit dem Verkäufer ein Commerce-Konto beim Seiten-Shop und Instagram Shopping-Kanal mit Onsite-Kaufabschluss erstellen können. Die Option zur Auswahl des Offsite-Kaufabschlusses ist bei diesem Vorgang ebenfalls verfügbar.
  • COMMERCE_OFFSITE: Vorgang,mit dem Verkäufer ein Commerce.Konto mit Offsite-Facebook Shop und Offsite Instagram Shopping erstellen können.

Hinweis: Partner sollten die Berechtigung instagram_basic für alle Commerce-Vorgänge anfordern (COMMERCE und COMMERCE_OFFSITE). Die Berechtigung instagram_basic ist erforderlich, damit eine App die Instagram-Onboarding-/Verkäuferzugriffsrichtlinie unterstützt. Für diese Berechtigung ist App Review erforderlich.

business_manager_id
String

Optional
Business Manager-ID für den vorhandenen Business Manager des*der Nutzer*in, die ein Partner als Vorauswahl für den*die Nutzer*in im Setup-Vorgang eingeben kann.

ad_account_id
string

Optional
Werbekonto-ID für das vorhandene Werbekonto des Nutzers, die ein Partner als Vorauswahl für den Nutzer im Setup-Vorgang eingeben kann.

page_id
string

Optional
Seiten-ID für die vorhandene Facebook-Seite des*der Nutzer*in, die ein Partner als Vorauswahl für den*die Nutzer*in im Setup-Vorgang eingeben kann.

ig_profile_id
string

Optional
Instagram-Unternehmensprofil-ID für das vorhandene Instagram-Unternehmensprofil des*der Nutzer*in, die ein Partner als Vorauswahl für den*die Nutzer*in im Setup-Vorgang eingeben kann.

pixel_id
string

Optional
Pixel-ID für das vorhandene Pixel des*der Nutzer*in, die ein Partner als Vorauswahl für den*die Nutzer*in im Setup-Vorgang eingeben kann.

catalog_id
string

Optional
Katalog-ID für den vorhandenen Katalog des Nutzers, die ein Partner als Vorauswahl für den Nutzer im Setup-Vorgang eingeben kann.

Business Config

Verwende dieses Objekt zum Konfigurieren der Unternehmenseinstellungen für einen Endnutzer. Dazu gehört Messenger und mehr. Zu jedem Feld gehört ein „Typ“, der mit den jeweiligen Tabellen unten verknüpft ist.

FeldBeschreibung

business
FBEBusinessPropertiesConfigData

Erforderlich
Informationen für das Unternehmen des*der Endnutzer*in

messenger_chat
FBEMessengerChatConfigData

Optional
Messenger-Chat-Funktionen auf der Facebook-Seite des Endnutzers, z. B. enabled und domains.

catalog_feed_scheduled
FBECatalogFeedConfigData

Optional
Bestimmt, ob die Facebook Business Extension eine Feed-Methode verwenden sollte, die Katalogartikel von einer feed_url abruft.

page_cta
FBEPageCtaConfigData

Optional
CTA-Button (Call to Action) auf der Seite des Endnutzers, z. B. cta_button_text, cta_button_url usw.

ig_cta
FBEIGCtaConfigData

Optional
Funktionen für das CTA-Feature (Call to Action) von Instagram, z. B. enabled, cta_button_text, cta_button_url usw.

messenger_menu
FBEMessengerMenuConfigData

Optional.
Features für den CTA-Button im Messenger, wenn ein*e Nutzer*in Nachrichten an das Unternehmen sendet, z. B. cta_button-text und cta_button_url

Nach der Installation