Facebook Pixel: configurazione e aiuto

Avvio rapido

  1. Carica lo ZIP mprfacebookpixel tramite Moduli > "Module Manager" > "Upload a module".
  2. Fai clic su "Configure" e inserisci il "Pixel ID" numerico da Meta Events Manager.
  3. Controlla "Exclude employees" e "Respect cookie consent".
  4. Imposta "Enable Facebook Pixel" su Sì, scegli gli eventi browser necessari e salva.
  5. Per gli acquisti server, attiva "Enable Conversions API purchase events", inserisci token di accesso Conversions API e salva. Lascialo disattivo per una configurazione solo browser.
  6. Apri il negozio in un browser cliente, concedi il consenso marketing quando richiesto e controlla PageView, ViewContent e un'aggiunta riuscita al carrello negli strumenti di test Meta.
  7. Effettua un ordine di prova e controlla Purchase. Se usi CAPI, verifica l'ID evento corrispondente e l'attività send_facebook_conversions nella configurazione cron MPR condivisa.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.

Manuale di configurazione

Installa e configura

Segui i passaggi in Avvio rapido.

Impostazioni di Facebook Pixel

Apri "Configure" in "Module Manager". Il modulo offre un modulo di impostazioni, un pannello di connessione Meta, una guida alla configurazione e controlli di titolarità del tracciamento. Usa un account Back Office autorizzato a configurare il modulo; l'azione di connessione controlla il permesso di modifica e il token amministratore.

Impostazione Valore predefinito Cosa configurare
"Enable Facebook Pixel" No Attiva il tracciamento browser del modulo e l'elaborazione degli acquisti server idonei.
"Pixel ID" Vuoto Inserisci solo cifre. Copia l'ID del Pixel o dataset desiderato da Meta Events Manager.
"Exclude employees" Sì Blocca il tracciamento quando la richiesta ha il contesto di un dipendente connesso al Back Office. Prova con un browser cliente separato.
"Respect cookie consent" Sì Usa il consenso marketing quando Cookies Revolution o Cookie Banner è attivo.

Con protezione del consenso attiva e un modulo MPR supportato attivo, l'intestazione prepara un controllo del consenso browser. Avvia il Pixel dopo l'autorizzazione e ascolta mprcr:consent e mprcookie:consent. Il controllo server legge la decisione marketing MPR, usando il valore predefinito configurato nel modulo di consenso quando manca il suo cookie. Se nessun modulo di consenso MPR supportato è attivo, la protezione di questo modulo consente il tracciamento. Configura separatamente un altro strumento di consenso se lo usi.

Usa i controlli di titolarità se un'altra integrazione MPR gestisce la stessa destinazione Meta. Il modulo controlla la capacità meta_pixel prima di inviare. Rimuovi gli snippet Pixel duplicati installati indipendentemente dal tema o da altri moduli.

Eventi browser

Tutti gli eventi standard sono preimpostati su Sì. Disattiva quelli che non desideri.

Impostazione Cosa invia
"Track ViewContent" Visualizzazioni prodotto con ID, nome, categoria, valore e valuta disponibili.
"Track AddToCart" Eventi carrello dal bus PrestaShop updateCart e dai controlli di aggiunta al carrello di riserva.
Traccia l'inizio del pagamento Ingresso nel checkout con contenuti del carrello, valore, valuta e numero di articoli se il carrello non è vuoto.
Traccia gli acquisti Conferma d'ordine browser e, se configurato, accodamento degli acquisti CAPI.
Traccia le ricerche Query da s o search_query nel controller search.
"Track AddToWishlist" Azioni wishlist quando il bus eventi o un controllo supportato espone un ID prodotto.
"Track CompleteRegistration" Marcatore di registrazione consumato sulla successiva pagina my-account dopo la creazione dell'account.

PageView viene inviato all'avvio del Pixel browser. Non ha un interruttore separato. Il comportamento di prodotti, carrello e wishlist dipende da dati ed eventi esposti dal tema. Prova esplicitamente i controlli personalizzati.

Configura gli acquisti Conversions API

Impostazione Valore predefinito Cosa configurare
"Enable Conversions API purchase events" No Accoda eventi Purchase per l'invio server.
token di accesso Conversions API Vuoto Inserisci il token Meta per la destinazione desiderata. Il segreto salvato è mascherato nel modulo.
Codice evento di prova Vuoto Inserisci un codice Meta Test Events durante la convalida. Cancellalo per la produzione.
"Graph API version" v25.0 Mantieni il valore salvo che l'integrazione richieda un altro valore vNUMBER.NUMBER supportato.

Il modulo invia via CAPI solo Purchase. Gli altri eventi standard e le regole personalizzate usano il Pixel browser.

actionValidateOrder e displayOrderConfirmation possono accodare lo stesso ordine. L'identità della coda impedisce ammissioni duplicate per quell'evento; gli acquisti browser e server usano lo stesso ID evento stabile creato dall'ID ordine. I dati d'acquisto includono valore dell'ordine tasse incluse, valuta, ID prodotto, contenuti delle righe e quantità. I dati server costruiscono anche i dati disponibili di corrispondenza cliente e gli identificatori dei cookie Facebook.

Il modulo tenta un piccolo lotto di tre eventi durante questi hook. Registra anche l'attività cron condivisa:

task: send_facebook_conversions
callable: mprfacebookpixel::cronProcessFacebookConversions
schedule: every:300
context: any
timeout: 30

Assicurati che il runner cron MPR condiviso esegua l'attività registrata. Il lotto normale del worker è 20; questo modulo non ha un campo per la dimensione del lotto. Il worker può ritentare gli eventi in attesa. La pulizia conserva le righe inviate per 30 giorni e le altre vecchie righe per 90 giorni. Un cambiamento del legame di titolarità può far scartare le righe obsolete o sostituite anziché inviarle.

L’ID evento corrispondente browser/server consente la deduplicazione presso il fornitore. Meta decide l’attribuzione delle conversioni; controlla l’invio e i risultati di attribuzione in Meta.

Configura eventi browser personalizzati

"Track custom events" è preimpostato su No. "Custom event rules" parte vuoto. Aggiungi regole prima di attivare. Usa un nome distinto che inizi con una lettera, contenga lettere, numeri o underscore e abbia al massimo 50 caratteri. I nomi standard degli eventi Meta sono riservati. Il modulo limita l'elaborazione a 50 regole e 50 nomi distinti di eventi personalizzati.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-cover img","params":{"area":"product_gallery"},"once":false},
  {"event":"SizeGuideView","trigger":"url","contains":["/size-guide"],"params":{"area":"product_help"}},
  {"event":"AccountAreaView","trigger":"controller","controllers":["my-account"]},
  {"event":"ModuleCheckoutView","trigger":"controller","modules":["onepagecheckout"]},
  {"event":"ConfiguratorCompleted","trigger":"event","dom_event":"product-configurator:complete","params":{"source":"configurator"}}
]

Usa selector, contains, controllers/modules o dom_event per l'attivazione corrispondente. enabled e once sono true per impostazione predefinita. params fornisce parametri evento sanificati. Il modulo richiama fbq('trackCustom', ...) per queste regole.

Genera l'evento DOM personalizzato dal JavaScript del tema:

document.dispatchEvent(new CustomEvent('product-configurator:complete', {
  detail: {source: 'configurator', product_type: 'custom_size'}
}));

Mantieni selettori e nomi di controller/moduli coerenti con il tema e il checkout installati.

Verifica il tracciamento

Apri il negozio in un browser cliente e controlla la richiesta Pixel dopo la decisione di consenso applicabile. Verifica secondo necessità PageView, un ViewContent prodotto, aggiunta al carrello, inizio checkout, ricerca, wishlist e registrazione. Usa un ordine di prova per Purchase.

Per CAPI, controlla il pannello di connessione e Meta Test Events con il codice test salvato. Conferma che l'acquisto server usi l'ID evento dell'acquisto browser. Controlla l'esecuzione del worker se un reinvio è in attesa. Cancella il codice test e salva dopo la convalida. Il controllo della connessione richiede un'azione Back Office autorizzata; non esporre token di accesso in schermate o codice frontend personalizzato.

Risolvi i problemi

Se non si carica nulla, controlla attivazione, "Pixel ID" numerico, titolarità della capacità, contesto dipendente, decisione di consenso e script bloccati. Cerca caricamenti duplicati.

Se manca un evento, controlla il suo interruttore e i dati prodotto/carrello richiesti. La registrazione viene consumata su my-account; un reindirizzamento diverso dopo la registrazione può ritardarla. Una wishlist personalizzata richiede un ID prodotto esposto o una regola personalizzata.

Se CAPI è inattivo, controlla il suo interruttore, token, interruttore principale, Traccia gli acquisti e titolarità. Esamina errori server/cron e risposta del fornitore. Blocco del consenso browser e attribuzione Meta possono far differire i report dai totali PrestaShop.

Disattiva o disinstalla

Imposta "Enable Facebook Pixel" su No e salva per sospendere gli invii browser e server del modulo. Disinstalla tramite "Module Manager" per rimuovere menu, registrazione cron e configurazione. La tabella condivisa della coda resta se un altro modulo usa il pacchetto conversioni; altrimenti l'helper di disinstallazione della coda la elimina. Gestisci separatamente Pixel, dataset e report storici in Meta.

Schermate di riferimento

Usa i nomi delle impostazioni sopra quando una schermata differisce dalla versione installata.

Facebook Pixel. Aggiunta al carrello Facebook Pixel

Facebook Pixel, Impostazioni Facebook Pixel nell'amministrazione

Facebook Pixel. Flusso eventi di aggiunta al carrello

Facebook Pixel, Monitor Pixel nel negozio

Domande

1

Quali dati del cliente invia a Meta la Conversions API?

Gli eventi server Purchase idonei possono includere hash SHA-256 di ID cliente, e-mail, nome, telefono, città, CAP, paese e regione, usando l'indirizzo di fatturazione o, in sua assenza, quello di consegna. I cookie _fbp e _fbc disponibili, l'IP e lo user-agent della richiesta attuale vengono inviati senza hashing.

Problemi noti

9

Il tracciamento ignora il consenso aggiornato o le esclusioni

RisoltoAggiornato:
Risolto nella versione: 1.5.0
Alcuni percorsi di invio degli eventi non applicavano sempre la scelta di consenso attuale e le impostazioni di esclusione del personale.

Etichette non tradotte nelle impostazioni tedesche e spagnole

RisoltoAggiornato:
Risolto nella versione: 1.4.1
Le impostazioni, i nomi degli eventi in anteprima e le scelte Sì/No non usavano sempre la lingua tedesca o spagnola selezionata.

Etichette del modulo non tradotte

RisoltoAggiornato:
Risolto nella versione: 1.4.0
Alcune etichette del modulo continuavano a comparire in inglese nonostante fosse disponibile una traduzione.

Informazioni della pagina assenti nei rapporti di conversione

RisoltoAggiornato:
Risolto nella versione: 1.3.3
I rapporti di conversione potevano perdere l’identità pubblica della pagina se il negozio usava URL senza riscrittura semplificata.

Sicurezza rafforzata

RisoltoAggiornato:
Risolto nella versione: 1.3.1
Sicurezza rafforzata.

Consenso marketing non rilevato in modo affidabile

RisoltoAggiornato:
Risolto nella versione: 1.2.6
Il tracciamento poteva restare inattivo perché una scelta di consenso marketing supportata non veniva rilevata.

Tracciamento avviato prima del consenso nelle pagine in cache

RisoltoAggiornato:
Risolto nella versione: 1.2.2
Le pagine in cache potevano attivare il Meta Pixel per un visitatore che non aveva dato il consenso marketing.

Eventi di aggiunta al carrello mancanti in alcuni temi

RisoltoAggiornato:
Risolto nella versione: 1.2.2
Il tracciamento delle aggiunte al carrello poteva fallire nei temi privi del supporto standard agli eventi del negozio.

Tracciamento incompleto di lista desideri e checkout

RisoltoAggiornato:
Risolto nella versione: 1.2.2
Le aggiunte alla lista desideri e gli eventi del checkout non venivano sempre registrati con le informazioni previste su prodotti e checkout.

Richieste funzionalità

9

Implementato

Meta Conversions API con deduplicazione degli eventi

Implementato
Puoi inviare gli eventi di acquisto a Meta dal server, usando identificativi comuni per deduplicare gli eventi del browser e del server. L'invio segue i controlli di consenso configurati nel modulo.

Meta Conversions API

Implementato
Invia gli eventi di conversione supportati a Meta direttamente dal negozio, insieme al tracciamento nel browser.

Monitor interattivo degli eventi

Implementato
Esamina gli eventi del browser in un monitor spostabile e ridimensionabile mentre testi il negozio.

Monitoraggio degli eventi personalizzati

Implementato
Esamina gli eventi Facebook personalizzati nel monitor degli eventi.

Aggiornamenti del modulo con un clic

Implementato
Installa gli aggiornamenti disponibili del modulo dal back office.

Tracciamento Meta coordinato

Implementato
Evita il doppio tracciamento con i moduli supportati e verifica quale modulo gestisce gli eventi.

Verifica della connessione e guida alla configurazione

Implementato
Verifica la connessione Meta salvata senza registrare una conversione, consulta l'attività recente degli invii e segui una guida alla configurazione.

Anteprima degli eventi demo

Implementato
Visualizza in anteprima gli eventi generati dalle azioni nel negozio senza inviarli a Meta.

Eventi Contact e Lead

Implementato
Traccia le azioni di contatto e acquisizione di lead supportate con controlli sul consenso.

Registro modifiche

v1.2.32026-09-09

  • AddedAdd Facebook custom event telemetry
  • AddedUse shared conversions package
  • AddedMake facebook pixel monitor resizable
  • AddedAlign facebook pixel demo monitor
  • AddedUnify facebook pixel demo controls
  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedKeep demo monitor below modals
  • FixedAdd native config warnings
  • FixedAlign Facebook checkout and wishlist tracking
  • FixedPosition facebook pixel demo monitor
Versioni precedenti

v1.1.102026-07-17

  • Addednative PrestaShop configuration warnings for disabled state, missing Pixel ID and incomplete setup.
  • Updatedshared conversion context helpers for consistent product and category metadata.

v1.1.82026-07-05

  • FixedAddToWishlist tracking to use successful PrestaShop wishlist events with click fallback and deduplication.
  • ImprovedInitiateCheckout detection for native checkout and checkout-module controllers.
  • Updatedembedded release and license packages for the customer artifact.

v1.1.72026-05-15

  • Fixedconsent-safe Pixel boot so cached pages do not leak tracking before marketing consent.

v1.1.62026-05-03

  • Improvedthe demo Meta Pixel monitor and kept CAPI token handling safe for public demos.

v1.1.32026-02-09

  • Addeda demo-only Meta Pixel event monitor.
  • Addedstricter install failure handling when configuration or menu setup fails.

v1.1.22025-12-29

  • FixedAddToCart browser event binding for themes that expose PrestaShop without prestashop.on.

v1.1.12025-11-18

  • Fixedrelease packaging so demo artifacts exclude install-hostile vendor assets.

Demo

Prova il modulo completo prima di acquistare

Acquista la licenza in seguito e mantieni le tue impostazioni.

  • La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su