Autorizzazione

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

Livello 1: tipi di app

Quando crei un'app Facebook, ti viene chiesto di specificarne l'utilizzo. L'opzione scelta definisce il tuo tipo di app: Business, Gaming o Nessuno. Consulta Tipi di app.

Per accedere agli endpoint dell'API Marketing, devi creare un'app business. Consulta Prodotti disponibili per le app business.

Dopo aver registrato la tua app, puoi assegnare ruoli a chiunque con un account sviluppatore ti aiuterà nello sviluppo.

Livello 2: livelli di accesso, autorizzazioni e funzioni

Le app business sono soggette a un livello aggiuntivo di autorizzazione dell'API Graph noto come livelli di accesso. Durante l'analisi dell'app, la tua app deve inoltre richiedere specifiche autorizzazioni e funzioni.

Livelli di accesso alle funzioni

Livello di accesso alle funzioni	Descrizione
Accesso standard	Le app business ricevono automaticamente l'approvazione per l'accesso standard per tutte le autorizzazioni e le funzioni disponibili per questo tipo di app. Usa questa opzione se stai muovendo i primi passi. Puoi creare flussi di lavoro end-to-end prima di richiedere autorizzazioni complete. Puoi accedere a un numero illimitato di account pubblicitari. Alcune chiamate API potrebbero non essere disponibili con l'accesso standard poiché potrebbero appartenere a più account oppure perché non è possibile identificare l'account interessato in modo programmatico.
Accesso avanzato	L'accesso avanzato deve essere approvato tramite la procedura Analisi dell'app, eseguita per le singole autorizzazioni e funzioni. Per richiedere l'accesso avanzato, vai alla dashboard della tua app e clicca su Analisi dell'app > Autorizzazioni e funzioni. Trova l'autorizzazione o la funzione a cui desideri accedere e, in Azione, clicca su Richiedi l'accesso avanzato. Puoi selezionare una o più funzioni. Dopo aver selezionato le opzioni desiderate, clicca su Continua con la richiesta per ritornare a una schermata che ti guiderà attraverso la procedura di invio. Dopo l'invio delle informazioni, Facebook ti risponderà approvando o negando la richiesta e fornendoti le informazioni pertinenti nel caso in cui l'app non sia qualificata per l'accesso standard. Se ti viene concesso l'accesso avanzato, dovrai completare le attività seguenti per mantenere il tuo stato: almeno 1500 chiamate API Marketing correttamente effettuate negli ultimi 15 giorni; tasso di errori delle chiamate API Marketing inferiore al 10% negli ultimi 15 giorni.

Livello di accesso alle funzioni

Descrizione

Accesso standard

Le app business ricevono automaticamente l'approvazione per l'accesso standard per tutte le autorizzazioni e le funzioni disponibili per questo tipo di app.

Usa questa opzione se stai muovendo i primi passi. Puoi creare flussi di lavoro end-to-end prima di richiedere autorizzazioni complete. Puoi accedere a un numero illimitato di account pubblicitari.

Alcune chiamate API potrebbero non essere disponibili con l'accesso standard poiché potrebbero appartenere a più account oppure perché non è possibile identificare l'account interessato in modo programmatico.

Accesso avanzato

L'accesso avanzato deve essere approvato tramite la procedura Analisi dell'app, eseguita per le singole autorizzazioni e funzioni.

Per richiedere l'accesso avanzato, vai alla dashboard della tua app e clicca su Analisi dell'app > Autorizzazioni e funzioni.

Trova l'autorizzazione o la funzione a cui desideri accedere e, in Azione, clicca su Richiedi l'accesso avanzato. Puoi selezionare una o più funzioni. Dopo aver selezionato le opzioni desiderate, clicca su Continua con la richiesta per ritornare a una schermata che ti guiderà attraverso la procedura di invio.

Dopo l'invio delle informazioni, Facebook ti risponderà approvando o negando la richiesta e fornendoti le informazioni pertinenti nel caso in cui l'app non sia qualificata per l'accesso standard.

Se ti viene concesso l'accesso avanzato, dovrai completare le attività seguenti per mantenere il tuo stato:

almeno 1500 chiamate API Marketing correttamente effettuate negli ultimi 15 giorni;
tasso di errori delle chiamate API Marketing inferiore al 10% negli ultimi 15 giorni.

Ogni livello presenta una serie di restrizioni. Per maggiori informazioni consulta Livelli di accesso e funzioni. Tutti gli sviluppatori sono tenuti inoltre a osservare le Condizioni della Piattaforma Facebook e le Normative per gli sviluppatori. Le chiamate relative a TUTTI i livelli di accesso fanno riferimento ai dati di produzione.

Per controllare il tuo livello di accesso attuale, vai a Dashboard gestione app > Analisi dell'app > Autorizzazioni e funzioni.

Mappatura dell'accesso all'API Ads rispetto all'accesso standard a Gestione inserzioni

Accesso all'API Marketing	Accesso standard a Gestione inserzioni	Azione
Accesso come sviluppatore	Accesso standard	Impostazione predefinita
Accesso standard	Accesso avanzato	Applicazione requisiti Dashboard gestione app

Autorizzazioni e funzioni

Le autorizzazioni che devi richiedere variano a seconda dell'API a cui desideri accedere.

Se la tua app gestisce solo il tuo account pubblicitario, sono sufficienti l'accesso standard e le autorizzazioni ads_read e ads_management. Se la tua app gestisce anche gli account pubblicitari di altre persone, hai bisogno delle autorizzazioni ads_read e/o ads_management per l'accesso avanzato. Consulta tutte le autorizzazioni disponibili per le app business.

Le funzioni che devi richiedere variano a seconda di come desideri utilizzare le nostre API. Se ti occupi della gestione di inserzioni, una funzione comune da richiedere è Ads Management Standard Access. Consulta tutte le funzioni disponibili per le app business.

Per ottenere l'accesso avanzato per Ads Management Standard Access, la tua app deve soddisfare i seguenti requisiti:

almeno 1500 chiamate API Marketing correttamente effettuate negli ultimi 15 giorni;
tasso di errori delle chiamate API Marketing inferiore al 10% negli ultimi 15 giorni.

Se ti occupi della gestione delle inserzioni di terzi, usa il parametro scope per richiedere le autorizzazioni ads_management o ads_read. La tua app ottiene l'accesso quando un utente clicca su Consenti:

https://www.facebook.com/v21.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Quando inserisci il campo YOUR_URL, immetti un / finale. Ad esempio: http://www.facebook.com/

Esempi

Caso d'uso	Cosa richiedere
Desideri leggere e gestire le inserzioni per gli account pubblicitari che possiedi o ai quali ti è stato concesso l'accesso dal rispettivo titolare.	Autorizzazione: `ads_management` Funzione: `Ads Management Standard Access`
Desideri leggere i report pubblicitari per gli account pubblicitari che possiedi o ai quali ti è stato concesso l'accesso dal rispettivo titolare.	Autorizzazione: `ads_read` Funzione: `Ads Management Standard Access`
Desideri estrarre report pubblicitari da un gruppo di clienti e leggere e gestire le inserzioni da un altro gruppo di clienti.	Autorizzazioni: `ads_management` e `ads_read` Funzione: `Ads Management Standard Access`

Livelli di accesso e funzioni

La tabella sotto mostra in che modo i livelli di accesso standard e accesso avanzato influiscono sulla funzione Accesso standard a Gestione inserzioni.

	Accesso standard	Accesso avanzato
Limiti di account	Gestione di un numero illimitato di account pubblicitari. Gli amministratori o gli sviluppatori dell'app possono effettuare chiamate API per conto di amministratori dell'account pubblicitario o inserzionisti.	Gestione di un numero illimitato di account pubblicitari, dopo aver ottenuto l'autorizzazione `ads_read` o `ads_management` dagli account interessati.
Rate limiting	Rate limiting elevato per account pubblicitario. Solo per finalità di sviluppo. Non per le app di produzione in esecuzione per inserzionisti live.	Rate limiting minimo per account pubblicitario.
Business Manager	Accesso limitato alle API Business Manager e Product Catalog. Nessun accesso a Business Manager per la gestione di account pubblicitari, autorizzazioni degli utenti e Pagine.	Accesso a tutte le API Business Manager e Product Catalog.
Utente di sistema	Possibilità di creare 1 utente di sistema e 1 utente di sistema amministratore.	Possibilità di creare 10 utenti di sistema e 1 utente di sistema amministratore.
Creazione di Pagine	Impossibilità di creare le pagine mediante l'API.	Impossibilità di creare Pagine mediante l'API.

Differenza tra i livelli di accesso e l'accesso standard a Gestione inserzioni

Le autorizzazioni e le funzioni per le app hanno due diversi livelli di accesso: accesso standard e accesso avanzato. L'utilizzo del termine "accesso standard" qui non si riferisce alla funzione Accesso standard a Gestione inserzioni. Per poter accedere a questa funzione in modalità avanzata, l'app deve comunque essere sottoposta alla procedura di analisi.

Livello 3: verifica dell'azienda

La verifica dell'azienda è una procedura che ci consente di verificare la tua identità come entità aziendale ed è necessaria se la tua app accederà a dati riservati. Scopri di più sulla procedura di verifica dell'azienda.