Den richtigen Typ wählen: der Entscheidungsbaum
Die drei Typen bedienen unterschiedliche Kaufbedürfnisse. Zwei Fragen genügen:
- Ist das Volumen garantiert? Will der Käufer eine feste Impressions-Reservierung, ist es ein Programmatic Guaranteed. Andernfalls PMP oder Preferred Deal.
- Ist der Preis fix oder per Auktion? Ein fester Verhandlungspreis ohne zugesagtes Volumen → Preferred Deal. Mehrere Käufer im Wettbewerb über einem Mindestpreis → Private Auction (PMP).
Der Setup-Workflow
Der technische Weg unterscheidet sich je nach Typ — REST für PMP, SOAP (Proposal) für PG und PD.
PMP-Weg (Private Auction) — REST
- Die übergeordnete PrivateAuction erstellen (
create_auction) — der benannte Container, der die Deals einer Verhandlung gruppiert. - Den Käufer identifizieren (
list_buyers) — diebuyer_account_iddes Authorized-Buyers-Seats (DSP) abrufen. - Den Deal erstellen (
create_deal,deal_type = pmp_auction) mit demfloor_price(Mindest-CPM) und optional Targeting und Creative-Größen.
PG- / PD-Weg — SOAP (Proposal + ProposalLineItem)
- Das Proposal erstellen (
create_proposal) — es erfordert den Advertiser (Company), den Salesperson, den Trafficker und den Marketplace-Buyer vor jeder Aktion. - Die ProposalLineItems hinzufügen (
create_proposal_line_items) —lineItemType = SPONSORSHIPfür ein PG,PREFERRED_DEALfür ein PD, mit Net Rate (CPM), Goal und Targeting. - Den Status vorantreiben —
request_buyer_acceptance, um es an den Käufer zu senden, oderreserve_proposal, um Inventar zu reservieren (PG). Die Verhandlung läuft überedit_proposal_for_negotiation,get_marketplace_commentsund bei Bedarfterminate_proposal_negotiations.
Der Validierungs-Workflow
Das ist der Schritt, den die GAM-Konsole nicht explizit macht — und wo Deals am häufigsten scheitern. OrbiAds validiert vorab, vor jedem Netzwerkaufruf:
- Lokale Validierung — Geo-Hierarchie des Targetings, ein strikt positiver
floor_priceund die typspezifischen Bedingungen: PG erfordert ein Volumenunits > 0, PD erzwingtFRONTLOADED+goalType = NONE. Der Diskriminator stellt sicher, dass genau ein Spec (PMP/PG/PD) gesetzt ist. - Kostenschätzung (
estimate_deal_cost) — die Anzahl der Credits wird vor dem Schreiben berechnet und angezeigt, abhängig vom Typ und der Anzahl der Line Items. - Dry-Run, dann Bestätigung — jeder Schreibvorgang wird zuerst simuliert (
dry_run = true) und gibt einconfirmation_tokenzurück. Nichts wird an GAM gesendet, bis das Token bestätigt ist: kein Deal geht versehentlich live. - Status-Lebenszyklus — ein Deal wandert von
PENDING_ACCEPTANCEzuACTIVE, dann möglicherweisePAUSED,CANCELEDoderENDED. Diesen Status zu prüfen gehört zur Validierung nach der Erstellung.
Mit OrbiAds, in natürlicher Sprache
Das MCP-Tool deals stellt diesen gesamten Workflow Ihrem KI-Agenten (Claude, ChatGPT, Gemini) bereit — Deals, Auctions, Buyers, Proposals und Proposal Line Items erstellen und aktualisieren, plus estimate_deal_cost und AdCP-Integration. Lesevorgänge sind kostenlos; nur Schreibvorgänge verbrauchen Credits, immer nach dem Dry-Run und der Bestätigung.
