DataFirefly Google Shopping — Guide complet

Présentation

DataFirefly Google Shopping est un module PrestaShop 8 et 9 qui génère des flux Merchant Center conformes à la spec Google Shopping 2025 et les décline automatiquement sur 6 canaux (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Il embarque 5 assistants IA (Anthropic Claude, OpenAI GPT-4o ou Mistral AI au choix), un score qualité 0-100, un éditeur de masse AJAX, un audit d’images par vision IA et des outils premium (A/B test de titres, forecaster saisonnier, export Google Ads Editor).

Le module crée 12 tables préfixées dfgs_ et 9 onglets back-office sous le menu « Google Shopping ». Aucune surcharge core, aucun fichier PrestaShop modifié.

Installation

1. Dans le back-office PrestaShop, allez dans Modules → Gestionnaire de modules → Installer un module.
2. Téléversez le fichier dfexportgoogleshopping.zip.
3. Cliquez sur Installer. Le module crée ses tables, ses onglets admin et ses valeurs de configuration par défaut.

Prérequis : PrestaShop 8.0 à 9.x, PHP 8.1+, MySQL 5.7+ ou MariaDB 10.3+, extension cURL activée. Le multiboutique et le multilingue sont supportés nativement.

Créer votre premier flux

1. Allez dans Google Shopping → Flux et cliquez sur Ajouter un flux.
2. Renseignez le nom, le type de flux (Produits, Local Inventory Ads ou Promotions), la boutique, la langue, la devise et le pays cible.
3. Choisissez le canal cible : Google Shopping (défaut), Bing, Meta Catalog, Kelkoo, Idealo ou LeGuide. Le format XML est adapté automatiquement au canal (namespaces, renames d’attributs, limites de longueur).
4. Configurez les filtres d’inclusion : catégories, fabricants, exclusion des produits hors stock.
5. Enregistrez puis cliquez sur Générer. L’URL publique du flux (sécurisée par token) s’affiche dans la liste — c’est elle que vous déclarez dans Merchant Center.

Mapping des catégories Google

Dans Google Shopping → Mapping catégories, associez chaque catégorie de votre boutique à une catégorie de la taxonomie Google (environ 6 000 entrées, mise en cache 30 jours). Deux méthodes :

• Manuelle : recherche avec autocomplétion dans la taxonomie.
• Auto-mapping IA : le bouton « Mapper automatiquement » envoie vos catégories non mappées à l’assistant IA, qui propose la meilleure correspondance. Les propositions à confiance élevée sont appliquées, les autres restent en attente de validation.

Le mapping se propage aux sous-catégories non mappées. L’attribut google_product_category et le product_type sont renseignés automatiquement dans le flux.

Surcharges produit

L’onglet Surcharges produits permet de forcer, produit par produit (et par langue/boutique), les valeurs du flux : titre, marque, GTIN, MPN, condition, couleur, taille, matière, custom labels 0-4, catégorie Google, exclusion du flux, etc. Les surcharges priment toujours sur les valeurs extraites du catalogue.

Édition de masse

L’onglet Édition de masse affiche une grille AJAX de 50 produits par page avec recherche par nom, référence ou ID. Fonctionnement :

• Édition inline : cliquez dans une cellule, saisissez la valeur, Entrée — la sauvegarde est immédiate (fond vert = succès).
• Action en masse : cochez plusieurs produits, choisissez un champ et une valeur, cliquez sur Appliquer. Le bouton « Supprimer overrides » retire les surcharges des produits sélectionnés.

Import / Export CSV et prévisualisation

L’onglet Import / Export / Preview regroupe trois outils :

• Export CSV des surcharges ou des mappings catégorie (UTF-8 avec BOM, séparateur point-virgule, compatible Excel).
• Import CSV avec sémantique claire : cellule vide = aucun changement, astérisque (*) = vider le champ.
• Prévisualisation XML : saisissez un ID produit et un flux, obtenez le XML exact de ce produit avec les problèmes de validation détectés. Idéal pour déboguer un produit refusé.

Assistants IA

Configurez d’abord le fournisseur dans Google Shopping → Réglages : Anthropic (Claude), OpenAI (ChatGPT/GPT-4o) ou Mistral AI, avec votre clé API et le modèle. Modèles recommandés : claude-haiku-4-5-20251001 ou gpt-4o-mini (rapides, peu chers) ; claude-sonnet-4-6 ou gpt-4o pour la qualité maximale.

L’onglet Assistants IA pilote les 5 assistants :

• Mapping catégories : associe vos catégories à la taxonomie Google.
• Réécriture de titres : optimise les titres selon le vertical détecté (apparel, electronics, books, home, beauty, food) et les patterns recommandés par Google.
• Extraction d’attributs : déduit color, size, material, pattern, age_group, gender depuis les descriptions (confiance ≥ 0.80).
• Recherche GTIN : retrouve le GTIN à partir de marque + MPN + nom, avec validation modulo 10 (confiance ≥ 0.85).
• Correction des refus : analyse chaque refus Merchant Center et propose (ou applique automatiquement à confiance ≥ 0.85) une correction structurée.

Chaque appel est journalisé dans la table dfgs_ai_log (fournisseur, modèle, tokens entrants/sortants, durée) : vous suivez votre budget IA au centime.

Score qualité 0-100

À chaque génération d’un flux produits, le module échantillonne 500 items et calcule 9 sous-scores pondérés : couverture GTIN (15 pts), couverture images (10), qualité images (10), qualité titres (15), qualité descriptions (10), mapping catégorie (15), couverture highlights (10), absence de refus critiques ouverts (10), présence des frais de port (5). Le total donne une note de A+ à F affichée sur le dashboard, avec les 5 recommandations à plus fort impact en tête.

Alertes Slack et email

Dans Réglages, renseignez un webhook Slack entrant et/ou une adresse email. Trois déclencheurs : nouveaux refus critiques détectés pendant une génération, chute du score qualité ≥ 10 points par rapport à la génération précédente, échec de génération. Anti-spam : maximum 1 alerte par type et par 6 heures.

Features premium

L’onglet Premium regroupe 5 outils :

• Analyse Search Console : téléversez l’export CSV des requêtes (Search Console → Résultats de recherche → Exporter). Le module croise chaque requête avec vos titres produit et calcule un score d’opportunité (impressions × mots-clés absents du titre × multiplicateur de position). Les 20 meilleures opportunités s’affichent avec le produit suggéré.
• A/B test des titres : deux variantes alternent par cycles de 7 jours dans le flux. Le gagnant est déclaré quand chaque variante atteint ≥ 500 impressions avec un delta CTR ≥ 5 % ; il est alors appliqué automatiquement en surcharge.
• Forecaster saisonnier : analyse 24 mois d’historique de commandes et tague les produits dans custom_label_4 — upcoming_season (index saisonnier > 1.5 sur les 2 prochains mois), bestseller (top 10 % du CA 30 jours), declining_trend (baisse ≥ 20 % sur 6 mois).
• Audit qualité d’images : par lots de 25, la vision IA (Claude Vision ou GPT-4o — Mistral non supporté) détecte filigranes, textes promotionnels, type de fond et produits multiples. Note 0-10 par image, cache 30 jours.
• Export Google Ads Editor : CSV importable directement, avec groupes d’annonces hiérarchisés par custom labels et multiplicateurs d’enchère par tag (bestseller ×1.5, upcoming_season ×1.3, on_sale ×1.2, declining_trend ×0.5).

Automatisation par cron

Chaque flux expose une URL de génération sécurisée par token, affichée dans la liste des flux. Exemple de crontab pour régénérer toutes les 6 heures :

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

La génération est en streaming : les catalogues de 100 000+ produits passent sans saturation mémoire.

Dépannage

• Le flux est vide : vérifiez les filtres du flux (catégories, stock) et que les produits sont actifs et visibles dans la boutique liée au flux.
• Produits exclus à la génération : consultez l’onglet Diagnostic — chaque exclusion est motivée (GTIN invalide, image manquante, prix à zéro…). Utilisez la prévisualisation XML pour le détail d’un produit précis.
• Erreur d’appel IA : vérifiez la clé API et le modèle dans Réglages. Le journal dfgs_ai_log enregistre les échecs avec leur cause.
• L’audit d’images échoue avec Mistral : c’est attendu — la vision nécessite Anthropic ou OpenAI.
• Après mise à jour PrestaShop, un onglet ne s’affiche plus : réinitialisez le module (Modules → dfexportgoogleshopping → Réinitialiser) pour recréer les onglets admin sans perdre vos données.

Désinstallation

La désinstallation supprime les 12 tables dfgs_, les onglets admin et les valeurs de configuration DFGS_. Exportez vos surcharges et mappings en CSV avant si vous souhaitez les conserver.