Référence des champs de flux de produits pour OpenAI

Fonctionnement des mappages par défaut

Le flux de produits pour OpenAI utilise un système de cartographie basé sur les données pour transformer les données produit B2C Commerce dans le format requis par OpenAI. Lorsque B2C Commerce peut dériver une valeur à l’aide d’attributs B2C Commerce standard, il crée un mappage par défaut qui spécifie la façon dont la valeur est dérivée :

• Mappages de champs: Mappage direct à un seul attribut de produit B2C Commerce, tel qu’un nom, une marque ou un prix.
• Mappages dérivés: Calculez des valeurs à partir de plusieurs attributs ou appliquez des transformations, par exemple en supprimant le code HTML des descriptions ou en formatant les prix avec des codes de devise.
• Mappages constants: Utilisez une valeur fixe pour tous les produits. Par exemple, is_eligible_checkout est toujours faux. Le paiement instantané dans ChatGPT n’est pas pris en charge.
• Mappages de secours: Mappez d’abord à l’attribut principal, puis revenez à une alternative si l’attribut principal est vide pour ce produit. Par exemple, title utilise name, revenant à masterProductName si name est vide.

Vous pouvez personnaliser les champs marqués comme pouvant être remplacés : Oui, dans Business Manager. Champs marqués comme pouvant être remplacés : Non sont gérés par le système et visibles dans le tableau Mappage des champs, mais vous ne pouvez pas modifier leurs mappages.

Mise en forme automatique des champs

B2C Commerce applique une mise en forme automatique aux valeurs des champs avant qu’elles ne soient écrites dans le flux. Cette mise en forme se produit que vous conserviez le mappage par défaut ou que vous le remplaciez par un attribut différent. Lorsque vous remplacez un mappage par défaut, vous n’avez pas besoin d’adapter les données de votre catalogue pour qu’elles correspondent au format d’OpenAI : B2C Commerce gère la transformation.

La mise en forme s’applique comme suit :

• Dates de l’événement: Les valeurs de date et d’heure sont au format aaaa-mm-jj (ISO 8601). Les dates non valides sont omises du flux.
• Booléens: Les valeurs sont converties en true ou false.
• Chiffres:  Les valeurs numériques sont mises en forme avec la précision requise (par exemple, des entiers sans décimales, ou deux décimales pour les évaluations et les prix). Les valeurs non valides ou nulles sont omises.
• Prix:  Les valeurs positives sont mises en forme à deux décimales près et concaténées avec le code de la devise.
• Descriptions:  Les balises HTML sont supprimées du texte.
• Énumérations: Des valeurs telles que la disponibilité et age_group sont validées par rapport à des valeurs autorisées prédéfinies.

Héritage d’attributs personnalisés pour les variantes

Lorsque vous mappez un attribut personnalisé à un champ OpenAI, B2C Commerce résout automatiquement les valeurs d’attribut pour les variantes de produits à l’aide de la chaîne d’héritage suivante :

1. Variante du produit:  B2C Commerce vérifie d’abord la valeur de l’attribut dans la variante du produit.
2. Groupe de variations: Si la variante n’a pas la valeur de l’attribut, B2C Commerce vérifie le groupe de variations (le cas échéant).
3. Produit maître:  Si le groupe de variations n’a pas la valeur, B2C Commerce vérifie le produit maître.

Cette chaîne d’héritage garantit que les attributs personnalisés définis au niveau du maître ou du groupe de variations sont automatiquement hérités par les variantes sans qu’il soit nécessaire de saisir des données en double.

Éligibilité du produit

Deux couches contrôlent les produits qui apparaissent dans le flux :

• Règles de filtrage des produits: Règles d’inclusion et d’exclusion configurables qui déterminent quels produits sont envoyés à OpenAI. Par défaut, les règles correspondent aux produits en ligne et recherchables, mais vous pouvez les ajuster. Voir Règles de filtrage des produits pour le flux de produits.
• Exclusions automatiques: Quelles que soient vos règles de filtrage, B2C Commerce exclut toujours les éléments suivants du flux :
  • Produits maîtres (les variantes sont exportées à la place)
  • Groupes de variations (les variantes sont exportées à la place)
  • Ensembles de produits. ChatGPT ne peut pas gérer la sélection dynamique de composants requise par les ensembles de produits. Les bundles, qui ont des composants fixes, sont pris en charge et sont envoyés à OpenAI en tant que produits autonomes.

Dérivation du prix catalogue

Le champ prix correspond au prix normal (catalogue) d’un produit. B2C Commerce n’a pas de concept intégré de « prix catalogue » ; Les équipes de boutique en ligne mettent en œuvre la tarification catalogue à l’aide de différentes stratégies de listes de prix. Pour s’adapter à cette variété, B2C Commerce calcule le prix catalogue du flux en deux étapes :

1. Liste de prix sélectionnée. Si vous sélectionnez une liste de prix dans Liste de prix dans l’onglet Paramètres généraux, B2C Commerce utilise le prix de cette liste de prix. La liste déroulante contient uniquement les listes de prix actives et les prix dans la devise du flux. Si vous désactivez ultérieurement la liste de prix sélectionnée, reconfigurez la liste de prix catalogue pour qu’elle pointe vers une autre liste de prix.
2. Parcours de la liste de prix de vente. Si vous ne sélectionnez pas de liste de prix, B2C Commerce dérive le prix catalogue de la liste de prix soldés sélectionnée par le moteur de prix B2C Commerce pour le produit. Le moteur de prix évalue toutes les listes de prix applicables au produit, et pas seulement les listes actives, et renvoie le meilleur prix (le plus bas) avec sa liste de prix source. À partir de cette liste de prix de vente, B2C Commerce applique l’une des deux règles suivantes :
   • Si la liste de prix soldes a une liste de prix parente, B2C Commerce guide la chaîne parente jusqu’à la racine et renvoie le prix de la liste de prix racine. Cela correspond au comportement par défaut des boutiques SFRA et SiteGenesis.
   • Si la liste de prix soldes n’a pas de parente, B2C Commerce renvoie le prix maximum dans toutes les listes de prix applicables au produit. Cela correspond au comportement par défaut des boutiques PWA Kit.

Remarque Si le prix catalogue résolu est égal au prix soldé, B2C Commerce ne remplit que le champ prix et omet sale_price de l’entrée de flux de ce produit. Cela évite d’afficher un prix barré dans ChatGPT pour les produits qui ne sont pas en solde.

La configuration d’une liste de prix catalogue dans l’onglet Paramètres généraux est le moyen le plus fiable de s’assurer que le prix catalogue de votre flux correspond à ce que les acheteurs voient sur votre boutique en ligne, en particulier pour les boutiques avec une logique de prix personnalisée, une tarification par zone ou des listes de prix multidevises.

Dérivation du prix de vente

Le champ sale_price correspond à l’attribut salePrice de B2C Commerce et à la devise configurée. La valeur salePrice n’est pas extraite d’une seule liste de prix : le moteur de prix B2C Commerce sélectionne le meilleur prix (le plus bas) parmi toutes les listes de prix applicables au produit, quelle que soit la hiérarchie de la liste de prix ou si une hiérarchie est configurée ou non.

Étant donné que le même moteur renseigne le prix affiché dans votre boutique en ligne, la valeur sale_price envoyée à OpenAI correspond à ce que les acheteurs voient sur votre site.

Si le prix de vente résolu est égal au prix catalogue résolu (champ de prix ), B2C Commerce omet sale_price de l’entrée de flux de ce produit. Cela évite d’afficher un prix barré dans ChatGPT pour les produits qui ne sont pas réellement en solde. Voir Dérivation du prix catalogue.

Si votre boutique en ligne utilise une logique de tarification personnalisée, telle que la sélection de listes de prix par zone ou par zone géographique, le calcul du prix de vente par défaut peut ne pas correspondre à ce que voient les acheteurs. Dans ce cas, la configuration d’une liste de prix catalogue dans l’onglet Paramètres généraux est le moyen le plus fiable d’aligner le flux sur votre boutique en ligne.

Champs obligatoires

Les champs suivants sont obligatoires pour une entrée de flux de produits valide. Les produits pour lesquels il manque des champs obligatoires sont toujours inclus dans le flux, mais OpenAI peut rejeter ces lignes individuelles. Utilisez l’aperçu du flux de produits pour identifier les produits pour lesquels il manque des champs obligatoires et les corriger avant d’activer la synchronisation quotidienne des flux. Voir Aperçu du flux de produits.

Avertissement Si plus de 30 % de vos produits n’ont pas de champs obligatoires, OpenAI peut rejeter l’ensemble du flux. Assurez-vous que les données de votre catalogue sont complètes avant d’activer la synchronisation quotidienne des flux.

Remarque Certains champs obligatoires n’ont pas de mappage par défaut. Configurez ces champs dans Business Manager avant de générer votre flux. Ils se répartissent en deux groupes :

• Configurez dans l’onglet Paramètres généraux, dans la section Détails de l’entreprise:
  • seller_name: Le nom de votre magasin ou de votre marque tel qu’il est affiché aux acheteurs dans ChatGPT.
• Configurez dans l’onglet Catalogue, dans la section Mappage de champ, à l’aide de l’option Remplacer avec une valeur constante ou un modèle:
  • seller_url: URL vers la page d’accueil de votre boutique.
  • return_policy: Une URL qui pointe vers la page de votre politique de retour.

Champs facultatifs

Les champs suivants sont facultatifs et peuvent améliorer vos listes de produits dans ChatGPT. Les champs facultatifs sont omis du flux lorsque l’attribut mappé ou la valeur constante est vide.