Flux OpenAI Commerce : guide technique complet du mapping

Introduction

OpenAI Commerce est une plateforme de distribution de données produits qui permet aux commerçants de mettre leurs articles à disposition via les services et intégrations d'OpenAI. Ce flux facilite la syndication de catalogues produits vers des solutions de commerce électronique, des moteurs de recherche et des outils de gestion d'inventaire.

Les commerçants utilisent cette plateforme pour augmenter la visibilité de leurs produits, améliorer leur présence dans les résultats de recherche et synchroniser leurs données d'inventaire en temps réel. La qualité et la complétude du flux influencent directement l'approbation des produits, leur classement et leur capacité à être achetés par les clients.

Champs d'éligibilité et de contrôle d'accès

Trois champs déterminent si un produit peut être utilisé dans différents contextes :

Ces trois champs doivent être définis explicitement à true pour que chaque fonctionnalité soit activée. Si un champ est absent ou défini à false, la fonctionnalité correspondante sera désactivée, même si les autres données du produit sont complètes.

Identification et classification des produits

L'identification correcte des produits est essentielle pour éviter les doublons, gérer les variantes et assurer la traçabilité.

item_id : identifiant unique et immuable du produit dans votre système. Cet identifiant doit rester constant d'une transmission de flux à l'autre. Les modifications ou la réutilisation de cet identifiant causent la création de fiches produit dupliquées et dégradent les performances de vente. Utilisez un identifiant interne stable, jamais un UUID aléatoire.

gtin : code à barres international (EAN, UPC, ISBN). Ce champ améliore significativement la visibilité moteur recherche et facilite l'appariement automatique avec d'autres catalogues. Sans GTIN valide, les produits de marque connue sont pénalisés en classement. Fournissez le GTIN complet et exact du produit réel.

mpn : numéro de pièce du fabricant. Utilisé pour l'identification technique, notamment pour les produits techniques ou les pièces détachées. Combiné avec le brand, le MPN aide à différencier les variantes.

group_id : identifiant de groupe pour les produits avec variantes (tailles, couleurs, genres). Tous les articles appartenant à un même produit logique doivent partager le même group_id. Cela permet à la plateforme de les afficher comme variantes d'un seul produit et d'améliorer la conversion en offrant un sélecteur de variantes à l'acheteur.

condition : état du produit. Les valeurs acceptées sont new (neuf), refurbished (reconditionné) ou used (occasion). Un produit neuf marqué comme occasion réduit la confiance client et peut être rejeté lors de l'approbation. Soyez précis sur cet attribut.

Données descriptives et présentation

Les données descriptives déterminent comment le produit est présenté au client et influencent le classement en recherche.

title : nom du produit visible par le client. Doit inclure les informations essentielles (marque, modèle, caractéristique principale) dans les 150 premiers caractères. Les titres trop longs sont tronqués. Les titres sans marque ou trop génériques (par exemple, "Produit") sont rejetés lors de la validation du flux. Incluez les détails pertinents : "Chaise de bureau ergonomique noir avec accoudoirs réglables" plutôt que "Chaise".

description : texte détaillé du produit. Doit décrire les caractéristiques, les matériaux, les dimensions et les avantages. Les descriptions vides ou très courtes (moins de 50 caractères) réduisent la confiance client et le classement en recherche. Utilisez des phrases claires et structurées, pas du texte en vrac.

brand : marque du produit. Champ obligatoire pour tous les produits de marque. Les produits sans marque ou avec une marque non reconnue sont pénalisés en visibilité. Utilisez le nom officiel de la marque.

product_category : catégorie du produit selon la taxonomie Google. Exemples : "Apparel & Accessories", "Electronics", "Home & Garden". Une catégorie incorrecte entraîne un rejet du produit ou une mauvaise classification qui limite sa découverte. Consultez la taxonomie officielle et sélectionnez la catégorie la plus spécifique applicable.

image_url : URL de l'image principale du produit. Doit être une image de haute qualité, au moins 800 x 800 pixels, montrant le produit seul sur fond neutre. Les images floues, mal cadrées ou avec du texte superposé sont rejetées. L'image doit être accessible publiquement et servie via HTTPS. Une image manquante ou inaccessible entraîne le rejet du produit.

additional_image_urls : liste d'images supplémentaires séparées par des points-virgules. Fournissez 3 à 5 images montrant différents angles ou utilisations du produit. Ces images augmentent le taux de conversion en donnant une vue complète du produit.

Tarification et disponibilité

Les données de tarification et de disponibilité influencent directement la conversion et la confiance client.

price : prix standard du produit en devise locale. Doit correspondre au prix affiché sur votre site. Un prix incorrect cause des retours clients et des plaintes. Incluez les taxes si elles sont affichées au client sur votre site.

sale_price : prix réduit si applicable. Doit être inférieur au price. Les prix de promotion incorrects ou inversés (sale_price supérieur à price) sont rejetés.

sale_price_start_date et sale_price_end_date : dates de début et fin de la promotion au format ISO 8601 (YYYY-MM-DD). Si ces dates ne sont pas fournies, la plateforme peut considérer la promotion comme permanente, ce qui réduit son impact perçu. Utilisez des dates précises pour que les promotions s'affichent au moment opportun.

availability : statut de disponibilité. Les valeurs acceptées sont in stock, out of stock ou preorder. Un produit marqué comme disponible alors qu'il est en rupture de stock cause des commandes impossibles à traiter et endommage la réputation du vendeur. Mettez à jour ce champ en temps réel si possible.

availability_date : date prévue de disponibilité pour les articles en précommande ou rupture de stock. Format ISO 8601. Aide les clients à comprendre quand le produit sera disponible.

Variantes et attributs produit

Les attributs de variante permettent aux clients de sélectionner la version exacte du produit qu'ils souhaitent.

size : taille du produit. Doit correspondre à un système de taille standard (XS, S, M, L, XL pour les vêtements; cm ou pouces pour d'autres produits). Utilisez un format cohérent dans tout le flux.

color : couleur du produit en anglais ou français standard ("black", "red", "navy blue"). Les valeurs non standard ou mal orthographiées empêchent le regroupement des variantes.

gender : genre cible du produit. Valeurs : male, female, unisex. Utilisé pour filtrer les résultats de recherche.

age_group : groupe d'âge cible. Valeurs acceptées : newborn, infant, toddler, kids, adult. Essentiel pour les produits enfants ou les jouets pour assurer la conformité légale.

size_system : système de taille utilisé (par exemple, EU pour les chaussures européennes, US pour américaines). Évite la confusion lors de la conversion de tailles.

material : matériau principal du produit ("cotton", "leather", "plastic"). Améliore la pertinence en recherche et aide les clients à filtrer selon leurs préférences.

Informations de vente et logistique

seller_name : nom du vendeur tel qu'il doit apparaître au client. Doit correspondre à l'entité légale qui vend le produit. Un nom de vendeur incorrect ou trompeur peut entraîner le rejet du flux.

seller_url : URL de la page d'accueil du vendeur ou du site marchand. Doit être accessible et correspondre au seller_name fourni.

seller_privacy_policy et seller_tos : URLs des politiques de confidentialité et conditions d'utilisation. Obligatoires pour la conformité légale (RGPD, droit des consommateurs). Les produits sans ces documents sont rejetés.

return_policy : politique de retour en texte libre ou structuré. Doit inclure le délai de retour (par exemple, "30 jours"), les conditions (produit non utilisé) et le processus. Une politique claire augmente la confiance client et réduit les retours non justifiés.

pickup_method : mode de retrait disponible. Valeurs : ship, pickup, curbside. Indique comment le client peut recevoir le produit.

pickup_sla : délai de mise à disposition pour le retrait (par exemple, "2 jours"). Format : nombre suivi de l'unité ("hours", "days").

Dimensions et poids

weight et item_weight_unit : poids du produit et unité (kg, g, lb). Utilisé pour calculer les frais de port et vérifier la faisabilité de la livraison.

length, width, height et dimensions_unit : dimensions du produit et unité (cm, inches). Permet de vérifier les contraintes d'emballage et de calcul des frais.

Tarification unitaire

unit_pricing_measure et base_measure : pour les produits vendus à l'unité (par exemple, "100 ml" ou "1 kg"). Permet au client de comparer le prix au litre ou au kilo avec d'autres produits. Obligatoire pour les aliments et produits de consommation courante en certaines juridictions.

Ciblage géographique

target_countries : liste des pays où le produit peut être vendu, séparés par des virgules (codes ISO 2 lettres : FR, DE, IT). Restreint la visibilité géographique et évite les ventes impossibles à livrer.

store_country : pays où le vendeur est établi. Utilisé pour les calculs de TVA et la conformité réglementaire.

Offres et identifiants

offer_id : identifiant unique de l'offre spécifique (combinaison de produit, prix, vendeur). Utilisé pour suivre les changements de prix et de disponibilité au niveau granulaire. Doit rester stable pour la même offre.

url : URL de la fiche produit sur votre site. Doit être directement accessible, sans redirection, et afficher le produit correct. Une URL incorrecte ou cassée entraîne une mauvaise expérience client et est rejetée.

Optimisation pratique du flux

Validation avant transmission

Avant d'envoyer le flux, vérifiez que :

• Tous les item_id sont uniques et stables
• Les champs obligatoires (title, description, price, availability, image_url, brand, product_category) sont présents pour chaque produit
• Les trois champs d'éligibilité (is_eligible_search, is_eligible_checkout, is_eligible_ads) sont explicitement définis à true ou false
• Les URLs (image_url, url, seller_url) sont valides et accessibles
• Les images sont au format JPEG ou PNG, au moins 800 x 800 pixels
• Les prix sont cohérents (sale_price < price)
• Les codes GTIN sont au format correct (EAN-13, UPC-12)
• Les catégories correspondent à la taxonomie Google
• Les dates (sale_price_start_date, sale_price_end_date, availability_date) sont au format ISO 8601

Gestion des variantes

Pour les produits avec variantes (tailles, couleurs), créez un item_id distinct pour chaque combinaison mais utilisez le même group_id. Cela permet à la plateforme d'afficher un sélecteur de variantes au lieu de fiches produit séparées, améliorant l'expérience client et la conversion.

Mise à jour régulière

Transmettez le flux au moins une fois par jour pour que les données de disponibilité et de prix restent à jour. Les données obsolètes causent des commandes impossibles à traiter et endommagent la réputation du vendeur.

Monitoring et débogage

Vérifiez régulièrement les rapports d'erreurs fournis par la plateforme. Les erreurs courantes incluent :

• Images manquantes ou inaccessibles
• URLs cassées ou redirigeantes
• Catégories invalides
• Champs obligatoires manquants
• Codes GTIN mal formés

Corriger ces erreurs améliore immédiatement la visibilité et l'approbation des produits.

Données structurées et SEO

Bien que ce flux soit destiné à OpenAI Commerce, les données qu'il contient peuvent être utilisées pour générer des données structurées (schema.org) sur votre site. Cela améliore votre visibilité moteur recherche et votre taux de clic. Assurez-vous que les données du flux correspondent exactement à celles affichées sur votre site.

Résumé

Le flux OpenAI Commerce repose sur trois piliers : l'identification correcte des produits (item_id, gtin, group_id), la présentation de qualité (title, description, images) et les données transactionnelles précises (price, availability, seller_name). Les champs d'éligibilité (is_eligible_search, is_eligible_checkout, is_eligible_ads) contrôlent où et comment les produits sont visibles.

Une transmission régulière, une validation stricte et une mise à jour en temps réel de la disponibilité et des prix sont essentielles pour maintenir une bonne performance de vente. Les erreurs courantes, comme les images manquantes, les URLs cassées ou les catégories invalides, réduisent directement la visibilité et la conversion.

En respectant ces exigences et en optimisant chaque champ selon son impact spécifique, les commerçants maximisent leur présence sur la plateforme OpenAI Commerce et améliorent leur taux de conversion.