Verkäufer löschen

Diese Seite enthält Anleitungen zum Löschen von Verkäufern von Managed Partner Ads.

Hinweis: Unternehmen, die ihre Produkte über Marketplaces oder Einzelhändler verkaufen, werden als Verkäufer bezeichnet. Nach dem Onboarding von Verkäufern für Managed Partner Ads gelten diese als Managed Partner. Der Einfachheit halber wird auf dieser Seite der Begriff „Verkäufer“ auch für Managed Partner (also freigeschaltete Verkäufer) verwendet.

Verkäufer mit aktiven Werbekampagnen können NICHT gelöscht werden.

Die Seller Deletion API deaktiviert das Werbekonto und löscht alle Assets, die beim Onboarding erstellt wurden, darunter:

Katalogsegment
Seite
Systemnutzer
Unternehmen

Nach dem erfolgreichen Löschen kann die zugehörige vendor_id für den Verkäufer wiederverwendet und gegebenenfalls einem anderen Verkäufer zugewiesen werden.

Bevor du beginnst

Führe vor dem Löschen von Verkäufern die folgenden Schritte aus:

Erforderliche Berechtigungen

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

Unternehmens-Admin
Kredit verwalten
App-Entwickler

Seller Deletion API-Aufruf

Anfrage

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "DELETE", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses?child_business_external_id=<VENDOR_ID>", 
        "name": "<ASYNC_SESSION_NAME>"
      } 
  ]' \
  -F "appsecret_proof=<APP_SECRET>" \
  "https://graph.facebook.com/v20.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
`appsecret_proof` String	Erforderlich. Der hexadezimale String, der das Eigentum des bereitgestellten Zugriffsschlüssels nachweist. `appsecret_proof` sollte aus dem Zugriffsschlüssel und App-Geheimcode des Marketplace generiert werden.
`child_business_external_id` String	Erforderlich, es sei denn, `child_business_id` ist angegeben. Jeder Marketplace muss eine eindeutige ID für jeden Verkäufer übergeben. Der Name des Felds auf Seite des Marketplace lautet `vendor_id`.
`child_business_id` String	Erforderlich, es sei denn, `child_business_external_id` ist angegeben. Die Business Manager-ID des Verkäufers.
`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.

Antwort

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

Verwende die ASYNC_SESSION_ID, um den Löschstatus des Verkäufers von Managed Partner Ads abzurufen.

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\":\"<MANAGED_PARTNER_BM_ID>\", \"success\":true}",
  "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 Deletion API können zu mehreren verschiedenen Fehlerantworten führen. Weitere Informationen findest du unter Fehlerbehandlung.

Fehlercode	Fehler-Subcode	Fehlermeldung
1800007	2310162	Die eingegebene Unternehmens-ID {business_id} gehört nicht zu einem Partner in Managed Partner Ads. Prüfe deinen Eintrag oder gib eine neue Unternehmens-ID ein.
1800007	2310163	Die eingegebene Anbieter-ID {vendor_id} gehört nicht zu einem Partner in Managed Partner Ads. Prüfe deinen Eintrag oder gib eine neue Anbieter-ID ein.
1800008	2310164	Dein Unternehmen verwaltet nicht den Partner {business_id ODER vendor_id}, den du löschen möchtest. Prüfe die ID oder gib eine neue ein.
1800009	2310113	Managed Partner mit Unternehmens-ID {business_id} kann nicht gelöscht werden. Partner mit einem ausstehende Betrag von {amount} {currency} kann nicht gelöscht werden. Bezahle deine Rechnung und versuche dann erneut, den Partner zu löschen.
1800009	2310134	DerDie Seiteneigentümerin {page_owner_id} für die Seite {page_id} ist kein Admin-Systemnutzer. Die Seite wurde nicht von Managed Partner Ads erstellt und muss gelöscht werden, bevor du den Partner löschen kannst.
1800009	2310135	Dieser Partner hat mindestens eine Facebook-Seite, die nicht von Managed Partner Ads erstellt wurde. Du musst die folgenden Seiten löschen, bevor du den Partner löschen kannst: {list_of_page_ids}
1800009	2310165	Ein Unternehmen mit aktiven Kampagnen kann nicht gelöscht werden. Gehe zum Werbeanzeigenmanager, um zu prüfen, wann die aktiven Kampagnen enden, oder um sie auszuschalten.