Passa al contenuto principale

Test di Eventi Facebook Pixel e CAPI tramite Facebook Events Manager

Introduzione​

Testare i tuoi eventi Facebook Pixel e Conversion API (CAPI) utilizzando lo strumento Test Events in Events Manager è un modo efficace per validare che il tuo negozio PrestaShop stia inviando correttamente sia gli eventi browser che quelli lato server (CAPI).

Questo metodo è particolarmente utile per testare eventi complessi che potrebbero non apparire sempre in Pixel Helper, come:

  • Initiate Checkout
  • Add Payment Info
  • Ritardi nel Tracciamento dell'Evento Purchase

Questa guida ti accompagnerà passo dopo passo nel processo per abilitare la modalità test e analizzare gli eventi nello strumento Test Events di Meta.

Passo 1: Ottenere il Codice Evento di Test da Events Manager​

Per iniziare il test, devi prima recuperare il Codice Evento di Test dall'Events Manager di Facebook.

📌 Come Ottenere il Codice di Test​

  1. Vai su Meta Business Suite: Accedi a Meta Business Manager.
  2. Apri Events Manager: Naviga su Events Manager.
  3. Seleziona il Tuo Pixel: Scegli il Pixel ID utilizzato nel tuo negozio PrestaShop.
  4. Vai alla Scheda "Test Events": Clicca sulla sezione Test Events.
  5. Copia il Codice Evento di Test:
    • Vedrai un codice di test unico, solitamente formattato come TESTXXXXXXXXXX (dove XXXXXXXXXX è un numero casuale).
    • Clicca su Copia.

📌 Nota: Questo codice è temporaneo e funziona solo mentre lo strumento Test Events è aperto.

Passo 2: Abilitare la Modalità Test nel Modulo Pixel Plus​

Ora che hai il Codice Evento di Test, devi inserirlo nel modulo Pixel Plus per PrestaShop.

📌 Come Abilitare la Modalità Test nel Modulo​

  1. Vai al Back Office di PrestaShop.
  2. Naviga su Moduli > Pixel Plus > Impostazioni Conversion API (CAPI).
  3. Trova il Campo Test Events:
    • Scorri verso il basso per trovare un'impostazione etichettata "Test Events Code" (o simile).
    • Incolla il Codice Evento di Test che hai copiato da Events Manager.
  4. Limita il Test al Tuo IP:
    • Individua il riquadro "Limita Registrazione a IP Specifici".
    • Clicca su "Aggiungi il Mio IP" per aggiungere automaticamente il tuo indirizzo IP corrente.
    • Questo assicura che solo le tue azioni vengano registrate, evitando dati non necessari.
  5. Abilita la Modalità Test nel Modulo:
    • Sotto il riquadro IP, trova l'opzione che permette di abilitare la modalità test.
    • Impostala su "Sì" per attivare la registrazione degli eventi di test.
  6. Clicca su Salva per applicare le modifiche.

🔍 Perché Limitare il Test al Tuo IP?

  • Previene che i log degli eventi vengano inondati da azioni di clienti reali.
  • Assicura che solo le tue azioni vengano registrate per l'analisi.

Passo 3: Attivare Eventi di Test dal Tuo Negozio​

Ora che la Modalità Test è abilitata, è il momento di simulare azioni del cliente sul tuo negozio PrestaShop.

📌 Come Aprire il Tuo Negozio in Modalità Test​

  1. Torna su Events Manager in Meta Business Suite.
  2. Cerca l'URL Test Events:
    • Meta suggerirà il dominio del tuo negozio (es., https://tuonegozio.com).
    • Clicca sull'URL del tuo negozio.
  3. Si Aprirà una Nuova Scheda: Questa scheda è ora collegata allo strumento Test Events.
  4. Esegui Azioni sul Tuo Negozio:
    • Visualizza un prodotto.
    • Aggiungi un prodotto al carrello.
    • Inizia il processo di checkout.
    • Simula un acquisto.

Passo 4: Analizzare gli Eventi in Events Manager​

Una volta eseguite le azioni sul tuo negozio PrestaShop, torna su Events Manager per analizzare i dati in arrivo.

📌 Come Appaiono gli Eventi nello Strumento di Test​

  • Eventi Browser (basati su Pixel) → Appaiono quasi istantaneamente.
  • Eventi Server (basati su CAPI) → Impiegano alcuni secondi fino a un minuto per apparire.

Identificare Eventi Deduplicati​

Facebook raggruppa automaticamente eventi browser e server corrispondenti insieme. Puoi facilmente identificare:

  • Evento Browser (inviato tramite Pixel).
  • Evento Server (inviato tramite CAPI).
  • Event ID (usato per la deduplicazione).

Controllo dei Dati Aggiuntivi​

Clicca su un evento per espandere i dettagli. Vedrai:

  • Event ID → Assicura che le versioni browser e server siano correttamente collegate.
  • User Data → Dettagli hashati inviati per un miglior tracciamento.
  • Custom Parameters → Esempio: ID prodotto, prezzo, categoria.

Passo 4: Verificare se Facebook ha Ricevuto l'Evento tramite CAPI​

Dopo un po' di tempo, dovresti vedere l'evento da due fonti, il pixel e il server. Se il secondo non appare nemmeno dopo aver aspettato alcuni minuti, un'impostazione di prestazioni nel modulo potrebbe essere il "colpevole".

Il modulo utilizza un nuovo sistema per inviare gli eventi in modo asincrono. Questo sistema funziona bene nel 95% dei server, ma in alcuni gli eventi non passano.

Se non vedi l'evento in Events Manager, c'è un'alta probabilità che questa impostazione ti stia influenzando. Per disabilitarne l'uso ti serve solo un minuto.

Disattivare Multi-cURL​

  • Vai alla pagina di configurazione del modulo.
  • Apri la sezione CAPI e scorri fino alla fine.
  • Abilita l'opzione per disabilitare l'uso di multi-cURL.
  • Salva le modifiche e riprova a inviare gli eventi.

Passo 5: Confermare che gli Eventi sono Inviati da Pixel Plus​

Quando controlli qualsiasi evento (browser o server), Pixel Plus include sempre un parametro specifico:

"event_trigger": "Pixel Plus"

✅ Se vedi il campo event_trigger: "Pixel Plus" nei dettagli dell'evento, conferma che l'evento è stato attivato dal modulo Pixel Plus.

Se questo campo manca, è possibile che:

  • Un altro modulo
  • Codice JavaScript manuale (es., chiamate fbq())
  • Tag manager come GTM

stiano inviando eventi in modo indipendente.

Questo controllo è fondamentale per evitare tracciamenti duplicati e garantire dati puliti.

Aiuta anche a identificare eventi potenzialmente duplicati o eventi inviati da fonti esterne che possono causare problemi con il tracciamento. Consulta la nostra guida Rilevare Fonti Esterne che Inviano Eventi per maggiori informazioni.

Passo 6: Alcuni Eventi Sono Visibili Solo nello Strumento Test Events​

Alcuni eventi — come "Initiate Checkout" e "Add Payment Info" — potrebbero non apparire sempre in Meta Pixel Helper.

Questo accade perché:

  • Sono attivati lato server (tramite CAPI).
  • Alcuni browser o impostazioni di privacy bloccano il tracciamento lato client.

✅ Tuttavia, questi eventi appariranno correttamente nello strumento Test Events dentro Facebook Events Manager.

🔍 Importante: Se non vedi un evento in Pixel Helper, controlla sempre lo strumento Test Events prima di presumere che ci sia qualcosa di sbagliato.

Passo 7: Cosa Fare se Non Appaiono Eventi Server​

Se, dopo aver eseguito azioni sul tuo negozio, non vedi alcun evento lato server apparire nello strumento Test Events, segui questi passaggi per risolvere il problema:

📋 Checklist da Rivedere​

  1. Controlla la tua configurazione Pixel Plus:

    • Assicurati che il Codice di Test sia correttamente incollato nel campo "Test Events Code".
    • Conferma che "Abilita Eventi Codice di Test" sia impostato su Sì.

  2. Assicurati di aver salvato la configurazione:

    • Dopo aver incollato il codice e abilitato l'opzione, clicca sempre su Salva per applicare le modifiche.

  3. Verifica le Impostazioni di Restrizione IP:

    • Se hai aggiunto il tuo IP sotto "Limita Test per IP", conferma che sia correttamente rilevato.
    • Questa restrizione aiuta a evitare di mescolare i tuoi test con il traffico dei clienti.

  4. Considera le Differenze tra IP Server e IP Utente:

    • In alcune configurazioni (es., reverse proxy, load balancer, Cloudflare), l'indirizzo IP che Facebook vede potrebbe non corrispondere al tuo IP reale.
    • Se sospetti che sia questo il caso:
      • Disabilita temporaneamente la restrizione IP.
      • Esegui il tuo test rapidamente.
      • Tieni presente che senza restrizione, eventi esterni aggiuntivi potrebbero apparire nel log.

🚨 Importante: Disabilita la restrizione IP solo temporaneamente durante il test. Riabilitala dopo per mantenere dati di test puliti.

📈 Perché gli Eventi Server Potrebbero Mancare​

Se mancano gli eventi server, di solito significa:

  • La Modalità Test non è stata completamente attivata.
  • Il Codice di Test mancava o non è stato salvato correttamente.
  • La restrizione IP stava impedendo la registrazione dell'evento.

Dopo aver corretto le impostazioni, ripeti le azioni sul negozio (es., visualizzare un prodotto, aggiungere al carrello, iniziare il checkout) e controlla nuovamente nello strumento Test Events.

Conclusione​

Seguendo questa guida, puoi testare e debuggare eventi Facebook Pixel e CAPI in PrestaShop utilizzando lo Strumento Test Events di Events Manager.

🎯 Cosa Hai Ottenuto:​

✔ Recuperato il Codice Evento di Test da Facebook ✔ Abilitato la Modalità Test nel modulo Pixel Plus ✔ Aperto il tuo negozio PrestaShop in modalità test ✔ Verificato gli eventi nello strumento Test Events di Facebook ✔ Confermato che gli eventi sono correttamente attribuiti a Pixel Plus ✔ Confrontato eventi browser e server per la deduplicazione ✔ Identificato eventi difficili da tracciare oltre il rilevamento di Pixel Helper

🚀 Suggerimento Finale: Ricorda di disabilitare l'opzione codice di test dopo aver completato i tuoi test per evitare falsi positivi o avvisi fuorvianti di Facebook.

📘 Risorse Correlate​