Skip to content

Commit abbdd89

Browse files
author
Bosko Milekic
committed
Implements the Deals Protocol (renamed from Curation Protocol).
The Deals Protocol enables buyer agents to discover and activate pre-packaged and bespoke signal-enriched inventory deal packages from SSPs and curation platforms. The Deals Protocol provides an alternative to the Media Buy Protocol for package-based buying, enabling: - Natural language deal discovery - Activation on SSP platforms (Magnite, Pubmatic, OpenX, Index Exchange, Microsoft Curate, etc.) - Support for PMP and Curated deal types - Integration with Signals Protocol for audience-targeted inventory packages
1 parent 706414b commit abbdd89

17 files changed

+1586
-46
lines changed

.changeset/deals-protocol.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
"adcontextprotocol": major
3+
---
4+
5+
Add Deals Protocol for inventory package discovery and activation.
6+
7+
**New Protocol:**
8+
- Deals Protocol enables buyer agents to discover and activate pre-packaged and ad-hoc inventory deal packages from SSPs and curation platforms
9+
- Alternative to Media Buy Protocol for package-based buying
10+
11+
**Tasks:**
12+
- `get_deals`: Discover deal packages using natural language descriptions
13+
- `activate_deal`: Activate deals on SSP platforms
14+
15+
**Core Schemas:**
16+
- `deal.json`: Deal package with pricing, targeting, and platform availability
17+
- `deal-pricing.json`: Pricing configuration with Floor, Fixed, and Market types, plus optional margins for curated deals
18+
- `deal-targeting.json`: Targeting parameters including geo, devices, allow/block lists, and segments
19+
20+
**Deal Types:**
21+
- **PMP (Private Marketplace)**: Direct deals with fixed or floor pricing
22+
- **Curated**: Enhanced inventory packages with margin-based pricing
23+
24+
**Architecture:**
25+
- Deals Agents integrate with Signals Agents (using Signals Protocol) to include audience targeting
26+
- Buyer Agents interact with Deals Agents (using Deals Protocol) without directly accessing Signals Agents
27+
- Parallel architecture to Media Buy Protocol's Sales Agent integration
28+
29+
**Documentation:**
30+
- Protocol overview and specification
31+
- Task reference documentation
32+
- Integration examples with Signals Protocol
33+
- Renamed from Curation Protocol to Deals Protocol

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ Discover and activate data signals using natural language.
4646
- **Transparent Pricing**: CPM and revenue share models
4747
- **Real-time Status**: Track activation and deployment progress
4848

49-
### 📍 Curation Protocol - Coming Soon
50-
Curate media inventory based on context and brand safety requirements.
49+
### 📍 Deals Protocol - RFC/v0.1
50+
Discover and activate pre-packaged and ad-hoc inventory deals.
5151

5252
### 💰 Media Buy Protocol - RFC/v0.1
5353
Execute and optimize media buys programmatically across platforms.

docs.json

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -90,9 +90,17 @@
9090
]
9191
},
9292
{
93-
"group": "Curation Protocol",
93+
"group": "Deals Protocol",
9494
"pages": [
95-
"docs/curation/coming-soon"
95+
"docs/deals/overview",
96+
"docs/deals/specification",
97+
{
98+
"group": "Tasks",
99+
"pages": [
100+
"docs/deals/tasks/get_deals",
101+
"docs/deals/tasks/activate_deal"
102+
]
103+
}
96104
]
97105
},
98106
{

docs/curation/coming-soon.mdx

Lines changed: 0 additions & 39 deletions
This file was deleted.

docs/deals/overview.mdx

Lines changed: 279 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,279 @@
1+
---
2+
sidebar_position: 1
3+
title: Overview
4+
---
5+
6+
# Deals Protocol Overview
7+
8+
The Deals Protocol enables AI assistants to discover and activate pre-packaged and ad-hoc inventory deal packages from publishers and ad decisioning platforms through natural language—simplifying the complex landscape of programmatic deal buying.
9+
10+
## The Challenge: Navigating Deal Marketplaces
11+
12+
Modern programmatic advertising offers numerous deal opportunities across publishers and SSPs. While this provides access to premium inventory, it creates challenges:
13+
- **Fragmented discovery**: Deals scattered across multiple SSPs and sellers
14+
- **Varying deal structures**: PMPs, curated packages, guaranteed deals with different terms
15+
- **Complex targeting**: Deals may include pre-applied audiences, context, or brand safety
16+
- **Pricing opacity**: Floor vs. fixed pricing, margins, and package costs vary
17+
- **Manual activation**: Setting up deals across SSPs is time-intensive
18+
19+
## How AI Assistants Transform Deal Discovery
20+
21+
### Current Approach
22+
```
23+
Human → Navigate multiple SSP UIs → Evaluate deal terms → Manual setup across platforms
24+
```
25+
- **Challenges**: Time-intensive, miss opportunities, requires platform expertise
26+
27+
### With Deals Protocol
28+
```
29+
Human describes objectives → AI discovers matching deals → Streamlined activation
30+
```
31+
- **Benefits**: Comprehensive discovery, transparent comparison, efficient activation
32+
33+
## The Power of AI-Assisted Deal Discovery
34+
35+
### AI Can Process and Compare Deals at Scale
36+
37+
```
38+
Human: I need premium video inventory for automotive brand with
39+
guaranteed viewability and brand-safe context
40+
41+
AI: Analyzing 143 video deals across 8 publishers and 5 SSPs...
42+
43+
Best match: AutoMedia Network's "Premium Automotive Bundle"
44+
- Deal Type: Curated package
45+
- SSP: Magnite
46+
- Inventory: Top 15 automotive content sites
47+
- Ad Format: Video (pre-roll and mid-roll)
48+
- Pricing: $18 CPM fixed + 15% curation margin
49+
- Targeting: Automotive context + auto intender audiences (optional)
50+
- Brand Safety: IAS verification, blocked competitor categories
51+
- Availability: Q1 2026, 50M impressions reserved
52+
- Viewability: 85% guaranteed or make-good
53+
54+
Alternatives with trade-offs:
55+
- CarContent Direct PMP: Lower cost ($15 CPM) but single publisher
56+
- PremiumVideo Curator: Higher viewability (90%) but $22 CPM
57+
```
58+
59+
### Flexible Deal Structures
60+
61+
The Deals Protocol supports diverse deal types:
62+
63+
#### Private Marketplace (PMP) Deals
64+
Direct relationships with fixed or floor pricing:
65+
```
66+
"Sports Publisher Premium Video PMP"
67+
- Deal Type: PMP
68+
- SSP: Pubmatic
69+
- Pricing: $12 CPM floor
70+
- Inventory: All premium sports video inventory
71+
- Bidding: Open auction above floor
72+
```
73+
74+
#### Curated Deals
75+
Enhanced packages with added targeting and safety:
76+
```
77+
"Contextual Curator - Tech Enthusiast Video Package"
78+
- Deal Type: Curated
79+
- SSP: Index Exchange
80+
- Base Cost: $10 CPM
81+
- Margin: 20% ($2 CPM curator fee)
82+
- Enhancement: AI-powered contextual selection + viewability optimization
83+
- Audience: Tech enthusiast targeting included
84+
- Brand Safety: Category blocks and verification
85+
```
86+
87+
## From Fragmented Platforms to Unified Discovery
88+
89+
### Traditional Approach: Multi-Platform Navigation
90+
- Log into multiple SSP platforms individually
91+
- Manually search deal catalogs in each system
92+
- Compare terms across different interfaces
93+
- Set up deals individually on each SSP
94+
- Track performance separately per platform
95+
96+
### Enhanced with Deals Protocol: AI-Powered Unified Access
97+
98+
```
99+
Human: Find video inventory deals targeting parents, ensure kid-safe content
100+
101+
AI: Found 5 matching deals across 3 SSPs:
102+
103+
1. FamilyContent Network - "Parent-Targeted Video Bundle"
104+
SSP: OpenX
105+
Type: Curated
106+
Pricing: $14 CPM + 12% margin
107+
Safety: COPPA-compliant, family-safe categories only
108+
Audience: Parents with children under 12
109+
Scale: 30M impressions/month
110+
111+
2. KidSafe Curator - "Family-Friendly Premium Video"
112+
SSP: Magnite
113+
Type: Curated
114+
Pricing: $16 CPM + 15% margin
115+
Safety: AI verification + manual review for kid-safe context
116+
Audience: Optional parent targeting
117+
Scale: 45M impressions/month
118+
119+
3. PremiumFamily Sites - "Direct Parent Deal"
120+
SSP: Pubmatic
121+
Type: PMP
122+
Pricing: $10 CPM floor
123+
Safety: Category-based blocks
124+
Audience: None (reach all visitors)
125+
Scale: 20M impressions/month
126+
127+
Select deals to activate on SSPs?
128+
```
129+
130+
## Deal Discovery with Natural Language
131+
132+
### Describing Deal Objectives
133+
134+
The AI assistant helps translate campaign objectives into deal criteria:
135+
136+
**Objective**: "I need high-impact display placements for luxury brand awareness"
137+
138+
**AI Translation**:
139+
- Ad Type: Display (likely high-impact formats)
140+
- Targeting: Affluent audiences, premium contexts
141+
- Brand Alignment: Luxury-appropriate environments
142+
- Deal Types: Likely curated packages with quality guarantees
143+
144+
**Objective**: "Cost-efficient video scale for product launch"
145+
146+
**AI Translation**:
147+
- Ad Type: Video
148+
- Pricing: Floor pricing or market-rate deals preferred
149+
- Scale: Large impression volumes
150+
- Deal Types: PMP deals or broad curation packages
151+
152+
### Intelligent Filtering and Recommendations
153+
154+
The AI assistant can:
155+
- **Filter by constraints**: Budget, scale requirements, timing
156+
- **Compare pricing models**: Floor vs. fixed, with/without margins
157+
- **Evaluate targeting fit**: Match deal targeting to campaign objectives
158+
- **Assess brand safety**: Verify appropriate controls are in place
159+
- **Recommend combinations**: Multiple deals to achieve scale or coverage
160+
161+
## Integration with Signals Protocol
162+
163+
**Integration Architecture**: The Deals Agent integrates with Signals Agents behind the scenes. The Buyer Agent interacts only with the Deals Agent—not directly with Signals Agents.
164+
165+
```
166+
Buyer Agent → Deals Agent → Signals Agent
167+
(Deals Protocol) (Signals Protocol)
168+
```
169+
170+
This is parallel to how the Media Buy Protocol works with Sales Agents.
171+
172+
### How Deals Agents Leverage Signals
173+
174+
When the Buyer Agent requests deals, the Deals Agent can:
175+
- Discover relevant audience signals from integrated Signals Agents
176+
- Include those signals in the targeting of returned deals
177+
- Bundle audience targeting with inventory in curated packages
178+
- Provide deals with pre-selected segments for brand safety or performance
179+
180+
### Signals-Enhanced Deals
181+
182+
```
183+
Human (to Buyer Agent): Find video deals for luxury automotive brand
184+
185+
Buyer Agent → Deals Agent: get_deals request with automotive specifications
186+
187+
Deals Agent workflow:
188+
1. Searches available video inventory deals
189+
2. Queries integrated Signals Agents for relevant automotive audiences
190+
3. Matches signals with appropriate inventory packages
191+
192+
Deals Agent → Buyer Agent: Returns deals including:
193+
→ "Premium Video Curator - Auto Context" on Magnite
194+
→ Includes automotive content + "Luxury Auto Intenders" segment
195+
→ Targeting pre-configured with signal IDs from Signals Agent
196+
197+
Result: Buyer Agent receives deals with inventory + audience targeting combined
198+
```
199+
200+
### Deals with Included Targeting
201+
202+
Deals can return targeting that includes:
203+
- **Context-based signals**: Automotive content, premium publishers
204+
- **Audience signals**: Segments obtained from Signals Agents (referenced by signal IDs)
205+
- **Brand safety**: Block lists and allow lists for appropriate content
206+
- **Geographic targeting**: Regional or local inventory packages
207+
208+
The Buyer Agent doesn't need to know how the Deals Agent obtained the signals—it just receives deals with targeting ready to use.
209+
210+
## Activation and Deployment
211+
212+
Once deals are discovered, activation is streamlined:
213+
214+
### Single-Platform Activation
215+
```
216+
Activate "Premium Video Bundle" on Magnite
217+
→ Deal ID configured in SSP
218+
→ Ready for buyers to access
219+
```
220+
221+
### Multi-Platform Deployment
222+
```
223+
Activate "Cross-Publisher PMP" on:
224+
- Pubmatic (seller account: publisher_abc)
225+
- Index Exchange (seller account: publisher_abc)
226+
→ Same deal available across both SSPs
227+
→ Unified reporting and management
228+
```
229+
230+
### Asynchronous Activation
231+
Large or complex deals may require asynchronous activation:
232+
```
233+
Activate deal → Receive operation_id
234+
→ Webhook notification when ready
235+
→ Or poll for activation status
236+
→ Use deal once deployed
237+
```
238+
239+
## Use Cases
240+
241+
### Premium Brand Campaigns
242+
- Discover high-quality inventory packages
243+
- Ensure brand-safe environments
244+
- Access guaranteed viewability or performance
245+
- Activate across multiple premium SSPs
246+
247+
### Performance Marketing at Scale
248+
- Find floor-priced PMPs for efficient buying
249+
- Access large-scale deal inventory
250+
- Combine multiple deals for reach
251+
- Optimize spend with market-rate opportunities
252+
253+
### Contextual Targeting Campaigns
254+
- Discover context-aligned deal packages
255+
- Access curated inventory with AI-powered selection
256+
- Combine contextual deals with audience signals
257+
- Ensure content relevance to campaign messaging
258+
259+
### Retail Media and Commerce
260+
- Access retailer-specific deal inventory
261+
- Combine first-party audience data with publisher deals
262+
- Leverage commerce-focused curation packages
263+
- Target high-intent shoppers in relevant contexts
264+
265+
## Next Steps
266+
267+
- **[Protocol Specification](/docs/deals/specification)**: Technical details, data models, and complete task reference
268+
- **[Signals Protocol](/docs/signals/overview)**: Combine deals with audience targeting
269+
270+
## Get Involved
271+
272+
Want to help shape the Deals Protocol?
273+
274+
- Join our [working group](https://join.slack.com/t/agenticads/shared_invite/zt-3c5sxvdjk-x0rVmLB3OFHVUp~WutVWZg) (discussion in the #pmp-protocol channel)
275+
- Share your use cases
276+
- Review early drafts
277+
- Implement the protocol
278+
279+
Subscribe to updates: announcements@adcontextprotocol.org

0 commit comments

Comments
 (0)