Test degli Eventi Facebook Pixel e CAPI in PrestaShop
Introduzione
Testare i tuoi eventi Facebook Pixel e API di Conversioni (CAPI) è fondamentale per garantire un corretto tracciamento degli eventi e la deduplicazione nel tuo negozio PrestaShop. Questa guida ti mostrerà due metodi:
- Utilizzare l'Estensione Pixel Helper di Google Chrome per verificare gli eventi del browser.
- Utilizzare la Funzione di Registrazione di PrestaShop all'interno della sezione CAPI del modulo Pixel Plus per registrare gli eventi lato server.
Seguendo questa guida, puoi confermare che:
✅ Gli eventi si attivano correttamente nel browser. ✅ Gli eventi lato server vengono registrati ed elaborati. ✅ La deduplicazione funziona come previsto.
Passo 1: Installare l'Estensione Facebook Pixel Helper
Per testare gli eventi del browser, devi installare Meta Pixel Helper, un'estensione di Google Chrome.
Istruzioni di Installazione:
- Apri Google Chrome.
- Visita l'estensione Meta Pixel Helper.
- Fai clic su "Aggiungi a Chrome", poi su "Aggiungi estensione".
- Una volta installata, vedrai l'icona di Pixel Helper nella barra degli strumenti di Chrome.
💡 Suggerimento: Se non vedi l'icona di Pixel Helper, fai clic sul menu delle estensioni (icona del puzzle) e fissala.
Passo 2: Abilitare la Registrazione degli Eventi CAPI in PrestaShop
Per verificare gli eventi lato server (CAPI), utilizza la funzione di registrazione nel modulo Pixel Plus.
Come Abilitare la Registrazione CAPI:
- Vai al Back Office di PrestaShop.
- Naviga su Moduli > Pixel Plus > Impostazioni API di Conversioni.
- Trova l'opzione "Abilita Registrazione Eventi."
- Impostala su "Sì".
- (Consigliato) Limita la Registrazione al Tuo IP:
- Individua il campo "Limita Registrazione a IP Specifici".
- Fai clic su "Aggiungi il Mio IP" per aggiungere automaticamente il tuo indirizzo IP.
- Questo garantisce che i log vengano salvati solo per i tuoi test, evitando la raccolta di dati non necessari.
- Salva la configurazione.
Funzionalità di Registrazione Aggiuntive:
- Visualizza Eventi Registrati in PrestaShop: Una volta abilitati, gli eventi verranno memorizzati nella sezione log di PrestaShop, aiutandoti ad analizzare cosa viene inviato a Facebook.
- Campi Chiave da Verificare:
events_received→ Indica quanti eventi Facebook ha ricevuto con successo.fbtrace→ Un token di tracciamento univoco di Facebook. Questo conferma che Facebook ha elaborato l'evento.
🛑 Se questi campi mancano nei log, Facebook non sta ricevendo i tuoi eventi! Ricontrolla le tue impostazioni CAPI.
Passo 3: Iniziare a Generare Eventi
Ora che l'estensione Pixel Helper è installata e la registrazione CAPI è abilitata, segui questi passaggi per testare i tuoi eventi Pixel basati sul browser.
- Apri il tuo negozio PrestaShop in Chrome.
- Fai clic sull'icona di Pixel Helper nella barra degli strumenti.
- Il Pixel Helper mostrerà tutti gli eventi Facebook Pixel attivati sulla pagina.
- Fai clic su ogni evento per verificare:
- Nome dell'Evento (es.,
PageView,AddToCart,Purchase). - ID Pixel (Dovrebbe corrispondere a quello configurato nel modulo Pixel Plus).
- Avvisi o errori (se presenti).
- Nome dell'Evento (es.,
📌 Espandi i Dettagli dell'Evento per Maggiori Informazioni
Fai clic sul triangolo nero (▸) accanto a un evento per espandere i suoi dettagli. Questo rivela:
- ID Evento (usato per la deduplicazione con gli eventi CAPI).
- Parametri dati utente (es., email, numero di telefono, hash per la privacy).
- Parametri personalizzati (es., ID prodotto, prezzo).
- Diagnostica (avvisi su parametri mancanti o mal configurati).
⚠️ Problema Comune: Se Pixel Helper non mostra eventi, assicurati che:
- L'ID del Facebook Pixel sia configurato correttamente.
- Nessun ad blocker stia bloccando lo script.
- Il Pixel si attivi sulla pagina.
- Il modulo non sia bloccato da un modulo/sistema di gestione del consenso
🛑 Suggerimento per la Risoluzione dei Problemi: Se gli eventi scompaiono dopo poco tempo, prova ad attivare un evento, passare a un'altra scheda, e poi ricontrollare il log di Pixel Helper.
Passo 4: Verificare se Facebook ha Ricevuto l'Evento (CAPI)
Facebook fornisce parametri di conferma che indicano se l'evento è stato ricevuto.
📌 Campi Importanti da Verificare nei Log di PrestaShop
events_received→ Indica quanti eventi Facebook ha ricevuto.fbtrace→ Un token di tracciamento univoco di Facebook che conferma l'elaborazione dell'evento.
⚠️ Se
events_receivedmanca:
- Multi-cURL potrebbe causare problemi.
- Disabilita multi-cURL all'interno delle opzioni CAPI (ultima opzione nelle impostazioni).
- Salva le modifiche e riprova ad inviare gli eventi.
Passo 5: Confrontare gli Eventi del Browser e del Server per la Deduplicazione
Ora che Pixel Helper (browser) e log CAPI (server) sono attivi, confronta i risultati.
✅ Cosa Cercare:
- Lo stesso evento (es.,
Purchase) dovrebbe apparire in entrambi:- Pixel Helper (browser)
- Log CAPI (server)
Questo porterà alla deduplicazione degli eventi, il che significa che solo l'evento più significativo verrà mantenuto da Facebook. Affinché ciò avvenga, è necessario che:
- L'ID Evento in Pixel Helper e nei log CAPI corrispondano.
Come Verificare la Deduplicazione:
- Apri Pixel Helper ed espandi i dettagli dell'evento.
- Cerca l'ID Evento.
- Apri i log CAPI di PrestaShop e trova lo stesso evento.
- Confronta l'ID Evento in entrambi i luoghi.
- Se corrispondono, Facebook deduplicherà l'evento e ottimizzerà in base alla fonte più affidabile.
⚠️ Pixel Helper Potrebbe Nascondere gli Eventi nel Tempo! Se l'evento scompare:
- Attiva nuovamente l'evento (es., aggiungi un prodotto al carrello).
- Passa a un'altra scheda.
- Torna a Pixel Helper per verificare se i log degli eventi sono ancora disponibili.
Conclusione
Seguendo questa guida, puoi testare e debuggare i tuoi eventi Facebook Pixel e API di Conversioni in PrestaShop.
Cosa Hai Ottenuto:
✔ Verificato che gli eventi del browser si attivino utilizzando Pixel Helper. ✔ Abilitato la registrazione degli eventi CAPI e limitata al tuo IP. ✔ Confrontato gli eventi del browser e del server per confermare la deduplicazione.
🚀 Prossimo Passo: Se riscontri ancora problemi, verifica gli Strumenti di Debug di Facebook o rivedi le configurazioni CAPI e Pixel all'interno del modulo Pixel Plus.
Per maggiori dettagli, visita la Guida Ufficiale al Debug degli Eventi di Facebook.
Cos'è Meta Pixel Helper e come usarlo per verificare gli eventi Facebook?
Meta Pixel Helper è un'estensione Chrome che mostra in tempo reale gli eventi inviati dal Facebook Pixel dal browser. Installala dal Chrome Web Store, visita il tuo negozio e vedrai gli eventi che si attivano con i loro parametri, come il tipo di evento, l'ID del prodotto e il valore.
Come attivo la registrazione degli eventi CAPI in Pixel Plus?
Vai nel Back Office di PrestaShop, accedi a Pixel Plus e cerca la sezione CAPI. Attiva l'opzione di registrazione degli eventi e, per maggiore sicurezza, clicca su Aggiungi il Mio IP per restringere i log alla tua sessione attuale. Questo ti permette di vedere tutti gli eventi lato server inviati dal modulo.
Come verifico la deduplicazione tra eventi browser e server?
Apri Pixel Helper ed espandi i dettagli di un evento per vedere il suo ID Evento. Poi apri i log CAPI di Pixel Plus e cerca lo stesso evento. Se entrambi hanno lo stesso ID Evento, Facebook li deduplicherà correttamente e non conterà lo stesso evento due volte.
Perché gli eventi scompaiono in Pixel Helper dopo un po' di tempo?
Pixel Helper può nascondere gli eventi più vecchi man mano che si accumulano nuovi. Se un evento scompare, attivalo di nuovo (ad esempio, aggiungi un prodotto al carrello), passa a un'altra scheda e torna a Pixel Helper per vedere se il registro è ancora disponibile.
Qual è la differenza tra testare con Pixel Helper e con Events Manager?
Pixel Helper mostra solo gli eventi del browser in tempo reale ed è utile per verifiche rapide. Events Manager con Test Events mostra sia gli eventi del browser che quelli del server CAPI, ed è più completo per verificare la deduplicazione e gli eventi complessi che non sempre appaiono in Pixel Helper.