Outils de débogage de la génération
Deux paramètres de l'onglet Options de génération vous permettent de limiter ou de cibler la génération du flux lors du dépannage — sans toucher à votre planification cron ni à votre configuration de production.
Disponible depuis la v2.4.6
Présentation
Lorsqu'un produit affiche des données inattendues dans le catalogue Facebook, ou lorsque vous souhaitez tester une modification de configuration sans attendre que l'intégralité de votre catalogue soit traitée, ces outils vous permettent de restreindre la génération exactement aux produits qui vous intéressent ou de plafonner le nombre total à un petit nombre. Ces deux paramètres sont temporaires par conception : le module vous avertit de façon bien visible lorsque l'un ou l'autre est actif, afin que vous n'oubliiez pas de le désactiver avant votre prochain run planifié.
Les deux champs se trouvent dans l'onglet Options de génération de la page de configuration du module.
Paramètres
| Champ | Clé de config | Défaut | Description |
|---|---|---|---|
| Max Products Generation | FPF_GENERATE_MAX_PRODUCTS | 0 (désactivé) | Plafonne le nombre total de produits inclus dans le flux à cette valeur. 0 signifie aucun plafond. |
| Debug Product Feed Generation | FPF_FEED_DEBUG_IDS | vide (désactivé) | Liste d'identifiants de produits séparés par des virgules. Lorsqu'elle est renseignée, le flux ne contient que ces produits et tous les autres sont ignorés. |
Max Products Generation
Saisissez un entier positif pour arrêter le flux après que ce nombre de produits ait été traité. Les requêtes SQL qui récupèrent votre liste de produits sont réécrites pour appliquer un LIMIT au niveau de la base de données, de sorte que la génération s'arrête tôt et est proportionnellement plus rapide.
Ce paramètre s'applique globalement à toutes les boutiques, toutes les langues et tous les flux par pays dans le même run.
Avertissement : Lorsque ce champ contient une valeur non nulle, le module affiche une bannière d'avertissement en haut de chaque page de configuration pour vous rappeler qu'un plafond de génération est actif. Videz le champ (mettez-le à
0) une fois vos tests terminés, afin que votre flux en production contienne l'intégralité de votre catalogue.
Debug Product Feed Generation
Saisissez un nom ou un identifiant de produit dans le champ de recherche et sélectionnez le produit dans la liste d'autocomplétion. Vous pouvez ajouter plusieurs produits. Le module enregistre la sélection sous forme de liste d'identifiants de produits séparés par des virgules.
Lors de la génération, tout produit dont l'identifiant ne figure pas dans la liste est immédiatement ignoré avec le motif de saut debug — aucun XML n'est écrit pour lui et il ne compte pas dans les totaux d'erreurs. Les produits de la liste passent par l'intégralité du pipeline de génération exactement comme lors d'un run normal : tarification, déclinaisons, images, livraison, libellés personnalisés et correspondance de catégorie Google sont tous appliqués.
Ce paramètre est utile dans deux types de cas d'usage différents :
- Diagnostiquer un produit spécifique — vous voyez la sortie exacte (ou l'erreur) pour ce produit de façon isolée, sans le bruit des autres articles de votre catalogue.
- Vérifier ponctuellement des modifications de configuration — appliquez une modification, déclenchez une génération manuelle avec une courte liste d'identifiants, et inspectez le résultat avant de lancer un run complet.
Avertissement : Lorsque ce champ est non vide, le module affiche une bannière d'avertissement sur chaque page de configuration. Le message indique le nombre de produits sélectionnés et inclut un lien direct vers le champ. Videz la sélection une fois vos tests terminés.
Cas d'usage
Vérifier un produit mal configuré Un produit affiche un prix incorrect ou une image manquante dans le catalogue Facebook. Saisissez son identifiant dans Debug Product Feed Generation, cliquez sur Générer le flux maintenant depuis l'onglet de génération manuelle, et ouvrez l'URL du flux. Vous ne verrez que l'entrée de ce produit et pourrez la comparer à ce que vous attendez.
Tester une nouvelle configuration sur un grand catalogue
Vous avez 15 000 produits et souhaitez vérifier qu'activer un nouveau libellé personnalisé fonctionne correctement avant de lancer une génération complète. Réglez Max Products Generation à 50, enregistrez, puis déclenchez une génération manuelle. Le flux se génère en quelques secondes. Vérifiez le résultat, puis remettez le plafond à 0.
Isoler un problème de déclinaison Un produit avec plusieurs déclinaisons de taille et de couleur génère des entrées en double. Ajoutez l'identifiant du produit dans Debug Product Feed Generation et générez. Le flux n'affiche que les déclinaisons de ce produit, ce qui facilite l'identification des attributs de déclinaison à l'origine du doublon.
Remarques importantes
- Les deux paramètres affectent chaque boutique et chaque flux de langue dans le même run de génération — ils ne sont pas par boutique ni par langue.
- Lorsque Debug Product Feed Generation est actif, le plafond normal de verbosité des logs n'est pas appliqué. Les logs de génération affichent chaque produit au fur et à mesure de son traitement, vous donnant une sortie détaillée même avec des niveaux de log faibles.
- Régler Max Products Generation à
1produit un flux valide à un seul produit, ce qui est un moyen rapide de vérifier que l'URL du flux est accessible et que le format XML est correct avant d'investiguer des problèmes de contenu. - Les deux paramètres persistent jusqu'à ce que vous les effaciez manuellement. Un run déclenché par cron respectera également ces limites, de sorte qu'un run cron en production produirait un flux incomplet ou filtré si vous oubliez d'effacer les paramètres après vos tests.
- Aucun de ces paramètres ne modifie l'emplacement du fichier de flux ni l'URL que Facebook utilise pour récupérer le catalogue. La même URL de flux est mise à jour que vous ayez généré un run de test filtré ou un run de production complet.