Webhooks pour les comptes publicitaires

Les webhooks pour les comptes publicitaires vous permettent de recevoir des notifications en temps réel pour certaines modifications publicitaires.

Pour configurer des webhooks pour les comptes publicitaires, procédez comme suit :

1. Configurez votre point de terminaison et les webhooks.
2. Abonnez votre application dans votre compte publicitaire.

Configurer le point de terminaison et les webhooks

Suivez notre Guide de démarrage pour Webhooks pour créer votre point de terminaison et configurer vos webhooks. Lorsque vous configurez vos webhooks, assurez-vous de choisir Ad Account.

Actuellement, vous pouvez recevoir des notifications en temps réel pour les changements de statut des objets publicitaires pour WITH_ISSUES et IN_PROCESS. Abonnez-vous à un des champs ci-dessous ou aux deux :

Abonner votre application

Vous devez abonner votre application aux notifications webhook pour votre compte publicitaire. Votre application doit disposer de l’autorisation de modifier le compte publicitaire pour terminer cette étape. L’application doit aussi posséder l’autorisation ads_management.

Pour abonner votre application, envoyez une requête POST au point de terminaison subscribed_apps du compte publicitaire :

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

Si l’opération aboutit, la réponse suivante s’affiche :

{"success": "true"}

Pour voir quelles applications sont abonnées à votre compte publicitaire, envoyez une requête GET :

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

Si l’opération aboutit, la réponse suivante s’affiche :

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

Pour résilier l’abonnement d’une application, envoyez une requête DELETE :

Si l’opération aboutit, la réponse suivante s’affiche :

{"success": "true"}

Abonner une application via l’Explorateur de l’API Graph

Vous pouvez aussi abonner une application avec l’Explorateur de l’API Graph.

Remplacez la requête me?fields=id,name par act_AD_ACCOUNT_ID/subscribed_apps. Cela permet d’abonner l’application que vous utilisez afin qu’elle puisse envoyer la requête POST dans l’Explorateur de l’API Graph. Vous pouvez également abonner une autre application en spécifiant subscribed_apps en tant que paramètre d’entrée avec l’ID de l’application concernée.

L’application doit avoir l’autorisation de modifier le compte publicitaire pour pouvoir s’abonner.

[
  {
    "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"
            }
          }
        ]
      }
    ]
  }
]