Déclinaisons et gestion de la déclinaison par défaut
Contrôlez la façon dont les déclinaisons de produits (taille, couleur, matière) apparaissent dans votre catalogue Facebook — en tant qu'entrées de variantes individuelles, en tant que produit représentatif unique, ou en tant que produit simple.
Disponible depuis la v2.0.2
Vue d'ensemble
Dans PrestaShop, un produit avec des attributs (par exemple un T-shirt en tailles S, M, L) possède un produit parent et plusieurs déclinaisons. Le format de catalogue Facebook traite ces éléments comme un groupe de produits : chaque déclinaison devient un article distinct qui partage un item_group_id pointant vers le parent.
Lorsque vous exportez des déclinaisons, votre catalogue grossit proportionnellement — un produit avec 10 déclinaisons taille-couleur génère 10 entrées dans le catalogue. Cela donne à Facebook des données précises de stock et de prix par variante, mais cela signifie également que la taille du catalogue augmente considérablement pour les boutiques ayant de nombreuses combinaisons d'attributs.
Si vous désactivez l'export des déclinaisons, chaque produit apparaît comme une entrée unique utilisant les données du produit parent. Vous pouvez enrichir cette entrée unique avec les attributs de la déclinaison par défaut (stock, impact sur le prix, référence) grâce au paramètre Utiliser les données de la déclinaison par défaut.
Configuration
Accédez à Modules > Gestionnaire de modules > Facebook & Instagram Product Catalogue Feed Pro > Configurer, puis ouvrez l'onglet Options produits.
| Champ | Valeurs | Défaut | Description |
|---|---|---|---|
| Générer les déclinaisons de produits | Oui / Non | Non | Lorsqu'activé, chaque déclinaison est exportée comme un article distinct avec son propre g:id et un g:item_group_id partagé. Lorsque désactivé, seul le produit parent (ou la déclinaison par défaut — voir ci-dessous) est exporté comme une entrée unique. |
| Préfixe d'ID de déclinaison | Chaîne de texte (ex. V) | (vide) | Un séparateur inséré entre l'ID produit et l'ID d'attribut de déclinaison lors de la construction du g:id de chaque déclinaison. Requis lorsque les IDs de déclinaison risquent d'entrer en collision avec des IDs de produits ailleurs dans le catalogue. |
| Utiliser les données de la déclinaison par défaut si disponible | Oui / Non | Non | Ne prend effet que lorsque Générer les déclinaisons de produits est désactivé. Lorsqu'activé, l'entrée unique du catalogue pour un produit avec déclinaisons utilise le stock, le prix et la référence de la déclinaison par défaut. Lorsque désactivé, l'entrée utilise les données du produit de base sans aucun détail de déclinaison. |
Le champ Préfixe d'ID de déclinaison n'a aucun effet si Générer les déclinaisons de produits n'est pas activé.
Fonctionnement
Déclinaisons activées
Lorsque Générer les déclinaisons de produits est défini sur Oui, le flux génère une entrée par déclinaison. Chaque entrée contient :
g:id— construit comme{préfixe}{product_id}{préfixe_déclinaison}{combination_attribute_id}{suffixe}. Si la déclinaison possède sa propre référence et que votre type d'identifiant est défini sur référence, la référence de la déclinaison est utilisée directement.g:item_group_id— toujours l'identifiant du produit parent (ID produit ou référence produit, correspondant au paramètre de type d'identifiant). C'est ce qui indique à Facebook que toutes ces entrées appartiennent au même groupe de produits.
Le stock, le prix, les images, la couleur, la taille et les champs de matière proviennent tous de la déclinaison individuelle, de sorte que les acheteurs voient des données précises pour chaque variante.
Si les IDs d'attributs de vos déclinaisons se chevauchent avec les IDs de produits dans votre catalogue, ajoutez un Préfixe d'ID de déclinaison (par exemple
V) pour garantir que chaqueg:idest unique dans l'ensemble de votre flux.
Déclinaisons désactivées — sans données de déclinaison par défaut
Lorsque Générer les déclinaisons de produits est défini sur Non et que Utiliser les données de la déclinaison par défaut est également sur Non, chaque produit avec déclinaisons est exporté comme une entrée de produit parent simple. Les attributs spécifiques de la déclinaison (taille, couleur, stock par variante) ne sont pas pris en compte. La référence, le prix et le stock du produit sont ceux de l'enregistrement parent.
Ce mode est le plus compact mais perd la précision par variante.
Déclinaisons désactivées — avec données de déclinaison par défaut
Lorsque Générer les déclinaisons de produits est défini sur Non et que Utiliser les données de la déclinaison par défaut est défini sur Oui, le flux génère toujours une entrée unique par produit, mais cette entrée utilise les données de la déclinaison par défaut. Le g:id est l'ID produit simple (sans préfixe de déclinaison ni ID d'attribut), et aucun g:item_group_id n'est émis — l'entrée est lue comme un produit simple, pas comme une variante.
L'effet concret : le prix, le stock et la référence reflètent votre déclinaison par défaut plutôt que le produit de base. Cela est utile lorsque le produit de base lui-même a un prix nul et que toute la valeur provient de ses déclinaisons, ou lorsque la déclinaison par défaut est la seule variante que vous avez généralement en stock.
Exemples d'utilisation
Exemple : Boutique de mode avec variantes de taille
Vous vendez des jeans dans les tailles 28 à 38 (6 tailles) et 50 produits. L'activation des déclinaisons produit jusqu'à 300 entrées dans le flux. Chaque entrée a son propre niveau de stock et renvoie directement à la taille présélectionnée sur votre page produit. Facebook peut afficher "plus que 2 en stock" pour une taille spécifique. Recommandé pour toute boutique où le stock au niveau des variantes est significatif pour les acheteurs.
Ajoutez V comme préfixe de déclinaison pour obtenir des IDs tels que 42V5, 42V6, 42V7, afin qu'ils n'entrent jamais en collision avec votre ID produit 42.
Exemple : Boutique à SKU unique utilisant les déclinaisons uniquement pour la tarification
Vous utilisez les déclinaisons PrestaShop uniquement pour gérer les prix d'achat ou les références fournisseurs, mais ne les montrez jamais aux clients. Définissez Générer les déclinaisons de produits sur Non et Utiliser les données de la déclinaison par défaut sur Oui. Chaque produit apparaît comme une entrée unique avec le prix et la référence corrects de la déclinaison par défaut, ce qui garde votre catalogue compact.
Exemple : Grand catalogue où les déclinaisons provoqueraient des délais d'expiration lors de l'envoi
Vous avez 2 000 produits, chacun avec 5 déclinaisons — soit 10 000 entrées potentielles. Si la génération du flux est lente ou si Facebook atteint une limite de taille, désactiver l'export des déclinaisons réduit le flux à 2 000 entrées. Vous perdez les données par variante, mais gagnez en fiabilité. Associez cela à un intervalle cron plus long pour rester à jour.
Remarques importantes
g:item_group_idn'est écrit dans le flux que lorsque Générer les déclinaisons de produits est activé. Lorsque vous utilisez le repli sur la déclinaison par défaut, aucung:item_group_idn'est émis — Facebook le traite comme un produit autonome, pas comme une variante.- Le Préfixe d'ID de déclinaison s'applique uniquement aux entrées de déclinaisons. Le préfixe défini dans Préfixe d'ID produit s'applique à tous les produits quel que soit le mode de déclinaison.
- Les déclinaisons en rupture de stock sont ignorées sauf si Inclure les produits en rupture de stock est activé. La déclinaison par défaut est soumise au même contrôle de stock : si elle est en rupture de stock et que le produit ne peut pas être vendu en rupture de stock, elle n'apparaîtra pas même en mode déclinaison par défaut.
- Ces paramètres s'appliquent globalement à toutes les boutiques et à toutes les langues du flux. La configuration des déclinaisons par boutique n'est pas prise en charge.
- La modification de ce paramètre nécessite de régénérer le flux avant que le changement soit visible dans Facebook Commerce Manager.
Résolution des problèmes
| Problème | Solution |
|---|---|
Facebook signale des valeurs g:id en double après l'activation des déclinaisons | Ajoutez un Préfixe d'ID de déclinaison pour séparer les IDs de déclinaisons des IDs de produits. Un seul caractère comme V ou - est suffisant. |
| Le catalogue contient moins d'articles que prévu après l'activation des déclinaisons | Les déclinaisons en rupture de stock sont exclues par défaut. Activez Inclure les produits en rupture de stock dans l'onglet Options produits, ou vérifiez que vos déclinaisons ont du stock assigné dans PrestaShop. |
| Les données de la déclinaison par défaut n'apparaissent pas malgré l'activation de l'option | Confirmez que Générer les déclinaisons de produits est défini sur Non — le repli sur la déclinaison par défaut ne s'active que lorsque l'export des déclinaisons est désactivé. |
Toutes les déclinaisons partagent le même g:item_group_id mais Facebook les affiche toujours comme des produits séparés | Il s'agit du comportement normal. Facebook regroupe automatiquement par item_group_id ; aucune configuration supplémentaire n'est nécessaire dans Commerce Manager. |
| Le prix dans le flux ne correspond pas au prix de la déclinaison | Vérifiez le paramètre Inclure les taxes dans le prix dans Options produits. Vérifiez également si la déclinaison a un impact de prix défini dans PrestaShop. |
Foire aux questions
À quoi sert item_group_id ?
C'est le champ que Facebook utilise pour relier toutes les variantes d'un produit dans le catalogue. Toutes les déclinaisons d'un même produit partagent le même item_group_id, qui correspond à l'identifiant du produit parent. Cela permet à Facebook d'afficher une seule fiche produit avec un sélecteur de variantes plutôt que des produits séparés sans lien entre eux.
L'activation des déclinaisons va-t-elle considérablement agrandir mon catalogue ?
Oui. Chaque déclinaison activée génère une entrée de catalogue distincte. Un produit avec 10 déclinaisons devient 10 entrées. Si vous avez un grand nombre de déclinaisons et que la génération du flux est lente, réfléchissez à la nécessité des données par variante pour vos objectifs publicitaires avant d'activer cette option.
Ai-je toujours besoin d'un préfixe d'ID de déclinaison ?
Vous en avez besoin uniquement si vos IDs d'attributs de déclinaisons risquent d'entrer en collision avec des IDs de produits dans votre catalogue. En pratique, toute boutique avec un catalogue raisonnablement grand devrait ajouter un préfixe par précaution. Si votre catalogue compte 500 produits et que chaque produit a au plus 20 déclinaisons, il existe un risque réel de chevauchement sans préfixe.
Si j'utilise la Référence comme type d'identifiant produit, la référence de la déclinaison est-elle utilisée ?
Oui, à condition que la déclinaison elle-même ait une référence définie dans PrestaShop. Si la déclinaison n'a pas de référence, le module revient au format numérique {préfixe}{product_id}{préfixe_déclinaison}{attribute_id}{suffixe}.
Puis-je n'afficher que la déclinaison par défaut au lieu de toutes les variantes ?
Oui. Définissez Générer les déclinaisons de produits sur Non et Utiliser les données de la déclinaison par défaut sur Oui. Le flux génèrera une entrée par produit en utilisant le prix, le stock et la référence de la déclinaison par défaut, sans la surcharge des variantes.
Le repli sur la déclinaison par défaut émet-il un item_group_id ?
Non. En mode repli sur la déclinaison par défaut, l'entrée possède un g:id simple (l'ID propre du produit) et aucun g:item_group_id. Facebook la traite comme un produit autonome, et non comme faisant partie d'un groupe de variantes.