Definitions of key terms used throughout the Prebid Sales Agent documentation, organized into Sales Agent-specific concepts and AdCP protocol terms.
These terms are specific to the Prebid Sales Agent implementation.
| Term | Definition |
|---|---|
| ToolContext | Dependency-injected object providing tenant context, database session, adapter instance, and authentication state to MCP tools. Populated via Depends(get_tool_context) on each tool invocation. |
| Adapter | Pluggable integration layer connecting the Sales Agent to an ad server. Each adapter translates AdCP operations into platform-specific API calls. Current adapters include Google Ad Manager and a mock adapter for testing. |
| Tenant | An isolated publisher instance within a multi-tenant deployment. Each tenant has its own products, advertisers, configuration, and data. Tenant isolation is enforced at the database and authentication layers. |
| Principal | An authenticated entity (AI buying agent or human user) that interacts with the Sales Agent via MCP or A2A. Principals are identified by their access token and granted scopes. |
| Workflow | Human-in-the-loop approval process for media buys and creatives. When a buying agent creates or modifies a campaign, the operation may be queued for publisher review in the Admin UI before taking effect in the ad server. |
| Setup Mode | Initial state of a new deployment before any tenants are configured. The Admin UI presents a guided setup wizard that walks the publisher through tenant creation, adapter configuration, and product catalog setup. |
| Demo Tenant | Auto-generated publisher tenant with sample products, advertisers, and configuration. Created when the environment variable CREATE_DEMO_TENANT=true is set. Useful for testing and evaluation without manual setup. |
These terms are defined by the Ad Context Protocol (AdCP) specification. The definitions below are brief summaries; see the AdCP Glossary for canonical definitions.
| Term | Definition |
|---|---|
| Brief | A natural language description of an advertiser’s campaign goals, used by buying agents to search for matching products. Passed to get_products as the brief parameter. See AdCP Glossary. |
| Product | An advertising offering from a publisher, including placement details, pricing options, creative format requirements, and targeting capabilities. See AdCP Glossary. |
| Package | A bundled collection of products offered as a single purchasable unit, often with combined pricing or volume discounts. See AdCP Glossary. |
| Media Buy | A committed purchase of advertising inventory, specifying products, budget, flight dates, and targeting parameters. The central transactional object in AdCP. See AdCP Glossary. |
| Creative | An advertising asset (image, video, HTML) that is associated with a media buy and rendered to users. Must conform to the format specifications of the purchased products. See AdCP Glossary. |
| Format ID | A standardized identifier for a creative format (e.g., display banner dimensions, video duration). Returned by list_creative_formats and referenced in product and creative objects. See AdCP Glossary. |
| Pricing Option | A pricing model attached to a product, specifying the rate type (CPM, CPC, flat rate), currency, and amount. Multiple pricing options may be available for a single product. See AdCP Glossary. |
| Brand Manifest | A structured description of a brand’s identity, category, audience, and compliance requirements. Provided by buying agents to enable personalized product recommendations. See AdCP Glossary. |
| Targeting Overlay | Additional targeting constraints applied to a media buy beyond the defaults inherited from the product. Allows buyers to narrow delivery by geography, audience segment, or other dimensions. See AdCP Glossary. |
| Orchestrator | A coordinating agent that manages workflows across multiple sales agents on behalf of a buyer. Orchestrators use A2A protocol for multi-agent communication. See AdCP Glossary. |
| Sales Agent | A server-side agent representing a publisher that exposes advertising inventory to AI buying agents. The Prebid Sales Agent is the reference implementation. See AdCP Glossary. |
For the canonical definitions of AdCP protocol terms, see the AdCP Glossary.