Documentation technique

Documentation technique Pour les développeurs : l'API Ads d'OpenAI en détail, endpoint par endpoint, pour automatiser vos campagnes plutôt que de tout faire à la main. Authentification, compte publicitaire et fichiers dans l'API Ads — L'API Ads d'OpenAI ( developers.openai.com/ads ) est une API REST distincte de l'interface Ads Manager, destinée aux développeurs et intégrateurs techniques. Chaque requête… Campagnes et annonces dans l'API Ads — Deux ressources de l'API REST…

Campagnes optimisées pour la conversion via l'API Ads (oCPC)

Campagnes optimisées pour la conversion via l'API Ads (oCPC) Idée centrale Une campagne « conversion-optimized » (oCPC) utilise le mode d'enchère bidding_type: "conversions" : la diffusion est optimisée vers un événement de conversion suivi, mais la facturation reste au clic valide, pas à la conversion. Ce processus documente, côté API REST, comment créer et piloter une telle campagne (standard ou à flux produits), en beta ouverte au moment de la…

Configuration d'un compte partenaire via l'API Ads (API Partner Setup)

Configuration d'un compte partenaire via l'API Ads (API Partner Setup) Idée centrale Ce guide opérationnel s'adresse aux partenaires API (agences ou plateformes tierces gérant des comptes clients) pour configurer, par programmation, un compte client existant : vérification du compte, complétion du favicon de marque, mise en place des conversions (pixel, clé API serveur, événement de conversion), puis création d'une campagne et d'un groupe d'annonces. C'est un point de vue «…

Création de campagnes à flux produits via l'API Ads

Création de campagnes à flux produits via l'API Ads Idée centrale Ce processus documente le workflow API complet des campagnes fondées sur un flux produits (« product feed ») : quatre composants s'articulent — le flux produits (catalogue), la campagne (mode: "product_feed"), l'ensemble de produits (product_set, sélection et filtres) et le modèle d'annonce produit (product_ad_template, remplissage automatique à partir du produit sélectionné). C'est la contrepartie technique/API de Création de campagnes…

Démarrage rapide de l'API Ads (Quickstart)

Démarrage rapide de l'API Ads (Quickstart) Idée centrale Ce guide de démarrage rapide documente l'implémentation minimale permettant de faire vivre une campagne publicitaire de bout en bout par l'API REST Ads d'OpenAI : de la vérification de l'accès au compte jusqu'à la lecture des résultats de performance. Le parcours suit exactement la hiérarchie campagne → groupe d'annonces → annonce : une annonce vit dans un groupe d'annonces, qui vit lui-même…

Authentification, compte publicitaire et fichiers dans l'API Ads

Authentification, compte publicitaire et fichiers dans l'API Ads Idée centrale L'API Ads d'OpenAI (developers.openai.com/ads) est une API REST distincte de l'interface Ads Manager, destinée aux développeurs et intégrateurs techniques. Chaque requête s'authentifie par une clé API portée par un en-tête Authorization: Bearer, scopée à un seul compte publicitaire. Cette page regroupe les trois éléments socles sur lesquels reposent tous les autres points de terminaison de cette API : le mécanisme…

Campagnes et annonces dans l'API Ads

Campagnes et annonces dans l'API Ads Idée centrale Deux ressources de l'API REST Ads d'OpenAI (api.ads.openai.com/v1) forment le cœur de la gestion programmatique de la hiérarchie publicitaire : la campagne (campaign), qui porte budget, calendrier et ciblage, et l'annonce (ad), qui porte le contenu créatif. Chacune expose un cycle de vie CRUD complet (créer, lire, mettre à jour) ainsi que des actions dédiées de changement d'état (activate, pause, archive). Le…

Ciblage géographique des campagnes dans l'API Ads (Campaign Targeting)

Ciblage géographique des campagnes dans l'API Ads (Campaign Targeting) Idée centrale L'API Ads permet de cibler géographiquement une campagne par pays, région ou DMA (« Designated Market Area », zone de marché télévisuel/publicitaire nord-américaine). Le ciblage repose sur deux étapes : rechercher des identifiants de localisation via un endpoint dédié (geo_lookup/search), puis les appliquer au champ targeting.locations.include lors de la création (ou mise à jour) d'une campagne — voir Campagnes…

Configuration de la mesure de conversion dans l'API Ads (Conversion Setup)

Configuration de la mesure de conversion dans l'API Ads (Conversion Setup) Idée centrale Avant de pouvoir envoyer des événements de conversion — que ce soit via le Pixel de mesure JavaScript (Measurement Pixel) ou la Conversions API (mesure de conversion côté serveur) — trois ressources doivent être créées par programmation pour le compte publicitaire courant : un pixel (source de conversion web), une clé Conversions API (pour l'envoi côté serveur),…

Conversions API (mesure de conversion côté serveur)

Conversions API (mesure de conversion côté serveur) Idée centrale La Conversions API permet d'envoyer des événements de conversion directement depuis le serveur d'un annonceur ou d'un partenaire de mesure vers OpenAI, en complément du Pixel de mesure JavaScript (Measurement Pixel) côté navigateur. La documentation la présente comme « une source de suivi plus fiable que le pixel seul » (« a more reliable tracking source than the pixel alone »),…

Image Tag (suivi de conversion sans JavaScript)

Image Tag (suivi de conversion sans JavaScript) Idée centrale L'Image Tag est une troisième méthode d'envoi d'événements de conversion à l'API Ads d'OpenAI, aux côtés du Pixel de mesure JavaScript (Measurement Pixel) et de la Conversions API (mesure de conversion côté serveur) : une balise <img> 1×1 dont l'URL de requête encode l'événement, sans aucune exécution de JavaScript. Chaque requête image envoie un seul événement, au chargement de la page.…

Insights et reporting dans l'API Ads

Insights et reporting dans l'API Ads Idée centrale L'API Ads expose quatre points de terminaison de reporting (« insights »), tous de même mécanique de requête et de forme de réponse, qui renvoient des métriques de performance (impressions, clics, dépense, CTR, CPC, CPM) agrégées par entité publicitaire (compte, campagne, groupe d'annonces, annonce) et par fenêtre temporelle, avec prise en charge du filtrage, du tri, de la segmentation et de la…

Mise à jour incrémentale d'un flux produit (Delta Feeds API)

Mise à jour incrémentale d'un flux produit (Delta Feeds API) Idée centrale La Delta Feeds API met à jour la disponibilité et le titre de variantes déjà existantes dans un flux produit lié, sans retéléverser l'intégralité du catalogue. C'est un mécanisme d'optimisation opérationnelle qui présuppose systématiquement un flux et un catalogue initial déjà en place, documentés dans Création de campagnes à flux produits via l'API Ads : elle ne crée…

Opérations en masse sur les campagnes, groupes d'annonces et annonces (Bulk API)

Opérations en masse sur les campagnes, groupes d'annonces et annonces (Bulk API) Idée centrale Le Bulk API est un point de terminaison asynchrone qui permet de créer ou mettre à jour, en une seule requête, jusqu'à 1 000 opérations portant sur des campagnes, groupes d'annonces et annonces. Un job soumis se suit et se récupère par identifiant, avec inspection du résultat de chaque opération individuelle. Le Bulk API est en…

Pixel de mesure JavaScript (Measurement Pixel)

Pixel de mesure JavaScript (Measurement Pixel) Idée centrale Le Measurement Pixel (« ChatGPT Ads Measurement Pixel ») est le SDK JavaScript côté navigateur d'OpenAI pour mesurer les événements de conversion sur un site web après qu'un utilisateur a cliqué sur une annonce ChatGPT. Il repose sur une seule primitive globale, la fonction oaiq(command, ...args), déclinée en plusieurs commandes : init (initialisation), consent (contrôle du consentement), measure (envoi d'un événement à…

Événements de conversion pris en charge par l'API Ads (Supported Events)

Événements de conversion pris en charge par l'API Ads (Supported Events) Idée centrale Cette page documente le vocabulaire standardisé des événements de conversion de l'API Ads d'OpenAI : treize noms d'événements standard, chacun associé à un type de données (« data shape »), et la structure exacte de chaque type de données. Ce vocabulaire est transverse : il est consommé à l'identique par les trois canaux d'envoi d'événements — Pixel…