Webhooks Meta

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 :

Champ Description

with_issues_ad_objects

Vous prévient lorsqu’une campagne, un ensemble de publicités ou une publicité figurant sous le compte publicitaire reçoit le statut WITH_ISSUES.

in_process_ad_objects

Vous prévient lorsqu’une campagne, un ensemble de publicités ou une publicité quitte le statut IN_PROCESS. Voir post-traitement pour plus d’informations.

ad_recommendations

Vous avertit lorsque des recommandations publicitaires sont générées pour vos publicités.

creative_fatigue

Vous avertit lorsque votre publicité commence à susciter de la lassitude, mais également quand ce n’est plus le cas. Fournit des informations plus précises en matière de niveaux de lassitude, par exemple Faible, Moyen et Élevé. Vous ne recevrez des notifications que pour les publicités configurées comme ACTIVE.

product_set_issue

Vous avertit lorsqu’un ensemble de produits rencontre des problèmes qui affectent vos publicités.

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