Elegir el tipo correcto: el árbol de decisión
Los tres tipos responden a necesidades de compra distintas. Dos preguntas lo resuelven:
- ¿El volumen está garantizado? Si el comprador quiere una reserva firme de impresiones, es un Programmatic Guaranteed. Si no, PMP o Preferred Deal.
- ¿El precio es fijo o por subasta? Un precio negociado fijo sin volumen comprometido → Preferred Deal. Varios compradores compitiendo por encima de un suelo → Private Auction (PMP).
El flujo de configuración
La vía técnica difiere según el tipo — REST para PMP, SOAP (Proposal) para PG y PD.
Vía PMP (Private Auction) — REST
- Crear el PrivateAuction padre (
create_auction) — el contenedor con nombre que agrupa los deals de una negociación. - Identificar al comprador (
list_buyers) — obtener elbuyer_account_iddel seat de Authorized Buyers (DSP). - Crear el deal (
create_deal,deal_type = pmp_auction) con elfloor_price(CPM mínimo) y, opcionalmente, la segmentación y los tamaños de creatividades.
Vía PG / PD — SOAP (Proposal + ProposalLineItem)
- Crear el Proposal (
create_proposal) — requiere el anunciante (Company), el comercial, el trafficker y el buyer del marketplace antes de cualquier acción. - Añadir los ProposalLineItem (
create_proposal_line_items) —lineItemType = SPONSORSHIPpara un PG,PREFERRED_DEALpara un PD, con el net rate (CPM), el goal y la segmentación. - Avanzar el estado —
request_buyer_acceptancepara enviarlo al comprador, oreserve_proposalpara reservar el inventario (PG). La negociación pasa poredit_proposal_for_negotiation,get_marketplace_commentsy, si hace falta,terminate_proposal_negotiations.
El flujo de validación
Es el paso que la consola de GAM no hace explícito — y donde los deals fallan más a menudo. OrbiAds valida por adelantado, antes de cualquier llamada de red:
- Validación local — jerarquía geográfica de la segmentación,
floor_priceestrictamente positivo y las restricciones propias de cada tipo: PG exige un volumenunits > 0, PD imponeFRONTLOADED+goalType = NONE. El discriminador garantiza que solo un spec (PMP/PG/PD) esté relleno. - Estimación de coste (
estimate_deal_cost) — el número de créditos se calcula y se muestra antes de la escritura, según el tipo y el número de line items. - Dry-run y luego confirmación — cada escritura se simula primero (
dry_run = true) y devuelve unconfirmation_token. Nada se envía a GAM hasta confirmar el token: ningún deal se activa por accidente. - Ciclo de vida del estado — un deal pasa de
PENDING_ACCEPTANCEaACTIVE, y luego posiblemente aPAUSED,CANCELEDoENDED. Comprobar ese estado forma parte de la validación posterior a la creación.
Con OrbiAds, en lenguaje natural
La herramienta MCP deals expone todo este flujo a tu agente de IA (Claude, ChatGPT, Gemini) — crear y actualizar deals, auctions, buyers, proposals y proposal line items, además de estimate_deal_cost y la integración AdCP. Las lecturas son gratuitas; solo las escrituras consumen créditos, siempre tras el dry-run y la confirmación.
