Programmatic Deals
Manage your programmatic deals (Preferred Deals, Private Marketplace, Private Auctions) and negotiate with DSPs.
REST endpoints
| Method | Path | Description | Credits |
|---|---|---|---|
| POST | /deals/proposals | Create a programmatic deal proposal | 0 |
| GET | /deals/proposals | List deal proposals | 0 |
| GET | /deals/proposals/{id} | Proposal detail | 0 |
| POST | /deals/proposals/{id}/negotiate | Send to the buyer/DSP for negotiation | 0 |
| POST | /deals/proposals/{id}/approve | Approve the finalized proposal | 0 |
| GET | /deals/buyers | List the configured buyers/DSPs | 0 |
MCP tools
| Tool | Description | Credits |
|---|---|---|
| create_programmatic_deal | Create and send a Preferred Deal | 0 |
| list_programmatic_deals | List active proposals | 0 |
| get_programmatic_deal | Deal detail | 0 |
Examples
Create a Preferred Deal via MCP
{
"tool": "create_programmatic_deal",
"arguments": {
"buyer_id": "by_dv360_451",
"deal_type": "PREFERRED_DEAL",
"cpm": 4.50,
"ad_unit_id": "ad_homepage_masthead"
}
}Notes
- • Supports Preferred Deals, Private Marketplace (PMP) and Private Auctions.
- • Direct integration with the main DSPs (DV360, TTD, Yahoo, etc.).
- • Prices (CPM) and targeting are validated before being pushed to GAM.