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 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.

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.

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.

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.

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.