DataFirefly Google Shopping — Guide complet
Installation, flux par pays / langue / devise, catégories Google, règles, surcharges, problèmes, Merchant API et suggestions IA facultatives, cron et dépannage du module Google Shopping pour PrestaShop 1.7.8, 8 et 9.
Présentation
DataFirefly Google Shopping génère vos flux Google Merchant Center depuis PrestaShop : produits, inventaire en magasin et promotions, un flux par boutique, pays, langue et devise. Il vérifie chaque article par rapport à la spécification des données produit de Google, montre ce qu’il a trouvé et vous permet de le corriger avec les catégories, les règles et les surcharges avant que Google ne lise le flux. La Merchant API et les suggestions IA sont facultatives.
Le module ajoute un menu Google Shopping sous Améliorer avec 10 pages : Tableau de bord, Flux, Catégories Google, Règles, Produits, Problèmes, Suggestions IA, Analyses, Import / export et Réglages. Il crée 18 tables préfixées dfgs_, ne surcharge aucune classe de PrestaShop et ne modifie aucun fichier du cœur.
Le module suit la spécification de Google, mais Google seul décide de l’approbation et de l’affichage de vos produits. L’indicateur de qualité du tableau de bord est un contrôle de complétude interne, pas un score Google.
Prérequis
- PrestaShop 1.7.8, 8.x ou 9.x.
- PHP 7.4 à 8.5 avec les extensions
xmlwriteretzlib(openssletcurlpour la Merchant API et l’IA). - Un compte Google Merchant Center.
Installation
- Dans le back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Téléverser un module.
- Sélectionnez
dfexportgoogleshopping-2.0.0.zip. PrestaShop installe le module. - Ouvrez Améliorer → Google Shopping. L’assistant de configuration démarre à la première visite.
Mise à jour depuis la version 1.x
Téléversez le zip 2.0.0 par-dessus le module installé (même procédure que pour l’installation). La mise à jour :
- conserve vos flux, leur URL publique, leur jeton et les ID d’articles de la version 1.x, Merchant Center conserve donc vos produits ;
- reprend les correspondances de catégories, les surcharges de produits et les paramètres ;
- chiffre les clés API enregistrées par la version 1.x ;
- laisse la synchronisation Merchant API désactivée tant que vous ne l’avez pas configurée (la Content API for Shopping utilisée par la 1.x a été arrêtée par Google) ;
- supprime les anciens fichiers de la 1.x, y compris le dossier
feeds/.
La version 2.0.0 ne produit que des flux Google. Si un flux 1.x était configuré pour Bing, Meta, Kelkoo, Idealo ou LeGuide, son URL sert désormais le format Google : vérifiez-le avant de le conserver sur ce canal.
Après la mise à jour, ouvrez le Tableau de bord : les flux sont régénérés au premier passage du cron ou lorsque vous cliquez sur Générer.
Assistant de configuration
Quatre étapes : pays, langue et devise, livraison, puis les catégories Google de vos catégories principales. L’assistant crée un flux par pays sélectionné. Tout peut être modifié ensuite dans Flux et Catégories Google.
Flux
Dans Flux, chaque carte affiche le pays, la langue, la devise, les articles envoyés et exclus, l’indicateur de qualité et l’URL du flux (masquée ; Copier l’URL la copie). Actions : Générer, Aperçu, Historique, Paramètres, Désactiver, Dupliquer.
Les paramètres du flux comportent cinq onglets :
- Cible : type de flux (produits, inventaire en magasin, promotions), nom, boutique, pays cible, langue, devise, prix (automatique : HT pour les États-Unis et le Canada, TVA comprise ailleurs), format des ID d’articles, destinations et destinations exclues. Conservez le format des ID d’articles d’un flux existant : le modifier fait voir de nouveaux produits à Merchant Center.
- Produits : uniquement certaines catégories et marques ou toutes sauf certaines, prix minimum et maximum, ID de produits exclus, produits en rupture de stock.
- Titres et textes : modèle de titre avec les variables
{name},{brand},{attributes},{color},{size},{material},{category},{reference},{feature:Name}et un aperçu en direct sur les produits du flux ; valeurs de déclinaison dans le titre ; suppression des mots promotionnels et des majuscules d’insistance ; source de la description, points forts issus des listes à puces de la description, détails du produit issus des caractéristiques, marque utilisée lorsqu’un produit n’en a pas. - Livraison : aucune, un prix forfaitaire avec un seuil de livraison gratuite, ou un transporteur PrestaShop ; nom du service et délais de livraison facultatifs.
- Avancé : taille d’image envoyée, paramètres de suivi ajoutés aux liens, et Changer l’URL publique.
Déclarer le flux dans Merchant Center
- Cliquez sur Copier l’URL sur la carte du flux.
- Dans Merchant Center, ajoutez une source de produits à partir d’un fichier avec une récupération planifiée, et collez l’URL.
- Choisissez le même pays et la même langue que le flux.
L’URL contient un jeton de 40 caractères. S’il a fuité, utilisez Changer l’URL publique dans l’onglet Avancé : l’ancienne URL cesse immédiatement de fonctionner et doit être remplacée dans Merchant Center. Les fichiers de flux sont stockés dans var/dfgs_feeds/ sous un nom impossible à deviner et ne sont servis que par cette URL, sous Apache comme sous nginx.
Aperçu de l’article
Aperçu sur un flux calcule, pour le produit que vous choisissez, ce que ce flux enverrait maintenant : une fiche de style Shopping, le prix et le prix soldé, les problèmes trouvés et chacun des attributs. Utilisez-le pour vérifier un produit avant ou après une modification.
Génération, historique et cron
La génération s’effectue par lots. Si elle est interrompue, l’exécution suivante reprend là où elle s’est arrêtée ; un verrou empêche deux exécutions simultanées du même flux. À la fin, le module vérifie que le XML est bien formé, écrit une copie gzip et compare les articles avec la génération précédente.
Historique liste les 30 dernières générations (déclencheur, articles envoyés et exclus, indicateur, différences, durée, mémoire, taille, contrôle XML) et les différences champ par champ d’un article.
Pour régénérer les flux automatiquement, appelez l’URL cron affichée dans Réglages (par exemple toutes les heures) ; Régénérer chaque flux au plus toutes les définit la fréquence à laquelle un flux doit être régénéré (1 à 24 heures). Chaque appel génère les flux à régénérer, en 25 secondes environ, et reprend à l’appel suivant si nécessaire ; lorsque la Merchant API est activée, il envoie aussi les modifications de produits en file d’attente.
0 * * * * curl -s "https://www.example.com/index.php?fc=module&module=dfexportgoogleshopping&controller=cron&token=YOUR_CRON_TOKEN" > /dev/null
Catégories Google
La taxonomie des produits Google (version 2021-09-21) est incluse en 8 langues : la recherche s’effectue en local, sans appel à Google. Pour chaque catégorie de la boutique, saisissez quelques mots et choisissez la catégorie Google. Une sous-catégorie hérite du choix de sa catégorie parente tant que vous ne lui en attribuez pas un. Pour l’habillement, définissez le genre et la tranche d’âge : ils sont obligatoires dans plusieurs pays.
Règles
Une règle comporte des conditions (catégorie, marque, prix, quantité, titre, référence, état, GTIN présent, catégorie Google présente, en promotion, disponibilité) et une action : exclure l’article, définir une étiquette personnalisée de 0 à 4, ajouter un préfixe ou un suffixe au titre, remplacer ou supprimer des mots. Les règles s’exécutent de haut en bas à chaque génération, pour tous les flux ou pour un seul. Aperçu montre les articles concernés avant et après la règle.
Produits et surcharges
Produits liste vos produits avec le titre envoyé, le GTIN, la marque, le MPN, l’état, la catégorie Google et le statut. Double-cliquez sur une cellule pour la modifier ; sélectionnez des produits pour appliquer une action en masse (exclure de Google, inclure, état, genre, tranche d’âge, marque, catégorie Google, étiquette personnalisée, retirer les surcharges).
Détails ouvre les surcharges d’un produit, pour le produit entier ou une déclinaison, et pour chaque langue : titre, description, points forts, couleur, taille, matière, type de produit, GTIN, MPN, marque, catégorie Google, étiquettes personnalisées. À droite, l’aperçu montre ce que Google recevra. Les surcharges ne modifient que le flux, jamais votre catalogue. Un GTIN est refusé si sa longueur, son chiffre de contrôle ou son préfixe n’est pas valide.
Problèmes
Problèmes liste ce que le module a détecté lors de la dernière génération, par type (exclu, avertissement, information), avec ce qu’il faut faire et les articles concernés. L’Audit des GTIN du catalogue vérifie chaque GTIN du catalogue. Lorsque la Merchant API est activée, les problèmes signalés par Google apparaissent dans une section distincte.
Merchant API (facultatif)
- Dans Google Cloud, créez un projet, activez la Merchant API et créez un compte de service avec une clé JSON.
- Dans Merchant Center, ajoutez l’adresse e-mail du compte de service en tant qu’utilisateur.
- Dans Réglages → Merchant API, saisissez l’ID de votre compte Merchant Center et la clé JSON (stockée chiffrée, plus jamais affichée), puis cliquez sur Tester la connexion, Enregistrer le projet (une seule fois) et Créer la source de données API.
- Activez Envoyer les modifications de produits par la Merchant API (avec le cron).
L’enregistrement d’un produit ne fait que l’ajouter à une file d’attente ; le cron envoie la file et lit les statuts des articles. Les erreurs de quota sont réessayées plus tard avec un délai croissant.
Suggestions IA (facultatif)
Dans Réglages → IA, choisissez le fournisseur (Anthropic, OpenAI ou Mistral), saisissez votre clé API (stockée chiffrée), le modèle et un plafond mensuel. Dans Suggestions IA, choisissez les titres, les catégories Google ou les attributs, les produits et la langue : le coût est estimé avant l’exécution.
Chaque suggestion passe dans En attente de validation avec la valeur actuelle et la valeur suggérée, que vous pouvez modifier avant de cliquer sur Appliquer. Rien n’est appliqué sans votre clic. Les titres générés par l’IA sont envoyés comme contenu généré par IA, comme Google le demande. L’IA n’est jamais sollicitée pour un GTIN.
Analyses
- Tests de titres : deux titres alternent par période pour un produit. Saisissez les impressions et les clics de vos rapports Merchant Center ou Google Ads. Un résultat n’est déclaré significatif qu’avec au moins 1 000 impressions par titre, 30 clics au total et p < 0,05 ; même alors, d’autres facteurs (saison, concurrence, enchères) peuvent expliquer la différence.
- Requêtes de recherche : importez le CSV de vos requêtes Search Console ; le module associe chaque requête à un produit et affiche les requêtes dont des mots manquent dans le titre.
- Saisonnalité : produits dont les ventes passées se concentrent sur les deux mois à venir, que vous pouvez marquer avec une étiquette personnalisée.
- Audit des images : images de produits trop petites (moins de 100 ou 500 pixels sur le petit côté), trop allongées ou plus lourdes que 16 Mo.
Alertes
Dans Réglages → Alertes, saisissez une adresse e-mail et/ou un webhook Slack et choisissez les événements : échec de la génération, baisse de l’indicateur de qualité, nouveaux problèmes signalés par Google.
Import / export
Exportez et importez les surcharges en CSV (point-virgule, UTF-8). Les cellules commençant par =, +, - ou @ sont neutralisées à l’export. Cette page contient aussi la liste des magasins du flux d’inventaire en magasin et les promotions du flux de promotions.
Données structurées (JSON-LD)
Désactivé par défaut. Dans Réglages, Données structurées sur les pages produit en mode automatique ajoute un bloc Product à la page produit uniquement si la page n’en a pas (thème, module SEO ou d’avis), avec le prix affiché sur la page. Si votre thème en produit déjà un, laissez l’option désactivée.
Autres modules DataFirefly
Lorsqu’ils sont installés, le flux prend en compte : le produit emballage cadeau (jamais envoyé), les produits bloqués par une enchère, les lots dont la date de durabilité minimale est dépassée, l’état et le grade reconditionné, le prix unitaire et les groupes de produits de la liaison de produits (item_group_id).
Multiboutique et permissions
Chaque flux appartient à une boutique et ne voit que ses produits et ses surcharges ; dans un contexte de boutique, les flux des autres boutiques ne peuvent pas être ouverts. Les actions d’écriture nécessitent la permission de modification sur la page : un employé disposant uniquement de la permission de lecture peut consulter mais ne peut rien modifier.
Dépannage
- Le flux est vide : vérifiez les catégories et les filtres du flux, et que les produits sont activés, visibles et disponibles à la commande dans la boutique du flux. La page Problèmes donne la raison de chaque exclusion.
- L’URL renvoie une erreur 404 : le flux est désactivé, le jeton a été renouvelé ou le module est désactivé.
- Les prix diffèrent de ceux de la boutique : vérifiez le pays et la devise du flux ainsi que l’option de taxe dans Avancé ; Google attend des prix HT pour les États-Unis et le Canada.
- Merchant API : erreur d’authentification : vérifiez que le compte de service est utilisateur du compte Merchant Center et que le projet est enregistré.
- IA : rien ne se passe : vérifiez la clé, le modèle et le plafond mensuel dans Paramètres → IA ; le journal indique la cause de chaque appel en échec.
Désinstallation
La désinstallation supprime les 18 tables dfgs_, les paramètres DFGS_, les pages d’administration et les fichiers de flux générés. Exportez d’abord vos surcharges si vous souhaitez les conserver.