Comment fonctionnent les rapports de génération des flux et comment interpréter les warnings et erreurs ?

Comment fonctionnent les rapports de génération des flux et comment interpréter les warnings et erreurs ?

Le rapport de génération du module ChatGPT Ads vous permet de vérifier les produits examinés lors de la création du flux CSV, de repérer les offres exportées ou rejetées et d'identifier les données à corriger dans votre catalogue PrestaShop.

Chaque offre est accompagnée d'un résultat et, lorsque cela est nécessaire, d'indications précisant les points à vérifier. Ces informations vous aident à distinguer les problèmes qui empêchent l'export d'une offre de ceux qui peuvent être corrigés pour améliorer la qualité des données transmises à OpenAI.

Consulter le rapport de génération

Après une génération du flux, ouvrez le Rapport de génération correspondant au flux concerné. Les détails affichés permettent notamment d'identifier la langue, le pays et la devise utilisés pour cette génération, ainsi que la date de la dernière tentative et son mode de lancement.

La section Détails de génération présente plusieurs indicateurs permettant d'évaluer rapidement le résultat de l'opération :

• Produits examinés : nombre de produits pris en compte lors de la génération.
• Offres exportées : nombre d'offres intégrées au flux généré. Un produit avec plusieurs déclinaisons peut correspondre à plusieurs offres.
• Produits exclus : nombre de produits exclus par les règles de sélection du stock ou des identifiants.
• Offres rejetées : nombre d'offres qui n'ont pas pu être exportées en raison de problèmes détectés dans leurs données.

Le message affiché en haut du rapport indique également si le flux a été généré. Une génération réussie ne signifie pas nécessairement que toutes les offres sont exploitables : certaines peuvent avoir été rejetées ou comporter des avertissements nécessitant votre attention.

Comprendre les résultats des offres

Dans la liste Produits nécessitant votre attention, chaque ligne correspond à un produit ou à une déclinaison. Vous y trouverez son nom, son identifiant, sa référence, le résultat de la validation et les points à vérifier.

Rejeté

Le statut Rejeté indique que l'offre n'a pas été exportée. Le rapport précise la donnée manquante ou le problème à résoudre.

Par exemple, si le fabricant du produit n'est pas renseigné et qu'aucune marque par défaut n'est définie dans les paramètres du flux, le rapport peut demander d'attribuer un fabricant au produit ou de définir une marque par défaut dans les paramètres du flux.

Pour corriger ce problème, cliquez sur Modifier le produit afin d'accéder à la fiche du produit concerné. Renseignez le fabricant ou la marque appropriée, selon les informations disponibles dans votre catalogue. Si plusieurs produits sont concernés, vous pouvez également définir une marque par défaut dans les paramètres du flux lorsque cette solution correspond à votre catalogue.

Relancez ensuite la génération pour vérifier que l'offre est désormais exportée.

Valide avec avertissements

Le statut Valide avec avertissements signifie que l'offre peut être exportée, mais que certaines données méritent d'être complétées ou vérifiées.

Par exemple, le rapport peut signaler qu'une offre ne possède ni GTIN ni MPN. Ces identifiants permettent de mieux identifier un produit. Leur absence ne bloque pas nécessairement l'export dans le module, mais elle peut réduire la qualité des informations transmises à OpenAI.

Pour améliorer l'offre, vérifiez si le produit dispose d'un GTIN valide, tel qu'un code EAN, UPC ou ISBN, ou d'un MPN correspondant à sa référence fabricant. Renseignez l'identifiant approprié dans PrestaShop s'il existe.

Ne créez pas de faux identifiants pour faire disparaître un avertissement. Si le produit ne possède réellement aucun identifiant fabricant, tenez compte des règles de la spécification OpenAI et du comportement pris en charge par le module.

Quels champs sont obligatoires selon OpenAI ?

La documentation officielle d'OpenAI distingue les champs indispensables aux données produit des attributs facultatifs ou soumis à des conditions particulières. Les exigences dépendent également du type d'intégration utilisé. Pour un flux destiné aux publicités, il convient donc de consulter la spécification des flux produit ainsi que le guide consacré aux flux publicitaires.

Dans la spécification des données produit au format OpenAI, les champs de base suivants sont indiqués comme obligatoires :

• item_id : identifiant unique et stable de l'article ou de la déclinaison dans le flux.
• title : nom du produit, avec les caractéristiques de la déclinaison lorsqu'elles sont pertinentes.
• description : description factuelle du produit.
• url : adresse de la page produit, idéalement avec la déclinaison sélectionnée.
• brand : marque du produit.
• seller_name : nom du vendeur.
• image_url : adresse de l'image principale du produit.
• availability : état de disponibilité, par exemple en stock ou en rupture de stock.
• price : prix du produit dans la devise correspondante.

Ces champs doivent contenir des valeurs conformes au format attendu. Par exemple, l'adresse de la page produit et celle de l'image doivent être accessibles publiquement. La disponibilité doit utiliser une valeur reconnue par la spécification.

La présence d'un champ dans cette liste ne signifie pas que le module utilise nécessairement le même nom technique dans son interface PrestaShop. Le module traduit les données du catalogue vers le format attendu par le flux.

Vous pouvez consulter la liste détaillée des champs, leurs types et leurs règles dans la documentation officielle OpenAI sur les données produit.

Les identifiants GTIN et MPN sont-ils obligatoires ?

Le GTIN et le MPN sont soumis à des conditions particulières dans la spécification OpenAI. Lorsqu'un identifiant produit est attendu, un GTIN valide ou un MPN approprié peut être nécessaire, sauf si l'absence d'identifiant est explicitement déclarée selon les règles applicables.

• GTIN : identifiant commercial international du produit, notamment sous la forme d'un code EAN ou UPC.
• MPN : référence attribuée au produit par son fabricant.

Dans le rapport du module, l'absence de ces identifiants peut être signalée par un avertissement plutôt que par un rejet. Il faut donc distinguer le comportement du module lors de la génération et les règles de données définies par OpenAI : une offre exportée n'est pas nécessairement une offre disposant de tous les identifiants recommandés ou requis dans chaque situation.

Pour connaître les conditions précises applicables à ces champs, consultez la section correspondante de la spécification OpenAI des données produit.

Comprendre les produits exclus

Les produits exclus par les règles de sélection du stock ou des identifiants sont comptabilisés séparément des offres rejetées. Leur exclusion résulte des paramètres de sélection du flux et ne signifie pas nécessairement que leurs fiches PrestaShop comportent une erreur.

Le rapport précise également que les produits exclus par les paramètres du flux sont listés avec ceux dont les données sont manquantes. Il est donc important de vérifier la cause indiquée avant de modifier une fiche produit.

Si un produit ne devrait pas être exclu, vérifiez notamment les règles de sélection du stock et les exigences relatives aux identifiants dans les paramètres du module. Les choix disponibles peuvent notamment concerner tous les états de stock, les produits en stock uniquement ou les produits en stock, en réapprovisionnement et en précommande.

[Capture d'écran des options « Stock selection » et « Identifier selection » dans les paramètres du flux.]

Rechercher un produit et filtrer les problèmes

Lorsque le catalogue contient de nombreuses offres, utilisez le champ Rechercher un produit pour retrouver une ligne à partir de son nom, de son identifiant ou de sa référence.

La liste déroulante Afficher permet de filtrer les éléments présentés dans le rapport. Vous pouvez ainsi limiter l'affichage aux problèmes à examiner, selon les filtres disponibles dans votre version du module.

Ces outils permettent de retrouver rapidement les produits concernés sans devoir parcourir l'intégralité du rapport.

Modifier un produit et vérifier la correction

Le bouton Modifier le produit, disponible sur chaque ligne, permet d'accéder directement à la fiche du produit concerné dans PrestaShop. Corrigez les informations signalées en vous appuyant sur les données réelles du produit.

Après vos modifications, générez à nouveau le flux et consultez le rapport actualisé. Vérifiez que l'offre n'est plus rejetée et que les avertissements ont disparu lorsqu'ils ont pu être résolus.

Si un avertissement persiste alors que les informations vous semblent correctes, vérifiez la conformité des valeurs avec la spécification OpenAI et les paramètres du flux avant de modifier d'autres données.

Automatiser la génération et le contrôle des flux

Si vous automatisez la génération du flux à l'aide d'une tâche cron, il est important de contrôler régulièrement les résultats afin de détecter les nouveaux rejets et avertissements. Une génération automatique peut réussir techniquement tout en laissant certaines offres à corriger.

Pour configurer une tâche cron dans PrestaShop, consultez notre FAQ Comment créer une tâche cron ?.