Configure a The Trade Desk deal-targeted line item via the Platform API
domain: partner.thetradedesk.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate to the TTD Platform API using your API key in the TTD-Auth request header.
Create or retrieve a campaign and ad group (TTD terminology: 'campaign' and 'adgroup'); deal targeting is applied at the ad group level.
Obtain the supplier deal ID (deal_id) from your supply-side partner or from the TTD Deal Desk / Inventory marketplace; verify the deal is active and approved for your advertiser.
In the ad group payload, add the deal_id to the supplierTargetingData.supplierIds list or the supplyVendorTargetingData depending on the deal type (Open Auction vs. PMP).
Set budget, bid, and flight dates on the ad group and activate it; for programmatic guaranteed (PG) deals, the price is typically fixed in the deal terms and overrides the manual bid.
Monitor delivery via the reporting API; PMP deals that fail to scale often have frequency caps or audience targeting layered on top that restrict eligible bid requests.
Known gotchas
Approximately 90% of PMP deal IDs fail to scale in practice; if spend is under a few dollars per day, audit whether the deal's targeting (geo, device, audience) is restricting eligible inventory before assuming an API configuration error.
For programmatic guaranteed deals, the agreed CPM is locked at deal negotiation time and billing follows the deal terms regardless of your ad group's max bid setting; setting a lower max bid will not reduce costs but may prevent the ad group from winning guaranteed impressions.
Deal IDs from one SSP are not transferable to another; always confirm the SSP seat ID alongside the deal ID, as the same inventory can surface under different deal IDs across DSPs.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?