Meta Business Extension

Onboarding für MPE Pixel and Conversions API

Mit dem Vorgang „Pixel and Conversions API“ für Meta Business Extension (FBE) können Nutzer ihren Business Manager, ihre Seite und ihr Facebook-Pixel erstellen oder auswählen. Dieser Vorgang wird Partnern mit Funktionen zum Hosten von Websites empfohlen. Mit dem Pixel, das nach Abschluss dieses Vorgangs zurückgegeben wird, können Partner im Namen ihrer Kunden per Browser oder Conversions API Events an Facebook senden. Dieser Vorgang hat keine Katalogfunktionen.

Bevor du beginnst

  1. Deine App muss einem Business Manager gehören, der ein verifiziertes Unternehmen ist. Erfahre mehr darüber, wie du dein Unternehmen verifizieren kannst.

  2. Du benötigst eine Facebook-App mit der folgenden Zugriffsebene, dem folgenden Feature und den folgenden Berechtigungen:

    • Zugriffsebene: Advanced Access
    • Feature: Standardzugriff für das Anzeigenmanagement
    • Öffentliche Berechtigungen: ads_management, pages_read_engagement und ads_read
    • Private Berechtigungen: manage_business_extension. Hierbei handelt es sich um eine private Berechtigung, die voraussetzt, dass dein Facebook-Ansprechpartner deine App der Positivliste hinzufügt.
    • Systemnutzer-Zugriffsschlüssel: Für das Senden von Events an die Conversions API ist ein Zugriffsschlüssel erforderlich. Verwende zum Generieren eines Zugriffsschlüssels im Auftrag des Kunden den Zugriffsschlüssel, der über FBE zurückgegeben wird, und konvertiere ihn in einen Systemnutzer-Zugriffsschlüsse, indem du einen zusätzlichen API-Aufruf tätigst.

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

Mit diesem Objekt kannst du die Einstellungen für die Facebook-Präsenz des Endnutzers definieren.

FeldBeschreibung

external_business_id
string

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

timezone
string

Optional
Die Zeitzone, in der sich das Unternehmen befindet. Siehe Mögliche Zeitzonenwerte.

currency
String

Optional
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, den Conversions API-Vorgang der FBE zu konfigurieren. Für den Conversions API-Vorgang muss dieser Wert CONVERSIONS_API sein.

  • CONVERSIONS_API – Vorgang, der es Endnutzer*innen ermöglicht, Business Manager-, Werbekonto- und Facebook-Pixel-Objekte zu erstellen oder auszuwählen. Die Erstellung dieser Objekte ermöglicht es Endnutzer*innen, von ihrer Webseite mittels Conversions API oder Browser-Pixel Events an Facebook zu senden.

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

Mit diesem Objekt konfigurierst du die Unternehmenseinstellungen für eine*n Endnutzer*in. Dies umfasst unter anderem CTAs. Zu jedem Feld gehört ein „Typ“, der mit den jeweiligen Tabellen unten verknüpft ist.

FeldBeschreibung

business
Typ: FBEBusinessPropertiesConfigData

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

messenger_chat
Typ: FBEMessengerChatConfigData

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

catalog_feed_scheduled
Typ: FBECatalogFeedConfigData

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

page_cta
Typ: FBEPageCtaConfigData

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

ig_cta
Typ: FBEIGCtaConfigData

Optional
Funktionen für die CTA-Funktin (Call to Action) auf Instagram, z. B. enabled, cta_button_text, cta_button_url usw.

messenger_menu
Typ: FBEMessengerMenuConfigData

Optional
Funktionen für das beständige Messenger-Menü, z. B. cta_button-text und cta_button_url