Onboarding für FBE Marketplace

Mit Facebook Business Extension (FBE) können deine Verkäufer*innen mühelos Anzeigen in allen Apps der Facebook-Familie schalten, indem sie vorhandene Facebook-Elemente wie eine Facebook-Seite oder verbinden oder ganz neue Elemente erstellen. FBE kann eingesetzt werden, um Marketplace-Verkäufer*innen den Start mit Meta-Lösungen zu erleichtern.

Unten sind die wichtigsten Schritte speziell für den Marketplace-Vorgang aufgeführt. Wir empfehlen, diese Schritte in Kombination mit den wichtigsten Entwickler*innendokumenten zu verwenden.

FBE Marketplace-Vorgang

Partner = Marketplace

FBE = Facebook Business Extension (UI, die Facebook gehört)

Bevor du beginnst

Deine App muss einem Business Manager gehören, der ein verifiziertes Unternehmen ist. Erfahre mehr darüber, wie du dein Unternehmen verifizieren kannst.
Du benötigst eine Facebook-App mit den folgenden Berechtigungen, die über App Review genehmigt wurden:

Private Berechtigung
1. manage_business_extension. Hierbei handelt es sich um eine private Berechtigung, die voraussetzt, dass dein*e Meta-Ansprechpartner*in deine App der Positivliste hinzufügt. Bitte wende dich für Unterstützung an deine*n Meta-Ansprechpartner*in.
Öffentliche Berechtigungen (Marketplace muss diese über App Review anfordern).
1. business_management: Erforderlich, um die über FBE erstellte Business Manager-ID zu erhalten und die Business Manager API zur Verwaltung von Unternehmenselementen zu nutzen.
2. ads_management: Erforderlich, um Werbeanzeigen von Verkäufern im Auftrag des Kunden zu verwalten.

Wichtige Schritte für FBE und Collaborative Ads API

Der Verkäufer (Marke) startet FBE-Setup-Popup-Bildschirm über die Marketplace-Webseite.
Der*die Verkäufer*in durchläuft den FBE-Onboarding-Vorgang und schließt Setup der Kernelemente ab (Business Manager, Seite usw.).
FBE gibt die von dem*der Verkäufer*in erfolgreich erstellten Element-IDs zurück (über API oder Webhook). Sobald Marketplace die IDs erhält, kann das Katalogsegment über API oder UI erstellt/geteilt werden (mit dem Collaboration Center-Tool in Business Manager).
Der*die Verkäufer*in startet die FBE-Management-Ansicht, wo er*die den Status des erstellten Katalogsegments einsehen kann, und akzeptiert die Nutzungsbedingungen, wenn der*die Verkäufer*in erstmals eine Katalogsegmentanforderung vom Marketplace erhält.
Marketplace leitet den*die Verkäufer*in an den Vorgang zur Anzeigenerstellung weiter (bestehender Producer-Vorgang, Werbeanzeigenmanager usw.).

Erforderliche Konfigurationen

Extras

Feld Typ Beschreibung

Feld	Typ	Beschreibung
`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

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

Feld	Beschreibung
`external_business_id` Typ: String	Erforderlich. Eindeutige Unternehmens-ID für das Unternehmen deinesdeiner Kundin. Wir verwenden diese als eindeutige ID. Wenn das Unternehmen desder Verkäuferin beispielsweise „Fubar“ heißt, könnte die `external_business_id` „fubar-123“ lauten.
`timezone` Typ: String	Erforderlich. Die Zeitzone, in der sich das Unternehmen befindet. Siehe Mögliche Zeitzonenwerte.
`currency` Typ: 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` Typ: Enum	Erforderlich. Die Branche des Unternehmens für Marketplace ist `ECOMMERCE`
`merchant_settings_id` Typ: String	Optional. Wird beim Upgrade von Facebook Business Extension, v1 verwendet. Wende dich an deinen Facebook-Ansprechpartnerin, wenn du von v1 zu v2 migrierst.
`channel` Typ: Enum	Erforderlich. Bietet demder Partnerin die Möglichkeit, die Absicht für dendie Nutzerin hinsichtlich Funktionen auszudrücken, die weitere Schritte oder Beschränkungen erfordern. Hinweis: Der `channel` für den Marketplace-spezifischen FBE-Vorgang lautet: `MARKETPLACE`. Denke daran, dies im Feld `channel` zu übergeben.
`business_manager_id` Typ: String	Optional. Business Manager-ID für den vorhandenen Business Manager desder Nutzerin, die eine Partnerin als Vorauswahl für dendie Nutzerin im Setup-Vorgang eingeben kann.
`page_id` Typ: String	Optional. Seiten-ID für die vorhandene Facebook-Seite desder Nutzerin, die eine Partnerin als Vorauswahl für dendie Nutzerin 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.

Feld	Beschreibung
`business` FBEBusinessPropertiesConfigData	Erforderlich. Informationen für das Unternehmen desder Endnutzerin
`messenger_chat` FBEMessengerChatConfigData	Optional. Messenger-Chat-Funktionen auf der Facebook-Seite desder Endnutzerin, 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. Funktionen für das beständige Messenger-Menü, z. B. `cta_button-text` und `cta_button_url`

Nach der Installation

Rufe Element-IDs ab, bestätige Webhook-Benachrichtigungen und Pixel-Events.
Sobald die Element-IDs eingegangen sind, erstelle/teile das Katalogsegment über API oder UI (mit dem Collaboration Center-Tool in Business Manager).
Sobald der API-Aufruf für die Katalogsegmenterstellung erfolgreich ist, suche hier nach Details zum Starten des Popup-Fensters für die FBE-Management-Ansicht, damit der*die Verkäufer*in die geteilten Katalogsegmente akzeptiert und das Onboarding abschließt.

Starte die FBE-Verwaltungsansicht, sobald die FBE-Einrichtung abgeschlossen ist und die Asset-IDs erfolgreich über die Webhooks/APIs zurückgegeben wurden.