Catégories de produits Google — Téléchargement de la liste de taxonomie
Avant de pouvoir associer des catégories de produits Google à vos catégories de boutique, vous devez télécharger la liste officielle de taxonomie Google. Ce téléchargement en un clic récupère la liste directement depuis Google et la stocke localement afin que l'autocomplétion des catégories fonctionne hors ligne.
Disponible depuis la v1.0.3
Vue d'ensemble
Google gère une liste standardisée de catégories de produits — connue sous le nom de Taxonomie des produits Google — que Facebook et Instagram utilisent pour classer les produits de votre catalogue. Chaque catégorie possède un identifiant numérique et un chemin lisible tel que Apparel & Accessories > Clothing > Dresses.
Le module a besoin d'une copie locale de cette liste pour alimenter le champ d'autocomplétion dans le panneau Association des catégories de produits Google. Sans elle, ce panneau est indisponible et vous ne pouvez pas associer vos catégories de boutique aux catégories Google.
Le fichier de taxonomie est téléchargé depuis les serveurs publics de Google et enregistré dans le dossier du module sous downloads/{lang}.txt. Le module tente d'abord de récupérer la taxonomie dans la langue par défaut de votre boutique (par exemple fr-FR.txt pour les boutiques en français), puis utilise l'anglais (en-US.txt) en solution de repli si une version localisée n'est pas disponible.
Comment télécharger ou actualiser la liste
- Accédez à Modules > Gestionnaire de modules, trouvez Facebook & Instagram Product Catalogue Feed Pro et cliquez sur Configurer.
- Dans la navigation de gauche, cliquez sur Liste des catégories de produits Google (l'onglet avec l'icône de téléchargement).
- Si la liste n'a jamais été téléchargée, le panneau affiche une invite vous demandant de la télécharger. Si une liste est déjà présente, le panneau indique sa date de dernière mise à jour.
- Cliquez sur Télécharger les catégories de produits Google.
- Le module récupère le dernier fichier depuis les serveurs de Google et l'enregistre. Une bannière de confirmation verte apparaît lorsque le téléchargement est terminé.
Une fois le téléchargement réussi, le panneau Association des catégories de produits Google devient actif et vous pouvez commencer à associer vos catégories de boutique.
Quand mettre à jour la liste
Google met à jour sa taxonomie plusieurs fois par an — de nouvelles catégories sont ajoutées, certaines sont renommées, et les catégories obsolètes sont supprimées. Le panneau affiche la date de votre fichier actuel afin que vous puissiez évaluer son ancienneté.
Actualisez la liste dans les cas suivants :
- Le fichier actuel a plus de quelques mois.
- Vous constatez qu'une catégorie dont vous avez besoin est absente des suggestions d'autocomplétion.
- Google annonce une mise à jour de la taxonomie (les notes de version sont publiées dans le Centre d'aide Commerce).
- Vous venez d'installer le module pour la première fois — la procédure d'installation tente un téléchargement automatique, mais actualiser manuellement confirme que le fichier est à jour.
Il n'y a aucun inconvénient à télécharger plus souvent. L'opération prend quelques secondes, remplace le fichier local et n'affecte pas les associations de catégories que vous avez déjà enregistrées.
Remarques importantes
Solution de repli linguistique. Le module tente d'abord de télécharger la taxonomie dans la langue par défaut de votre boutique. Par exemple, une boutique configurée en espagnol télécharge es-ES.txt. Si Google ne publie pas de fichier pour cette locale, le module utilise en-US.txt en solution de repli. Dans les deux cas, l'autocomplétion fonctionne — mais les noms de catégories seront dans la langue du fichier récupéré avec succès.
Connectivité serveur. Le téléchargement se connecte à https://www.google.com/basepages/producttype/taxonomy-with-ids.{lang}.txt. Si votre serveur dispose de restrictions HTTP/HTTPS sortantes ou d'un pare-feu bloquant les requêtes vers des hôtes externes, le téléchargement échouera. Dans ce cas, demandez à votre hébergeur d'autoriser les connexions sortantes vers www.google.com, ou téléchargez le fichier manuellement depuis cette URL et déposez-le dans modules/facebookproductsfeed/downloads/en-US.txt.
Permissions de fichiers. Si le module ne peut pas écrire dans le dossier downloads/, vous verrez une erreur vous invitant à vérifier les permissions d'écriture des fichiers et dossiers. Le répertoire downloads/ à l'intérieur du module doit être accessible en écriture par l'utilisateur du serveur web (généralement www-data).
Les associations de catégories sont préservées. L'actualisation de la liste de taxonomie met uniquement à jour le fichier texte local utilisé pour l'autocomplétion. Elle ne modifie ni ne supprime aucun identifiant de catégorie Google que vous avez déjà attribué à vos catégories de boutique dans la base de données.
Multi-boutique. Le fichier téléchargé est partagé entre toutes les boutiques. Les associations de catégories de chaque boutique sont stockées séparément, mais elles utilisent toutes le même fichier de taxonomie pour les suggestions d'autocomplétion.
Résolution des problèmes
| Problème | Solution |
|---|---|
| Le téléchargement échoue avec une erreur réseau | Vérifiez que votre serveur peut atteindre www.google.com sur le port 443. Contactez votre hébergeur si les connexions sortantes sont bloquées. |
| Erreur « Impossible de créer le fichier » | Le dossier downloads/ n'est pas accessible en écriture. Définissez ses permissions à 755 (ou 775) et assurez-vous qu'il appartient à l'utilisateur du serveur web. |
| L'autocomplétion des catégories ne retourne aucun résultat après le téléchargement | Videz le cache du back-office PrestaShop (Paramètres avancés > Performances > Vider le cache) et rechargez la page de configuration. |
| Le panneau affiche toujours « vous devez télécharger » après un téléchargement réussi | La confirmation a été affichée mais la page n'a pas été rechargée. Appuyez sur F5 ou revenez à l'onglet Liste des catégories de produits Google. |
| Le fichier téléchargé est en anglais mais ma boutique est dans une autre langue | Google ne publie peut-être pas de fichier de taxonomie pour la locale de votre boutique. La liste anglaise est utilisée en solution de repli — tous les identifiants de catégories sont universels, quelle que soit la langue. |
Foire aux questions
Dois-je retélécharger la liste de taxonomie après une mise à jour du module ?
Non. Le fichier est conservé lors des mises à jour du module. Téléchargez une nouvelle copie uniquement lorsque vous souhaitez récupérer les catégories nouvelles ou renommées par Google.
Que se passe-t-il avec mes associations de catégories existantes si j'actualise la liste de taxonomie ?
Rien. Vos associations sont stockées dans la base de données par identifiant de catégorie Google, et non par nom. L'actualisation du fichier texte local ne modifie pas ces identifiants ni ne supprime aucune association.
Puis-je utiliser le panneau d'association des catégories de produits Google sans télécharger la liste ?
Non. L'arborescence des catégories et l'autocomplétion dans le panneau d'association ne s'affichent qu'une fois qu'un fichier de taxonomie est présent dans downloads/. Le téléchargement est un prérequis à effectuer une seule fois.
Le module me notifie-t-il lorsque Google met à jour la taxonomie ?
Non. Il n'y a pas de notification automatique. Vérifiez périodiquement la date de dernière mise à jour affichée dans le panneau et actualisez lorsqu'elle date de plus de quelques mois.
Pourquoi l'autocomplétion affiche-t-elle des noms de catégories en anglais alors que ma boutique est en français ?
Google ne publie des fichiers de taxonomie localisés que pour certaines langues. Si un fichier en locale française (fr-FR.txt) n'est pas disponible, le module télécharge en-US.txt à la place. Les identifiants de catégories sont identiques dans toutes les langues, de sorte que votre flux reste valide quelle que soit la langue utilisée par le fichier local.