Test degli Eventi Purchase e Risoluzione dei Problemi in PrestaShop
Introduzione
Assicurarsi che l'evento Purchase di Facebook sia correttamente tracciato nel tuo negozio PrestaShop è fondamentale per report di vendita accurati e ottimizzazione degli annunci. Questa guida ti mostrerà:
✅ Testare l'evento Purchase utilizzando Pixel Helper e la registrazione CAPI di PrestaShop. ✅ Verificare la deduplicazione tra eventi del browser e del server. ✅ Risolvere eventi Purchase mancanti per metodi di pagamento specifici.
Passo 1: Installare Meta Pixel Helper per Google Chrome
Per analizzare gli eventi del browser, devi installare Meta Pixel Helper, un'estensione di Chrome.
📌 Come Installare Pixel Helper
- Apri Google Chrome.
- Vai all'Estensione Meta Pixel Helper.
- Fai clic su "Aggiungi a Chrome", poi su "Aggiungi estensione".
- L'icona di Pixel Helper apparirà nella tua barra degli strumenti di Chrome.
💡 Suggerimento: Se l'icona di Pixel Helper non appare, vai al menu delle estensioni (icona del puzzle) e fissala.
Passo 2: Abilitare la Registrazione nel Modulo Pixel Plus
Per analizzare gli eventi lato server (CAPI), devi abilitare la registrazione degli eventi all'interno del modulo Pixel Plus.
📌 Come Abilitare la Registrazione in PrestaShop
- Vai al Back Office di PrestaShop.
- Naviga su Moduli > Pixel Plus > Impostazioni API di Conversioni.
- Scorri fino alla Sezione Registrazione.
- Aggiungi il Tuo Indirizzo IP:
- Individua il campo "Limita Registrazione a IP Specifici".
- Fai clic su "Aggiungi il Mio IP" per registrare automaticamente il tuo IP attuale.
- Abilita la Registrazione degli Eventi:
- Attiva l'impostazione etichettata come "Registra eventi nel log di PrestaShop."
- Salva le Modifiche.
Ora, sia gli eventi del browser (Pixel) che gli eventi del server (CAPI) verranno registrati, permettendoti di verificare se Facebook sta ricevendo l'evento Purchase.
Passo 3: Testare l'Evento Purchase per Ogni Metodo di Pagamento
Poiché alcuni metodi di pagamento potrebbero non attivare l'evento Purchase, testare ogni metodo individualmente garantisce una copertura completa del tracciamento.
📌 Come Testare un Metodo di Pagamento
- Crea un Acquisto di Test utilizzando uno dei tuoi metodi di pagamento.
- Verifica immediatamente il Pixel Helper:
- L'evento Purchase dovrebbe apparire.
- Fai clic sull'evento per espandere i dettagli.
- Assicurati che il parametro
event_trigger: 'Pixel Plus'sia presente. - Verifica l'event_id (questo aiuterà con le verifiche di deduplicazione più avanti).
- Apri la Sezione Log di PrestaShop:
- Nel Back Office, vai su Parametri Avanzati > Log / Registri.
- Cerca l'evento Purchase nei log.
- L'event_id dovrebbe corrispondere a quello del Pixel Helper.
⚠️ Suggerimento: Se l'event_trigger: Pixel Plus manca nell'evento, significa che l'evento non è stato attivato dal modulo Pixel Plus.
🛑 Problema: Nessun Evento Purchase nel Pixel Helper?
- Assicurati che il tracciamento Pixel sia abilitato nel modulo.
- Alcune pagine di pagamento (es., gateway basati su reindirizzamento) potrebbero impedire il tracciamento.
Passo 4: Verificare se Facebook ha Ricevuto l'Evento
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 l'evento di acquisto.
Passo 5: Verificare la Deduplicazione
Per assicurarti che la deduplicazione funzioni, verifica che lo stesso event_id appaia in entrambi:
- Pixel Helper (evento del browser).
- Log di PrestaShop (evento del server via CAPI).
✅ Se l'event_id corrisponde, Facebook deduplicherà l'evento, selezionando la versione più affidabile per il tracciamento.
Passo 6: Assicurarsi che Non Appaiano Acquisti Duplicati
Dopo aver ricaricato la pagina:
- Pixel Helper non dovrebbe più mostrare un evento Purchase.
- Nessun nuovo evento Purchase dovrebbe apparire nei log di PrestaShop.
Se appare un evento Purchase duplicato, Facebook potrebbe non deduplicare correttamente gli eventi.
🛑 Soluzione: Abilita i Cookie per la Deduplicazione
- Nelle impostazioni del modulo Pixel Plus, trova "Usa cookie per prevenire duplicati."
- Abilita questa opzione.
- Salva le impostazioni e riprova l'acquisto.
Passo 7: Risoluzione dei Problemi di Eventi Purchase Mancanti
✅ Scenario 1: Un Metodo di Pagamento Non Attiva l'Evento
Se uno dei tuoi metodi di pagamento non invia un evento Purchase, regola le impostazioni del modulo:
- Vai a Modulo Pixel Plus > Parametri Avanzati.
- Individua "Forza Modalità Base".
- Seleziona il Metodo di Pagamento che non è riuscito a inviare l'evento.
- Abilita l'opzione "Usa cookie per prevenire duplicati."
- Salva le impostazioni.
✅ Scenario 2: L'Evento Purchase Non Appare su Facebook
Se l'evento è registrato in PrestaShop ma non ricevuto da Facebook:
- Verifica
events_receivedefbtracenei log (Passo 4). - Verifica se multi-cURL è abilitato e prova a disabilitarlo (Passo 4).
- Ripeti il test di acquisto dopo aver salvato le modifiche.
✅ Scenario 3: Alcuni Eventi Sono Tracciati, ma Altri Mancano
Alcuni gateway di pagamento reindirizzano gli utenti fuori dal tuo negozio prima di riportarli. Questo può causare il fallimento degli eventi basati su Pixel.
- Soluzione: CAPI dovrebbe gestire questi casi, quindi assicurati che il tracciamento lato server sia abilitato.
Conclusione
Seguendo questa guida, puoi testare e risolvere i problemi dell'evento Purchase per ogni metodo di pagamento nel tuo negozio PrestaShop.
Cosa Hai Ottenuto:
✔ Verificato gli eventi Purchase utilizzando Pixel Helper.
✔ Abilitato la registrazione degli eventi del server e verificato i log in PrestaShop.
✔ Verificato la risposta di Facebook per events_received e fbtrace.
✔ Assicurato che la deduplicazione funzioni facendo corrispondere gli event_ids.
✔ Risolto eventi mancanti per metodi di pagamento specifici.
🚀 Prossimo Passo: Se un metodo di pagamento ancora non traccia correttamente, rivedi il suo flusso di checkout e assicurati che il tracciamento lato server sia abilitato.
Per ulteriore debug, visita la Guida Ufficiale al Debug di Facebook.