API Ads Insights

L'API Ads Insights fornisce dati e statistiche sulle prestazioni delle inserzioni di Meta. Grazie alle opzioni flessibili relative ai report, puoi personalizzare le tue richieste e ottenere praticamente qualsiasi metrica disponibile in Gestione inserzioni di Meta.

Prima di iniziare

Per accedere all'API Ads Insights, avrai bisogno di:

Un'app. (Per maggiori informazioni, consulta Sviluppo di app di Meta.)
Autorizzazione ads_read. (Per maggiori informazioni, consulta Autorizzazioni e Autorizzazione).

Dovresti anche configurare le tue inserzioni per il monitoraggio delle azioni che ti interessano. A tale scopo, puoi usare strumenti come l'API Conversions o il pixel di Meta.

Chiamata all'API Ads Insights

L'API Ads Insights è disponibile come edge in tutti gli oggetti pubblicitari. Scopri di più sulla gerarchia delle inserzioni di Meta qui.

Risorse	Fornisce
`/{ad-account-id}/insights`	Insight di un account pubblicitario
`/{campaign-id}/insights`	Insight da una campagna pubblicitaria
`/{ad-set-id}/insights`	Insight da un gruppo di inserzioni
`/{ad-id}/insights`	Insight di un'inserzione

Per impostazione predefinita, le richieste GET restituiranno le metriche di base per l'oggetto dell'inserzione, in genere degli ultimi 30 giorni.

Esempio di richiesta

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

Risposta di esempio:

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Personalizzazione delle richieste

Puoi ottenere dati molto più specifici sfruttando tre componenti principali nella tua richiesta: parametri (per specificare elementi come intervalli di tempo, finestre di attribuzione ecc.), campi (ovvero metriche) e dettagli. Ad esempio, per conoscere il numero di clic (tutti) in base al genere che si sono verificati negli ultimi 7 giorni della campagna, potresti includere:

Parametri: date_preset=last_7d
Campi: clicks
Dettagli: gender

Esempio di richiesta

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

Risposta di esempio

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Per saperne di più

L'API Ads Insights può rivelarsi molto efficace, quindi continua a leggere e impara a padroneggiare le sue funzioni:

Parametri e campi
Metriche
Dettagli
Richieste asincrone
Limiti e best practice
Guide specifiche per report sulle conversioni, report a livello di prodotto e marketing mix modeling

Puoi inoltre trovare la documentazione di riferimento generata automaticamente per ogni segmento relativo agli insight degli oggetti pubblicitari:

Se hai intenzione di includere dati provenienti dall'API Ads Insights nella tua soluzione, consulta anche le Condizioni della Piattaforma Meta e le Normative per gli sviluppatori dell'API Marketing.