DataFirefly Google Shopping — Guida completa

Panoramica

DataFirefly Google Shopping è un modulo per PrestaShop 8 e 9 che genera feed Merchant Center conformi alla spec Google Shopping 2025 e li adatta automaticamente a 6 canali (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Include 5 assistenti IA (Anthropic Claude, OpenAI GPT-4o o Mistral AI a scelta), un punteggio qualità 0-100, un editor massivo AJAX, l’audit delle immagini tramite Visione IA e strumenti premium (test A/B dei titoli, forecaster stagionale, export Google Ads Editor).

Il modulo crea 12 tabelle con prefisso dfgs_ e 9 schede back-office sotto il menu «Google Shopping». Nessun override del core, nessun file PrestaShop modificato.

Installazione

1. Nel back-office di PrestaShop, vai su Moduli → Gestore moduli → Carica un modulo.
2. Carica il file dfexportgoogleshopping.zip.
3. Clicca su Installa. Il modulo crea le sue tabelle, le schede admin e i valori di configurazione predefiniti.

Requisiti: PrestaShop 8.0 a 9.x, PHP 8.1+, MySQL 5.7+ o MariaDB 10.3+, estensione cURL attiva. Multinegozio e multilingua supportati nativamente.

Creare il tuo primo feed

1. Vai su Google Shopping → Feed e clicca su Aggiungi un feed.
2. Compila nome, tipo di feed (Prodotti, Local Inventory Ads o Promozioni), negozio, lingua, valuta e paese di destinazione.
3. Scegli il canale di destinazione: Google Shopping (predefinito), Bing, Meta Catalog, Kelkoo, Idealo o LeGuide. Il formato XML viene adattato automaticamente al canale (namespace, rename degli attributi, limiti di lunghezza).
4. Configura i filtri di inclusione: categorie, produttori, esclusione dei prodotti non disponibili.
5. Salva e clicca su Genera. L’URL pubblico del feed (protetto da token) appare nella lista — è quello che dichiari in Merchant Center.

Mapping delle categorie Google

In Google Shopping → Mapping categorie, associa ogni categoria del tuo negozio a una categoria della tassonomia Google (circa 6.000 voci, cache 30 giorni). Due metodi:

• Manuale: ricerca con autocompletamento nella tassonomia.
• Auto-mapping IA: il pulsante «Mappa automaticamente» invia le tue categorie non mappate all’assistente IA, che propone la migliore corrispondenza. Le proposte ad alta confidenza vengono applicate; le altre restano in attesa di validazione.

Il mapping si propaga alle sottocategorie non mappate. L’attributo google_product_category e il product_type vengono compilati automaticamente nel feed.

Override di prodotto

La scheda Override prodotti permette di forzare, prodotto per prodotto (e per lingua/negozio), i valori del feed: titolo, marca, GTIN, MPN, condizione, colore, taglia, materiale, custom label 0-4, categoria Google, esclusione dal feed, ecc. Gli override hanno sempre la precedenza sui valori del catalogo.

Modifica massiva

La scheda Modifica massiva mostra una griglia AJAX di 50 prodotti per pagina con ricerca per nome, riferimento o ID:

• Modifica inline: clicca su una cella, digita il valore, Invio — il salvataggio è immediato (sfondo verde = successo).
• Azione massiva: seleziona più prodotti con la casella, scegli un campo e un valore, clicca su Applica. Il pulsante «Elimina override» rimuove gli override dai prodotti selezionati.

Import / Export CSV e anteprima

La scheda Import / Export / Preview raggruppa tre strumenti:

• Export CSV degli override o dei mapping di categoria (UTF-8 con BOM, separatore punto e virgola, compatibile Excel).
• Import CSV con semantica chiara: cella vuota = nessuna modifica, asterisco (*) = svuota il campo.
• Anteprima XML: inserisci un ID prodotto e un feed, ottieni l’XML esatto di quel prodotto con i problemi di validazione rilevati. Ideale per il debug di un prodotto rifiutato.

Assistenti IA

Configura prima il provider in Google Shopping → Impostazioni: Anthropic (Claude), OpenAI (ChatGPT/GPT-4o) o Mistral AI, con la tua chiave API e il modello. Modelli consigliati: claude-haiku-4-5-20251001 o gpt-4o-mini (veloci, economici); claude-sonnet-4-6 o gpt-4o per la massima qualità.

La scheda Assistenti IA pilota i 5 assistenti:

• Mapping categorie: associa le tue categorie alla tassonomia Google.
• Riscrittura titoli: ottimizza i titoli secondo il verticale rilevato (apparel, electronics, books, home, beauty, food) seguendo i pattern raccomandati da Google.
• Estrazione attributi: deduce color, size, material, pattern, age_group, gender dalle descrizioni (confidenza ≥ 0.80).
• Ricerca GTIN: recupera il GTIN da marca + MPN + nome, con validazione modulo 10 (confidenza ≥ 0.85).
• Correzione dei rifiuti: analizza ogni rifiuto Merchant Center e propone (o applica automaticamente a confidenza ≥ 0.85) una correzione strutturata.

Ogni chiamata viene registrata nella tabella dfgs_ai_log (provider, modello, token in ingresso/uscita, durata): segui il tuo budget IA al centesimo.

Punteggio qualità 0-100

A ogni generazione di un feed prodotti, il modulo campiona 500 item e calcola 9 sotto-punteggi ponderati: copertura GTIN (15 pt), copertura immagini (10), qualità immagini (10), qualità titoli (15), qualità descrizioni (10), mapping categorie (15), copertura highlight (10), assenza di rifiuti critici aperti (10), spedizione presente (5). Il totale dà un voto da A+ a F sulla dashboard, con le 5 raccomandazioni a maggiore impatto in cima.

Avvisi Slack ed email

In Impostazioni, inserisci un webhook Slack in entrata e/o un indirizzo email. Tre trigger: nuovi rifiuti critici rilevati durante una generazione, calo del punteggio qualità ≥ 10 punti rispetto alla generazione precedente, fallimento della generazione. Anti-spam: massimo 1 avviso per tipo ogni 6 ore.

Funzionalità premium

La scheda Premium raggruppa 5 strumenti:

• Analisi Search Console: carica l’export CSV delle query (Search Console → Risultati di ricerca → Esporta). Il modulo incrocia ogni query con i tuoi titoli di prodotto e calcola un punteggio di opportunità (impression × parole chiave assenti dal titolo × moltiplicatore di posizione). Le 20 migliori opportunità appaiono con il prodotto suggerito.
• Test A/B dei titoli: due varianti si alternano in cicli di 7 giorni nel feed. Il vincitore viene dichiarato quando ogni variante raggiunge ≥ 500 impression con un delta CTR ≥ 5%; viene quindi applicato automaticamente come override.
• Forecaster stagionale: analizza 24 mesi di storico ordini e tagga i prodotti in custom_label_4 — upcoming_season (indice stagionale > 1.5 nei prossimi 2 mesi), bestseller (top 10% del fatturato 30 giorni), declining_trend (calo ≥ 20% su 6 mesi).
• Audit qualità immagini: a lotti di 25, la Visione IA (Claude Vision o GPT-4o — Mistral non supportato) rileva filigrane, testi promozionali, tipo di sfondo e prodotti multipli. Punteggio 0-10 per immagine, cache 30 giorni.
• Export Google Ads Editor: CSV direttamente importabile, con gruppi di annunci gerarchizzati per custom label e moltiplicatori di offerta per tag (bestseller ×1.5, upcoming_season ×1.3, on_sale ×1.2, declining_trend ×0.5).

Automazione via cron

Ogni feed espone un URL di generazione protetto da token, visibile nella lista dei feed. Esempio di crontab per rigenerare ogni 6 ore:

0 */6 * * * curl -s "https://tuonegozio.com/module/dfexportgoogleshopping/cron?token=TUO_TOKEN&id_feed=1" > /dev/null

La generazione è in streaming: i cataloghi da 100.000+ prodotti passano senza saturazione della memoria.

Risoluzione dei problemi

• Il feed è vuoto: verifica i filtri del feed (categorie, stock) e che i prodotti siano attivi e visibili nel negozio collegato al feed.
• Prodotti esclusi alla generazione: consulta la scheda Diagnostica — ogni esclusione ha un motivo (GTIN non valido, immagine mancante, prezzo a zero…). Usa l’anteprima XML per il dettaglio di un prodotto specifico.
• Errore di chiamata IA: verifica la chiave API e il modello in Impostazioni. Il registro dfgs_ai_log registra i fallimenti con la loro causa.
• L’audit immagini fallisce con Mistral: è previsto — la visione richiede Anthropic o OpenAI.
• Una scheda scompare dopo un aggiornamento PrestaShop: reinizializza il modulo (Moduli → dfexportgoogleshopping → Reimposta) per ricreare le schede admin senza perdere i tuoi dati.

Disinstallazione

La disinstallazione rimuove le 12 tabelle dfgs_, le schede admin e i valori di configurazione DFGS_. Esporta prima i tuoi override e mapping in CSV se vuoi conservarli.