PrestaShop Flux XML Google Merchant

Documentation PrestaShop Google Merchant Feed

1. Introduction
2. Installation et exigences du système
3. Activation du module
4. Configuration de base du flux
5. Configuration avancée
6. Structure du flux XML
7. Filtres produits
8. Intégration avec Google Merchant Center
9. Actualisation automatique (CRON)
10. Sécurité et jetons
11. Connexion et débogage
12. Dimensions des images
13. Résolution de problèmes
14. FAQ

1. Introduction

• Génération automatique d'un flux XML pour Google Merchant Center
• Prise en charge de tous les champs obligatoires et facultatifs de Google Shopping
• Filtrage avancé des produits (catégories, fabricants, quantité, promotions)
• Prise en charge de plusieurs langues et devises dans la boutique
• Images supplémentaires des produits (jusqu'à 10 par produit)
• Actualisation automatique du flux par CRON
• Accès sécurisé à l'aide de jetons
• Mise en cache du flux pour optimiser les performances
• Normalisation des données – suppression du code HTML, des surlignages et des espaces
• Validation des URL et des formats de données
• Compatible avec PrestaShop 1.7.x, 8.x et 9.x
• Système complet de traduction (polonais, anglais, allemand, espagnol, français)

2. l'installation et les exigences du système

• PrestaShop 1.7.0.0 ou plus récent (testé jusqu'à la version 9.0)
• PHP 7.4 ou supérieur
• Accès au panneau d'administration PrestaShop
• Compte Google Merchant Center (gratuit)
• Possibilité d'enregistrer des fichiers sur le serveur
• Accès à CRON (facultatif, pour l'actualisation automatique)

1. Télécharger le fichier ZIP du module depuis le site officiel cocos.codes
2. Se connecter au panneau d'administration de PrestaShop
3. Aller à : Modules → Gestionnaire de modules
4. Cliquez sur „ Télécharger le module ” dans le coin supérieur droit.
5. Sélectionnez le fichier ZIP téléchargé et cliquez sur „ Télécharger ce module ”.”
6. Une fois l'installation terminée, cliquez sur "Configurer"
7. Le module est prêt à être configuré.

3. Activation du module

1. Accédez à Modules → Gestionnaire de modules
2. Recherchez le module „ CC Google Merchant Feed ”.”
3. Cliquez sur „ Configurer ”.”
4. Sélectionnez l'onglet „ Configuration ”.”
5. Remplissez les paramètres de base du flux
6. Cliquez sur „ Enregistrer et générer le flux XML ”.”

4. Configuration de base du flux

1. Dans la configuration du module, sélectionnez „ Langue du flux ”.”
2. Sélectionnez dans la liste déroulante la langue pour les noms et descriptions des produits.
3. Cliquez sur „ Enregistrer et générer le flux XML ”.”

• Tous les produits de la langue sélectionnée sont chargés depuis la boutique.
• Le flux XML est généré et enregistré automatiquement.
• Le fichier est disponible à l'adresse URL indiquée dans l'onglet „ Instructions ”.”
• Google Merchant Center peut télécharger immédiatement le nouveau flux.

5. Configuration avancée

1. Entrez le nom de la marque/société que vous souhaitez utiliser pour les produits sans fabricant.
2. Si vous laissez ce champ vide, le nom du magasin défini dans les paramètres PrestaShop sera utilisé.
3. La marque est obligatoire pour les produits sans GTIN.

1. Entrez le préfixe du code MPN (par exemple „ MPN- ” ou „ SKU- „).
2. Le préfixe sera ajouté au numéro de référence du produit.
3. Si le produit a un numéro de référence, le préfixe lui sera appliqué.
4. Si aucune référence n'est fournie, le préfixe sera ajouté à l'ID du produit.

• Limite de produits – par défaut 0 (sans limite). Modifiez cette valeur, par exemple en 1000, si le flux est trop volumineux.
• Nombre maximal d'images supplémentaires – par défaut 10. Réduisez cette valeur pour diminuer la taille du flux.

6. Structure du flux XML

 http://example.com
    Flux de produits pour Google Merchant Center  123 Nom du produit Description du produit 

123 T-shirt bleu taille L T-shirt en coton de haute qualité, couleur bleu, taille L
  http://example.com/produkt/niebieski-t-shirt http://example.com/images/tshirt-blue-large.jpg
  http://example.com/images/tshirt-blue-1.jpg 99,99 PLN 79,99 PLN
  en stock neuf 5901234123457 Marque de mode MPN-123

7. Filtres produits

1. Dans la section „ Catégories ”, vous verrez la liste de toutes les catégories de la boutique.
2. Cochez les cases correspondant aux catégories que vous souhaitez exporter.
3. Pour sélectionner plusieurs catégories, maintenez la touche CTRL (Cmd sur Mac) enfoncée et cliquez sur les catégories.
4. Laissez cette case décochée si vous souhaitez exporter toutes les catégories.

1. Dans la section „ Fabricants ”, vous trouverez la liste de tous les fabricants/marques.
2. Cochez les cases correspondant aux fabricants dont vous souhaitez exporter les produits.
3. Pour sélectionner plusieurs fabricants, maintenez la touche CTRL (Cmd sur Mac) enfoncée et cliquez.
4. Laissez cette case décochée si vous souhaitez exporter tous les fabricants.

1. Entrez la quantité minimale de produits en stock.
2. Les produits avec moins de contenu seront ignorés dans le flux.
3. Entrez 0 pour ne pas filtrer par quantité (par défaut)
4. Utile pour n'exporter que les produits disponibles

1. Cochez l'option „ Seulement les produits en promotion ” si vous souhaitez exporter uniquement les promotions.
2. Cochez cette case si vous souhaitez exporter tous les produits, indépendamment des promotions.
3. Le module ajoute automatiquement le champ sale_price pour les produits bénéficiant de remises.

8. Intégration avec Google Merchant Center

1. Dans le panneau d'administration PrestaShop, allez dans Modules → Gestionnaire de modules.
2. Cliquez sur „ Configurer ” dans le module CC Google Merchant Feed.
3. Accédez à l'onglet „ Instructions ”.”
4. Dans la section „ Lien vers le flux XML ”, vous verrez l'URL complète du flux.
5. Cliquez sur le bouton „ Copier ” pour copier l'URL dans le presse-papiers.

1. Se connecter à Google Merchant Center
2. Accédez à la section „ Produits ” → „ Chaînes ”.”
3. Cliquez sur „ Nouveau canal ”.”
4. Sélectionnez „ Shopping ads ” ou le type de canal approprié.
5. Entrez le nom du flux (par exemple „ Flux XML PrestaShop ”).
6. Dans la section „ Produits ”, sélectionnez „ URL du flux ”.”
7. Collez l'URL copiée dans le flux.
8. Cliquez sur „ Suivant ” et terminez la configuration du canal.

1. Une fois le flux ajouté, Google le téléchargera et le validera automatiquement.
2. Accédez à „ Produits ” → „ Diagnostics ”
3. Vérifiez si le flux a été indexé avec succès.
4. S'il y a des erreurs, le module indiquera quels produits posent problème.

1. Google Merchant Center télécharge automatiquement le flux parfois
2. Pour forcer une mise à jour immédiate, cliquez sur l'icône d'actualisation à côté du canal.
3. Ou configurez l'actualisation automatique via CRON (décrite ci-dessous)

9. Actualisation automatique (CRON)

• Outil permettant d'exécuter automatiquement des tâches sur le serveur
• Permet de planifier des actions régulières (toutes les 6 heures, tous les jours, etc.)
• Idéal pour actualiser votre flux Google Merchant Center
• Nécessite un accès au panneau d'hébergement/serveur

1. Dans la configuration du module, sélectionnez l'option „ Actualisation automatique ”.”
2. Si vous décochez cette case, le flux sera mis en cache pendant un certain nombre d'heures.
3. Laissez cette option cochée pour actualiser le flux à chaque appel.

0 */6 * * * curl -s "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 */6 * * * – lance la tâche toutes les 6 heures, à l'heure pile
• curl -s – récupère l'URL en mode silencieux (sans messages)
• http://example.com – remplacez par l'adresse de votre boutique
• TOKEN_GÉNÉRÉ – jeton de sécurité issu de la configuration du module
• > /dev/null 2>&1 – masque les messages et les erreurs

0 */6 * * * wget -q -O - " http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN " > /dev/null 2>&1

• 0 * * * * – toutes les heures
• 0 */6 * * * – toutes les 6 heures (recommandé)
• 0 0 * * * – tous les jours à minuit
• 0 */12 * * * – toutes les 12 heures

10. Sécurité et jetons

• Code unique généré aléatoirement lors de l'installation du module
• Requis à chaque appel du flux par CRON
• Empêche toute personne non autorisée d'actualiser le flux.
• Change à chaque régénération

1. Dans le panneau d'administration PrestaShop, allez dans Modules → Gestionnaire de modules.
2. Cliquez sur „ Configurer ” à côté de CC Google Merchant Feed.
3. Accédez à l'onglet „ Instructions ”.”
4. Dans la section „ Régénération automatique (CRON) ”, vous verrez le jeton
5. Un jeton est une longue chaîne de caractères alphanumériques.

http://example.com/modules/cc_ps_google_merchant/feed.xml http://example.com/modules/cc_ps_google_merchant/feed.xml?token=abc123def456ghi789jkl

1. Dans l'onglet „ Instructions ”, cliquez sur le bouton „ Générer un nouveau jeton de sécurité ”.”
2. Une fenêtre de confirmation apparaîtra – cliquez sur OK.
3. Un nouveau jeton sera généré et affiché.
4. L'ancien jeton cessera immédiatement de fonctionner.
5. Si vous utilisez CRON, vous devez mettre à jour la commande avec l'ancien jeton.

11. Connexion et débogage

1. Ouvrez l'URL du flux dans votre navigateur Web.
2. Vous devriez voir le code XML brut avec les produits.
3. Cliquez avec le bouton droit de la souris et sélectionnez „ Afficher la source de la page ”.”
4. Vérifiez que la structure XML est correcte.
5. Vérifiez que tous les champs obligatoires sont remplis pour chaque produit.

1. Aller à Validateur XML
2. Copiez le contenu du flux et collez-le dans le validateur.
3. Le validateur indiquera si le XML a une syntaxe correcte.
4. S'il y a des erreurs, notez le numéro de la ligne où se trouve le problème.

1. Accéder à Google Merchant Center
2. Ouvrez le canal avec le flux
3. Aller à „ Diagnostics ”
4. Vérifiez les „ Erreurs ” et les „ Avertissements ”.”
5. Google montrera quels produits posent problème et ce qui ne va pas.

• Si le flux ne se génère pas, vérifiez les journaux d'erreurs PHP sur le serveur.
• Rechercher les erreurs concernant le module cc_ps_google_merchant
• Vérifiez si le serveur dispose des droits d'écriture dans le répertoire du module.
• Vérifiez si PHP dispose de l'extension SimpleXML installée.

12. Dimensions des images

1. Dans la configuration du module, allez dans „ Taille des images ”.”
2. Sélectionnez la taille souhaitée dans la liste déroulante.
3. Cliquez sur „ Enregistrer et générer le flux XML ”.”

• Dimension minimale : 100 x 100 pixels
• Dimensions recommandées : 800 x 800 pixels ou plus
• Taille maximale du fichier : aucune limite, mais Google ne télécharge que les 10 premiers Mo.
• Formats : JPG, PNG, GIF, BMP, TIFF, ICO, CUR, SVG, WEBP

• Le module peut ajouter jusqu'à 10 photos supplémentaires à chaque produit.
• Augmente les chances que le produit apparaisse dans le moteur de recherche Google Images.
• Vous pouvez désactiver cette option pour réduire la taille du flux.
• L'option „ Nombre maximal d'images supplémentaires ” permet de contrôler le nombre

13 Dépannage

1. Vérifiez si le module est actif dans le Gestionnaire de modules.
2. Vérifiez si le serveur dispose des droits d'écriture dans le répertoire. /modules/cc_ps_google_merchant/
3. Connectez-vous au panneau d'administration et essayez de cliquer sur „ Enregistrer et générer un flux XML ”.”
4. Vérifiez les journaux d'erreurs du serveur (error.log PHP)
5. Assurez-vous que PHP dispose de l'extension SimpleXML installée.
6. Essayez de désactiver le module et de le réactiver.

1. Vérifiez si les produits sont actifs dans PrestaShop
2. Vérifiez si les produits ont une catégorie attribuée.
3. Si vous utilisez des filtres, vérifiez que les produits répondent aux conditions du filtre.
4. Vérifiez la quantité minimale en stock – les produits en rupture de stock peuvent être ignorés.
5. Ouvrez le flux XML dans votre navigateur et recherchez les produits manuellement (CTRL+F).

1. Accédez à Google Merchant Center et ouvrez l'onglet „ Diagnostics ”.”
2. Lisez attentivement le message d'erreur.
3. Vérifiez les champs manquants – Google exige certains champs spécifiques.
4. Le module ignore automatiquement les produits pour lesquels les données requises sont manquantes.
5. Assurez-vous que les produits ont : un titre, une description, un lien, une photo, un prix, une disponibilité, un GTIN ou une marque.

1. Vérifiez que le prix dans PrestaShop est correctement défini.
2. Vérifiez que la devise de la boutique est correctement configurée.
3. S'il y a des remises, le module doit sélectionner le prix avec la remise.
4. Vérifiez que la TVA est correctement appliquée (le prix doit inclure la TVA).

1. Vérifiez que l'option „ Images supplémentaires ” est activée dans la configuration.
2. Assurez-vous que les produits ont des photos supplémentaires attribuées dans PrestaShop.
3. Vérifiez que le nombre maximal d'images supplémentaires n'est pas défini sur 0.
4. Ouvrez le flux XML et vérifiez s'il contient les éléments g:additional_image_link.

1. Vérifiez que la tâche CRON est correctement ajoutée dans le panneau d'hébergement.
2. Vérifiez que l'URL dans la commande CRON est correcte.
3. Vérifiez que le jeton dans l'URL est à jour (il change parfois lors des mises à jour).
4. Essayez d'accéder manuellement à l'URL depuis votre navigateur pour vérifier si cela fonctionne.
5. Vérifiez les journaux CRON dans le panneau d'hébergement – ils peuvent contenir des informations sur les erreurs.

14. LES FAQ