Webhooks di Meta

Webhook per account pubblicitari

I webhook per gli account pubblicitari ti consentono di ricevere notifiche in tempo reale per alcune modifiche alle inserzioni.

Per configurare i webhook per gli account pubblicitari, sono necessari i seguenti passaggi:

  1. Configura il tuo endpoint e imposta i webhook.
  2. Attiva l'iscrizione della tua app all'account pubblicitario.

Configura endpoint e webhook

Segui la nostra guida introduttiva per i webhook per creare il tuo endpoint e configurare i tuoi webhook. Quando configuri i tuoi webhook, assicurati di scegliere Ad Account.

Al momento, puoi ricevere notifiche in tempo reale per le modifiche allo stato dell'oggetto pubblicitario per WITH_ISSUES e IN_PROCESS. Attiva l'iscrizione per uno o più campi qui sotto:

Campo Descrizione

with_issues_ad_objects

Ti informa quando una campagna, un gruppo di inserzioni o un'inserzione nell'account pubblicitario riceve lo stato WITH_ISSUES.

in_process_ad_objects

Ti informa quando una campagna, un gruppo di inserzioni o un'inserzione lascia lo stato IN_PROCESS. Consulta il documento sulla post-elaborazione per maggiori informazioni.

Attiva l'iscrizione della tua app

Devi attivare l'iscrizione della tua app alle notifiche webhook per il tuo account pubblicitario. La tua app deve disporre dell'autorizzazione per la modifica dell'account pubblicitario per completare questo passaggio. L'app deve anche disporre dell'autorizzazione ads_management.

Per attivare l'iscrizione, l'app deve inviare una richiesta POSTsubscribed_apps per l'account pubblicitario:

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

Se l'azione viene eseguita correttamente, ottieni questa risposta:

{"success": "true"}

Per visualizzare le app per le quali è attivata l'iscrizione per il tuo account pubblicitario, invia una richiesta GET:

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

Se l'azione viene eseguita correttamente, ottieni questa risposta:

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

Per eliminare l'iscrizione di un'app, invia una richiesta DELETE:

Se l'azione viene eseguita correttamente, ottieni questa risposta:

{"success": "true"}

Attiva l'iscrizione con il Tool di esplorazione per la API Graph

Puoi attivare l'iscrizione dell'app anche con il Tool di esplorazione per la API Graph.

Sostituisci la query me?fields=id,name con act_AD_ACCOUNT_ID/subscribed_apps. Questa procedura ti consentirà di iscrivere l'app che utilizzi per inviare la richiesta POST nel Tool di esplorazione per la API Graph. In alternativa, puoi iscrivere un'app diversa specificando subscribed_apps come parametro di input con l'ID dell'app.

Per attivare l'iscrizione dell'app, questa deve disporre dell'autorizzazione per la modifica dell'account pubblicitario.

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