Champs spéciaux produit (Taille, Couleur, Matière)
Associez les attributs et caractéristiques produit de votre boutique aux champs XML standards g:size, g:color et g:material requis par Facebook et Instagram pour les catalogues de mode et d'habillement.
Disponible depuis la v1.1.0
Vue d'ensemble
Le catalogue produit de Facebook reconnaît des champs XML spécifiques — g:size, g:color et g:material — pour le filtrage, les publicités dynamiques et les surfaces Shopping. Ces champs doivent correspondre aux données de votre boutique PrestaShop, mais chaque boutique organise ces données différemment : certaines utilisent des groupes d'attributs (pour les produits avec déclinaisons), d'autres utilisent des caractéristiques produit (pour les produits simples), et beaucoup combinent les deux.
La section Champs spéciaux produit vous permet d'indiquer au module quel groupe d'attributs ou quelle caractéristique de votre boutique correspond à chaque champ standard. Une fois la correspondance établie, le flux génère automatiquement les valeurs correctes pour chaque produit et chaque déclinaison.
Il existe également une option pour inclure les attributs de déclinaison restants en tant qu'éléments <additional_variant_attribute>, ce qui fournit à Facebook des données plus riches sur les variantes sans que vous ayez à associer manuellement chaque attribut.
Configuration
- Rendez-vous dans Modules > Gestionnaire de modules, trouvez Facebook & Instagram Product Catalogue Feed Pro, puis cliquez sur Configurer.
- Cliquez sur l'onglet Champs spéciaux produit.
- Le panneau affiche trois champs de balises — Taille du produit, Couleur du produit et Matière du produit — ainsi que le bouton Champs variables supplémentaires.
Association des sources à Taille, Couleur et Matière
Chacun des trois champs affiche un widget de saisie par balises. Cliquez n'importe où dans le widget pour afficher une liste déroulante répertoriant tous les groupes d'attributs et caractéristiques produit disponibles dans votre boutique. Sélectionnez l'entrée qui contient les données pertinentes.
| Champ | Ce qu'il faut associer | Élément XML résultant |
|---|---|---|
| Taille du produit | Le groupe d'attributs ou la caractéristique qui stocke les valeurs de taille (ex. : « Taille », « Pointure ») | <g:size> |
| Couleur du produit | Le groupe d'attributs ou la caractéristique qui stocke les valeurs de couleur (ex. : « Couleur ») | <g:color> |
| Matière du produit | Le groupe d'attributs ou la caractéristique qui stocke les valeurs de matière (ex. : « Matière », « Tissu ») | <g:material> |
Vous pouvez associer plusieurs sources à un même champ. Si un produit possède une valeur pour la première source, cette valeur est utilisée ; sinon, le module essaie la deuxième source, et ainsi de suite. Cela est utile lorsque certains produits utilisent un groupe d'attributs et d'autres une caractéristique pour le même concept.
Après avoir effectué vos sélections, cliquez sur Enregistrer la configuration en bas de la section.
Fonctionnement
Groupes d'attributs vs. caractéristiques
PrestaShop stocke les données de variation produit à deux endroits :
- Les groupes d'attributs (ex. : Taille, Couleur, Pointure) gèrent les déclinaisons. Un « T-shirt » en tailles S, M, L utilise un groupe d'attributs. Chaque déclinaison porte une valeur de groupe d'attributs distincte.
- Les caractéristiques produit (ex. : Matière, Pays d'origine) sont des champs de métadonnées fixes attachés au produit lui-même, et non aux déclinaisons individuelles.
Lors de la génération du flux, le module vérifie chaque produit par rapport à vos associations :
- Pour une source de groupe d'attributs, il recherche la valeur de la déclinaison en cours pour ce groupe et la restitue.
- Pour une source de caractéristique, il lit la valeur de la caractéristique dans la fiche produit elle-même.
La première source qui retourne une valeur non vide est retenue. Si aucune source ne trouve de données pour un produit donné, l'élément XML est simplement omis pour ce produit — Facebook accepte les articles sans ces champs ; ils ne sont obligatoires que pour certaines catégories de produits.
Champs variables supplémentaires
| Champ | Valeurs | Défaut | Description |
|---|---|---|---|
| Générer les champs variables supplémentaires ? | Activé / Désactivé | Activé | Lorsqu'il est activé, tous les attributs de déclinaison NON déjà associés à Taille, Couleur ou Matière sont restitués en tant qu'éléments <additional_variant_attribute> dans le flux. |
Lorsque cette option est activée, le module prend tous les groupes d'attributs présents dans une déclinaison et exclut ceux que vous avez déjà associés à Taille, Couleur ou Matière. Les attributs restants sont chacun écrits comme suit :
<additional_variant_attribute>
<label>Fabric Weight</label>
<value>300gsm</value>
</additional_variant_attribute>
Cela est particulièrement utile pour les boutiques ayant de nombreuses dimensions de variation (ex. : style, coupe, longueur de jambe) qui n'ont pas d'équivalent direct dans les champs Facebook standard. La désactivation de cette option produit un flux plus petit et plus simple — approprié si vous avez déjà associé tous les attributs pertinents aux champs standard.
Cette option s'applique au flux complet principal et au flux par langue. Elle ne s'applique pas aux flux en mode pays (remplacements de prix par pays).
Référence de syntaxe
Le widget de balises stocke les valeurs en interne sous forme de liste séparée par des virgules avec des préfixes de type. Vous n'aurez normalement pas besoin de les modifier directement, mais comprendre le format est utile lors du dépannage :
| Préfixe | Signification | Exemple |
|---|---|---|
a:<id> | Groupe d'attributs avec l'identifiant donné | a:3 (groupe d'attributs ID 3) |
f:<id> | Caractéristique produit avec l'identifiant donné | f:7 (caractéristique ID 7) |
Les sources multiples sont séparées par des virgules : a:3,f:7 signifie « essayer d'abord le groupe d'attributs 3, puis la caractéristique 7 ».
Vous pouvez trouver les identifiants de vos groupes d'attributs dans Catalogue > Attributs et caractéristiques > Attributs et les identifiants de caractéristiques dans Catalogue > Attributs et caractéristiques > Caractéristiques dans le Back Office.
Exemples d'utilisation
Exemple : Boutique de prêt-à-porter classique
Votre boutique vend des T-shirts avec des déclinaisons Taille et Couleur. Dans PrestaShop, ce sont des groupes d'attributs nommés « Taille » (ID 1) et « Couleur » (ID 3). Associez « Taille » à Taille du produit et « Couleur » à Couleur du produit. Laissez Matière vide si vous ne suivez pas les données de tissu. Le flux restituera <g:size>M</g:size> et <g:color>Blue</g:color> par déclinaison, et Facebook pourra filtrer les annonces selon ces valeurs.
Exemple : Catalogue mixte avec caractéristiques et attributs
Vous vendez des chaussures (déclinaisons par taille) et des accessoires (produits simples avec une caractéristique « Matière »). Associez votre groupe d'attributs de pointure à Taille du produit, et votre caractéristique « Matière » à Matière du produit. Pour les chaussures, le flux lit la taille depuis la déclinaison. Pour les accessoires, il lit la matière depuis la caractéristique. Les deux types de produits fonctionnent avec une seule configuration.
Exemple : Suppression des variables supplémentaires redondantes
Vous avez déjà associé Couleur, Taille et Matière. Vos produits ont également un attribut « Motif », mais vous ne souhaitez pas le voir dans le flux. Laissez Champs variables supplémentaires désactivé — aucun élément <additional_variant_attribute> n'apparaîtra. Si vous décidez ultérieurement que Motif est utile pour le filtrage Facebook, réactivez le bouton et il apparaîtra automatiquement pour toutes les déclinaisons ayant une valeur Motif.
Remarques importantes
- Si un produit n'a de valeur pour aucune source que vous avez associée à un champ, cet élément XML est omis. Le flux reste valide — Facebook n'exige Taille, Couleur et Genre que pour les articles d'habillement.
- Les sources de groupe d'attributs ne fonctionnent que pour les produits avec déclinaisons. Si un produit simple n'a pas de déclinaisons, les sources de groupe d'attributs ne retournent rien ; utilisez plutôt une source de caractéristique pour les produits simples.
- L'option Champs variables supplémentaires restitue les groupes d'attributs qui ne figurent pas dans votre association Taille/Couleur/Matière. Si aucun n'est exclu, tous les groupes d'attributs apparaissent comme variables supplémentaires.
- Ces paramètres sont par boutique. Dans une configuration multi-boutiques, accédez au contexte de chaque boutique pour configurer les associations indépendamment.
- Après avoir modifié les associations, régénérez manuellement votre flux depuis l'onglet Génération manuelle du flux afin que Facebook récupère la structure mise à jour lors de sa prochaine importation.
Dépannage
| Problème | Solution |
|---|---|
g:size ou g:color est absent du flux | Vérifiez que le groupe d'attributs ou la caractéristique est bien associé dans le widget de balises. Vérifiez que les produits ont effectivement des valeurs pour ce groupe/cette caractéristique. Les produits simples nécessitent une source de caractéristique, pas une source de groupe d'attributs. |
| Une valeur incorrecte apparaît pour une déclinaison | Vous avez peut-être placé la source de caractéristique avant la source de groupe d'attributs pour un champ. La première source l'emporte — réordonnez les balises pour que la balise du groupe d'attributs apparaisse en premier. |
Les éléments <additional_variant_attribute> n'apparaissent pas | Vérifiez que Générer les champs variables supplémentaires ? est réglé sur Activé et que le produit a des attributs de déclinaison non déjà associés à Taille, Couleur ou Matière. |
| Après l'enregistrement, les balises apparaissent vides au rechargement | Cela peut se produire si les identifiants n'existent plus dans votre boutique (ex. : un groupe d'attributs a été supprimé). Ouvrez le widget de balises et réassociez depuis la liste déroulante. |
| Facebook signale des attributs obligatoires manquants pour les vêtements | Taille, Couleur et Genre sont obligatoires pour l'habillement dans certaines régions. Assurez-vous que Taille et Couleur sont associés. Genre est configuré séparément dans l'onglet Genre au sein des Champs spéciaux produit. |
Foire aux questions
Puis-je associer le même groupe d'attributs à la fois à Couleur et à Taille ?
C'est possible, mais cela n'aurait pas de sens pratique — la même valeur apparaîtrait dans <g:color> et <g:size> pour chaque déclinaison. Utilisez des groupes d'attributs ou des caractéristiques distincts pour chaque champ.
Dois-je associer les trois champs (Taille, Couleur, Matière) ?
Non. N'associez que les champs qui s'appliquent à vos produits. Facebook n'exige Taille et Couleur que pour les catégories habillement et chaussures. Matière est toujours optionnelle. Les champs non associés ne sont simplement pas restitués dans le flux.
Ma boutique a des déclinaisons, mais les valeurs de taille sont stockées comme caractéristique produit et non comme groupe d'attributs. Est-ce que ça fonctionnera ?
Oui. Associez la source de caractéristique (préfixée f:) au champ Taille du produit. Le module lit les caractéristiques aussi bien sur les produits simples que sur les produits avec déclinaisons. Notez qu'une caractéristique contient une valeur unique par produit, donc toutes les déclinaisons de ce produit afficheront la même valeur de taille.
Quelle est la différence entre associer deux sources à un champ et activer les Champs variables supplémentaires ?
Plusieurs sources sur un même champ (ex. : a:1,f:7) sont des alternatives — le module les essaie dans l'ordre et restitue le premier résultat non vide dans le champ standard <g:size>. Les Champs variables supplémentaires restituent tous les groupes d'attributs restants (ceux qui ne figurent dans aucune des trois associations standard) en tant qu'éléments <additional_variant_attribute> séparés. Ils servent des objectifs différents et peuvent tous deux être actifs en même temps.
Comment trouver les identifiants numériques de mes groupes d'attributs et caractéristiques ?
Dans le Back Office, rendez-vous dans Catalogue > Attributs et caractéristiques. La colonne ID est visible dans la vue liste. Alternativement, lorsque vous ouvrez le widget de balises dans Champs spéciaux produit, chaque entrée de la liste déroulante a déjà le préfixe a: ou f: correct appliqué — vous n'avez pas besoin de rechercher les identifiants manuellement en utilisant le widget.