Autorizzazione
La procedura di autorizzazione verifica utenti e app che avranno accesso all'API Marketing e concede le autorizzazioni.
Ruoli dell'app
Nella dashboard della tua app, puoi impostare ruoli per te o per i membri del team, se necessario: amministratore, sviluppatore, tester.
Nota: a seconda del caso d'uso specifico, potresti dover fare analizzare la tua app per accedere alle autorizzazioni legate alla gestione delle inserzioni.
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.
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 e le Normative per gli sviluppatori di Meta. Le chiamate relative a TUTTI i livelli di accesso fanno riferimento ai dati di produzione.
Differenza tra i livelli di accesso all'API Marketing 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 (Nota: l'uso del termine "accesso standard" qui non è correlato alla funzione Accesso standard a Gestione inserzioni.) Il livello di accesso avanzato dell'Accesso standard a Gestione inserzioni richiede comunque che l'app sia sottoposta alla procedura di analisi per poter accedere alla funzione.
Mappatura dell'accesso all'API Marketing 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 nella Dashboard gestione app |
Per controllare il tuo livello di accesso attuale, vai a Dashboard gestione app > Analisi dell'app > Autorizzazioni e funzioni.
Autorizzazioni e funzioni
Autorizzazioni
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 alle autorizzazioni ads_read e ads_management. Se la tua app gestisce anche gli account pubblicitari di altre persone, hai bisogno dell'accesso avanzato alle autorizzazioni ads_read e/o ads_management. Consulta tutte le autorizzazioni disponibili per le app business.
Funzioni
Le funzioni che devi richiedere variano a seconda di come desideri utilizzare le nostre API. Se stai gestendo le inserzioni, potresti volere richiedere l'accesso standard a Gestione inserzioni. Consulta tutte le funzioni disponibili per le app business.
Livelli di accesso alle funzioni
| Livello di accesso alle funzioni | Descrizione |
|---|---|
Le app business vengono automaticamente approvate per l'accesso standard per tutte le autorizzazioni e le funzioni disponibili per il tipo di app business. Usa questa opzione se stai muovendo i primi passi. Puoi creare flussi di lavoro end-to-end prima di richiedere le autorizzazioni complete e 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. | |
L'accesso avanzato deve essere approvato tramite la procedura Analisi dell'app, eseguita per le singole autorizzazioni e funzioni.
Dopo l'invio delle informazioni, Meta ti risponderà approvando o negando la richiesta e fornendoti informazioni aggiuntive 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:
|
Significatività del livello di accesso
La tabella di seguito 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 all'API per conto di amministratori dell'account pubblicitario o inserzionisti. | Gestione di un numero illimitato di account pubblicitari, dopo aver ottenuto l'autorizzazione |
Rate limit | Rate limit elevato per account pubblicitario. Solo per finalità di sviluppo. Non per le app di produzione in esecuzione per inserzionisti live. | Rate limit minimo per account pubblicitario. |
Business Manager | Accesso limitato alle API Business Manager e 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 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 le pagine mediante l'API. |
Ottenimento dell'accesso avanzato
Per ottenere l'accesso avanzato a Gestione inserzioni, la tua app deve soddisfare i seguenti requisiti:
- almeno 1500 chiamate all'API Marketing correttamente effettuate negli ultimi 15 giorni;
- tasso di errori delle chiamate all'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/v22.0/dialog/oauth? client_id=<YOUR_APP_ID> &redirect_uri=<YOUR_URL> &scope=ads_management
Nota: quando inserisci il campo YOUR_URL, immetti un / finale (per esempio, http://www.facebook.com/).
Casi d'uso esemplificativi
| 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. |
|
Vuoi leggere i report pubblicitari per gli account pubblicitari che possiedi o ai quali ti è stato concesso l'accesso dal relativo titolare. |
|
Vuoi estrarre report pubblicitari da un gruppo di clienti e leggere e gestire le inserzioni da un altro gruppo di clienti. |
|
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.