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 capture.
Définition
Le parcours de configuration d'une campagne à bidding_type: "conversions" via POST /campaigns et POST /ad_groups (voir Campagnes et annonces dans l'API Ads), incluant ses prérequis de mesure de conversion et ses règles de facturation, documenté par la page « Conversion-Optimized Campaigns » de la documentation développeur Ads. Contrepartie API du même objectif de campagne documenté côté interface dans Création de campagnes dans Ads Manager (section oCPC).
Contexte
S'appuie sur Campagnes et annonces dans l'API Ads (endpoints POST /campaigns/POST /ad_groups) et sur Configuration de la mesure de conversion dans l'API Ads (Conversion Setup) (provisionnement de l'événement de conversion). Cette page ne définit elle-même aucun nouveau champ ou endpoint : elle illustre un scénario d'usage combinant des champs déjà définis ailleurs. Capturée le 2026-08-08.
Fonctionnement
Trois objectifs de campagne
| Objectif | Le mieux pour | Facturation | Ce que la diffusion optimise |
|---|---|---|---|
impressions (CPM) | Portée et notoriété | Pour 1 000 impressions | Diffusion large à l'échelle |
clicks (CPC) | Engagement et trafic | Par clic valide | Clics de personnes susceptibles de s'engager |
conversions (oCPC) | Une action suivie après un clic | Par clic valide, pas par conversion | Clics plus susceptibles de mener à l'événement de conversion choisi |
Prérequis
- Le compte publicitaire doit prendre en charge l'enchère à la conversion. Si la création de campagne renvoie
403avec le message « Conversion bidding is not enabled », contacter son représentant partenaire OpenAI. - Le suivi de conversion doit être configuré via le Pixel de mesure JavaScript (Measurement Pixel), la Conversions API (mesure de conversion côté serveur), ou les deux — cette dernière étant présentée comme une source de suivi plus fiable que le pixel seul.
- Exactement un événement de conversion standard actif (voir Événements de conversion pris en charge par l'API Ads (Supported Events)) à utiliser comme objectif d'optimisation. Les événements personnalisés ne peuvent pas être des objectifs oCPC.
- Le réglage d'événement de conversion doit appartenir au compte publicitaire courant et se connecter à une seule source de conversion active.
- L'oCPC pour les campagnes à flux produits est en beta ouverte. Ni l'objectif ni l'événement de conversion sélectionné ne peuvent être changés après création de la campagne.
Créer une campagne conversion-optimized
Créer avec status: "paused" pendant l'ajout et la vérification des groupes d'annonces et annonces.
curl -X POST "https://api.ads.openai.com/v1/campaigns" \
-H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme purchases",
"status": "paused",
"budget": { "lifetime_spend_limit_micros": 250000000 },
"bidding_type": "conversions",
"conversion_event_setting_ids": ["ces_123"]
}'
ces_123 est l'identifiant du réglage d'événement de conversion actif (créé via Configuration de la mesure de conversion dans l'API Ads (Conversion Setup)) représentant l'objectif visé (exemples : order_created, lead_created, registration_completed).
Variante à flux produits — même endpoint, avec mode: "product_feed" et un product_feed_id lié (voir Création de campagnes à flux produits via l'API Ads) :
curl -X POST "https://api.ads.openai.com/v1/campaigns" \
-H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Running shoes catalog purchases",
"status": "paused",
"mode": "product_feed",
"product_feed_id": "product_feed_123",
"budget": { "lifetime_spend_limit_micros": 250000000 },
"bidding_type": "conversions",
"conversion_event_setting_ids": ["ces_123"]
}'
Groupe d'annonces enfant — billing_event_type: "click" obligatoire. max_bid_micros correspond alors à l'enchère CPA (coût par acquisition), même si la facturation reste basée sur les clics valides. Exemple : 100000000 équivaut à 100,00 $ de CPA pour un compte en USD.
curl -X POST "https://api.ads.openai.com/v1/ad_groups" \
-H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"campaign_id": "cmpn_101",
"name": "US English",
"status": "active",
"bidding_config": {
"billing_event_type": "click",
"max_bid_micros": 100000000
}
}'
Pour une campagne à flux produits, le groupe d'annonces hérite automatiquement du flux de la campagne ; product_set n'est à inclure que pour des filtres de produits. Les annonces se créent ensuite normalement (voir Campagnes et annonces dans l'API Ads et Démarrage rapide de l'API Ads (Quickstart)) ; la campagne s'active une fois toutes les ressources enfants prêtes.
Diffusion et facturation
oCPC combine l'événement de conversion sélectionné avec la qualité de l'annonce, la pertinence, la probabilité de clic et la probabilité de conversion pour favoriser les clics les plus susceptibles de mener à cet événement. L'enchère CPA contrôle la compétitivité de la campagne dans l'enchère. La facturation ne change pas vers un paiement par conversion : OpenAI facture uniquement lorsqu'un clic valide se produit, et l'enchère au sein de l'enchère (auction) détermine le CPC réel. L'enchère CPA doit être traitée comme une entrée d'optimisation, pas comme un tarif de conversion.
Suivi et amélioration de la performance
Comme oCPC optimise vers l'événement sélectionné, les conversions sont le résultat principal à suivre ; le coût par conversion se calcule en divisant la dépense par les conversions. Les endpoints Insights permettent de récupérer ces métriques par voie programmatique.
Conseils : choisir l'événement de conversion standard représentant le mieux l'objectif de la campagne ; maintenir un suivi de conversion en bon état ; utiliser un événement avec un volume suffisant pour évaluer la performance ; aligner le texte de l'annonce avec l'intention de l'utilisateur ; examiner un volume suffisant avant d'effectuer des changements importants d'enchères, de budgets ou de créations.
Questions fréquentes
- Événements pris en charge : exactement un réglage d'événement de conversion standard actif ; les événements personnalisés ne sont pas pris en charge comme objectifs.
- Changer une campagne existante : non — impossible de convertir une campagne CPM ou CPC existante en oCPC ; il faut créer une nouvelle campagne.
- Changer l'événement de conversion sélectionné : non — impossible après création ; une nouvelle campagne est nécessaire.
- Facturation : non, oCPC optimise la diffusion vers l'événement sélectionné, mais la facturation continue d'utiliser les clics valides.
- Campagnes à flux produits : oui — disponible en beta ouverte, selon le même schéma que ci-dessus.
Éléments essentiels
- Le tableau comparatif des trois objectifs de campagne positionne clairement oCPC comme un troisième objectif à part entière, toujours facturé au clic, mais avec une logique d'optimisation distincte de CPM et CPC.
- Le « Bid Cap » de l'interface Ads Manager (voir Création de campagnes dans Ads Manager) et
max_bid_microsdansbidding_configde l'API désignent le même concept (enchère CPA) sous deux noms différents.
Distinctions importantes
Ne pas confondre cette page (contrepartie API) avec la section oCPC de Création de campagnes dans Ads Manager (même mécanisme, décrit côté interface) : les deux apportent des faits distincts — vocabulaire UI/Bid Cap/FAQ côté interface ; endpoints/JSON/statut beta/erreur 403/campagnes à flux produits côté API. Trois informations figurent ici sans équivalent dans la page UI existante : le statut explicite de beta ouverte, le code et message d'erreur exacts (403 / « Conversion bidding is not enabled »), et la prise en charge documentée des campagnes oCPC à flux produits.
Ne pas confondre bidding_type: "conversions" (objectif de campagne, verrouillé après création) et conversion_event_setting_ids (l'événement précis optimisé au sein de cet objectif, également verrouillé après création) : deux verrous distincts.
Cas pratiques
Aucun cas pratique disponible : identifiants et exemples (Acme purchases, ces_123) manifestement fictifs et illustratifs.
Erreurs fréquentes
Ne pas essayer de convertir une campagne CPM ou CPC existante en oCPC : il faut toujours créer une nouvelle campagne avec bidding_type: "conversions".
Ne pas utiliser un événement de conversion personnalisé (custom) comme objectif d'optimisation oCPC : seuls les événements standards actifs sont acceptés.
Ne pas interpréter max_bid_micros en contexte oCPC comme un tarif garanti par conversion : c'est une entrée d'optimisation d'enchère, la facturation reste au clic.
Limites et nuances
- Source unique, page de documentation développeur officielle récupérée par le web (dérogation ponctuelle autorisée), sans SHA-256 de fichier local.
- Statut « beta ouverte » mentionné explicitement à deux reprises, sans date de sortie prévue ni limitations fonctionnelles énumérées au-delà de celles déjà listées.
- Comportement exact de l'API si
conversion_event_setting_idscontient plus d'un identifiant non confirmé (rejet à la création, ou validation silencieuse du premier élément — la page insiste sur « exactement un » sans le démontrer par un exemple d'erreur). - Mécanique précise de l'enchère par probabilité de conversion prédite (modèle partagé avec CPC classique ou distinct) non détaillée.
- La page de référence « Ad Groups » est absente du lot de sources traité : le détail exhaustif de
bidding_configet des autres modes d'enchère possibles n'est illustré que par cette page et par Campagnes et annonces dans l'API Ads. - Aucune fourchette d'enchère CPA recommandée, ni délai d'apprentissage typique, ni donnée chiffrée de performance réelle — cohérent avec la même limite déjà relevée côté interface dans Création de campagnes dans Ads Manager.
Relations
- Campagnes et annonces dans l'API Ads — endpoints
POST /campaigns/POST /ad_groupsréutilisés ici. - Configuration de la mesure de conversion dans l'API Ads (Conversion Setup) — fournit
conversion_event_setting_ids. - Événements de conversion pris en charge par l'API Ads (Supported Events) — liste des événements standard éligibles.
- Insights et reporting dans l'API Ads — suivi programmatique des conversions et du coût par conversion.
- Création de campagnes à flux produits via l'API Ads — variante à flux produits de l'oCPC.
- Démarrage rapide de l'API Ads (Quickstart) — séquence générale de création de ressources publicitaires.
- Création de campagnes dans Ads Manager — équivalent côté interface Ads Manager (« Bid Cap »), à distinguer sans fusionner.
Points à vérifier
- Comportement exact de l'API si
conversion_event_setting_idscontient plus d'un identifiant. - Mécanique précise de l'enchère par probabilité de conversion prédite.
- Limitations fonctionnelles précises de la beta ouverte (quotas, disponibilité par type de compte, date de sortie de beta envisagée).
- Contenu complet des pages de référence Ad Groups (absente de ce lot), Conversion Setup, Campaigns et Insights pour valider tous les champs mentionnés de façon incidente.
Sources
SRC-2026-046— « Conversion-Optimized Campaigns (API) »,developers.openai.com/ads/conversion-optimized-campaigns, capturée le 2026-08-08.