Onboarding von Verkäufer*innen

Diese Seite enthält eine Anleitung zum Onboarding von Verkäufer*innen in Managed Partner Ads (MPA) mit der Seller Business Creation API.

Nachdem du mit der Seller Eligibility API geprüft hast, ob ein*e Verkäufer*in für MPA geeignet ist, führst du mit der Seller Business Creation API das Onboarding aus.

Beim Aufrufen der Seller Business Creation API mit der vendor_id eines*einer Verkäufer*in werden automatisch die folgenden Handlungen ausgeführt:

Ein untergeordneter Business Manager, eine Facebook-Seite und ein Werbekonto für den*die Verkäufer*in werden erstellt.
Eine Kreditlinie wird gewährt.
Das Katalogsegment des*der Verkäufer*in wird mit vendor_id=<child_business_external_id> als Filter eingerichtet.

Nach dem Onboarding von Verkäufer*innen in MPA gelten diese als Managed Partner.

Bevor du beginnst

Führe vor dem Onboarding von Verkäufer*innen die folgenden Schritte aus:

Erforderliche Berechtigungen

Zum Aufrufen der Seller Business Creation API benötigst du die folgenden Berechtigungen:

Business-Admin
Katalog-Admin
Kredit verwalten
App-Entwickler

Seller Business Creation API-Aufruf

Anfrage

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "POST", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses", 
        "name": "<ASYNC_SESSION_NAME>", 
        "body": "child_business_external_id=<VENDOR_ID>&line_of_credit_id=<LINE_OF_CREDIT_ID>&credit_limit=<CREDIT_LIMIT>&partition_type=<PARTITION_TYPE>&catalog_id=<PARENT_CATALOG_ID>&ad_account_currency=<AD_ACCOUNT_CURRENCY>&seller_targeting_countries=['COUNTRY_CODE1','COUNTRY_CODE2']&timezone_id=<TIMEZONE_ID>&name=<BUSINESS_MANAGER_NAME>&seller_external_website_url=<SELLER_EXTERNAL_WEBSITE_URL>&partner_facebook_page_url=<PARTNER_FACEBOOK_PAGE_&page_profile_image_url=<PROFILE_PIC_URL>&vertical=<VERTICAL>&partner_registration_countries=<PARTNER_REGISTRATION_COUNTRY>"
      } 
  ]' \
  "https://graph.facebook.com/v19.0"

Die Antwort auf den API-Aufruf wird sofort mit einer ASYNC_SESSION_ID zurückgegeben. Bei der weiteren Verarbeitung der Anfrage sollte die ASYNC_SESSION_ID abgefragt werden, bis ein Endstatus [COMPLETED|FAILED] erreicht wird.

Parameter

Name	Beschreibung
`ad_account_currency` String	Erforderlich. Die Währung des für Verkäufer*innen zu erstellenden Werbekontos. Hier sollte das Währungskürzel eingegeben werden. Siehe Akzeptierte Währungen für die monatliche Abrechnung.
`catalog_id` Numerischer String	Erforderlich. Die ID des Marketplace-Katalogs, als übergeordneter Katalog bezeichnet. Beim Onboarding kann dieser Katalog nach `vendor_id=<child_business_external_id>` gefiltert werden, um ein Katalogsegment für einen Verkäuferin zu erstellen.
`child_business_external_id` String	Erforderlich. Jeder Marketplace muss eine eindeutige ID für jeden Verkäuferin übergeben. Der Name des Feldes auf Marketplace-Seite lautet `vendor_id`. Mit diesem Feld wird das Katalogsegment mit dem Filter `vendor_id = <child_business_external_id>` erstellt.
`credit_limit` Numerischer String	Erforderlich. Der maximale Kredit, der Verkäuferinnen aus der line_of_credit_id gewährt werden soll. Du solltest das nur festlegen, wenn der `partition_type`-Wert auf `FIXED` gesetzt ist. Bedingung:* Verfügbarer Kredit in `line_of_credit_id` >= angefordertem `credit_limit`.
`partition_type` Enum-String	Erforderlich. Setze diesen Parameter auf einen der folgenden Werte: `FIXED` `AUTH` Standardwert:`FIXED` Festgelegter oder unbegrenzter Teil eines Kreditrahmens. Der für den Parameter `credit_limit` festgelegte Wert wird ignoriert, wenn der `partition_type`-Wert auf `AUTH` gesetzt ist.
`line_of_credit_id` Numerischer String	Erforderlich. Die ID der Hauptkreditlinie, von der du Verkäuferinnen Kredit gewähren kannst. Bedingungen:* Übergib die Parameter `credit_limit` und `ad_account_currency`. `no_ad_account` kann nicht übergeben werden.
`marketplace_bm_id` String	Erforderlich. Die Business Manager-ID des Marketplace. Mehr dazu erfährst du unter Deine Unternehmens-ID im Meta Business Manager finden.
`name` String	Erforderlich. Der individuelle Business Manager-Name, der für dendie Verkäuferin erstellt wurde.
`skip_partner_page_creation` Boolescher Wert	Optional. Setze diesen Parameter auf `true`, um die Seitenerstellung für Verkäuferinnen zu überspringen. Standardwert:*`false`
`page_name` String	Optional. Der Name für die für Verkäuferinnen erstellte Seite. Lege diesen Parameter nicht* fest, wenn `skip_partner_page_creation` auf `true` gesetzt ist. Bedingung: Der Seitenname muss den Anforderungen an Seitennamen von Facebook entsprechen. Standardwert: Facebook-Seitenname des Partners, der beim Onboarding der Managed Partner Ads API im Collaboration Center konfiguriert wurde.
`page_profile_image_url` String	Optional Die URL, von der das Profilbild für die Verkäuferinnenseite abgerufen werden soll. Lege diesen Parameter nicht* fest, wenn `skip_partner_page_creation` auf `true` gesetzt ist. Bedingungen: Bildabmessungen >= 180 * 180 Pixel Bildgröße < 1 MB Standardwert: Profilbild der Facebook-Seite des Partners, das beim Onboarding der Managed Partner Ads API im Collaboration Center konfiguriert wurde.
`seller_external_website_url` String	Erforderlich. Die URL der Verkaufs-Website.
`seller_targeting_countries` list<string>	Erforderlich. Das Array von Strings mit den Targeting-Ländern der Verkäufer*innen. Als Wert wird das Länderkennzeichen und nicht der Ländername verwendet. Bei der Anzeigenerstellung wird dieser Wert als Standard-Targeting-Land in den Anzeigengruppen verwendet. Mehr dazu erfährst du unter Länderkennzeichen.
`partner_facebook_page_url` String	Optional. Die URL der Facebook-Seite von Verkäufer*innen.
`partner_registration_countries` String	Erforderlich. Das Land, in dem das Verkaufsunternehmen eingetragen ist. Als Wert wird das Länderkennzeichen und nicht der Ländername verwendet. Mehr dazu erfährst du unter Länderkennzeichen.
`timezone_id` Numerischer String	Erforderlich. Zeitzonen-ID des Unternehmens/Werbekontos. Mehr dazu erfährst du unter Zeitzonen-IDs.
`vertical` Enum-String	Erforderlich. Setze diesen Parameter auf einen der folgenden Werte: `ADVERTISING` `AUTOMOTIVE` `CONSUMER_PACKAGED_GOODS` `ECOMMERCE` `EDUCATION` `ENERGY_AND_UTILITIES` `ENTERTAINMENT_AND_MEDIA` `FINANCIAL_SERVICES` `GAMING` `GOVERNMENT_AND_POLITICS` `MARKETING` `ORGANIZATIONS_AND_ASSOCIATIONS` `PROFESSIONAL_SERVICES` `RETAIL` `TECHNOLOGY` `TELECOM` `TRAVEL` `OTHER`

Antwort

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

Verwende die ASYNC_SESSION_ID, um die entsprechende ID von Verkäufer*innen abzurufen, die für Managed Partner Ads freigeschaltet wurden.

Mehr dazu erfährst du unter Asynchrone Session auf Antwort abfragen.

Erfolgsmeldung

Wenn der Status COMPLETED lautet, sehen die resultierenden Daten der Abfrage einer asynchronen Session wie folgt aus:

{
  "result": "{\"id\":\"<NEWLY_CREATED_MANAGED_PARTNER_BM_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

Fehlerantwort

Wenn der Status FAILED lautet, sehen die resultierenden Daten der Abfrage einer asynchronen Session wie folgt aus:

Fehlercodes

Anfragen an die Seller Onboarding API können zu mehreren verschiedenen Fehlerantworten führen. Weitere Informationen findest du unter Fehlerbehandlung.

Fehlercode	Fehler-Subcode	Fehlermeldung
1800000	2310114	Schließe den Onboarding-Prozess für Managed Partner Ads im Collaboration Center ab.
1800001	2310118	Die Anbieter-ID {vendor_id} wird bereits verwendet. Gib eine eindeutige Anbieter-ID an, die an keiner anderen Stelle verwendet wird.
1800002	2310138	Der Unternehmensname {invalid_business_name} ist kein gültiger Name. Verwende stattdessen eventuell {suggested_business_name}. Unternehmensnamen müssen den Anforderungen an Unternehmensnamen von Facebook entsprechen.
1800002	2310139	Der Unternehmensname {invalid_business_name} ist kein gültiger Name. Unternehmensnamen müssen den Anforderungen an Unternehmensnamen von Facebook entsprechen.
1800003	2310133	Gib ein gültiges Länderkennzeichen für das Land ein, in dem das Unternehmen dieses Partners eingetragen ist.
1800004	2310127	Entferne oder aktualisiere die folgenden ungültigen Länderkennzeichen für die Registrierungsländer des Partners: [{invalid_registration_country_codes}]
1800006	2310141	Entferne oder aktualisiere die folgenden ungültigen Länderkennzeichen, die du eingegeben hast: [{invalid_targeting_country_codes}]
1800100	2310117	Die eingegebene Katalog-ID {catalog_id} kann nicht zum Erstellen eines Katalogsegments verwendet werden. Suche im Commerce Manager die richtige Katalog-ID-Nummer mit den Artikeln des Partners. Wiederhole das Partner-Onboarding mit der richtigen Katalog-ID.
1800101	2310116	Die eingegebene Katalog-ID {catalog_id} wird nicht von deinem Unternehmen {business_id} verwaltet. Gib die ID eines Katalogs ein, der von deinem Unternehmen verwaltet wird.
1800102	2310115	Prüfe die eingegebene Katalog-ID {catalog_id}. Wenn die ID korrekt ist und du Zugriff auf diesen Katalog benötigst, bitte eine Person mit uneingeschränkter Kontrolle, dir in den Unternehmenseinstellungen im Business Manager Zugriff zu erteilen. Wiederhole anschließend das Partner-Onboarding.
1800200	2310119	Gib eine Kreditlinien-ID ein, über die du Partnern einen Kredit gewährst.
1800201	2310144	Die eingegebene Kreditlinien-ID {line_of_credit_id} ist keine Abrechnungskonto- oder Kreditlinien-ID. Gib die Kreditlinien-ID ein, die mit der Unternehmens-ID {marketplace_business_id} verknüpft ist. Das sollte die Kreditlinie sein, über die dein Unternehmen Partnern einen Kredit gewährt.
1800202	2310122	Prüfe die eingegebene Kreditlinien-ID {line_of_credit_id}. Wenn die ID korrekt ist und du Zugriff benötigst, bitte eine Person mit uneingeschränkter Kontrolle, dir in den Unternehmenseinstellungen im Business Manager Zugriff zum Finanzmanagement zu erteilen. Wiederhole das Partner-Onboarding, sobald du Zugriff auf das Finanzmanagement hast.
1800203	2310123	Die eingegebene Kreditlinien-ID {line_of_credit_id} wird nicht von deinem Unternehmen {business_id} verwaltet. Gib eine Abrechnungskonto- oder Kreditlinien-ID an, die von deinem Unternehmen verwaltet wird.
1800204	2310120	Gib die Währung für das Werbekonto ein. Sie kann später nicht geändert werden.
1800205	2310145	Die eingegebene Währung {ad_account_currency} wird von der Kreditlinien-ID {line_of_credit_id} nicht unterstützt. Ändere die Währung des Werbekontos des Partners in eine von der Kreditlinie unterstützt Währung.
1800206	2310121	Gib ein Kreditlimit über 0 ein.
1800207	2310143	Das eingegebene Kreditlimit ${credit_limit} übersteigt den verfügbaren Kredit von ${available_credit}. Reduziere das zugewiesene Kreditlimit oder verwende eine andere Kreditlinien-ID mit einem höheren Saldo.
1800305	2310149	Gib eine Bild-URL für das Profilbild des Partners ein. Das Bild muss mindestens 180 x 180 Pixel groß sein und darf 1 MB nicht überschreiten.
1800306	2310150	Bilder müssen mindestens 180 x 180 Pixel groß sein und dürfen 1 MB nicht überschreiten. Prüfe die Bildgröße und die URL {page_profile_image_url} und versuche es erneut oder gib eine neue Bild-URL ein.
1800306	2310151	Prüfe den Link {page_profile_image_url} oder gib einen neuen Link ein.
1800307	2310148	Beim Verarbeiten der Bild-URL {page_profile_image_url} ist eine Zeitüberschreitung aufgetreten. Prüfe die Bild-URL, wiederhole die Anfrage oder gib eine neue Bild-URL ein.
1800311	2310181	Der Seitenname {invalid_page_name} ist kein gültiger Name. Verwende stattdessen eventuell {suggested_page_name}. Seitennamen müssen den Anforderungen an Seitennamen von Facebook entsprechen.
1800311	2310182	Der Seitenname {invalid_page_name} ist kein gültiger Name. Seitennamen müssen den Anforderungen an Seitennamen von Facebook entsprechen.