Choisir le bon type : l'arbre de décision
Les trois types répondent à des besoins d'achat distincts. Deux questions suffisent à trancher :
- Le volume est-il garanti ? Si l'acheteur veut une réservation ferme d'impressions, c'est un Programmatic Guaranteed. Sinon, PMP ou Preferred Deal.
- Le prix est-il fixe ou en enchère ? Un prix négocié fixe sans volume garanti → Preferred Deal. Une mise en concurrence de plusieurs acheteurs au-dessus d'un plancher → Private Auction (PMP).
Le workflow de setup
Le chemin technique diffère selon le type — REST pour le PMP, SOAP (Proposal) pour PG et PD.
Chemin PMP (Private Auction) — REST
- Créer le PrivateAuction parent (
create_auction) — le conteneur nommé qui regroupe les deals d'une même négociation. - Identifier l'acheteur (
list_buyers) — récupérer lebuyer_account_iddu siège Authorized Buyers (DSP). - Créer le deal (
create_deal,deal_type = pmp_auction) avec lefloor_price(CPM minimum) et, optionnellement, le ciblage et les tailles de créatifs.
Chemin PG / PD — SOAP (Proposal + ProposalLineItem)
- Créer le Proposal (
create_proposal) — il requiert l'annonceur (Company), le commercial, le trafficker et le buyer marketplace avant toute action. - Ajouter les ProposalLineItem (
create_proposal_line_items) —lineItemType = SPONSORSHIPpour un PG,PREFERRED_DEALpour un PD, avec le net rate (CPM), le goal et le ciblage. - Faire avancer l'état —
request_buyer_acceptancepour envoyer à l'acheteur, oureserve_proposalpour réserver l'inventaire (PG). La négociation passe paredit_proposal_for_negotiation,get_marketplace_commentset, si besoin,terminate_proposal_negotiations.
Le workflow de validation
C'est l'étape que la console GAM ne rend pas explicite — et là où les deals cassent le plus souvent. OrbiAds valide en amont, avant tout appel réseau :
- Validation locale — hiérarchie géo du ciblage,
floor_pricestrictement positif, et les contraintes propres à chaque type : PG exige un volumeunits > 0, PD imposeFRONTLOADED+goalType = NONE. Le discriminateur garantit qu'un seul spec (PMP/PG/PD) est renseigné. - Estimation de coût (
estimate_deal_cost) — le nombre de crédits est calculé et affiché avant l'écriture, selon le type et le nombre de line items. - Dry-run puis confirmation — chaque écriture est d'abord simulée (
dry_run = true) et renvoie unconfirmation_token. Rien n'est envoyé à GAM tant que le token n'est pas confirmé : aucun deal ne part par accident. - Cycle de vie du statut — un deal évolue de
PENDING_ACCEPTANCEversACTIVE, puis éventuellementPAUSED,CANCELEDouENDED. Vérifier ce statut fait partie de la validation post-création.
Avec OrbiAds, en langage naturel
L'outil MCP deals expose tout ce workflow à votre agent IA (Claude, ChatGPT, Gemini) — création et mise à jour de deals, auctions, buyers, proposals et proposal line items, plus estimate_deal_cost et l'intégration AdCP. Les lectures sont gratuites ; seules les écritures consomment des crédits, toujours après le dry-run et la confirmation.
