Facebook Pixel: configurazione e aiuto
Avvio rapido
- Carica lo ZIP
mprfacebookpixeltramite Moduli > "Module Manager" > "Upload a module". - Fai clic su "Configure" e inserisci il "Pixel ID" numerico da Meta Events Manager.
- Controlla "Exclude employees" e "Respect cookie consent".
- Imposta "Enable Facebook Pixel" su Sì, scegli gli eventi browser necessari e salva.
- 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.
- Apri il negozio in un browser cliente, concedi il consenso marketing quando richiesto e controlla
PageView,ViewContente un'aggiunta riuscita al carrello negli strumenti di test Meta. - Effettua un ordine di prova e controlla
Purchase. Se usi CAPI, verifica l'ID evento corrispondente e l'attivitàsend_facebook_conversionsnella 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.
![]()
![]()
![]()
![]()
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
Etichette non tradotte nelle impostazioni tedesche e spagnole
Etichette del modulo non tradotte
Informazioni della pagina assenti nei rapporti di conversione
Sicurezza rafforzata
Consenso marketing non rilevato in modo affidabile
Tracciamento avviato prima del consenso nelle pagine in cache
Eventi di aggiunta al carrello mancanti in alcuni temi
Tracciamento incompleto di lista desideri e checkout
Richieste funzionalità
9
Implementato
Meta Conversions API con deduplicazione degli eventi
Meta Conversions API
Monitor interattivo degli eventi
Monitoraggio degli eventi personalizzati
Aggiornamenti del modulo con un clic
Tracciamento Meta coordinato
Verifica della connessione e guida alla configurazione
Anteprima degli eventi demo
Eventi Contact e Lead
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.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.