Tipi di deal Google Ad Manager:
PMP, Guaranteed e Preferred

Scegliere il tipo giusto: l'albero decisionale

I tre tipi rispondono a esigenze di acquisto distinte. Due domande bastano a decidere:

• Il volume è garantito? Se l'acquirente vuole una prenotazione ferma di impressioni, è un Programmatic Guaranteed. Altrimenti, PMP o Preferred Deal.
• Il prezzo è fisso o ad asta? Un prezzo negoziato fisso senza volume impegnato → Preferred Deal. Più acquirenti in competizione sopra una soglia → Private Auction (PMP).

Il workflow di setup

Il percorso tecnico differisce per tipo — REST per il PMP, SOAP (Proposal) per PG e PD.

Percorso PMP (Private Auction) — REST

1. Creare il PrivateAuction padre (create_auction) — il contenitore con nome che raggruppa i deal di una negoziazione.
2. Identificare l'acquirente (list_buyers) — ottenere il buyer_account_id del seat Authorized Buyers (DSP).
3. Creare il deal (create_deal, deal_type = pmp_auction) con il floor_price (CPM minimo) e, facoltativamente, il targeting e le dimensioni delle creatività.

Percorso PG / PD — SOAP (Proposal + ProposalLineItem)

1. Creare il Proposal (create_proposal) — richiede l'inserzionista (Company), il commerciale, il trafficker e il buyer del marketplace prima di qualsiasi azione.
2. Aggiungere i ProposalLineItem (create_proposal_line_items) — lineItemType = SPONSORSHIP per un PG, PREFERRED_DEAL per un PD, con il net rate (CPM), il goal e il targeting.
3. Far avanzare lo stato — request_buyer_acceptance per inviarlo all'acquirente, o reserve_proposal per riservare l'inventory (PG). La negoziazione passa da edit_proposal_for_negotiation, get_marketplace_comments e, se serve, terminate_proposal_negotiations.

Il workflow di validazione

È il passaggio che la console GAM non rende esplicito — e dove i deal si rompono più spesso. OrbiAds valida a monte, prima di qualsiasi chiamata di rete:

• Validazione locale — gerarchia geografica del targeting, floor_price strettamente positivo e i vincoli propri di ogni tipo: PG richiede un volume units > 0, PD impone FRONTLOADED + goalType = NONE. Il discriminatore garantisce che sia compilato un solo spec (PMP/PG/PD).
• Stima del costo (estimate_deal_cost) — il numero di crediti è calcolato e mostrato prima della scrittura, in base al tipo e al numero di line item.
• Dry-run e poi conferma — ogni scrittura è prima simulata (dry_run = true) e restituisce un confirmation_token. Nulla viene inviato a GAM finché il token non è confermato: nessun deal va live per sbaglio.
• Ciclo di vita dello stato — un deal passa da PENDING_ACCEPTANCE ad ACTIVE, poi eventualmente PAUSED, CANCELED o ENDED. Verificare quello stato fa parte della validazione post-creazione.

Con OrbiAds, in linguaggio naturale

Lo strumento MCP deals espone tutto questo workflow al tuo agente IA (Claude, ChatGPT, Gemini) — creare e aggiornare deal, auction, buyer, proposal e proposal line item, più estimate_deal_cost e l'integrazione AdCP. Le letture sono gratuite; solo le scritture consumano crediti, sempre dopo il dry-run e la conferma.