Meta Pixel e Conversions API: le vendite che il browser non riesce a dichiarare
Ad-blocker, iOS e schede chiuse: una parte delle vendite a Meta non arriva mai. Come collegare il pixel e il canale dal server che le recupera.
Il pixel di Meta vive nel browser del cliente, e nel browser del cliente succede di tutto: un'estensione blocca connect.facebook.net, Safari accorcia i cookie, qualcuno chiude la scheda mentre la banca chiede la conferma del pagamento. Ogni volta è una vendita vera che Meta non vede, e una campagna che sembra non rendere.
La Conversions API dichiara lo stesso acquisto dai nostri server, che un browser da cui dipendere non ce l'hanno. Questo tutorial collega entrambi, che è la configurazione giusta — non una al posto dell'altra.
È il pixel a creare il cookie _fbp, cioè il segnale con cui Meta riconosce la persona. Togliendolo sembrerebbe tutto più pulito e invece resterebbero solo l'email in hash e l'identificativo del clic. I due mandano lo stesso acquisto con lo stesso identificativo e Meta tiene il primo che arriva: è la configurazione ridondante che Meta stessa raccomanda.
Collega il pixel
Apri Gestione eventi →
Origini datiScegli il pixel del tuo sito, o creane uno se non ce l'hai.
Copia l'ID del pixel
Sono solo cifre, quindici o sedici. Se quello che hai copiato contiene lettere, hai preso il nome o l'ID dell'account pubblicitario.
Incollalo in
Impostazioni → Pixel conversioni, scheda Meta«Configura», incolla, salva. Da quel momento montiamo il pixel sul sito che ti generiamo, sulla Scheda tour, sulla Vetrina, sul checkout e dentro il widget — dove si carica solo al primo evento, e solo se il cliente ha accettato i cookie.
Gli eventi che mandiamo
Non solo l'acquisto. Meta impara a trovare clienti sull'evento che le chiedi di ottimizzare, e per farlo bene ne vuole circa 50 a settimana: con 20 prenotazioni a settimana il solo Purchase non ci arriva mai, e la campagna resta «in apprendimento». Per questo mandiamo anche i passi prima dell'acquisto, che sono molti di più.
| Evento | Quando parte | Da dove |
|---|---|---|
PageView | Si apre una pagina | Solo dalle pagine di Tourly aperte da sole: sito generato, Scheda tour, Vetrina, checkout. Mai dal widget incollato sul tuo sito: la visita l'ha già contata il tuo sito |
ViewContent | Il cliente apre un tour | Sito generato, Scheda tour, widget. Col tour come prodotto (content_ids = il tour) e il prezzo «da» |
AddToCart | Ha scelto data, orario e partecipanti | Il widget che fa pagare in pagina («Widget classico»), col totale a schermo |
InitiateCheckout | È arrivato al pagamento | Il widget, con l'importo calcolato dal nostro server; il checkout, all'apertura e senza importo (i partecipanti non sono ancora scelti) |
Purchase | Il pagamento è riuscito, o la prenotazione «paga in sede» è confermata | Ovunque, con valore, valuta e numero d'ordine. È l'unico che mandiamo anche dai nostri server |
Shopify, e molti temi con le schede prodotto, mandano ViewContent da soli quando il cliente apre la pagina del tour. Se lì sotto c'è anche il nostro widget, Meta riceverebbe lo stesso sguardo due volte. Nella scheda Meta di Pixel conversioni accendi «Il mio sito manda già ViewContent»: il widget incollato sul tuo sito smette di mandarlo. Scheda tour, Vetrina e sito generato aperti da soli continuano, perché lì il tuo sito non c'è.
Collega la Conversions API
La card compare nella stessa scheda Meta, sotto il pixel: senza pixel non avrebbe dove mandare niente.
In Gestione eventi apri il tuo pixel →
ImpostazioniScorri fino alla sezione Conversions API e premi Genera token di accesso.
Se non vedi la voce, ti mancano i permessi sul pixel: serve il ruolo di amministratore sull'asset, non solo sulla pagina.
Copia il token e incollalo in Tourly
Premi Collega. Il token si salva cifrato e non è più rileggibile: il pannello ti dirà «collegata», non *cosa* hai incollato.
È un segreto vero: chi ce l'ha può scrivere eventi sul tuo pixel. Non passarlo via email e non lasciarlo in un foglio condiviso.
Premi «Prova la connessione»
Legge il tuo pixel con quel token: nessun acquisto finto finisce nei tuoi dati. Se Meta risponde male, il messaggio è il suo, parola per parola.
Se lasci pieno il campo «codice eventi di test», gli acquisti veri finiscono in «Eventi di test» — cioè fuori dalle statistiche su cui Meta decide dove spendere il tuo budget — e tutto continua a dire «collegata». Finché c'è, il pannello tiene acceso un avviso. Toglilo appena hai finito di provare: si rimuove da solo, senza rigenerare il token.
Chi manda cosa, e in che ordine
| Chi | Quando | Cosa ha in più |
|---|---|---|
| Il browser del cliente | Subito dopo il pagamento | IP, user-agent e i cookie _fbp/_fbc veri. Passa dalla nostra origine, quindi gli ad-blocker non la vedono |
| I nostri server | 90 secondi dopo la conferma | Niente: è la rete di sicurezza per chi ha chiuso la scheda |
Il ritardo di 90 secondi serve a perdere la gara apposta: partendo subito, il server vincerebbe quasi sempre e manderebbe a Meta la versione peggiore dello stesso acquisto, quella senza IP e senza cookie. Chi arriva secondo trova il posto già preso e si ferma: l'acquisto resta uno.
Cosa arriva a Meta (e cosa non conserviamo)
- L'acquisto: valore in euro, valuta, numero d'ordine, tour comprato.
- Email, telefono, nome e cognome del cliente in SHA-256, mai in chiaro: è la forma che Meta usa per riconoscere la persona senza ricevere il dato.
- IP e user-agent, che Meta vuole grezzi: entrano nella chiamata, finiscono nel messaggio e muoiono lì. Non li scriviamo da nessuna parte — la prenotazione salva «iPhone · Safari», non l'impronta del dispositivo.
Il pixel non parte senza un sì, e un canale dal server che mandasse lo stesso trasformerebbe il banner in un teatrino. La risposta del cliente si registra al momento del checkout, quando è ancora sotto i suoi occhi: se manca, non parte niente e l'esito lo dice.
Verifica che funzioni davvero
Fai una prenotazione di prova con il consenso accettato
Un tour «paga in sede» basta.
In Gestione eventi apri
Panoramicae guardaPurchaseDeve comparire una volta sola. Sotto trovi anche la voce della deduplicazione, che conferma che pixel e server stanno parlando dello stesso acquisto.
Nel pannello, controlla «ultimo evento» e «ultimo errore»
Sono due righe apposta: «collegata e ferma» e «collegata e rotta» altrimenti si assomigliano troppo.
Le vendite arrivano a Meta dal browser e dal server, e Meta le conta una volta sola.
Domande frequenti
Sale da sola col volume: ogni acquisto porta email, telefono e nome in hash più i cookie del browser. Il salto più grande lo fa il pixel — se è in pausa o bloccato, alla API resta poco con cui lavorare.
No, si ferma anche quella. È la superficie che nessuno ispeziona: un pixel «in pausa» che continuasse a mandare acquisti dai nostri server sarebbe invisibile finché non apri Gestione eventi.
I token della Conversions API sono di lunga durata, ma decadono se rigeneri il pixel o se cambiano i permessi dell'asset. In quel caso Meta risponde con un errore e lo trovi scritto nel pannello, sotto «ultimo errore».
No. Quello continua a misurare le tue pagine: noi aggiungiamo quello che dalla tua pagina non si vede — la scelta della data, l'arrivo al pagamento, l'acquisto. L'unico doppione possibile è ViewContent, e si spegne con l'interruttore qui sopra.
Perché lì un evento perso non costa niente. La Conversions API serve a non perdere le vendite quando un ad-blocker ferma il pixel; per gli sguardi e le scelte, qualche evento in meno non sposta l'ottimizzazione, mentre mandarli dal server vorrebbe dire una chiamata a Meta per ogni apertura del widget.
Su Purchase appena arrivi a una cinquantina di acquisti a settimana fra tutte le campagne. Prima, InitiateCheckout è il compromesso migliore: è vicino alla vendita e capita abbastanza spesso da far imparare Meta.