API Conversions di Meta (CAPI) per i moduli di contatto: inviare i contatti senza doppi conteggi
Come inviare i contatti a Meta sia tramite il Pixel sia tramite l'API Conversions con un unico ID evento condiviso, ottenere un token di accesso, verificare in Eventi di prova e gestire il consenso per i recapiti con hash.
Risposta: l'API Conversions di Meta (CAPI) invia gli eventi dal tuo server invece che dal browser del visitatore. Usala insieme al Pixel e assegna a entrambi lo stesso nome evento e lo stesso ID evento; Meta ne terrà uno e scarterà il duplicato. I contatti che il Pixel perde (ad blocker, limiti di tracciamento dei browser, schede chiuse) vengono comunque registrati dall'evento lato server.
Perché il Pixel da solo non basta
Il Pixel funziona nel browser del visitatore. Ad blocker, limiti di tracciamento di iOS e persone che chiudono la scheda subito dopo l'invio fanno perdere eventi. Meta allora sottostima le conversioni e ottimizza gli annunci su meno dati. Una copia lato server colma il vuoto.
Cosa ti serve
- ID del Pixel (dataset) da Gestione eventi di Meta → Origini dati.
- Token di accesso dell'API Conversions: Gestione eventi → il tuo dataset → Impostazioni → API Conversions → Genera token di accesso.
- Codice evento di prova (facoltativo): compare nella scheda Eventi di prova e inizia con
TEST.
Come funziona la deduplicazione
| Inviato da | Nome evento | ID evento |
|---|---|---|
| Pixel nel browser | Lead |
fbq('track', 'Lead', {}, {eventID: 'abc123'}) |
| Server (CAPI) | Lead |
"event_id": "abc123" |
Quando da entrambi arrivano lo stesso nome e lo stesso ID, Meta ne tiene uno. Se gli ID sono diversi, o il nome è diverso (per esempio Lead e SubmitApplication), il contatto viene contato due volte. Genera un unico ID nel browser al momento dell'invio e passalo a entrambi.
Cosa inserire nell'evento lato server
event_name(Lead),event_time,event_id,action_source: "website",event_source_urluser_data- inviati così come sono:
client_ip_address,client_user_agent,fbc(cookie dell'ID clic),fbp(cookie dell'ID browser) - con hash SHA-256: telefono (
ph, cifre con prefisso internazionale, es. 821012345678), email (em, in minuscolo), nome
- inviati così come sono:
Più identificatori migliorano la qualità della corrispondenza degli eventi, ma prima sistema il consenso.
Consenso: i dati con hash restano dati personali
Secondo il Personal Information Protection Act coreano (e la maggior parte delle leggi sulla privacy), applicare un hash a un numero di telefono non lo rende anonimo, e Meta è un destinatario estero. Una configurazione sicura:
- Aggiungi un consenso separato e facoltativo per il "trasferimento all'estero per la misurazione pubblicitaria": destinatario (Meta Platforms), paese, dati, finalità, conservazione.
- Includi i recapiti con hash solo per chi ha acconsentito.
- Per tutti gli altri, invia l'evento solo con IP, user agent e ID dei clic.
- Non inviare mai informazioni sanitarie come i sintomi.
Vedi testo di consenso per i moduli di contatto in Corea oppure generalo con lo strumento gratuito per il consenso.
Verifica
- Aggiungi il codice evento di prova e invia un contatto di prova.
- In Eventi di prova dovresti vedere un evento Browser e uno Server, uno dei quali segnato come deduplicato.
- Rimuovi il codice di prova prima di andare online.
Rimanda indietro gli esiti
Quando un contatto diventa una consulenza o una vendita, invia un evento personalizzato lato server con gli stessi identificatori con hash (o un ID esterno). Meta potrà così imparare quali persone vanno oltre la compilazione del modulo.
Con CutLanding
Incolla l'ID del Pixel e il token di accesso in Impostazioni → Collegamenti. Dopo il salvataggio di un contatto, gli eventi del Pixel e del server partono con lo stesso ID, i recapiti con hash vengono aggiunti solo per chi ha dato il consenso alla misurazione pubblicitaria, i dati sanitari non vengono mai inviati e gli invii falliti vengono ritentati per 24 ore.
FAQ
Posso rimuovere il Pixel e usare solo l'API Conversions?
Meta consiglia di usarli entrambi con la deduplicazione. I dati del browser (cookie fbp e fbc) aiutano la corrispondenza, e se una delle due parti fallisce l'altra registra comunque il contatto.
I miei contatti vengono contati due volte. Perché?
I nomi o gli ID degli eventi sono diversi tra Pixel e server. Usa un unico ID per invio su entrambi i lati e lo stesso nome evento.
E se il mio token di accesso viene divulgato?
Genera un nuovo token in Gestione eventi e sostituiscilo ovunque sia usato. Conserva il token solo sul server, mai nell'HTML della pagina.