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.