Gérer les flux produits via l'API : création, accès SFTP, historique des envois et archivage

Jusqu'en octobre, le flux produits était la dernière pièce de ChatGPT Ads qui ne pouvait se gérer que dans l'OpenAI Ads Manager : le créer, récupérer les identifiants, vérifier les envois. L'API Advertiser couvre désormais ce déroulé, et Chatvertise l'a intégré dans la page « Flux produits ». Cet article parcourt le cycle de vie d'un flux, nomme les limites qui subsistent et décrit une bizarrerie qui surprend à la mise en pause de l'accès SFTP.

1. Créer le flux

Un nouveau flux n'a besoin que de deux informations : un nom et la liste des pays auxquels il s'applique. Sans nom, l'API refuse. Le résultat est un conteneur vide avec un identifiant de flux ; il ne contient encore aucun produit. Dans Chatvertise, c'est « Créer un nouveau flux » sur la page des flux produits.

2. Créer l'accès SFTP

Pour l'envoi par SFTP, vous générez des identifiants pour le flux : soit un mot de passe, soit une clé SSH publique. L'adresse de connexion est fixe et s'affiche à côté. Deux points importants : le mot de passe fait 32 caractères et ne s'affiche qu'une seule fois ; Chatvertise ne l'enregistre pas. Et si vous choisissez SSH, vous devez transmettre la clé publique, sinon l'API renvoie une erreur.

3. Envoyer le catalogue

C'est ici que l'API s'arrête : les produits ne peuvent toujours pas être envoyés via l'API Advertiser, seulement par SFTP, en fichier ou dans l'Ads Manager. Vous pouvez ajuster après coup des produits individuels par mise à jour delta, par exemple la disponibilité ou le titre, mais pas charger le catalogue. Pour les marchands Shopify, l'import Shopify reste le chemin le plus court, car il contourne l'envoi de flux.

4. Vérifier le traitement

Après l'envoi, l'API affiche un historique de tous les envois du compte avec statut, nombre de lignes et diagnostics. Chatvertise les liste dans le tableau « Derniers imports de flux » : quel envoi a été traité quand, combien de lignes il comptait, et quelles lignes OpenAI a rejetées pour quel motif. Cela remplace l'attente aveugle pour savoir si un catalogue est arrivé. La liste des derniers envois par flux est séparée, et en cas de nombreux envois, l'historique se charge page par page.

5. Réglages et campagne de flux

Outre le nom, les pays et la question du respect de la disponibilité à la recherche des produits, il existe un réglage appelé « Remplacement complet à chaque import » : s'il est activé, chaque envoi remplace le catalogue entier ; s'il est désactivé, il n'ajoute que les changements. Si vous exportez chaque nuit tout le catalogue, vous voulez « activé » ; si vous n'envoyez que des deltas, « désactivé ». Dès que les produits sont là, la campagne de flux suit, avec product sets et annonce modèle.

6. Archiver

Un flux qui n'est plus nécessaire peut être archivé. Il disparaît ensuite de la liste et son accès SFTP n'est plus consultable. L'appel est idempotent : archiver une seconde fois n'est pas une erreur. Chatvertise verrouille le bouton tant que des campagnes sont reliées au flux, pour qu'aucune campagne de flux en cours ne perde sa source.

La bizarrerie à la mise en pause de l'accès SFTP

L'accès SFTP peut être mis en pause, par exemple lors d'un changement de prestataire. Ce qu'on attendrait : l'activation rétablit l'ancien accès. Ce qui se passe réellement : après la pause, la méthode d'authentification est vide, et l'activation laisse l'accès désactivé. Vous devez générer de nouveaux identifiants. Chatvertise le signale à cet endroit ; en pratique, cela signifie que la pause est une révocation, pas un interrupteur.

Ce qui change avec les variantes et la disponibilité

Depuis octobre, la requête produits d'un flux renvoie la variante, la disponibilité et l'identifiant d'offre par produit. Chatvertise transmet ces champs à l'aperçu des produits. Pour les product sets, cela signifie qu'un filtre sur les articles en stock devient possible dès que le flux fournit la disponibilité.

Pour qui c'est pertinent

• Les agences qui gèrent des flux pour plusieurs clients : créer, générer l'accès et vérifier les diagnostics d'envoi sans passer dans chaque Ads Manager.
• Les boutiques avec leur propre export : le job SFTP nocturne gagne une étape de contrôle qui rend visibles les lignes en échec.
• Tous les autres : si vous avez un flux et ne faites que le consulter, vous aurez rarement besoin des nouvelles fonctions. L'historique des envois mérite tout de même un coup d'œil après chaque mise à jour du catalogue.

Toutes les nouveautés du mois, y compris les endpoints du compte, sont dans la mise à jour de fin octobre.