Passa al contenuto principale

Configurazione dell'API di Conversioni (CAPI) per PrestaShop

Introduzione​

L'API di Conversioni Facebook (CAPI) consente il tracciamento degli eventi server-to-server, garantendo che tutte le interazioni chiave dei clienti sul tuo negozio PrestaShop vengano acquisite con precisione, anche quando il tracciamento del browser è limitato. Questa guida spiega come configurare il modulo Pixel Plus per PrestaShop per inviare eventi utilizzando l'API di Conversioni.

Abilitare l'API di Conversioni​

Il primo passo per configurare l'API di Conversioni (CAPI) è abilitarla nel modulo Pixel Plus per PrestaShop.

  1. Naviga nelle impostazioni del modulo nel tuo back office PrestaShop.
  2. Individua l'opzione "Abilita API di Conversioni".
  3. Seleziona "Sì" per attivare CAPI.
  4. Salva la configurazione.

Nota: Se questa opzione è disabilitata, nessun evento verrà inviato tramite l'API di Conversioni Facebook, e tutto il tracciamento dipenderà esclusivamente dal Pixel di Facebook basato sul browser.

Aggiungere il Token di Accesso dell'API di Conversioni​

Come Ottenere il Token di Accesso Facebook​

Per inviare eventi tramite CAPI, Facebook richiede un Token di Accesso. Segui questi passaggi per ottenere il tuo token:

  1. Vai su Facebook Business Manager: Accedi a Facebook Business Manager.
  2. Apri Gestione Eventi: Naviga nella sezione Gestione Eventi.
  3. Seleziona il tuo Pixel: Scegli il Pixel che desideri configurare.
  4. Vai su Impostazioni: Scorri fino alla sezione API di Conversioni.
  5. Genera il Token di Accesso:
    • Fai clic sul link "Genera Token di Accesso".
    • Fai clic una volta per generare il token.
    • Fai clic di nuovo per copiare il token.
  6. Incolla il Token in PrestaShop:
    • Torna al tuo back office PrestaShop.
    • Nel modulo Pixel Plus, incolla il Token di Accesso nel campo corrispondente.
    • Salva la configurazione.

Importante: Se non viene fornito alcun token di accesso, gli eventi dell'API di Conversioni non verranno inviati.

Codice di Test per il Debug​

Facebook consente di testare gli eventi dell'API di Conversioni prima della messa in produzione. Lo strumento di test aiuta a verificare che gli eventi siano configurati correttamente.

Come Ottenere il Codice di Test Facebook:​

  1. Apri Gestione Eventi Facebook.
  2. Naviga nella sezione "Eventi di Test".
  3. Fai clic su "Codice di Test per l'API di Conversioni".
  4. Copia il Codice di Test generato.
  5. Incolla il Codice di Test nel modulo Pixel Plus sotto il campo "Codice di Test".
  6. Salva la configurazione.

Per disabilitare la modalità test, lascia il campo vuoto.

Promemoria: Questo codice è solo per scopi di test e deve essere rimosso prima della messa in produzione.

Opzioni di Corrispondenza Avanzata​

La funzionalità di Corrispondenza Avanzata migliora il tracciamento degli eventi aiutando Facebook a far corrispondere con precisione le interazioni degli utenti. Aiuta a prevenire eventi duplicati quando si utilizzano sia il Pixel di Facebook che l'API di Conversioni.

Come Funziona:​

  • Quando abilitata, gli eventi del Pixel di Facebook e CAPI vengono abbinati utilizzando dati hash aggiuntivi.
  • Questo riduce il tracciamento di eventi duplicati e migliora l'accuratezza dei report.
  • Raccomandato per i negozi PrestaShop che eseguono più configurazioni di tracciamento.

Considerazioni sulla Privacy:​

  • Se abilitata, menzionalo nella tua Informativa sulla Privacy per conformarti alle normative sui dati.

Scegliere i Dati per la Corrispondenza Avanzata​

Il modulo Pixel Plus per PrestaShop ti consente di specificare quali dati utente devono essere inviati a Facebook per la Corrispondenza Avanzata.

Opzioni di Dati Disponibili:​

✔ Dati di Contatto dell'Utente (Email, Telefono) ✔ Dati Personali dell'Utente (Nome, Cognome, Genere, Data di nascita) ✔ Dati di Indirizzo dell'Utente (Città, Stato, Paese, CAP)

Come Configurare in PrestaShop:

  1. Nelle impostazioni del modulo Pixel Plus, individua la sezione "Dati Opzioni Avanzate".
  2. Seleziona i tipi di dati utente da inviare.
  3. Salva la configurazione.

Nota: Il modulo invierà solo i dati disponibili. Se l'utente non è connesso o non ha inserito determinati dettagli, quei campi non verranno inviati.

Comprendere il Sistema di Punteggio di Facebook​

Facebook (Meta) utilizza un sistema di punteggio per misurare la qualità degli eventi ricevuti. Il modulo Pixel Plus per PrestaShop mira a raggiungere la migliore qualità di corrispondenza possibile.

  • Gli eventi non correlati agli ordini con un punteggio di 4+ sono già considerati buoni.
  • Gli eventi correlati agli ordini dovrebbero avere un punteggio di 8 o superiore.
  • I punteggi superano raramente 9.5, anche con impostazioni ottimali.

Conclusione​

L'integrazione dell'API di Conversioni (CAPI) nel modulo Pixel Plus per PrestaShop garantisce un tracciamento preciso degli eventi, anche quando il tracciamento del browser fallisce. Configurando la Corrispondenza Avanzata, aggiungendo il Token di Accesso e utilizzando il Codice di Test, puoi ottimizzare le prestazioni dei tuoi annunci Facebook e prevenire eventi duplicati.

Per maggiori dettagli, visita la Documentazione Ufficiale dell'API di Conversioni Facebook.

Cos'è l'API di Conversioni e perché usarla?

L'API di Conversioni invia dati sugli eventi direttamente dal tuo server a Meta, bypassando le limitazioni del browser e i blocchi pubblicitari. Questo garantisce che eventi come Purchase vengano tracciati anche quando il Pixel del browser è bloccato o non funziona.

Dove ottengo il Token di Accesso CAPI?

Accedi a Facebook Business Manager, apri Gestione Eventi, seleziona il tuo Pixel, vai su Impostazioni e scorri fino alla sezione API di Conversioni. Clicca su Genera Token di Accesso e copia il risultato nel modulo Pixel Plus.

Cosa succede se lascio il Token di Accesso vuoto?

Se non è configurato alcun Token di Accesso, Pixel Plus non invierà eventi tramite l'API di Conversioni. Tutto il tracciamento dipenderà solo dal Pixel del browser, che può essere bloccato da estensioni per la privacy o da ad blocker.

A cosa serve il campo Codice di Test?

Il campo Codice di Test collega i tuoi eventi CAPI allo strumento Test Events di Facebook per verificare che gli eventi arrivino correttamente prima di andare in produzione. Lascialo vuoto in produzione per evitare dati falsi nei tuoi report.

Attivare la Corrispondenza Avanzata aiuta con la deduplicazione?

Si. Quando sia il Pixel del browser che la CAPI inviano lo stesso evento con dati utente corrispondenti, Meta puo dedupliCarli e contare solo una conversione. La Corrispondenza Avanzata migliora la precisione di questo processo.