Parametri degli eventi del server

ParametroDescrizione
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.