API Conversions

Primi passi

Questa pagina descrive il processo di implementazione dell'API Conversions e i prerequisiti di implementazione. Se sei un partner terzo che offre funzionalità dell'API Conversions per gli inserzionisti, ci sono diversi requisiti da cui iniziare.

Se la tua azienda ha un firewall per le richieste in uscita, vedi IP crawler e agenti utente per ottenere gli indirizzi IP di Facebook. Tieni presente che l'elenco di indirizzi cambia spesso.

Web, app, and physical store events shared using the Conversions API require specific parameters. The list of required parameters is available here.

Panoramica della procedura

La procedura di configurazione di un'integrazione dell'API Conversions consiste nei seguenti passaggi fondamentali:

  1. scelta del metodo di integrazione giusto per te;
  2. completamento dei prerequisiti necessari per il metodo di integrazione scelto;
  3. implementazione mediante il metodo di integrazione scelto;
  4. verifica della configurazione e dell'aderenza alle best practice per il miglioramento delle prestazioni delle inserzioni.

Metodi di integrazione

Esistono diversi metodi per l'integrazione con l'API Conversions, che variano in base al livello di impegno, al costo e alle funzioni che abilitano. Consulta questo articolo per una panoramica delle opzioni di configurazione dell'API Conversions.

L'obiettivo principale di questa documentazione per gli sviluppatori è creare integrazioni dirette

Requisiti

ID del pixel

Devi ottenere un ID del pixel per usare l'API Conversions. Se hai già configurato un pixel per il tuo sito web, ti consigliamo di usare lo stesso ID del pixel per gli eventi del browser e del server.

Business Manager

Devi disporre anche di un Business Manager per utilizzare l'API. Business Manager consente agli inserzionisti di integrare le iniziative di marketing di Facebook nella loro azienda e con i partner esterni. Se non hai ancora un Business Manager, consulta l'articolo del Centro assistenza su come creare un Business Manager.

Token d'accesso

Per utilizzare l'API Conversions, hai bisogno di un token d'accesso. Sono disponibili due modi per ottenere il token d'accesso:

  • Tramite Gestione eventi (consigliato)
  • Tramite la tua app

Tramite Gestione eventi (consigliato)

Per utilizzare l'API Conversions, devi generare un token d'accesso, che viene passato come parametro in ogni chiamata API. In Gestione eventi, segui questa procedura:

Passaggio 1: scegli il pixel da implementare.

Passaggio 2: seleziona la tab Impostazioni.


Passaggio 3: trova la sezione API Conversions e clicca sul link Genera token d'accesso in Configura manualmente, quindi segui il pop-up di istruzioni:

Nota: il link Genera token d'accesso è visibile solo agli utenti con privilegi di sviluppatore nell'azienda. Il link è nascosto per gli altri utenti.


Una volta ottenuto il token, clicca sul pulsante Gestisci integrazioni nella tab Panoramica in Gestione eventi. Nella schermata pop-up, clicca sul pulsante Gestisci accanto all'API Conversions. In questo modo, creiamo automaticamente un'app API Conversions e l'utente di sistema API Conversions che potrai utilizzare. Non è necessario completare l'Analisi dell'app o richiedere autorizzazioni.



Tramite la tua app

Se hai già la tua app e il tuo utente di sistema, puoi generare il token in Business Manager. Per farlo:

Passaggio 1: vai alle Impostazioni di Business Manager.

Passaggio 2: assegna un pixel al tuo utente di sistema (hai anche la possibilità di creare un nuovo utente di sistema in questa fase).

Passaggio 3: seleziona l'utente di sistema assegnato e clicca su Genera token.

La tua app non deve essere sottoposta all'Analisi dell'app. Non devi richiedere alcuna autorizzazione.

I token d'accesso generati nella tab delle impostazioni dell'API Conversions in Gestione eventi non sono più limitati all'utilizzo della versione più recente dell'API Graph disponibile al momento della generazione del token. A partire dalla v12.0, i token d'accesso appena creati possono essere utilizzati con tutte le versioni dell'API Graph disponibili.

Risorse