Parametri sulle informazioni dei clienti

I parametri delle informazioni dei clienti sono un insieme di identificativi degli utenti che condividi con le informazioni sull'evento. Per maggiori informazioni sui parametri obbligatori e consigliati, consulta Best Practice - API Conversions: invio di parametri obbligatori e consigliati.

Nell'API Graph v13.0 erano presenti nuovi requisiti relativi alle combinazioni di parametri delle informazioni dei clienti considerate valide. Consulta le best practice per evitare interruzioni delle integrazioni dell'API Conversions.

Consulta la Guida all'uso dei dati e sulla privacy di Meta per sapere quali dati vengono inviati quando si usa l'API Conversions.

I nostri sistemi sono stati progettati in modo da non accettare informazioni di contatto dei clienti non sottoposte alla procedura di hashing, salvo nei casi indicati di seguito. Per informazioni di contatto si intendono le informazioni personali che consentono di identificare singole persone, come nomi e cognomi, indirizzi e-mail e numeri di telefono, che utilizziamo solo per la ricerca delle corrispondenze. Se utilizzi l'SDK di Meta Business, la procedura di hashing avviene automaticamente.

Confronto di pixel

Puoi inviare molti dei parametri delle informazioni dei clienti tramite il pixel di Meta, anche se alcuni (ad esempio, client_user_agent) vengono inviati automaticamente nell'ambito del normale funzionamento di Internet. Ad esempio, per inviare external_id tramite il pixel, utilizza il seguente codice:

fbq('init', 'PIXEL_ID', {'external_id': 12345});

Gli altri parametri che puoi passare con il pixel sono riportati nel documento Ricerca delle corrispondenze avanzata.

Assicurati di applicare lato server lo stesso insieme di parametri sulle informazioni dei clienti che il tuo sistema condivide attualmente lato browser.

Formattazione dei parametri `user_data`

Nella richiesta devi fornire almeno uno dei seguenti parametri user_data con la formattazione corretta.

Scarica questo file CSV

per gli esempi di dati correttamente normalizzati e in formato hash per i seguenti parametri.

Scarica (clic con il tasto destro > salva link con nome)

Parametro	Descrizione
`em` E-mail stringa o lista<string>	Hashing obbligatorio. Rimuovi gli spazi iniziali e finali. Converti tutti i caratteri in lettere minuscole. Esempio: Input: John_Smith@gmail.com Formato normalizzato: john_smith@gmail.com Output SHA256 previsto: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f
`ph` Numero di telefono stringa o lista<string>	Hashing obbligatorio. Rimuovi simboli, lettere ed eventuali zero iniziali. I numeri di telefono devono includere un prefisso internazionale da utilizzare per la ricerca delle corrispondenze (ad esempio, il numero 1 deve precedere i numeri di telefono degli Stati Uniti). Includi sempre il prefisso internazionale nel numero di telefono dei clienti, anche se tutti i dati provengono dallo stesso Paese. Esempio: Input: numero di telefono degli Stati Uniti (650)555-1212 Formato normalizzato: 16505551212 Output SHA256 previsto: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176
`fn` Nome stringa o lista<string>	Hashing obbligatorio. È consigliabile utilizzare i caratteri a-z dell'alfabeto romano. Solo minuscole e niente punteggiatura. Se utilizzi caratteri speciali, il testo deve essere codificato nel formato UTF-8. Esempio: Input: Mary Formato normalizzato: mary Output SHA256 previsto: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec Input: 정 Formato normalizzato: carattere UTF-8 "정" Output SHA256 previsto: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14 Input: Valéry Formato normalizzato: valéry Output SHA256 previsto: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c
`ln` Cognome stringa o lista<string>	Hashing obbligatorio. È consigliabile utilizzare i caratteri a-z dell'alfabeto romano. Solo minuscole e niente punteggiatura. Se utilizzi caratteri speciali, il testo deve essere codificato nel formato UTF-8. Vedi Nome (`fn`) per gli esempi.
`db` Data di nascita stringa o lista<string>	Hashing obbligatorio. È accettato il formato AAAAMMGG che può contenere un intervallo di combinazioni di mese, giorno e anno, con o senza punteggiatura. Anno: usa il formato AAAA dal 1900 all'anno corrente. Mese: usa il formato MM da 01 a 12. Data: usa il formato GG da 01 a 31. Esempio: Input: 2/16/1997 Formato normalizzato: 19970216 Output SHA256 previsto: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c
`ge` Genere stringa o lista<string>	Hashing obbligatorio. Il genere deve essere espresso dall'iniziale in lettera minuscola. Esempio: f per femminile m per maschile
`ct` Città stringa o lista<string>	Hashing obbligatorio. È consigliabile utilizzare i caratteri a-z dell'alfabeto romano. Solo minuscole, senza punteggiatura, caratteri speciali o spazi. Se utilizzi caratteri speciali, il testo deve essere codificato nel formato UTF-8. Esempio: parigi londra newyork
`st` Stato stringa o lista<string>	Hashing obbligatorio. Usa il codice di abbreviazione ANSI di 2 caratteri in minuscolo. Normalizza gli stati fuori dagli Stati Uniti in lettere minuscole, senza punteggiatura, caratteri speciali o spazi. Esempio: az ca
`zp` CAP stringa o lista<string>	Hashing obbligatorio. Usa lettere minuscole, senza spazi né trattini. Usa solo le prime 5 cifre per i CAP statunitensi. Usa il formato area, distretto e settore per il Regno Unito. Esempio: CAP statunitense: 94035 CAP australiano: 1987 CAP francese: 75018 CAP inglese: m11ae
`country` Paese stringa o lista<string>	Hashing obbligatorio. Usa i codici Paese di 2 lettere minuscole alfa-2 ISO 3166-1. Nota importante: includi sempre i Paesi dei clienti anche se tutti i codici Paese sono relativi allo stesso Paese. La ricerca delle corrispondenze viene effettuata su scala globale e questo semplice passaggio ci consente di associare quanti più account Centro gestione account possibile della tua lista. Esempio: Input: Stati Uniti Formato normalizzato: us Output SHA256 previsto: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621
`external_id` ID esterno stringa o lista<string>	Hashing raccomandato. Qualsiasi ID unico dell'inserzionista, come ID del programma fedeltà, ID utente e ID cookie esterni. Puoi inviare uno o più ID esterni per un determinato evento. Se un ID esterno viene inviato tramite altri canali, deve essere nello stesso formato di quando viene inviato tramite l'API Conversions.
`client_ip_address` Indirizzo IP del client stringa	Non applicare l'algoritmo di hashing. L'indirizzo IP del browser corrispondente all'evento deve essere un indirizzo IPV4 o IPV6 valido. Per gli utenti abilitati per IPV6, quest'ultimo è preferibile rispetto a IPV4. Non si deve mai applicare l'algoritmo di hashing al parametro dei dati degli utenti `client_ip_address`. Non devono essere inclusi spazi. Fornisci sempre l'indirizzo IP reale per garantire una segnalazione accurata degli eventi. Nota: queste informazioni vengono aggiunte automaticamente agli eventi inviati tramite il browser, ma devono essere configurate manualmente per gli eventi inviati tramite il server. Esempio: IPV4: 168.212.226.204 IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
`client_user_agent` Agente utente client stringa	Non applicare l'algoritmo di hashing. L'agente utente per il browser corrispondente all'evento. Il parametro `client_user_agent` è obbligatorio per gli eventi del sito web condivisi con l'API Conversions. L'invio di entrambi i parametri `client_ip_address` e `client_user_agent` per tutti gli eventi inviati tramite l'API Conversions può consentire di migliorare l'associazione degli eventi e potrebbe anche migliorare la pubblicazione delle inserzioni per le campagne pubblicitarie, consentendo di eseguire l'ottimizzazione sulla base degli eventi inviati tramite l'API Conversions. Nota: queste informazioni vengono aggiunte automaticamente agli eventi inviati tramite il browser, ma devono essere configurate manualmente per quelli inviati tramite il server. Esempio: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, come Gecko) Chrome/87.0.4280.141 Safari/537.36
`fbc` ID clic stringa	Non applicare l'algoritmo di hashing. Il valore dell'ID clic di Facebook viene memorizzato nel cookie del browser `_fbc` sotto il tuo dominio. Consulta Gestione dei parametri `fbc` e `fbp` per scoprire come ottenere questo valore o generarlo da un parametro della query `fbclid`. Il formato è `fb.${subdomain_index}.${creation_time}.${fbclid}`. Esempio: fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890
`fbp` ID browser stringa	Non applicare l'algoritmo di hashing. Il valore ID del browser di Facebook viene memorizzato nel cookie del browser `_fbp` sotto il tuo dominio. Consulta Gestione dei parametri `fbc` e `fbp` per scoprire come ottenere questo valore. Il formato è `fb.${subdomain_index}.${creation_time}.${random_number}`. Esempio: fb.1.1596403881668.1116446470
`subscription_id` ID abbonamento stringa	Non applicare l'algoritmo di hashing. L'ID abbonamento per l'utente in questa transazione; è simile all'ID dell'ordine per un singolo prodotto.
`fb_login_id` ID Facebook Login intero	Non applicare l'algoritmo di hashing. L'ID emesso da Meta quando una persona accede per la prima volta a un'istanza di un'app. È noto anche come ID per singola app.
`lead_id` ID contatto intero	Non applicare l'algoritmo di hashing. L'ID associato a un contatto generato dalle inserzioni per acquisizione contatti di Meta.
`anon_id` stringa	Non applicare l'algoritmo di hashing. L'ID di installazione. Questo campo rappresenta istanze uniche di installazione dell'applicazione. Nota: questo parametro è solo per gli eventi nell'app
`madid` stringa	ID dell'inserzionista mobile, ID pubblicitario da un dispositivo Android o IDFA da un dispositivo Apple.
`page_id` stringa	Non applicare l'algoritmo di hashing. ID della tua Pagina. Specifica l'ID della Pagina associato all'evento. Usa l'ID della Pagina Facebook associata al bot.
`page_scoped_user_id` stringa	Non applicare l'algoritmo di hashing. Specifica l'ID utente della singola Pagina associato al bot di Messenger che registra l'evento. Usa l'ID utente della singola Pagina fornito al webhook.
`ctwa_clid` stringa	Non applicare l'algoritmo di hashing. Clicca sull'ID generato da Meta per le inserzioni che rimandano a WhatsApp.
`ig_account_id` stringa	Non applicare l'algoritmo di hashing. ID account Instagram associato all'azienda.
`ig_sid` stringa	Non applicare l'algoritmo di hashing. Gli utenti che interagiscono con Instagram sono identificati dagli ID utente per Instagram (IGSID). L'IGSID può essere ottenuto da questo webhook.

Parametri sulle informazioni dei clienti

Confronto di pixel

Formattazione dei parametri user_data

Altri contenuti da consultare

Formattazione dei parametri `user_data`