Webhooks für Werbekonten

Mit Webhooks für Werbekonten kannst du Echtzeit-Benachrichtigungen für bestimmte Anzeigenänderungen zu erhalten.

Für die Einrichtung von Webhooks für Werbekonten musst du folgende Schritte ausführen:

Richte deinen Endpunkt ein und konfiguriere die Webhooks.
Abonniere deine App unter deinem Werbekonto.

Einrichten von Endpunkten und Webhooks

Befolge unseren Leitfaden für die ersten Schritte, um deinen Endpunkt zu erstellen und deine Webhooks zu konfigurieren. Stelle bei der Konfiguration von Webhooks sicher, dass du Werbekonto auswählst.

Derzeit kannst du Benachrichtigungen in Echtzeit für Änderungen des Werbeziels für WITH_ISSUES und IN_PROCESS abrufen. Abonniere ein oder mehrere der nachstehenden Felder:

Feld	Beschreibung
`with_issues_ad_objects`	Du wirst benachrichtigt, wenn eine Kampagne, eine Anzeigengruppe oder eine Anzeige unter dem Werbekonto den Status `WITH_ISSUES` annimmt.
`in_process_ad_objects`	Du wirst benachrichtigt, wenn eine Kampagne, eine Anzeigengruppe oder eine Anzeige nicht mehr den Status `IN_PROCESS` aufweist. Weitere Informationen findest du unter Nachbearbeitung.

Du musst deine App für Webhook-Benachrichtigungen für das Werbekonto abonnieren. Deine App muss über Bearbeitungsberechtigung für das Werbekonto verfügen, um diesen Schritt abzuschließen. Die App muss auch über ads_management-Berechtigung verfügen.

Zum Abonnieren deiner App muss deine App eine POST-Anfrage subscribed_apps für das Werbekonto senden:

curl -i -X POST \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"

Bei erfolgreichem Verlauf wird diese Antwort angezeigt:

{"success": "true"}

Möchtest du sehen, welche Apps für dein Werbekonto abonniert sind, sende eine GET-Anfrage:

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"

Bei erfolgreichem Verlauf wird diese Antwort angezeigt:

{
  "data": [
  { 
    "name": "<APP_NAME>", 
    "id": "<APP_ID>" 
  } ]
}

Möchtest du ein Abonnement für eine App löschen, sende eine DELETE-Anfrage:

Bei erfolgreichem Verlauf wird diese Antwort angezeigt:

{"success": "true"}

Abonnieren mit Graph API Explorer

Du kannst die App auch mit Graph API Explorer abonnieren.

Ersetze die me?fields=id,name-Abfrage durch act_AD_ACCOUNT_ID/subscribed_apps. Es wird die App abonniert, die du verwendest, um die POST Anfrage in Graph Explorer zu senden. Alternativ kannst du auch eine andere App abonnieren, indem du subscribed_apps als Eingabeparameter mit der App-ID hinzufügst.

Deine App benötigt die Genehmigung zum Bearbeiten des Werbekontos für einen erfolgreichen Abonnementvorgang.

[
  {
    "object": "ad_account",
    "entry": [
      {
        "id": "0",
        "time": 1568132516,
        "changes": [
          {
            "field": "with_issues_ad_objects",
            "value": {
              "id": "111111111111",
              "level": "AD",
              "error_code": "567",
              "error_summary": "error summary",
              "error_message": "error message"
            }
          }
        ]
      }
    ]
  }
]