Flux de produits (product feed) — ACP

Le flux produit est l'ensemble structuré de données de catalogue — identifiant, titre, description, prix, disponibilité, images — qu'un marchand partage avec OpenAI pour que ChatGPT indexe ses produits et les présente avec exactitude. C'est le point de départ obligatoire de toute intégration à l'Agentic Commerce Protocol (ACP), livrable selon deux méthodes : par fichier ou par API. L'accès reste réservé aux partenaires approuvés via un formulaire de candidature (chatgpt.com/merchants).

Le parcours d'intégration

Cinq étapes structurent la mise en place d'un flux, telles que documentées sur developers.openai.com/commerce/guides/get-started : décider de la méthode d'intégration (arbitrage détaillé) ; revoir les spécifications de la méthode choisie et ses règles de validation ; valider les champs requis pour chaque enregistrement ; téléverser les données ; puis maintenir le flux à jour — en écrasant le même fichier ou jeu de fragments à cadence régulière pour la méthode fichier, en upsertant en continu pour la méthode API.

La recommandation par défaut combine les deux : le flux complet une fois par jour par fichier, puis des mises à jour tout au long de la journée par API. Un catalogue de petite taille peut se contenter de l'API seule, pour l'intégralité comme pour les mises à jour.

La contrainte des promotions

Les données de promotions ne peuvent être fournies que par API, quelle que soit la méthode retenue pour le catalogue produit lui-même — voir Schéma des promotions — ACP. Un marchand qui a choisi le fichier pour son catalogue devra donc malgré tout appeler l'API dès qu'il veut exposer des promotions, même sans autre besoin de mise à jour intrajournalière.

L'identifiant de flux

Côté API, la création d'un flux (Intégrer un flux produit par API — ACP) retourne un identifiant (id) qui sert ensuite de paramètre de chemin à tous les endpoints ultérieurs — produits comme promotions.

Mise en pratique

1. Demander l'accès via le formulaire partenaire avant toute intégration technique.
2. Choisir la méthode selon la taille du catalogue et le besoin de promotions — voir Flux par fichier vs flux par API — ACP.
3. Valider un échantillon avant tout envoi en volume, quelle que soit la méthode.
4. Prévoir l'API dès la conception si des promotions doivent un jour être exposées, même si le catalogue part sur la méthode fichier.

Erreurs à éviter

Vouloir exposer des promotions uniquement via le fichier plat ne fonctionne pas : ce n'est possible que par API. Traiter le choix de méthode comme définitif et exclusif est également une erreur : les deux méthodes sont conçues pour être combinées, pas pour s'exclure.

Ce qu'il faut retenir

Le flux produit est le socle unique sur lequel repose toute présence dans la découverte ChatGPT. Le choix de méthode (fichier, API, ou combinaison des deux) dépend de la taille du catalogue et du besoin de promotions — pas d'une préférence arbitraire — et la contrainte « promotions API uniquement » doit être anticipée dès la conception de l'intégration.