​
What is a Brand Agent?

A Brand Agent is the advertiser’s account within the Scope3 Campaign API - the central hub that owns all the advertiser’s marketing assets and campaigns. Think of it as the brand’s advertising headquarters that coordinates all programmatic marketing activities.
Industry Standard: Brand agents mirror the advertiser account pattern used by major platforms like Google Ads, The Trade Desk, and Facebook Business Manager.

​
Why Brand Agents Matter

​
The Foundation of Everything

Brand agents are the foundational layer of the Scope3 API. Every resource - campaigns, creatives, audiences, and settings - belongs to a brand agent. This provides:
  • Centralized Management: All the advertiser’s marketing assets in one place
  • Resource Sharing: Creatives and audiences reused across campaigns
  • Brand Consistency: Unified safety rules and standards for the brand
  • Access Control: Team permissions and API key scoping
  • Performance Analytics: Cross-campaign insights and optimization

​
Real-World Example

Nike Brand Agent (ba_nike_123)
├── Campaigns
│   ├── "Air Max Holiday Sale" - $50K CTV campaign
│   ├── "Running Community" - $25K display retargeting
│   └── "Basketball Season" - $75K connected TV + social
├── Creative Library
│   ├── "Holiday Sale 30s Video" (shared across campaigns)
│   ├── "Running Lifestyle Banner Set" 
│   └── "Basketball Action Videos"
├── Brand Standards
│   ├── Blocked: competitor domains, political content
│   └── Safety: family-friendly content only
├── Audiences
│   ├── "Sports Enthusiasts 25-34"
│   ├── "Premium Athletic Buyers"
│   └── "Running Community Members"
└── Settings
    ├── DSP Integrations: TTD, DV360, Amazon DSP
    └── Measurement: GA4, Adobe Analytics

​
Core Components Inside Brand Agents

🎯 Campaigns

Marketing initiatives with budgets, targeting, and optimization goals. Multiple campaigns can run simultaneously, each with specific objectives.

🎨 Creatives

Your ad content library - videos, images, native ads, and interactive media. Creatives are shared across campaigns for efficiency and consistency.

👥 Brand Stories

Targeting profiles that define who to reach. Combine demographic, behavioral, and contextual signals for precise audience definition.

🛡️ Brand Standards

Safety and quality controls including domain blocklists, keyword filters, and content category restrictions to protect your brand.

📊 PMPs (Private Marketplaces)

Direct inventory relationships with premium publishers. Configure your DSP connections and preferred deal access.

📈 Measurement Sources

Analytics integrations for tracking conversions, brand lift studies, and attribution across your marketing stack.

​
Key API Endpoints

Create Brand Agent

Set up a new advertiser account with basic configuration

List Brand Agents

View all brand agents with filtering and search options

Get Brand Agent

Retrieve detailed information about a specific brand agent

Update Brand Agent

Modify brand agent settings, domains, and configuration

​
Tactic Seed Data Cooperative

Opt into better new tactic seeding through anonymized data sharing: 
await updateBrandAgent({
  brandAgentId: "ba_123",
  tacticSeedDataCoop: true
});
What’s shared when you opt in:
  1. Your pricing/delivery: "Product X delivered Y impressions at $Z CPM from [date] to [date]"
  2. Your performance quintiles: "Product X: Top 20% of tactics for [your vertical] from [date] to [date]"
What you receive:
  • Aggregated pricing data for realistic tactic starting points
  • Category performance quintiles to avoid poor-performing inventory
  • Better initial budget allocation for new tactic testing
How it improves tactic seeding:
  • New campaigns start testing higher-confidence inventory first
  • Initial budgets reflect realistic delivery expectations
  • Avoid wasting test budget on historically poor performers
What’s never shared:
  • Specific performance metrics or indexes
  • Creative content or audience targeting
  • Individual advertiser identity or campaign details

​
What’s Next?

Now that you understand brand agents, explore the core components:

🎨 Creatives

Build your creative asset library with AI-powered tools

🎯 Campaigns

Launch your first campaign with targeting and optimization

📊 Analytics

Monitor performance with dual-mode reporting system