adops-deal

GAM Programmatic Deals

Always confirm the tenant first: get_my_tenant_id. Write operations require a confirmation_token from a prior preview call.

Naming conventions (always fetch before creating)

Before naming any proposal or deal, call settings(action="get_naming_conventions") and apply the returned pattern. Convention violations cause ambiguity in billing reports. If no pattern is configured, ask the user to confirm the name explicitly.

Estimating cost before writes

For any proposal, run deals(action="estimate_deal_cost", params={deal_type, targeting, impressions_goal, cpm_floor}) first — it returns a credit breakdown at zero cost. Surface the estimate to the user before proceeding.

list

Calls deals(action="list_deals") and deals(action="list_auctions") in parallel. Render a table: type | name | buyer | status | CPM floor.

get <deal-id>

Call deals(action="get_deal", params={deal_id}) for PMP deals or deals(action="get_proposal", params={proposal_id}) for Marketplace proposals. Show full targeting, floor price, buyers, and associated line items.

For auction details: deals(action="get_auction", params={auction_id}).

create

Ask the user for deal type, then follow the corresponding path:

PMP deal or private auction:

1. Fetch available buyers: deals(action="list_buyers").
2. Fetch naming conventions: settings(action="get_naming_conventions").
3. Estimate cost: deals(action="estimate_deal_cost", params={...}).
4. Call deals(action="create_deal", params={name, buyer_id, cpm_floor, targeting, ...}) — preview step (0 cr, no token required).
5. For private auctions: deals(action="create_auction", params={name, floor_price, targeting, ...}).

Marketplace PG/PD proposal (costs 5 cr, token required):

1. Validate feasibility first: deals(action="adcp_validate", params={targeting, goal, cpm}) — free.
2. Preview the proposal: deals(action="adcp_preview", params={...}) — returns estimated delivery. Free.
3. Fetch buyers: deals(action="list_buyers").
4. Fetch naming conventions: settings(action="get_naming_conventions").
5. Estimate credit cost: deals(action="estimate_deal_cost", params={...}).
6. Preview ADCP: deals(action="adcp_create", params={..., dry_run: true}) — returns a signed ExecutionPlan with dealSpecs[], packageCount, partialFailureRisk, estimatedCost, and confirmationToken. Show the full plan to the user. If partialFailureRisk is present or high, call out that package 0..N-1 may remain in GAM if package N fails.
7. Execute ADCP: deals(action="adcp_create", params={..., confirmation_token: "<token>"}) — creates through DealPipeline (PMP REST / PG SOAP / PD SOAP).
8. Add line items when needed: deals(action="create_proposal_line_items", params={proposal_id, ...}). Costs 3 cr, requires a fresh confirmation_token.