Identifiant & Description du produit
Contrôlez quelle valeur votre flux utilise comme identifiant unique de chaque produit et quel champ texte Facebook reçoit comme description.
Disponible depuis la v1.0.0
Vue d'ensemble
Le format de catalogue Facebook exige deux informations pour chaque produit : un identifiant stable et unique (id) et une description textuelle. Le module vous donne un contrôle total sur ces deux éléments.
L'identifiant est ce que Facebook utilise pour faire correspondre les entrées du catalogue aux campagnes publicitaires, aux événements pixel et aux fiches boutique. Choisir la mauvaise valeur — ou la modifier ultérieurement — rompt le lien entre votre catalogue et toutes vos campagnes actives. Choisissez une fois pour toutes et ne changez plus.
La description est ce que les acheteurs lisent dans les publicités dynamiques et sur les pages de navigation du catalogue. Les produits PrestaShop disposent souvent de deux ou trois champs texte (description courte, description complète, méta-description), dont la qualité varie selon les produits. Le module peut choisir automatiquement la meilleure selon un ordre de priorité que vous définissez.
Configuration
- Allez dans Modules > Gestionnaire de modules, trouvez Facebook & Instagram Product Catalogue Feed Pro et cliquez sur Configurer.
- Cliquez sur l'onglet Options produit.
- Le bloc Identifiant principal du produit se trouve en haut de l'onglet. Le champ Priorité de description du produit se trouve juste en dessous.
- Ajustez les paramètres décrits ci-dessous, puis cliquez sur Enregistrer en bas du formulaire.
Identifiant principal du produit
Le paramètre Identifiant principal du produit (FPF_PRODUCT_ID_TYPE) détermine la valeur écrite dans le champ id de chaque entrée du catalogue.
| Option | Valeur utilisée dans le flux | Recommandé quand |
|---|---|---|
| ID (par défaut) | L'identifiant numérique interne du produit dans PrestaShop (ex. 42) | Votre boutique n'a pas de référence/SKU cohérente pour chaque produit, ou vous démarrez un nouveau catalogue sans historique |
| Référence | Le champ Référence de la fiche produit | Vos produits ont déjà des codes SKU/référence stables qui apparaissent aussi dans votre ERP, votre entrepôt ou d'autres canaux |
Le mode ID est la valeur par défaut la plus sûre. Chaque produit PrestaShop possède un identifiant numérique qui ne change jamais. L'inconvénient est que ces numéros n'ont aucune signification en dehors de PrestaShop — si vous migrez vers une autre plateforme, les identifiants ne correspondront pas.
Le mode Référence utilise la valeur saisie dans le champ Référence de chaque fiche produit. Cela rend le catalogue portable et cohérent avec les autres systèmes. La condition est que chaque produit (et chaque déclinaison, si vous vendez des déclinaisons) doit avoir une référence unique et non vide. Les produits sans référence basculent automatiquement vers le format d'identifiant numérique.
Si vous avez déjà des campagnes Facebook ou Instagram actives liées à un catalogue existant, ne modifiez pas ce paramètre. Changer le type d'identifiant modifie la valeur
idde chaque produit, ce qui rompt le lien entre vos publicités et les nouvelles entrées du catalogue.
Préfixe et suffixe
Si votre boutique partage un catalogue produit avec un autre canal (un second flux, un export Google Shopping, une autre installation PrestaShop), vous pourriez avoir deux catalogues contenant des produits avec le même identifiant. Facebook les traite alors comme des doublons. Un préfixe ou un suffixe rend chaque identifiant de ce flux unique sans modifier les données produit sous-jacentes.
| Champ | Clé de configuration | Description |
|---|---|---|
| Préfixe d'ID produit (facultatif) | FPF_PREFIX | Texte ajouté au début de chaque identifiant produit dans le flux. Exemple : shop1- produit shop1-42. |
| Suffixe d'ID produit (facultatif) | FPF_SUFFIX | Texte ajouté à la fin de chaque identifiant produit, que les déclinaisons soient activées ou non. Exemple : -FR produit 42-FR. |
Construction des identifiants avec les deux champs renseignés :
- Produit simple en mode ID :
{préfixe}{id_product}{suffixe}— ex.shop1-42-FR - Produit simple en mode Référence (avec une référence) :
{reference}{suffixe}— ex.MYSKU001-FR(le préfixe n'est pas appliqué en mode Référence) - Déclinaison en mode ID :
{préfixe}{id_product}{préfixe_déclinaison}{id_product_attribute}{suffixe} - Déclinaison en mode Référence (la déclinaison a sa propre référence) :
{ref_déclinaison}{suffixe}
Laissez les deux champs vides si votre catalogue est le seul à utiliser ces identifiants produit sur Facebook.
Le champ Préfixe d'ID de déclinaison (également sur cet onglet) est séparé — il s'insère entre l'identifiant produit et l'identifiant de déclinaison pour les produits avec déclinaisons en mode ID. Il n'est pas traité ici.
Priorité de description du produit
Le paramètre Priorité de description du produit (FPF_PRODUCT_DESC_PRIO) contrôle quel champ texte le module écrit dans le champ description du flux, et dans quel ordre il les essaie lorsque le champ préféré est vide ou trop court.
Les champs sources disponibles sont :
| Code | Champ source | Remarques |
|---|---|---|
Description courte (s) | Description courte du produit | Généralement un résumé d'une ou deux phrases. Souvent bien rédigée et concise. |
Description (d) | Description complète du produit | Peut être longue avec du balisage HTML. Le module supprime automatiquement le HTML. |
Méta-description (m) | Champ méta-description SEO | Généralement une phrase courte et propre rédigée pour les moteurs de recherche. |
La liste déroulante propose tous les ordres possibles de ces trois champs. Sélectionner Description courte > Description > Méta-description signifie : utiliser la description courte si elle est suffisamment longue ; sinon, utiliser la description complète ; si celle-ci est aussi trop courte, essayer la méta-description.
Facebook exige une longueur minimale de description. Le module utilise un minimum interne de 20 caractères. Tout champ plus court que ce seuil est ignoré et le champ suivant dans l'ordre de priorité est essayé.
Il existe également une option spéciale :
| Option | Comportement |
|---|---|
La plus longue — Choisir toujours la plus longue disponible (l) | Ignore l'ordre de priorité et choisit toujours celui des trois champs qui contient le plus de caractères. |
La valeur par défaut est Description courte > Description (sd), qui convient à la plupart des boutiques.
Si un produit n'a aucun champ de description qui atteint la longueur minimale dans aucune des sources configurées, le produit est signalé comme erreur de description. Vous pouvez voir ces erreurs dans l'onglet Erreurs après la génération.
Exemples d'utilisation
Exemple : boutique avec des SKU cohérents déjà en place
Vos produits ont tous une référence du type CHAISE-CHENE-L. Vous exportez également vers Google Shopping en utilisant ces mêmes références. Définissez Identifiant principal du produit sur Référence afin que les deux catalogues partagent les mêmes identifiants produit. Les événements pixel Facebook déclenchés avec le code de référence correspondront alors correctement aux entrées du catalogue.
Exemple : configuration multi-flux pour deux pays
Vous générez un flux pour la France et un pour l'Allemagne. Les deux flux contiennent les mêmes produits (mêmes identifiants). Pour éviter que Facebook les traite comme des doublons, définissez Suffixe d'ID produit sur -FR dans la configuration de la boutique française et -DE dans celle de la boutique allemande. Les produits dans le flux français deviennent 42-FR et dans le flux allemand 42-DE.
Exemple : produits avec des descriptions complètes riches mais des descriptions courtes médiocres
Votre catalogue a été migré depuis une autre plateforme et les descriptions courtes sont en grande partie vides. Définissez Priorité de description du produit sur Description > Description courte > Méta-description afin que le module essaie toujours la description complète en premier.
Remarques importantes
- Modifier l'Identifiant principal du produit après avoir déjà connecté un catalogue à des publicités Facebook nécessite de recréer la connexion au catalogue ou de reconfigurer le jeu de produits. Planifiez ce changement lors de la configuration initiale.
- Dans les configurations multi-boutiques, ce paramètre est enregistré par boutique. Le flux de chaque boutique peut utiliser un type d'identifiant et un préfixe/suffixe différents sans affecter les autres boutiques.
- Le mode Référence n'applique le préfixe qu'aux produits sans référence (qui basculent vers l'identifiant numérique). Les produits ayant une référence reçoivent uniquement le suffixe.
- La description est débarrassée de ses balises HTML avant d'être écrite dans le flux. Il n'est pas nécessaire d'utiliser des champs en texte brut — le module gère le nettoyage.
- Les descriptions de plus de 10 000 caractères sont tronquées à 9 996 caractères avec
...ajouté à la fin pour respecter la limite de longueur de champ de Facebook.
Résolution des problèmes
| Problème | Solution |
|---|---|
| Facebook signale des identifiants produit en double après l'ajout d'un second flux | Ajoutez un Préfixe ou Suffixe d'ID produit unique pour différencier ce flux de l'autre. |
| De nombreux produits signalés comme « erreur de description » après la génération | Consultez l'onglet Erreurs pour voir quels produits sont concernés. Ajoutez ensuite des descriptions à ces produits ou modifiez l'ordre de priorité pour qu'un champ renseigné soit essayé en premier. |
| Les campagnes publicitaires ont cessé de diffuser après le changement du paramètre d'identifiant | Les identifiants produit dans le catalogue ont changé. Re-téléversez ou actualisez le catalogue dans Facebook Business Manager et reliez à nouveau le jeu de produits à la campagne. |
| Les produits en mode Référence utilisent des identifiants numériques au lieu des références | Ces produits ont un champ Référence vide sur leur fiche produit. Renseignez le champ Référence ou passez en mode ID. |
Foire aux questions
Quel type d'identifiant Facebook recommande-t-il ?
Facebook n'impose pas de valeur spécifique, mais elle doit être unique et stable. Si vous suivez déjà vos produits par SKU ou référence dans d'autres systèmes, utilisez le mode Référence pour plus de cohérence. Si vos produits n'ont pas de références fiables, utilisez le mode ID par défaut.
Puis-je utiliser un préfixe et un suffixe en même temps ?
Oui. Les deux champs sont appliqués indépendamment. Un produit avec le préfixe A- et le suffixe -B produit un identifiant du type A-42-B.
Que se passe-t-il si deux produits ont la même valeur de Référence ?
Facebook rejettera l'entrée en double lors du traitement du catalogue et signalera une erreur de validation. Assurez-vous que toutes les références produit sont uniques avant de passer en mode Référence. Vous pouvez effectuer un audit dans PrestaShop sous Catalogue > Produits en exportant et en vérifiant la colonne Référence.
Le paramètre de priorité de description s'applique-t-il à toutes les langues du flux ?
Oui. Le même ordre de priorité est appliqué lors de la génération du flux pour chaque langue. Si un produit a une description courte en français mais pas en anglais, le module passe au champ de priorité suivant pour l'entrée en anglais.
Mes produits ont des descriptions complètes très détaillées avec des tableaux et des listes à puces. Seront-elles affichées correctement sur Facebook ?
Le champ de description de Facebook est en texte brut uniquement. Le module supprime toutes les balises HTML avant d'écrire la valeur. Les listes à puces et le contenu des tableaux apparaîtront sous forme de phrases en texte brut, ce qui correspond au comportement attendu pour un flux de catalogue.