Panoramica

L'API Marketing è un'API basata su HTTP che puoi usare per interrogare dati a livello di codice, creare e gestire inserzioni ed effettuare numerose altre operazioni. Questa sezione contiene informazioni generali sulle API Marketing, sull'accesso, sulla gestione delle versioni e molto altro.

Poiché l'API è basata su HTTP, funziona con qualsiasi linguaggio o software che supporti HTTP, inclusi cURL e quasi tutti i browser web moderni. L'API Marketing è realizzata sulla base dell'API Graph di Meta, pertanto quasi tutte le richieste devono essere passate all'URL dell'host graph.facebook.com.

Concetti di base

Concetti che devi comprendere per utilizzare l'API Marketing:

Struttura della campagna pubblicitaria

Meta organizza le inserzioni in una struttura a tre livelli: campagna, gruppo di inserzioni e inserzione. Nell'API gli sviluppatori hanno accesso a un quarto livello, la creatività.

Autorizzazione

Per accedere agli endpoint dell'API Marketing, la tua app deve disporre di diversi livelli di autorizzazione dell'API Graph.

Autenticazione

Scopri come ottenere e memorizzare il token d'accesso di cui hai bisogno per le tue chiamate API.

Rate limiting

L'API Marketing dispone della propria logica per il rate limiting ed è esclusa da tutti i rate limit dell'API Graph.

Gestione delle versioni

La piattaforma di Meta ha un modello di gestione delle versioni core ed esteso. Scopri di più sulle novità future e sulle funzionalità obsolete tramite i nostri sistemi di migrazione e gestione delle versioni. Consulta Programmazioni della versione, Migrazioni e Registro modifiche.

Analisi dell'app

Per utilizzare l'API Marketing, l'app deve essere sottoposta alla procedura di analisi dell'app, con alcune eccezioni per l'API lato server e le conversioni offline.

Autorizzazioni

Sono previste due autorizzazioni principali per le inserzioni: ads_management e ads_read. Le autorizzazioni devono essere concesse all'app che stai usando per effettuare chiamate. Le autorizzazioni possono essere richieste durante la procedura di analisi dell'app. Consulta la lista delle autorizzazioni disponibili per le app aziendali.

Codici di errore

Durante l'uso dell'API potrebbero essere visualizzati codici di errore. Usa queste informazioni come riferimento per acquisire maggiori informazioni su ciascun codice di errore.

Post-elaborazione

Acquisisci informazioni sulla fase di post-elaborazione dopo la ricezione di una richiesta da parte di Meta.