FB-Login-Reporting-API - Audience Network di Meta - Documentazione

Integrazione di Facebook Login con l'API Reporting di Audience Network V2

Facebook Login è un nuovo modo per consentire l'accesso ai dati dell'API Reporting di Audience Network. Questo approccio sostituirà il vecchio token utente di sistema copiato e incollato dall'interfaccia di Gestione della monetizzazione e rappresenta un modo più sicuro per consentire l'accesso ai tuoi dati, a causa del rischio che il token di Gestione della monetizzazione venga esposto al di fuori dell'azienda.

Lo scopo di questo documento è fornire linee guida per le integrazioni dirette dell'API Reporting, i Mobile Measurement Partner, i partner di mediazione e altri partner di Facebook che lavorano all'accesso ai dati dell'API Reporting per conto degli editori.

Ricevo i dati dell'API Reporting da terzi

Se utilizzi un partner esistente (Mobile Measurement Partner o partner di mediazione) non dovrai aggiungere codice. Assicurati che il tuo partner integri il flusso di Facebook Login. Dovrai cliccare sull'opzione "Accedi con Facebook" e selezionare le proprietà a cui desideri consentire di accedere con il token generato.

Se selezioni TUTTE le proprietà, il token fornirà l'accesso a tutte le proprietà sotto il Business Manager fino a quando l'utente che ha creato il token avrà accesso alla proprietà nel Business Manager.

Autorizzazioni

Se devi usare direttamente l'API Reporting, dovrai innanzitutto creare un'app Facebook e ottenere le autorizzazioni richieste. Per accedere ai dati dell'API Reporting di Audience Network, l'app ha bisogno dell'autorizzazione read_audience_network_insights. Per ottenere questa autorizzazione per la tua app, l'azienda deve essere registrata in Audience Network.

Dopo la registrazione in Gestione della monetizzazione, accedi alla Pagina degli sviluppatori Facebook e inizia a creare una nuova app business.

Seleziona il Business Manager appena creato nel campo account business.

Dopo aver creato l'app, dovrai collegarla al tuo account di Gestione della monetizzazione selezionando "Audience Network" e cliccando sul pulsante "Configura". Dovrai scegliere quale account di Gestione della monetizzazione collegare.

Puoi farlo anche andando all'indirizzo developers.facebook.com/apps e selezionando l'app appena creata.

L'app è ora registrata in Audience Network e può utilizzare l'autorizzazione read_audience_network_insights. Se non vedi read_audience_network_insights, assicurati che l'app abbia accesso al tuo account business di Gestione della monetizzazione.

Se hai ottenuto in precedenza read_insights permission tramite Facebook Login, questo funzionerà ancora, ma ti consigliamo di passare all'autorizzazione read_audience_network_insights.

La modalità di approccio all'accesso all'API Reporting varia a seconda del tipo di integrazione. Segui le istruzioni che si applicano al tuo caso:

Integrazione diretta dell'API senza interfaccia utente
Integrazione diretta dell'API con interfaccia utente

Integrazione diretta dell'API senza interfaccia utente

Se disponi di un'integrazione (diretta) personalizzata dell'API Reporting senza un'interfaccia front-end e la utilizzi esclusivamente per interrogare i dati della tua azienda, puoi utilizzare le seguenti istruzioni per ottenere l'accesso all'API Reporting.

Creazione di un token utente mediante il Tool di esplorazione per la API Graph

Se nella tua app utilizzi già l'API Marketing, puoi saltare questo passaggio. Altrimenti, segui le istruzioni indicate in Acquisizione dell'autorizzazione read_audience_network_insights.
Accedi al Tool di esplorazione per la API Graph.
Seleziona la tua app
Seleziona l'autorizzazione "read_audience_network_insights" (puoi trovarla in Autorizzazioni > Pagine del gruppo eventi) e clicca su "Genera token d'accesso".

Ora puoi accedere ai dati dell'API Reporting di Audience Network per un breve periodo di tempo con questo token, anziché con quello di Gestione della monetizzazione.
Disclaimer: questo token scadrà tra 2 ore, dovrai trasformarlo nel token d'accesso di lunga durata utilizzando le istruzioni indicate di seguito.

Trasformazione di questo token d'accesso in uno di lunga durata

Accedi al Debugger dei token d'accesso.
Inserisci il tuo token e premi "Debug".
Scorri fino in fondo alla tabella che contiene tutte le informazioni del token e clicca sul pulsante "Estendi token d'accesso".

Copia il token ottenuto.

Ora puoi accedere ai dati dell'API Reporting di Audience Network con questo token.

Integrazione diretta dell'API con interfaccia utente

La seguente guida è utile per editori e partner che hanno la propria interfaccia utente su cui è possibile posizionare il pulsante Facebook Login. Questa guida sarà utile per gli editori disposti ad accedere ai propri dati, nonché per i partner che desiderano accedere ai dati di monetizzazione degli altri editori con la loro autorizzazione.

Puoi anche controllare il video demo end-to-end della seguente guida, comprese le autorizzazioni indicate nel passaggio precedente:

Si è verificato un errore

Stiamo riscontrando problemi con la riproduzione di questo video.

Scopri di più

Nel portale per gli sviluppatori, seleziona la tua app business appena creata nei passaggi precedenti.
Aggiungi un nuovo prodotto "Facebook Login" a questa app.

Seleziona l'opzione "Web" e segui i passaggi di integrazione.

Inserisci l'URL del sito web dove mostrerai l'esperienza di Facebook Login. Assicurati che supporti il protocollo HTTPS.

Alla fine dei passaggi di integrazione, ti verrà fornito il codice di esempio per l'integrazione di Facebook Login nel tuo sito. Puoi copiare questo codice, ma utilizzando l'autorizzazione "read_audience_network_insights" alla quale hai appena avuto accesso invece delle autorizzazioni "public_profile,email" suggerite. Con l'autorizzazione aggiornata, il codice del pulsante dovrebbe essere simile a questo:

<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>

Assicurati di abilitare l'SDK JavaScript in Facebook Login nella pagina delle impostazioni del prodotto per la tua app.

Adesso gli utenti possono essere sottoposti al flusso di Facebook Login sulla tua pagina per generare il token d'accesso
Il token d'accesso sarà restituito come parte dell'argomento passato al metodo JavaScript statusChangeCallback indicato nei passaggi precedenti.

Per impostazione predefinita, questo token scadrà tra circa 2 ore.
Gli sviluppatori possono richiedere di estendere questo token ai token d'accesso di lunga durata senza ulteriore interazione dell'utente.
- I token di lunga durata vengono aggiornati una volta al giorno, quando viene inviata una richiesta dell'API Reporting ai server di Facebook. Se non viene eseguita alcuna richiesta, il token scade dopo 60 giorni e la persona dovrà generarne uno nuovo.
Tieni presente che i dati disponibili tramite questo token dipendono fortemente da chi passa attraverso questo flusso di Facebook Login e dai dati che accettano di condividere. Quindi, se il dipendente dell'azienda passa attraverso questo flusso, il token d'accesso ottenuto avrà le stesse autorizzazioni di questo dipendente.

Risoluzione dei problemi

Messaggio di errore	Cosa significa	Azione/Soluzione
Lettura di insight su una Pagina, un'azienda, un'app, un dominio o un gruppo con origine degli eventi non di proprietà dell'utente o dell'applicazione che ha inviato la query.	Per il token di Facebook Login, significa che l'app che ha rilasciato il token non ha le autorizzazioni necessarie (`read_audience_network_insights`) o che l'utente stesso non dispone dell'autorizzazione per visualizzare determinate proprietà. Questo può accadere per i seguenti motivi: * L'utente che ha generato il token non dispone dell'accesso al Business Manager. * L'utente che ha creato il token non dispone dell'accesso a tutte le proprietà oggetto di query.	L'amministratore strumenti business deve fornire l'accesso a tutte le proprietà all'utente che desidera generare o che ha generato il token.
Dati mancanti o vuoti	Normalmente significa che una parte o la totalità dei dati è stata filtrata usando la nostra aggregazione con protezione della privacy. Questo può essere verificato effettuando un controllo rispetto ai dati MoMa.	Controlla se è presente un array `omitted_results`, a indicare che i dati vengono aggregati. In questo caso, prova a effettuare una richiesta di dimensioni maggiori. Per ulteriori informazioni, leggi la sezione relativa all'aggregazione.
`read_audience_network_insights` non visibile per il token	L'app creata per generare il token non è stata creata come tipo business ed è stata collegata alla Gestione della monetizzazione del tuo Audience Network.	Assicurati di creare l'app per generare un token come Business. Prova a creare una nuova app e assicurati di seguire le istruzioni riportate nella sezione Autorizzazioni. Vai su developers.facebook.com/apps e seleziona l'app per la quale non riesci a vedere `read_audience_network_insights`, quindi seleziona "Audience Network" e clicca sul pulsante "Configura".
`Error validating access token: Session has expired on ...`	Il token è scaduto	Assicurati che il token sia convertito in un token di lunga durata. Segui le istruzioni riportate nella sezione "Trasformazione di questo token d'accesso in uno di lunga durata". I token di lunga durata vengono aggiornati una volta al giorno, quando viene effettuata una richiesta API Reporting ai server di Facebook. Se non viene eseguita alcuna richiesta, il token scade dopo 60 giorni e la persona dovrà generarne uno nuovo.
Sono mostrate due app con lo stesso nome	Controlla se una delle due app dispone delle autorizzazioni `read_audience_network_insights`	Usa l'app che dispone delle autorizzazioni `read_audience_network_insights` corrette
(n. 200) La modalità di accesso all'API Reporting v2.0 è cambiata. Ora è necessario implementare Facebook Login per consentire alla tua app di accedere a questa API.	Non stai usando le credenziali per accedere all'API con la nuova modalità.	Assicurati di creare una nuova app da zero (da usare solo per la creazione di token) e di crearla come tipo Business.