event_name stringa | Obbligatorio. Il nome di un evento standard o di un evento personalizzato. Questo campo è usato per deduplicare eventi inviati sia tramite web (tramite il pixel di Meta) o app (tramite SDK o l'API App Events) che con l'API Conversions. Anche il parametro event_id viene usato per la deduplicazione.
Per la stessa azione del cliente, event dall'evento del browser o dell'app corrisponde a event_name dall'evento del server. Se troviamo una corrispondenza tra eventi inviati entro 48 ore l'uno dall'altro, consideriamo solo il primo. Se un evento server e uno browser/app arrivano all'incirca nello stesso momento (ovvero entro 5 minuti l'uno dall'altro), la priorità viene data all'evento browser/app. Maggiori informazioni sulla Deduplicazione di eventi pixel e server. |
event_time intero | Obbligatorio. Una marca temporale Unix in secondi, indicante quando l'evento si è effettivamente verificato. L'indicazione temporale fornita può essere precedente al momento di invio dell'evento a Facebook. Questo rende possibile l'elaborazione in batch e l'ottimizzazione delle prestazioni del server. Devi inviare questa data nel fuso orario GMT.
event_time non può precedere di oltre 7 giorni il momento dell'invio di un evento a Facebook. Se qualsiasi event_time in data è precedente di più di 7 giorni, viene restituito un errore per l'intera richiesta e non viene elaborato alcun evento.
|
user_data oggetto | Obbligatorio. Una mappa che contiene i dati delle informazioni sui clienti. Consulta Parametri delle informazioni dei clienti per le opzioni disponibili. Consulta Associazione avanzata per le opzioni comparabili per i dati inviati tramite il pixel di Meta. |
custom_data oggetto | Opzionale. Una mappa che include dati aziendali aggiuntivi sull'evento. Consulta Parametri dei dati personalizzati per ulteriori informazioni. |
event_source_url stringa | Opzionale. L'URL del browser in cui è si è verificato l'evento. L'URL deve corrispondere al dominio verificato.
Nota:event_source_url è obbligatorio per gli eventi del sito web condivisi usando l'API Conversions. |
opt_out booleano | Opzionale. Un flag che indica che non dobbiamo utilizzare questo evento per l'ottimizzazione della pubblicazione delle inserzioni. Se impostato su true , utilizziamo l'evento solo per l'attribuzione. |
event_id stringa | Opzionale. Questo ID può essere qualsiasi stringa unica scelta dall'inserzionista. I parametri event_id e event_name sono usati per deduplicare eventi inviati sia tramite web (tramite il pixel di Meta) o app (tramite SDK o l'API App Events) che con l'API Conversions. Tieni presente che, anche se event_id è indicato come opzionale, è consigliato per la deduplicazione eventi.
Per la deduplicazione, l'eventID da un evento del browser o dell'app deve corrispondere all'event_id nell'evento server corrispondente. Scopri di più sulla Gestione degli eventi dell'API Conversions e del pixel duplicati.
Il numero d'ordine o l'ID della transazione sono due possibili identificativi che possono essere usati per l'event_id . Per esempio, se un cliente effettua due acquisti sul tuo sito web con numero d'ordine 123 e 456, ciascuna chiamata dell'API Conversions API dovrebbe includere il relativo numero d'ordine per l'event_id . Ciò permette di distinguere correttamente i due eventi di acquisto come ordini separati. I due pixel del browser degli eventi di acquisto corrispondenti devono anche inviare gli stessi numeri d'ordine nel parametro eventID per permetterci di capire che si tratta soltanto di due eventi e non di quattro singoli acquisti.
Per gli altri eventi senza un numero ID intrinseco, è possibile usare un numero casuale (purché venga inviato lo stesso numero casuale tra eventi del browser e del server). |
action_source stringa | Obbligatorio. Questo campo consente di specificare dove si sono verificate le conversioni. Sapere dove hanno avuto luogo gli eventi contribuisce a garantire che le inserzioni vengano dirette alle persone giuste. Usando l'API Conversions, dichiari che il parametro action_source , per quanto ne sai, è accurato.
I valori che puoi inviare nel campo action_source sono i seguenti:
email : conversione avvenuta via email.
website : conversione avvenuta sul tuo sito web.
app : conversione avvenuta sull'app mobile.
phone_call : conversione avvenuta al telefono.
chat : conversione avvenuta tramite un'app di messaggistica, via SMS o tramite una funzione di messaggistica online.
physical_store : conversione avvenuta di persona nel tuo punto vendita fisico.
system_generated : conversione avvenuta automaticamente, ad esempio il rinnovo di un abbonamento impostato sul pagamento automatico mensile.
business_messaging : conversione effettuata da inserzioni che rimandano a Messenger, Instagram o WhatsApp.
other : conversione avvenuta con una modalità non disponibile nella lista.
Nota: tutti i valori dell'origine delle azioni consentono la misurazione delle inserzioni e la creazione del pubblico personalizzato. Tutte le origini delle azioni, ad eccezione di physical_store consentono l'ottimizzazione delle inserzioni. |
data_processing_options array | Opzionale. Opzioni di trattamento che desideri abilitare per uno specifico evento. Il valore attualmente accettato è LDU , che indica la funzione Utilizzo limitato dei dati. È possibile inviare un array vuoto per specificare in modo esplicito che le restrizioni dell'utilizzo limitato dei dati non devono essere applicate all'elaborazione per questo evento. Scopri di più sulle opzioni per il trattamento dei dati. Consulta Esempi di implementazione dell'API Conversions. |
data_processing_options_country intero | Obbligatorio inviando LDU in data_processing_options . Il Paese che desideri associare a questa opzione di elaborazione dei dati. Gli attuali valori accettati sono 1 per gli Stati Uniti d'America e 0 per richiedere a Facebook di geolocalizzare l'evento. Scopri di più sulle opzioni per il trattamento dei dati. Consulta Esempi di implementazione dell'API Conversions. |
data_processing_options_state intero | Obbligatorio in alcuni casi. Consulta le note seguenti per i dettagli. La provincia/Lo stato che desideri associare a questa opzione di trattamento dei dati. Gli attuali valori accettati sono 1000 per la California e 0 per richiedere a Facebook di geolocalizzare l'evento.
Nota: Se imposti un Paese, devi impostare anche una provincia/uno stato. In caso contrario, applicheremo la nostra logica di geolocalizzazione all'intero evento. Questo campo è obbligatorio se invii LDU in data_processing_options e non fornisci un indirizzo IP.
Scopri di più sulle opzioni di elaborazione dei dati. Consulta Esempi di implementazione dell'API Conversions. |
app_data
oggetto | Obbligatorio per gli eventi dell'app Parametri per condividere i dati dell'app e le informazioni sul dispositivo con l'API Conversions. extinfo è un parametro secondario di app_data .
|
extinfo
oggetto | Obbligatorio per gli eventi nell'app Informazioni estese sul dispositivo, come larghezza e altezza dello schermo. Questo parametro è un array e i valori sono separati da virgole. Quando si utilizzano le informazioni estese, tutti i valori sono obbligatori e devono essere nell'ordine indicizzato di seguito. Se manca un valore, inserisci una stringa vuota come placeholder.
Nota:
version deve essere a2 per Android
version deve essere i2 per iOS
|
0
stringa | Obbligatorio versione extinfo
Esempio: i2 |
1
stringa | nome pacchetto app
Esempio: com.facebook.sdk.samples.hellofacebook |
2
stringa | versione breve (int o stringa)
Esempio: 1.0 |
3
stringa | versione lunga
Esempio: 1.0 long |
4
stringa | Obbligatorio Versione del sistema operativo
Esempio: 13.4.1 |
5
stringa | nome modello dispositivo
Esempio: iPhone5,1 |
6
stringa | lingua
Esempio: En_US |
7
stringa | abbreviazione fuso orario
Esempio: PDT |
8
stringa | gestore
Esempio: AT&T |
9
int64 | larghezza schermo
Esempio: 320 |
10
int64 | altezza schermo
Esempio: 568 |
11
stringa | densità schermo
Esempio: 2 |
12
int64 | Core CPU
Esempio: 2 |
13
int64 | dimensioni memoria esterna in GB
Esempio: 13 |
14
int64 | spazio libero sulla memoria esterna in GB
Esempio: 8 |
15
stringa | fuso orario dispositivo
Esempio: USA/New York |
referrer_url stringa | Facoltativo. L'intestazione del reindirizzamento HTTP come osservato dalla pagina che ha attivato l'API Conversions o l'evento del pixel di Meta. Solitamente si tratta della pagina precedente nel browser. |
original_event_data oggetto | Facoltativo. Tutti i campi di metadati che gli inserzionisti possono usare per specificare come un evento "ritardato" dovrebbe essere associato a un evento passato di acquisizione. Consigliamo vivamente di usare original_event_data quando c'è un ritardo tra il momento dell'invio di un evento e un evento passato di acquisizione a cui dovrebbe essere associato. Consulta Parametri dei dati degli eventi originali per ulteriori informazioni. |