get_products specification, providing implementation guidance for publishers and clear expectations for buyers.
Overview
A brief in AdCP is a natural language description of campaign requirements that helps publishers understand and fulfill media buying requests. While briefs can be as simple or detailed as needed, complete briefs enable better product recommendations and more efficient campaign execution.Required Components
Everyget_products and create_media_buy request MUST include:
Brand Manifest
Thebrand_manifest field is required in all requests. It identifies the advertiser brand:
- Apply policy restrictions (age-gated, prohibited categories, etc.)
- Verify brand identity
- Enforce brand safety standards
Brief Field
Thebrief field describes what is being promoted and campaign requirements:
When Briefs Are Optional
Thebrief field is optional because there are valid scenarios where buyers want the standard catalog:
Standard Catalog Discovery
When buyers want to see what’s available without targeting:- Get the publisher’s standard product catalog
- No audience targeting or niche products
- Returns baseline offerings available to all advertisers
- Useful for initial discovery and planning
Scenarios for No Brief:
- Initial exploration - Understanding publisher’s inventory
- Buyer-driven targeting - Bring your own audience segments via AXE
- Direct product selection - Already know specific product IDs
- Always-on campaigns - Replenishing existing campaigns
Example: Standard Catalog Request
- Publisher returns standard catalog products
- Not personalized or brief-matched products
- Baseline inventory available to this advertiser
- Buyer can apply their own targeting through AXE
- Focus is on discovering available inventory
Core Brief Components
When abrief IS provided, it should include these essential elements:
1. Business Objectives
What you’re trying to achieve with the campaign:- Awareness: Build brand recognition or product awareness
- Consideration: Drive interest and research
- Conversion: Generate sales or sign-ups
- Retention: Re-engage existing customers
- App installs: Drive mobile app downloads
- Lead generation: Capture contact information
- Traffic: Drive website or store visits
2. Success Metrics
How you’ll measure success of the campaign:- CTR (Click-Through Rate): Engagement measurement
- CPA (Cost Per Acquisition): Conversion efficiency
- ROAS (Return on Ad Spend): Revenue generation
- Brand lift: Awareness and perception improvement
- Video completion rate: Content engagement
- Conversion rate: Action completion
- Reach and frequency: Audience coverage
3. Flight Dates
When the campaign should run:- Start date: Campaign launch date
- End date: Campaign completion date
- Specific periods: Holiday seasons, events, promotions
- Blackout dates: Dates to avoid
- Dayparting requirements: Time-of-day preferences
Optional Brief Components
These elements enhance brief quality and enable better recommendations:Target Audience
Who you want to reach:Demographics
- Age ranges (e.g., 25-34, 35-44)
- Gender identity
- Household income levels
- Education level
- Parental status
- Employment status
Psychographics
- Interests and hobbies
- Lifestyle attributes
- Values and beliefs
- Purchase behaviors
- Media consumption habits
- Technology adoption
Behavioral Signals
- Past purchase behavior
- Website visit history
- App usage patterns
- Content engagement
- Shopping cart abandonment
Budget Information
Spending parameters:- Total budget: Overall campaign spend
- Daily budget: Maximum daily spend
- Budget flexibility: Ability to adjust
- Cost constraints: CPM limits, efficiency requirements
- Budget allocation: Split across products or time periods
Geographic Markets
Where ads should appear:- Countries: Target nations
- Regions/States: Specific areas within countries
- Cities/DMAs: Metropolitan areas
- Postal codes: Hyperlocal targeting
- Exclusions: Areas to avoid
Creative Constraints
Format and content requirements:- Available formats: Video, audio, display, native
- Creative variations: Number of versions available
- Language versions: Multilingual capabilities
- Technical limitations: File sizes, durations
- Brand guidelines: Color, logo, messaging requirements
Brand Safety Requirements
Content to avoid:- Blocked categories: Content types to exclude
- Sensitive topics: Subjects to avoid
- Competitor separation: Competing brands to avoid
- Quality standards: Viewability, fraud prevention
- Certification requirements: TAG, MRC, etc.
Brief Quality Levels
Publishers should handle briefs at different completeness levels:No Brief (Standard Catalog)
Minimal Brief
Standard Brief
Comprehensive Brief
Implementation Guidelines
For Publishers
- Parse Brief Elements: Extract key components programmatically
- Handle Incompleteness: Gracefully request missing critical information
- Provide Guidance: Suggest what additional information would help
- Match Intelligently: Use AI to interpret natural language and match products
- Explain Relevance: Always provide
brief_relevancefield in responses
For Buyers
- Be Specific: More detail enables better recommendations
- Prioritize Goals: Clearly state primary vs secondary objectives
- Provide Context: Include market conditions or competitive landscape
- Update Iteratively: Refine brief based on publisher feedback
- Maintain Consistency: Ensure brief aligns with promoted offering
Brief Processing Flow
Clarification Handling
When briefs need clarification, publishers should:- Ask Specific Questions: Target missing critical information
- Provide Examples: Show what complete information looks like
- Maintain Context: Remember previous brief elements
- Suggest Defaults: Offer reasonable assumptions
- Progressive Disclosure: Don’t overwhelm with all questions at once
Natural Language Processing
Publishers should implement NLP to extract:- Temporal expressions: “next quarter”, “holiday season”, “ASAP”
- Budget indicators: “$50K”, “low budget”, “premium spend”
- Audience descriptors: “millennials”, “high-income”, “parents”
- Geographic references: “west coast”, “major cities”, “nationwide”
- Objective keywords: “awareness”, “drive sales”, “generate leads”
Best Practices
DO:
- ✅ Include both advertiser and product in brand_manifest and brief
- ✅ Specify measurable success criteria
- ✅ Provide clear timing requirements
- ✅ Describe target audience in detail
- ✅ Mention creative format availability
- ✅ State budget or budget constraints
- ✅ Include brand safety requirements
DON’T:
- ❌ Provide vague objectives like “good performance”
- ❌ Omit timing without expecting clarification requests
- ❌ Use undefined abbreviations or jargon
- ❌ Contradict between brief and brand_manifest
- ❌ Include sensitive or confidential information
- ❌ Assume publisher knowledge of your business
Examples
Standard Catalog (No Brief)
E-commerce Brief
B2B Software Brief
Local Services Brief
Conclusion
Briefs serve different purposes for different buyers:- Discovery-focused buyers benefit from detailed briefs that help publishers recommend the best products
- Targeting-focused buyers may skip briefs entirely, using filters to get broad inventory and applying their own targeting
- Hybrid approaches can use minimal briefs to narrow the field while retaining control over targeting