outil

Ads Manager

Ads Manager Idée centrale Ads Manager est l'outil d'OpenAI par lequel les annonceurs créent, lancent, gèrent et mesurent leurs campagnes publicitaires dans ChatGPT. Il est actuellement en Beta. Son statut et son existence sont confirmés par l'index du centre d'aide OpenAI dédié à « ChatGPT Ads ». Définition Une plateforme de gestion de campagnes publicitaires (création de compte, configuration, lancement, suivi, mesure, facturation) rattachée au produit Publicité dans ChatGPT. Synthèse…

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…