# Facebook Dynamic Ads + Pixel PRO — Guida completa > Panoramica Facebook Dynamic Ads + Pixel PRO collega il tuo catalogo PrestaShop a Facebook e Instagram. Il modulo esporta un feed prodotti di alta qualità (XML nel formato Facebook RSS… - Pagina: - Lingua: it - Aggiornato il: 2026-09-14 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dffbadspixel/index.md), [en](https://www.datafirefly.com/en/documentation/dffbadspixel-2/index.md), [es](https://www.datafirefly.com/es/documentation/dffbadspixel-3/index.md), [de](https://www.datafirefly.com/de/documentation/dffbadspixel-4/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffbadspixel/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffbadspixel/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffbadspixel/index.md) - Indice: ## Panoramica Facebook Dynamic Ads + Pixel PRO collega il tuo catalogo PrestaShop a Facebook e Instagram. Il modulo esporta un feed prodotti di alta qualità (XML nel formato Facebook RSS o CSV), installa il pixel di Facebook sul tuo negozio e attiva l'API Conversions per un tracciamento affidabile lato server. Genera un feed distinto per ogni combinazione Paese / Lingua / Valuta, offre un controllo preciso sui dati esportati (esclusioni, etichette personalizzate, mappatura delle categorie Google) ed è progettato per cataloghi di grandi dimensioni fino a 200.000 prodotti. Compatibile con PrestaShop 8.0 fino a 9.x, PHP 7.4 fino a 8.3, multinegozio e multilingua. `cURL` è necessario per l'API Conversions. Nessuna dipendenza Composer in produzione. ## Installazione 1. Nel tuo back-office, apri **Moduli → Gestione moduli → Carica un modulo**. 2. Carica il file `dffbadspixel.zip`. 3. Il modulo si installa e crea automaticamente le sue tabelle (`dffbadspixel_exclusion`, `dffbadspixel_label`, `dffbadspixel_capi_queue`) e la scheda di amministrazione **Facebook Dynamic Ads + Pixel**. All'installazione viene generato un token di sicurezza univoco. Protegge gli URL del feed e del CRON e viene mostrato nella scheda **URL e CRON** del modulo. ## Scheda Feed prodotti È il cuore del modulo. Qui scegli il formato e la modalità di generazione, la selezione dei prodotti e il dettaglio dei dati esportati. ### Formato e generazione - **Formato** — XML (Facebook RSS + namespace Google), CSV o entrambi. - **Modalità di generazione** — _Al volo_ (streaming a ogni chiamata dell'URL) o _CRON_ (file in cache, consigliato per cataloghi grandi). - **Compressione gzip**, **dimensione del lotto** (chunking) e **solo paesi attivi** per ottimizzare le prestazioni. ### Selezione e granularità - **Esporta per** categoria o per marca, con selezione precisa (un campo di filtro facilita la ricerca nell'elenco). - **Granularità** per prodotto o per variante. - **Costruzione dell'ID del feed**: ID back-office (con opzione lingua e/o variante), riferimento o EAN. - **Tipo di descrizione** (breve/lunga), **disponibilità** (in base allo stock o sempre disponibile), **colori**, **taglie**, immagini aggiuntive o **solo immagine di copertina**. ### Spese di spedizione, tracciamento e qualità - **Spese di spedizione reali** calcolate tramite i tuoi corrieri PrestaShop (zona, fasce peso/prezzo), corriere di riferimento o il più economico, con spedizione gratuita configurabile. - **Parametri UTM** e integrazione **GA4**. - **Limiti di qualità**: lunghezze massime di titolo e descrizione usate dal validatore (scheda Diagnostica). ### Esclusioni generali Direttamente sotto la scheda Feed: escludere i prodotti esauriti, senza EAN/MPN o sotto un prezzo minimo. ## Esclusioni avanzate Nella scheda **Esclusioni**, aggiungi regole mirate per escludere alcuni prodotti dal feed. Ogni regola si basa su un tipo e un valore: - **Parola / espressione** — esclude se il nome o la descrizione contiene il termine. - **Prodotto**, **Variante**, **Fornitore** — per ID. - **Valore di caratteristica** o **Attributo** — per ID. ## Etichette personalizzate e tag abbigliamento Le **etichette personalizzate** (`custom_label_0` a `custom_label_4`) arricchiscono la segmentazione delle tue campagne: nome della categoria, valore di una caratteristica, fascia di prezzo o etichette «nuovo» / «più venduto». La scheda **Tag abbigliamento** aggiunge i campi Meta dedicati all'abbigliamento: `age_group`, `gender`, oltre a `pattern` (fantasia) e `material` (materiale) mappati su caratteristiche di prodotto. ## Mappatura delle categorie e valute Nella scheda **Mappatura e valute**, associa le tue categorie PrestaShop alle categorie Google/Facebook: - **Importazione CSV** nel formato `id_category;google_category` (separatore `;` o `,`, intestazione opzionale). - **Importazione da un altro modulo** DataFirefly installato (versione standard, Google Merchant Center, GMC Pro o TikTok Ads). - **Suggerimento automatico per parole chiave** — compila le corrispondenze vuote a partire dal nome della categoria. - Modifica manuale riga per riga, con filtro di ricerca. La **tabella Valuta / Paese** definisce la valuta usata per ogni paese durante la generazione dei feed multipaese. Senza associazione, viene usata la valuta predefinita del negozio. Inizia senza mappatura delle categorie: Meta accetta il feed senza `google_product_category`. Aggiungila progressivamente alle tue categorie principali per migliorare la diffusione. ## Pixel di Facebook Nella scheda **Pixel**, attiva il pixel e inserisci il tuo **ID pixel**. Il modulo inietta il codice base (PageView) e gli eventi contestuali: ViewContent, ViewCategory, Search, InitiateCheckout, AddToCart e AddToWishlist. - **Corrispondenza avanzata** — invia informazioni aggiuntive del cliente, con hash SHA-256, per migliorare il tuo pubblico. - **Selettori HTML personalizzabili** per i pulsanti «lista desideri» e «ordina», utili se il tuo tema ha modificato il markup predefinito. - **Importo Purchase configurabile**: con o senza tasse, con o senza spedizione e/o imballaggio. ## API Conversions (asincrona) L'API Conversions invia gli eventi direttamente dal tuo server e recupera le conversioni che il pixel da solo non può rilevare (blocker, cookie). Nella scheda **API Conversions**: 1. Attiva l'API Conversions e incolla il **token di accesso** generato nel tuo Business Manager di Meta. 2. Lascia attiva la **modalità asincrona** (consigliata): gli eventi vengono messi in coda e poi inviati a lotti tramite CRON, senza rallentare il negozio. 3. Regola la **dimensione del lotto** e il numero di **tentativi massimi** se necessario. Un **codice evento di test** permette di validare l'integrazione nel Business Manager. Gli eventi vengono deduplicati con il pixel del browser tramite un `event_id` condiviso (ad esempio `order-1234` per un acquisto). I dati utente vengono sottoposti a hash SHA-256 prima dell'invio. ### Stati che attivano il Purchase Dalla versione 2.1.0, l'evento Purchase viene emesso quando l'ordine **passa a uno stato attivatore**, e non alla sua creazione. Seleziona gli stati interessati nella scheda API Conversions: all'installazione sono pre-selezionati gli stati che PrestaShop contrassegna come pagati. Se non viene selezionato alcuno stato, il modulo ricade su quegli stessi stati pagati. Questo comportamento è indispensabile con i pagamenti asincroni (bonifico, Bizum, SEPA, Klarna): l'ordine viene creato in attesa di pagamento e il Purchase viene inviato solo a pagamento confermato. Poiché l'invio è interamente lato server, non dipende dalla pagina di conferma, anche se il cliente non torna mai al negozio. Una protezione tramite `event_id` impedisce duplicati se l'ordine cambia stato più volte. ### Dati utente inviati Quando disponibili, il modulo trasmette: `em` (email), `ph` (telefono), `fn`, `ln`, `ct`, `zp`, `external_id`, `fbp`, `fbc`, `client_ip_address` e `client_user_agent`. Tutti i dati personali sono sottoposti ad hash SHA-256 prima dell'invio. L'`external_id` usa l'ID cliente (o l'identificativo ospite per i visitatori). Il `fbc` viene letto dal cookie `_fbc` e, se non esiste ancora, ricostruito dal parametro URL `fbclid`. ## Consenso GDPR e CMP La scheda **Consenso** applica il consenso marketing al pixel _e_ agli invii lato server. Finché non viene concesso, il pixel resta in modalità `revoke` (Consent Mode di Meta) e nessun evento viene messo in coda né inviato tramite l'API Conversions. Il rilevamento è a cascata: 1. **IAB TCF v2.2**: lettura di `__tcfapi` (finalità 1 e vendor Meta 89). 2. **Cookie del tuo CMP**: nome e valore atteso configurabili (Axeptio, Cookiebot, Didomi, moduli GDPR PrestaShop…). 3. **API JavaScript**: chiama `window.dffbConsentGrant()` all'accettazione e `window.dffbConsentRevoke()` al rifiuto da un banner personalizzato. La decisione letta nel browser viene riflessa in un cookie `dffb_consent`, così l'API Conversions applica esattamente la stessa scelta lato server. Viene inoltre emesso un evento `dffb:consent` su `document`. ## URL del feed e attività CRON La scheda **URL e CRON** mostra l'URL di base del feed, l'URL del CRON e l'elenco degli URL per combinazione Paese / Lingua / Valuta. ### URL del feed ``` https://tuo-negozio.com/index.php?fc=module&module=dffbadspixel&controller=feed&token=TUO_TOKEN&id_lang=1&id_currency=1&id_country=8&format=xml ``` I parametri `id_lang`, `id_currency`, `id_country` e `format` (`xml` o `csv`) selezionano il feed da servire. È l'URL che dichiari come fonte del feed nel catalogo di Meta. ### Attività CRON In modalità CRON, programma la chiamata all'endpoint per (ri)generare i file in cache e svuotare la coda dell'API Conversions: ``` */30 * * * * curl -s "https://tuo-negozio.com/index.php?fc=module&module=dffbadspixel&controller=cron&token=TUO_TOKEN" > /dev/null ``` Il parametro opzionale `job` punta a un'attività specifica: `feeds` (generazione dei feed), `capi` (invio della coda dell'API Conversions) o `all` (predefinito). La risposta è un riepilogo testuale. ## Diagnostica: anteprima e validazione La scheda **Diagnostica** riunisce due strumenti: - **Coda dell'API Conversions** — numero di eventi in attesa, in errore e inviati. - **Anteprima e validazione del feed** — genera un campione XML e un report di qualità che segnala le righe problematiche: immagine mancante, GTIN non valido (verificato tramite cifra di controllo), titolo o descrizione troppo lunghi, identificativo prodotto insufficiente. ## Sicurezza Nella scheda **Sicurezza**: - **Lista di IP autorizzati** — limita l'accesso al feed e al CRON a determinati indirizzi o intervalli CIDR (ad esempio i server di Meta). Vuoto = nessuna restrizione. - **Rotazione del token** — rigenera il token degli URL. Il vecchio resta tollerato fino all'invalidazione, dandoti il tempo di aggiornare i tuoi feed in Meta. Dopo una rotazione del token, ricorda di aggiornare le tue fonti di feed nel Business Manager, quindi di invalidare il vecchio token dalla scheda Sicurezza per chiudere la finestra di transizione. ## Risoluzione dei problemi ### Il feed restituisce «Forbidden» Il token è assente, errato, o l'IP chiamante non è nella lista autorizzata. Verifica il token nella scheda URL e CRON e svuota la lista di IP autorizzati durante il test. ### Il feed è vuoto o incompleto Verifica la selezione di categorie/marche (vuoto = tutto il catalogo), le regole di esclusione e lo stock se l'esclusione «esaurito» è attiva. In modalità CRON, esegui prima l'attività `job=feeds` per generare la cache. ### Gli eventi dell'API Conversions non arrivano a Meta Assicurati che `cURL` sia disponibile, che il token di accesso sia valido, ed esegui l'attività `job=capi`. Segui la coda nella scheda Diagnostica; gli errori sono registrati in **Parametri avanzati → Log** con il prefisso `[dffbadspixel]`. ### Il pixel non si attiva su un pulsante Se il tuo tema ha modificato il markup, regola i selettori HTML «lista desideri» e «ordina» nella scheda Pixel. ## Buone pratiche - Usa la **modalità CRON + gzip** per cataloghi grandi: la generazione al volo resta possibile ma più costosa a ogni chiamata. - Attiva **pixel e API Conversions insieme**: la deduplica tramite `event_id` evita il doppio conteggio migliorando la copertura. - Compila la **mappatura delle categorie Google** e i **GTIN** per massimizzare l'idoneità dei tuoi prodotti ai posizionamenti Advantage+ e Shopping.