Passa al contenuto principale

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:

  1. Utilizzare l'Estensione Pixel Helper di Google Chrome per verificare gli eventi del browser.
  2. 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:​

  1. Apri Google Chrome.
  2. Visita l'estensione Meta Pixel Helper.
  3. Fai clic su "Aggiungi a Chrome", poi su "Aggiungi estensione".
  4. 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:​

  1. Vai al Back Office di PrestaShop.
  2. Naviga su Moduli > Pixel Plus > Impostazioni API di Conversioni.
  3. Trova l'opzione "Abilita Registrazione Eventi."
  4. Impostala su "Sì".
  5. (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.
  6. 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.

  1. Apri il tuo negozio PrestaShop in Chrome.
  2. Fai clic sull'icona di Pixel Helper nella barra degli strumenti.
  3. Il Pixel Helper mostrerà tutti gli eventi Facebook Pixel attivati sulla pagina.
  4. 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).

📌 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_received manca:

  • 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:​

  1. Apri Pixel Helper ed espandi i dettagli dell'evento.
  2. Cerca l'ID Evento.
  3. Apri i log CAPI di PrestaShop e trova lo stesso evento.
  4. Confronta l'ID Evento in entrambi i luoghi.
  5. 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.