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

ObjectifLe mieux pourFacturationCe que la diffusion optimise
impressions (CPM)Portée et notoriétéPour 1 000 impressionsDiffusion large à l'échelle
clicks (CPC)Engagement et traficPar clic valideClics de personnes susceptibles de s'engager
conversions (oCPC)Une action suivie après un clicPar clic valide, pas par conversionClics plus susceptibles de mener à l'événement de conversion choisi

Prérequis

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 enfantbilling_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

Éléments essentiels

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

Relations

Points à vérifier

Sources