Flux Delta ChatGPT Ads : mettre à jour prix et stocks sans renvoyer tout le catalogue

En bref

Le flux Delta de ChatGPT Ads (Delta Feeds API) met à jour le titre, le prix et la disponibilité de variantes déjà présentes dans un flux produits, en n'envoyant que les produits modifiés, sans renvoyer tout le catalogue. Il ne crée ni flux ni produit : il suppose un catalogue initial déjà importé. L'accès est activé compte par compte, et une réponse « acceptée » ne garantit pas que la diffusion soit déjà à jour.

Mis à jour le 6 novembre 2026.

Un prix qui change à midi, un produit épuisé à 15 heures : pour une boutique en ligne, la fraîcheur du catalogue décide de ce qu'une annonce promet. Les campagnes à flux produits de ChatGPT Ads s'appuient sur ce catalogue, et OpenAI a prévu un flux Delta pour le corriger sans tout recharger. Ce guide, fondé sur la documentation développeurs et l'aide d'OpenAI consultées le 5 novembre 2026, explique ce que l'API fait, ce qu'elle ne fait pas, comment formater une requête et comment l'articuler avec les imports complets. Les produits importés ne servent qu'aux annonces pendant la bêta, d'après l'aide.

Les définitions à retenir

Flux produits : le catalogue importé dans Ads Manager, qui sert de base aux annonces des campagnes de type Product feed (aide OpenAI).

Delta Feeds API : l'interface qui met à jour la disponibilité, le titre et le prix de variantes existantes d'un flux lié, en n'envoyant que les produits qui ont changé (OpenAI Developers).

Variante : une déclinaison d'un produit parent, par exemple une taille ou une couleur, identifiée par son item_id dans le catalogue.

Unités mineures : la plus petite unité d'une devise : 8999 signifie 89,99 dollars en USD dans l'API.

Remplacement du catalogue : un réglage des flux éligibles selon lequel chaque envoi complet doit contenir tous les produits à conserver, faute de quoi les produits absents sont supprimés sous un jour.

Ce que fait le flux Delta, et ce qu'il ne fait pas

Le périmètre est volontairement étroit. L'API met à jour le prix, la disponibilité, le titre, ou plusieurs de ces éléments, pour des variantes déjà dans le flux. Elle ne crée pas de flux, ne charge pas de catalogue complet et n'ajoute pas de produit absent (OpenAI Developers).

Les autres modifications passent donc par un envoi complet : nouveaux produits, images, descriptions, ou rafraîchissement total. Notre article sur les flux produits ChatGPT Ads détaille la création du flux et de la campagne, et celui sur l'import en masse couvre la partie campagnes.

Les prérequis à vérifier

Avant d'écrire une ligne de code, OpenAI demande de réunir quatre éléments : une clé API Ads créée dans l'onglet Settings d'Ads Manager, un flux produits lié au compte avec son identifiant, un catalogue initial déjà importé, et les identifiants existants des produits parents et des variantes. L'accès à l'API est activé compte par compte : une erreur 403 avec le code product_feed_api_disabled ou product_feed_delta_api_disabled signifie qu'il faut contacter l'équipe OpenAI du compte (OpenAI Developers).

C'est un point à clarifier avec votre contact avant de planifier un chantier : la fonction n'est pas forcément ouverte sur votre compte. Pour les accès, rôles et clés, notre guide sur l'automatisation par l'API ChatGPT Ads donne le cadre général.

Formater une requête Delta

La documentation décrit une requête PATCH sur le chemin des produits du flux, avec la clé API dans l'en-tête d'autorisation. Le corps contient une liste de produits, chacun avec ses variantes à modifier.

Voici les règles de contenu à retenir :

Les identifiants suivent une règle précise : pour le produit, on utilise le group_id du catalogue quand les variantes sont groupées, sinon l'item_id ; pour la variante, l'item_id (OpenAI Developers).

Le piège des formats de prix

OpenAI insiste sur une différence qui provoque des erreurs : le fichier CSV écrit le prix en unités principales avec le code de devise, par exemple 79.99 USD, tandis que l'API Delta attend un entier en unités mineures, soit 7999 avec la devise USD. Les budgets et enchères de campagne utilisent encore une autre échelle, en micros : 50000000 équivalent à 50 unités principales, et la documentation précise de ne pas employer ces micros pour des prix de produits (OpenAI Developers).

Par analogie avec l'exemple du dollar, un prix de 89,99 euros s'enverrait sous la forme 8999 avec la devise EUR. Pour une devise sans décimale comme le yen, l'exemple de la documentation montre que 7999 représente 7 999 yens. Testez d'abord sur un seul produit avant d'automatiser.

Tableau comparatif : quelle méthode pour quel changement

OpenAI indique quelle méthode utiliser selon la nature de la modification.

Ce tableau reprend la logique de la page des flux produits (OpenAI Developers). L'aide d'OpenAI précise que les éléments d'un flux expirent au bout de deux semaines, d'où sa recommandation d'utiliser une URL hébergée ou des envois SFTP automatisés (aide OpenAI). La documentation ne dit pas si une mise à jour Delta prolonge cette durée : posez la question à votre contact et gardez un envoi complet régulier.

Ce que « accepté » veut dire

La réponse réussie contient l'identifiant du flux et la valeur accepted à vrai. Cela signifie que la mise à jour a été acceptée par le traitement du flux, pas que l'indexation, l'éligibilité publicitaire ou la diffusion sont à jour. Les changements s'appliquent ensuite de façon asynchrone, sans horodatage de fin dans la réponse (OpenAI Developers).

Un produit en rupture cesse d'être éligible à la diffusion une fois le changement propagé. Le remettre en stock ne garantit pas la diffusion : le produit, la campagne, le groupe d'annonces et l'annonce doivent encore respecter les conditions habituelles. Les erreurs possibles sont les suivantes : 400 pour une requête mal formée, 401 pour une clé absente ou invalide, 403 pour un accès désactivé ou des droits manquants, 404 pour un flux inexistant ou non lié au compte. Pour les erreurs 403 liées à l'accès désactivé, OpenAI demande de ne pas répéter la requête telle quelle.

Remplacement du catalogue et cohérence des sources

Le réglage de remplacement du catalogue concerne les envois complets : les produits absents du fichier sont supprimés dans un délai d'un jour. Il ne s'applique pas aux mises à jour Delta partielles. Autre règle de bon sens citée par OpenAI : gardez votre catalogue source cohérent avec les changements envoyés par l'API, pour que les envois suivants contiennent les bonnes valeurs (OpenAI Developers). Un prix baissé par Delta mais écrasé par un export ancien reviendrait en effet à sa valeur précédente au prochain envoi complet.

Après traitement, OpenAI conseille de contrôler titres et prix par les requêtes sur les produits. Pour la même rigueur côté Google, notre guide d'optimisation des flux Google Shopping pose les mêmes principes de qualité des données.

Notre checklist d'exploitation

Ce sont nos recommandations, pas celles d'OpenAI.

Pour une opération de fin d'année, associez ce dispositif à notre guide du Black Friday et de Noël sur ChatGPT Ads. Et pour mesurer ce que rapportent ces annonces, notre guide du jour sur la balise image et les pixels multiples complète la boucle.

Questions fréquentes

Le flux Delta peut-il ajouter un nouveau produit ?

Non : il met à jour des variantes déjà présentes. Les nouveaux produits passent par un envoi complet du catalogue. Source : OpenAI Developers.

Que peut-on modifier avec la Delta Feeds API ?

Le titre, le prix et la disponibilité d'une variante. Les images et descriptions exigent un envoi complet. Source : OpenAI Developers.

Dans quelle unité envoyer un prix ?

En entier, en unités mineures de la devise : 7999 pour 79,99 USD. Le CSV, lui, écrit 79.99 USD. Source : OpenAI Developers.

Pourquoi une erreur 403 apparaît-elle ?

L'accès à l'API est peut-être désactivé sur le compte, ou les droits de gestion des données de flux manquent. OpenAI demande de contacter l'équipe du compte. Source : OpenAI Developers.

Une mise à jour acceptée est-elle déjà visible dans les annonces ?

Pas forcément : elle est acceptée par le traitement du flux, puis appliquée de façon asynchrone. Source : OpenAI Developers.

Fiabiliser vos flux ChatGPT Ads avec AdsMirable

Nous aidons les e-commerçants à structurer leurs flux, leurs filtres de produits et leurs mises à jour avant les temps forts. Découvrez notre offre ChatGPT Ads, notre agence ChatGPT Ads en France, demandez un audit gratuit ou contactez-nous.

Sources