Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.

Aggiornamento inglese: Oggi

Best practice - API Conversions

Segui queste best practice come consigli generali per una corretta integrazione dell'API Conversions. Questi consigli sono pensati per aiutarti a utilizzare nel modo più efficace possibile l'API Conversions. Segui i consigli di implementazione e post implementazione per un'integrazione perfetta e risultati ottimali quando condividi dati con Meta.

In aggiunta alle seguenti best practice, ti consigliamo di guardare questo video per un tutorial con indicazioni più pratiche sull'utilizzo dell'API Conversions. Il video ti guida attraverso le seguenti operazioni:

Invio di richieste
Gestione di eventi ignorati, data e ora della transazione relativa a un evento e richieste di gruppo
Verifica degli eventi
Uso dello strumento Testa gli eventi

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

Implementazione

Durante la configurazione della campagna, semplifica la struttura dell'account e applica le seguenti best practice consolidate per le campagne:

Implementa le best practice per la fase di apprendimento.
Evita di apportare modifiche significative alla campagna.
Riduci al minimo la sovrapposizione nell'asta.
Seleziona Posizionamenti automatici e Ottimizzazione del budget della campagna.
Scegli la giusta strategia di offerta sulla base dei tuoi obiettivi di business.

Configurazione di eventi ridondanti

Ti consigliamo di usare l'API Conversions in aggiunta al pixel di Meta e di condividere gli stessi eventi con entrambi gli strumenti. Questa strategia è nota come configurazione di eventi ridondanti. Ad esempio, se condividi gli eventi Purchase, Initiate Checkout e Contact con il pixel di Meta, ti consigliamo di condividere gli stessi eventi anche dal tuo server con l'API Conversions.

L'API Conversions ti consente di condividere eventi sul sito web che il pixel potrebbe perdere a causa di problemi di connettività di rete o di errori di caricamento della pagina. L'API Conversions può essere usata anche per condividere altri tipi di eventi e dati importanti che si verificano offline o in un secondo momento e che il pixel non può condividere.

Verifica della possibilità di deduplica degli eventi ridondanti

Quando invii eventi ridondanti con il pixel di Meta e l'API Conversions, assicurati che entrambi gli eventi usino lo stesso event_name e che siano inclusi l'event_id o una combinazione di external_id e fbp. Ti consigliamo di includere tutti questi parametri per aiutare Meta a deduplicare correttamente gli eventi e ridurre i casi di doppia segnalazione di eventi identici. Scopri di più sulla deduplicazione, quando è necessaria e come configurarla.

Invio di parametri obbligatori e consigliati

I seguenti parametri di eventi del server e informazioni sui clienti sono obbligatori:

Parametro	Tipo	Quando richiesto
`action_source`	Evento del server	Tutti gli eventi
`event_source_url`	Evento del server	Tutti gli eventi del sito web
`client_user_agent`	Informazioni sui clienti	Tutti gli eventi del sito web

Usando l'API Conversions, dichiari che il parametro action_source, per quel che ne sai, è accurato. Ti consigliamo inoltre di includere i parametri degli eventi external_id ed event_id per tutti gli eventi.

L'invio di parametri delle informazioni sui clienti aggiuntivi può contribuire a migliorare la qualità della corrispondenza degli eventi. Solo gli eventi corrispondenti possono essere utilizzati per ottimizzare attribuzione e pubblicazione delle inserzioni; maggiore è la qualità della corrispondenza e migliore risulta l'ottimizzazione. Sebbene gli eventi non corrispondenti non possano essere usati per ottimizzare attribuzione o pubblicazione delle inserzioni, possono ugualmente essere usati per la misurazione di base. Esempi di parametri delle informazioni sui clienti di qualità elevata includono:

Indirizzo e-mail (em)
Indirizzo IP (client_ip_address)
Nome (fn e ln)
Numero di telefono (ph)

Requisiti di base per la corrispondenza

In seguito al rilascio della versione 13.0 dell'API Graph, aggiorneremo i requisiti di base in merito a quali combinazioni di parametri delle informazioni sui clienti sono considerate valide con un evento dell'API Conversions. Queste modifiche ci aiuteranno a fornire un feedback migliore per i casi in cui un evento dispone di una combinazione di parametri delle informazioni sui clienti così ampia che difficilmente sarà efficace per la corrispondenza.

Un evento è considerato non valido se include solo parametri delle informazioni sui clienti costituiti da una delle seguenti combinazioni (o da un loro sottoinsieme).

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

Ad esempio, se un evento avesse solo i parametri delle informazioni sui clienti ge, ct, st e country (che potrebbero corrispondere a un uomo, a Menlo Park, in California, negli Stati Uniti), verrebbe rifiutato perché tali parametri rappresentano un sottoinsieme di una delle combinazioni precedenti.

Verifica che i parametri `fbp` e `fbc` siano aggiornati

I parametri fbp e fbc sono valori di cookie generalmente impostati sui browser dei visitatori del tuo sito, in connessione con la soluzione per cookie proprietaria di Meta, e sono soggetti a modifiche. Se li invii come parametri utente, ricordati di aggiornarne regolarmente i valori.

Questi valori verranno impostati come cookie proprietari quando il pixel di Meta viene implementato sul sito web e possono essere recuperati per l'uso nelle richieste dell'API Conversions.

Condividere eventi nel momento in cui si stanno svolgendo può consentirti di ottenere risultati ottimali con le tue campagne. Puoi condividere eventi del server usando l'API Conversions in tempo reale o in gruppi quasi in tempo reale.

Uso dello strumento Testa gli eventi

Ti consigliamo di usare lo strumento Testa gli eventi per convalidare la connessione con l'API Conversions. Di solito, gli sviluppatori dovrebbero usare i propri parametri delle informazioni sui clienti (ad esempio, nome, indirizzo e-mail, numero di telefono) per testare gli eventi poiché questi ultimi potrebbero essere eliminati in caso di mancata corrispondenza con un account Facebook o Meta.

Puoi usare lo strumento Testa gli eventi per:

controllare se hai configurato correttamente gli eventi del server e se li abbiamo ricevuti;
verificare di aver deduplicato correttamente gli eventi controllando quali sono stati elaborati e deduplicati;
eseguire il debug di eventuali attività insolite.

Scopri come testare gli eventi del server usando lo strumento Testa gli eventi.

Utilizzo dello strumento di assistenza per il payload

Compila i campi dei parametri dei dati obbligatori e consigliati nello strumento di assistenza per il payload per sapere come quest'ultimo deve essere strutturato e ottenere consigli sui parametri da includere.

Utilizzo del nostro SDK Business

Gli esempi di codice nella nostra documentazione includono esempi dell'SDK Business in Python, Java, Ruby, PHP e Node, che possono risparmiarti ulteriori attività di sviluppo, come l'hashing dei parametri utente che viene eseguito automaticamente nell'SDK Business.

Se non intendi usare l'SDK Business, ti consigliamo di implementare l'hashing.

Utilizzo dell'API Conversions per eventi offline

L'API Conversions supporta tutti gli eventi offline e deve essere utilizzata come contenitore unico per questi tipi di eventi. Alcuni esempi includono le vendite in negozio, le telefonate, le azioni sui dispositivi (come smart TV o console di gioco) e gli abbonamenti offline.

Quando invii eventi offline, assicurati di includere il parametro dell'evento action_source e di scegliere il valore appropriato (non website). È necessaria l'origine delle azioni per determinare gli obiettivi della campagna per cui è pensato l'evento.

Usando l'API Conversions, dichiari che il parametro action_source, per quel che ne sai, è accurato.

Best practice aggiuntive per i partner

Agenzie: invia la stringa `partner_agent`

Partner o agenzie che condividono eventi per conto dei propri inserzionisti devono inviare una stringa partner_agent unica, includendo il nome della piattaforma come indicato. Se applicabile, lavora con il tuo rappresentante di Meta dedicato per scegliere una stringa agente idonea.

Piattaforme per siti web: registrazione degli inserzionisti

Per impostazione predefinita, i partner di piattaforme per siti web possono valutare se offrire l'API Conversions in maniera selettiva oppure a inserzionisti che lo richiedono. Il pixel di Meta e l'API Conversions condividono le stesse condizioni aziendali, pertanto ti consigliamo di attivare l'opzione per consentire ai tuoi clienti di autorizzare la condivisione dei propri dati tramite l'API Conversions quando configurano il pixel di Meta. Sebbene riteniamo che l'utilizzo combinato di questi due strumenti possa rafforzare e tutelare la condivisione dei dati nel lungo periodo, ti consigliamo di fornire ai tuoi clienti le informazioni relative sia all'API Conversions sia al pixel di Meta, in modo che possano fare una scelta ponderata.

Post implementazione

Controllo della qualità della corrispondenza degli eventi

Se condividi eventi del server con l'API Conversions, puoi vedere la qualità della corrispondenza degli eventi (EMQ) per ogni evento in Gestione eventi. Il punteggio EMQ di un evento (fino a 10) indica il grado di efficacia delle informazioni dei clienti per l'evento del server nella definizione della corrispondenza con un account Facebook o Meta. Scopri di più sulle best practice per la EMQ qui.

La qualità della corrispondenza degli eventi è attualmente disponibile solo per gli eventi web. Per gli altri tipi di eventi, come gli eventi offline e dei punti vendita fisici, gli eventi nell'app, i contatti di conversione o qualsiasi integrazione nelle fasi alfa o beta, contatta il tuo rappresentante Meta per indicazioni su come migliorare la qualità della corrispondenza degli eventi.

Esecuzione di un test

Quando usi l'API Conversions, ti consigliamo di testare e ottimizzare la tua strategia pubblicitaria su Meta. Alcune opzioni di test includono:

Studio sul conversion lift: ti consente di comprendere l'impatto dell'utilizzo di eventi del server sulle prestazioni incrementali.
Test A/B: ti consente di comprendere quale strategia per le campagne garantisce gli esiti migliori e più efficaci per l'ottimizzazione delle prestazioni.