Documentation Index
Fetch the complete documentation index at: https://agenticadvertisingorg-changeset-release-main.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Buyer / brand track (C1βC4)
Members only β Requires Basics credential (A1βA3). Four modules, ~105 minutes total.
C1: Multi-agent buying and media planning
~20 min | Prerequisite: A3 How buyer agents orchestrate across multiple sales agents simultaneously: discovery, portfolio allocation, proposals, and measuring reach across publishers.Reading list
Media buy overview
The media buy protocol: how agents discover, negotiate, and execute advertising campaigns.
get_products task
Product discovery from multiple sellers β the first step in any buying workflow.
create_media_buy task
Campaign creation: manual mode, proposal mode, validation, and approval lifecycle.
Orchestrator design
Architecture patterns for agents that coordinate across multiple sellers.
Pricing models
pricing_options[] on products, buyer selects by pricing_option_id: CPM, vCPM, CPP, CPA, flat rate, time.Accountability terms
performance_standards, measurement_terms, and cancellation_policy β negotiable on guaranteed buys.Targeting
Targeting options, audience overlays, and geo-targeting.
Version negotiation
Declare
adcp_major_version on requests; sellers respond with VERSION_UNSUPPORTED when incompatible.Error handling
Error taxonomy: transient, correctable, terminal. Includes
GOVERNANCE_DENIED, TERMS_REJECTED, VERSION_UNSUPPORTED.Trusted Match Protocol
How your campaigns execute at impression time: context match, identity match, and cross-publisher frequency capping.
TMP Buyer Guide
Endpoint integration: responding to Context Match and Identity Match requests, structuring offers, provider registration.
get_media_buys task
Operational monitoring: lifecycle state, creative approvals, valid actions, delivery snapshots.
Key concepts
- Multi-agent buying β query multiple sellers in parallel, compare, allocate, execute
- Orchestration pattern β discover, evaluate, allocate, execute, monitor
- Order lifecycle β
pending_creativesβpending_startβactive; checkvalid_actionsfromget_media_buysbefore acting. S1 covers the full state machine and recovery - Version negotiation β declare
adcp_major_versionon every request; handleVERSION_UNSUPPORTEDby selecting a compatible seller or downgrading the payload - Pricing selection β products return
pricing_options[]; buyer selects one viapricing_option_idincreate_media_buy - Negotiated accountability β for guaranteed buys, propose
measurement_terms/performance_standards; seller accepts, adjusts, or returnsTERMS_REJECTED. S1 covers the recovery patterns - Account required on updates β
update_media_buytakesaccount+media_buy_id; omittingaccountis a protocol error - Audience targeting β
sync_audiencesfor custom segments - Impression-time execution β campaigns activate through TMP at serve time; frequency caps, audience eligibility, and brand suitability are enforced via Identity Match without exposing user data to buyers alongside content context
- Account setup β
sync_accountsto establish billing before buying
Start C1 with Addie
βIβd like to start certification module C1.β
C2: Brand identity, compliance, and safety
~20 min | Prerequisite: C1 The Brand Protocol (brand.json), content standards, and how brand agents enforce guidelines across automated buying.
Reading list
Brand protocol
Brand identity claims, brand.json discovery, brand hierarchy, and brand agents.
brand.json specification
The brand.json format: identity, logos, colors, guidelines, and agent declarations.
For advertisers
How advertisers license talent rights through the brand protocol β pricing, scopes, and what you get.
get_rights task
Search for licensable talent rights β pricing, availability, and exclusion filtering.
acquire_rights task
License talent rights: generation credentials, rights constraints, revocation, and approval workflows.
update_rights task
Extend, adjust, or pause an existing rights grant.
For rights holders
How rights holders monetize talent through the brand protocol.
Content standards
How content standards define whatβs appropriate, how calibration works, and local execution.
calibrate_content task
Testing whether content meets brand standards before placement.
Policy compliance
How compliance is enforced during media buy execution.
Creative governance
Creative quality and compliance governance.
Campaign governance
Tie campaigns to media plans: budget authority, multi-party validation, and always-on compliance.
Policy registry
Community-maintained compliance policies (COPPA, GDPR, HFSS) that brands reference by ID.
Key concepts
- Brand identity protocol β
brand.jsonat/.well-known/brand.jsondeclares brand identity - Content standards β automated compliance checking via MCP-based brand agents
- The Oracle model β using AI to evaluate brand safety at scale
- Supply chain preferences β suitability, safety, and sustainability requirements
- Campaign governance β campaign plans define authorized parameters;
check_governancevalidates every transaction before execution, returns agovernance_contexttoken you attach to the buy envelope, and usespurchase_typeto scope which rules apply (media_buy,rights_license,signal_activation,creative_services) - Governance denial recovery β
GOVERNANCE_DENIEDis a correctable buyer-side decision, not a transport error: fix targeting, creative, or plan reference and retry. S4 goes deeper on the correlation model - Policy registry β shared compliance policies (regulations and standards) referenced by ID, not written per-brand
- Governance adoption β governance agents support incremental adoption (audit β advisory β enforce) as an internal configuration, not a protocol field
- Policy categories β regulatory regimes (
children_directed,fair_housing,fair_lending) that plans declare and governance agents enforce - Restricted attributes β personal data categories (
health_data,racial_ethnic_origin) that must not be used for targeting under applicable policies
Start C2 with Addie
βIβd like to start certification module C2.β
C3: Creative workflows
~20 min | Prerequisite: C2 How creative assets flow through AdCP:build_creative, preview_creative, sync_creatives. Cross-platform adaptation and the Sponsored Intelligence Protocol.
Reading list
Creative overview
The creative protocol: assets, formats, manifests, creative agents.
build_creative task
Creative generation and transformation.
preview_creative task
Previewing creatives before deployment.
sync_creatives task
Synchronizing creative assets with publisher platforms.
Generative creative
AI-generated creative workflows and best practices.
Creative agent pricing
How creative agents charge: pricing discovery, build costs, and billing reconciliation.
Sponsored Intelligence
Conversational brand experiences in AI assistants.
SI specification
The Sponsored Intelligence protocol: sessions, messages, and offerings.
Key concepts
- Creative lifecycle β
build_creative,preview_creative,sync_creativesβ callable on any agent implementing the Creative Protocol, including sales agents - Preview modes β
preview_creativesupports single, batch, and variant requests β choose the mode that fits the workflow (S2 covers the tradeoffs) - Cross-platform adaptation β agents adapt assets across display, video, audio, native, and broadcast formats. Broadcast manifests carry
industry_identifiers[](Ad-ID, ISCI) β S2 goes deep - Seller-side generation β sales agents can generate creatives at serve time from a brief provided in the media buy
- Creative pricing β creative agents can charge for their services. When they do,
list_creativesreturnspricing_optionsfrom your accountβs rate card, andbuild_creativereturns the cost incurred. See the creative pricing specification for details. - Sponsored Intelligence β brands participate in conversational AI with transparency and user control. SI is an experimental surface in AdCP 3.0 (feature id
sponsored_intelligence.core); session lifecycle and UI components may change between 3.x releases with at least 6 weeksβ notice.
Start C3 with Addie
βIβd like to start certification module C3.β
C4: Build project β your first buyer agent
~45 min | Prerequisite: C3 Create a working buyer agent that discovers products and executes media buys. Use any AI coding assistant (Claude Code, Cursor, Copilot) with the@adcp/sdk SDK. The skill tested is orchestrating a buying workflow correctly.
What youβll build
- Account setup with
sync_accounts - Product discovery from at least 2 sellers
- Media buy creation with targeting and budget β including a fresh UUID v4
idempotency_keyper logical buy, and correct retry behavior that resends the identical payload with the same key on network failure (the mechanics of what the seller does with the key β replay, conflict, expired β are taught in S1: Media buy) - Creative sync with at least 1 format
- Campaign monitoring via delivery reporting
How youβll validate
Your buyer agent runs against the public test agent (test-mcp). Use npx @adcp/sdk@latest to execute tool calls and verify your agent handles the complete buying workflow:
Validating across sellers
Buyer agents donβt claim specialisms β specialisms describe what sellers offer. But your buyer agent should handle every specialism it expects to transact against. The storyboards a seller passes (declared viasupported_protocols and specialisms in their get_adcp_capabilities) tell you what behaviors to expect.
Review the Compliance Catalog and note which specialisms your target sellers claim β thatβs your test matrix.
Assessment rubric
| Dimension | Weight | What Addie evaluates |
|---|---|---|
| Specification quality | 20% | Can you specify a buying workflow in AdCP terms? |
| Schema compliance | 25% | Agent requests and responses validate against schemas |
| Error handling | 15% | Handles seller errors and async responses |
| Design rationale | 20% | Can you explain orchestration and buying strategy? |
| Extension ability | 20% | Can you extend the agent with new buying capabilities? |
Start C4 with Addie
βIβd like to start certification module C4.β
Whatβs next
After completing C1βC4, youβve earned the AdCP practitioner credential. From here you can pursue specialist modules:- S1: Media buy β transaction flows, pricing, orchestration
- S2: Creative β asset workflows, format compliance
- S3: Signals β measurement, attribution, optimization
- S4: Governance β brand safety, campaign governance, compliance, policy registry
- S5: Sponsored Intelligence β conversational brand experiences