Skip to main content

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.
This track teaches you the demand side of AdCP. You’ll learn how buyer agents orchestrate across multiple sellers, how brand identity and compliance protocols work, and how creative workflows and Sponsored Intelligence fit together. The track culminates in a build project where you create a working buyer agent. Completing this track (plus A1–A3) earns the AdCP practitioner credential.

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; check valid_actions from get_media_buys before acting. S1 covers the full state machine and recovery
  • Version negotiation β€” declare adcp_major_version on every request; handle VERSION_UNSUPPORTED by selecting a compatible seller or downgrading the payload
  • Pricing selection β€” products return pricing_options[]; buyer selects one via pricing_option_id in create_media_buy
  • Negotiated accountability β€” for guaranteed buys, propose measurement_terms / performance_standards; seller accepts, adjusts, or returns TERMS_REJECTED. S1 covers the recovery patterns
  • Account required on updates β€” update_media_buy takes account + media_buy_id; omitting account is a protocol error
  • Audience targeting β€” sync_audiences for 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_accounts to 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.json at /.well-known/brand.json declares 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_governance validates every transaction before execution, returns a governance_context token you attach to the buy envelope, and uses purchase_type to scope which rules apply (media_buy, rights_license, signal_activation, creative_services)
  • Governance denial recovery β€” GOVERNANCE_DENIED is 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_creative supports 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_creatives returns pricing_options from your account’s rate card, and build_creative returns 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_key per 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:
npx @adcp/sdk@latest test-mcp get_products '{"brief":"your campaign brief"}'
See Validate Your Agent for CLI setup and the full testing 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 via supported_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

DimensionWeightWhat Addie evaluates
Specification quality20%Can you specify a buying workflow in AdCP terms?
Schema compliance25%Agent requests and responses validate against schemas
Error handling15%Handles seller errors and async responses
Design rationale20%Can you explain orchestration and buying strategy?
Extension ability20%Can you extend the agent with new buying capabilities?
Passing threshold: 70%. Any AI coding assistant is welcome. The build must demonstrate cross-role interaction.

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: