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.

Team TourlyAggiornato il 7 min di lettura

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.

La API non sostituisce il pixel

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

Passo 1 di 3Su Meta e in Tourly

Collega il pixel

  1. Apri Gestione eventi → Origini dati

    Scegli il pixel del tuo sito, o creane uno se non ce l'hai.

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

  3. 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ù.

EventoQuando parteDa dove
PageViewSi apre una paginaSolo 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
ViewContentIl cliente apre un tourSito generato, Scheda tour, widget. Col tour come prodotto (content_ids = il tour) e il prezzo «da»
AddToCartHa scelto data, orario e partecipantiIl widget che fa pagare in pagina («Widget classico»), col totale a schermo
InitiateCheckoutÈ arrivato al pagamentoIl widget, con l'importo calcolato dal nostro server; il checkout, all'apertura e senza importo (i partecipanti non sono ancora scelti)
PurchaseIl pagamento è riuscito, o la prenotazione «paga in sede» è confermataOvunque, con valore, valuta e numero d'ordine. È l'unico che mandiamo anche dai nostri server
Il tuo sito manda già ViewContent? Diccelo

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'è.

Passo 2 di 3Su Meta e in Tourly

Collega la Conversions API

La card compare nella stessa scheda Meta, sotto il pixel: senza pixel non avrebbe dove mandare niente.

  1. In Gestione eventi apri il tuo pixel → Impostazioni

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

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

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

Il codice eventi di test va tolto prima di andare in onda

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

ChiQuandoCosa ha in più
Il browser del clienteSubito dopo il pagamentoIP, user-agent e i cookie _fbp/_fbc veri. Passa dalla nostra origine, quindi gli ad-blocker non la vedono
I nostri server90 secondi dopo la confermaNiente: è 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 consenso comanda anche sul canale dal server

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.

Passo 3 di 3Su Meta e in Tourly

Verifica che funzioni davvero

  1. Fai una prenotazione di prova con il consenso accettato

    Un tour «paga in sede» basta.

  2. In Gestione eventi apri Panoramica e guarda Purchase

    Deve comparire una volta sola. Sotto trovi anche la voce della deduplicazione, che conferma che pixel e server stanno parlando dello stesso acquisto.

  3. Nel pannello, controlla «ultimo evento» e «ultimo errore»

    Sono due righe apposta: «collegata e ferma» e «collegata e rotta» altrimenti si assomigliano troppo.

Pixel e Conversions API sono collegati.

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.