Parametri degli eventi server

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.

Opzionale.
Una mappa che include dati aziendali aggiuntivi sull'evento. Consulta Parametri dei dati personalizzati per ulteriori informazioni.

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.

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.

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.

app_data

Obbligatorio per gli eventi dell'app

Parametri per condividere i dati dell'app e le informazioni sul dispositivo con l'API Conversions.

extinfo

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

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.

Facoltativo.
Consente agli inserzionisti di specificare il segmento degli utenti a cui appartiene l'utente che esegue l'evento. Può essere usato per fornire più contesto sul rapporto dell'utente con l'azienda.

Questo campo accetta uno dei seguenti valori enum predefiniti:

• new_customer_to_business: l'utente è un nuovo cliente dell'azienda.
• new_customer_to_business_line: l'utente è un nuovo cliente di una linea di business specifica (ad esempio, prodotto o servizio).
• new_customer_to_product_area: l'utente è un nuovo cliente in una specifica area del prodotto (ad esempio, e-commerce, finanza).
• new_customer_to_medium: l'utente è un nuovo cliente per uno specifico canale di marketing (ad esempio, social media, e-mail).
• existing_customer_to_business: l'utente è un cliente esistente dell'azienda.
• existing_customer_to_business_line: l'utente è un cliente esistente di una linea di business specifica (ad esempio, prodotto o servizio).
• existing_customer_to_product_area: l'utente è un cliente esistente in una specifica area del prodotto (ad esempio, e-commerce, finanza).
• existing_customer_to_medium: l'utente è un cliente esistente per uno specifico canale di marketing (ad esempio, social media, e-mail).
• customer_in_loyalty_program: l'utente fa parte di un programma fedeltà.

Esempio di payload JSON:

{
 "event_name": "Purchase",
 "event_time": 1643723400,
 "user_data": {
   "em": "user@example.com"
 },
 "custom_data": {
   "currency": "USD",
   "value": 100.00,
   "customer_segmentation": "new_customer_to_business"
 }
}