​
Overview

The Scope3 Campaign API includes an AI-powered brief validation system that evaluates campaign briefs against Ad Context Protocol standards before campaign creation. This ensures campaigns have the essential information publishers need for effective inventory matching and execution.
Publisher Inventory Matching RequirementsPublishers require specific information to match campaigns with appropriate inventory. Missing critical elements makes campaign execution impossible or significantly less effective. The validation system prevents campaign failures by identifying gaps upfront.

​
Why Brief Validation Matters

Publishers need detailed campaign information to:
  • Match Inventory: Find appropriate ad placements that align with targeting requirements
  • Optimize Delivery: Ensure campaigns reach the right audience at the right time
  • Meet Creative Requirements: Serve ads in formats that fit available inventory slots
  • Reserve Capacity: Block inventory for specific dates and geographic regions
Without complete briefs, campaigns may fail to find suitable inventory or deliver suboptimal results.

​
Key Features

AI-Powered Evaluation

Uses advanced AI models to assess brief completeness against industry standards

Quality Scoring

Provides 0-100 scores with specific quality level classifications

Missing Element Detection

Identifies specific gaps and provides actionable improvement suggestions

Flexible Thresholds

Configurable quality requirements with intelligent defaults

​
Quality Scoring System

The validation system assigns scores from 0-100 based on brief completeness:

​
Quality Levels

  • Comprehensive Brief (80-100): Complete information with all elements present
  • Standard Brief (60-79): Good brief with most key elements, minor gaps
  • Minimal Brief (30-59): Basic information but missing important details
  • No Brief (0-29): Insufficient information for effective campaigns

​
Scoring Logic

Critical Requirement Penalties
  • Missing ANY critical requirement = automatic score below 60
  • Missing 2+ critical requirements = score capped at 40
  • Missing 3+ critical requirements = score capped at 30
This reflects the reality that publishers cannot effectively match campaigns without core targeting and creative information.

​
The 6 Critical Requirements

Publishers require these elements for successful inventory matching:

​
1. Business Objectives

Clear, measurable goals that define campaign success
  • “Increase brand awareness by 30% among target demographic”
  • “Drive 5,000 qualified leads for new product launch”
  • “Achieve 15% conversion rate improvement over Q3 baseline”

​
2. Success Metrics

Specific KPIs with measurable targets
  • “Target 2.5% CTR with minimum 15M impressions”
  • “Achieve 40% brand lift measured via brand tracker”
  • “Generate 500 form completions at $50 CPA or lower”

​
3. Target Audience

Detailed demographics, psychographics, and interests
  • “Urban millennials 25-35, household income $50k+, sustainability-focused”
  • “Small business owners 30-50 in retail/hospitality sectors”
  • “Parents with children 5-12, interested in education technology”

​
4. Geographic Markets [CRITICAL for Inventory Matching]

Specific locations, regions, or targeting areas
  • “Tier 1 US cities: NYC, LA, Chicago, San Francisco metro areas”
  • “United Kingdom and Germany, excluding rural areas”
  • “California and Texas, focusing on urban centers 100k+ population”

​
5. Flight Dates [CRITICAL for Inventory Availability]

Campaign timing for inventory reservation
  • “March 1 - April 15, 2025 (6-week campaign)”
  • “Q2 2025 launch, 8-week flight starting May 1”
  • “Black Friday push: November 15-30, 2024”

​
6. Creative Requirements [CRITICAL for Inventory Matching]

Formats, sizes, and specifications needed
  • “15-second and 30-second video ads, plus 728x90 display banners”
  • “Native content articles with accompanying social media assets”
  • “HTML5 rich media units, mobile-optimized 320x50 and 300x250”

​
Validation Workflow

​
Best Practice: Validate First, Create Second

1

Validate Brief Quality

Use campaign_validate_brief to check brief completeness and get improvement suggestions
2

Improve Brief Based on Feedback

Address missing elements and implement suggestions from AI evaluation
3

Create Campaign with Skip Validation

Use campaign_create with skipBriefValidation: true to avoid duplicate validation
Efficiency & Carbon ImpactValidating first and then creating with skipBriefValidation: true saves processing time and reduces carbon footprint by avoiding duplicate AI evaluations.

​
Alternative: Direct Campaign Creation

1

Create Campaign with Validation

Use campaign_create without skip flags - validation runs automatically
2

Handle Validation Failures

If brief quality is below threshold, improve and retry

​
Error Handling

When validation fails, you’ll receive detailed feedback: 
{
  "score": 45,
  "meetsThreshold": false,
  "threshold": 70,
  "qualityLevel": "Minimal Brief",
  "missingElements": [
    "Geographic targeting not defined - CRITICAL for inventory matching",
    "Campaign flight dates not specified - CRITICAL for inventory availability"
  ],
  "suggestions": [
    "Specify target locations (e.g., 'tier 1 US cities', 'NYC, LA, Chicago metro areas')",
    "Include campaign timing (e.g., 'March 1 - April 15, 2025', '6-week campaign starting Q2')"
  ]
}
Campaign Creation BlockedWhen a brief scores below the threshold (default 70/100), campaign creation will fail with a detailed error message. You must either improve the brief or explicitly skip validation.

​
Integration with Campaign Creation

The validation system is tightly integrated with the campaign_create tool:

​
Automatic Validation

By default, all campaign creation attempts include brief validation

​
Configurable Thresholds

Set custom quality requirements per campaign: 
briefValidationThreshold: 80  // Higher standard for premium campaigns

​
Skip for Pre-Validated Briefs

Avoid duplicate processing for already-validated content: 
skipBriefValidation: true  // Skip if already validated separately

campaign_validate_brief

Standalone brief validation with detailed feedback

campaign_create

Campaign creation with integrated validation

​
Next Steps

Try the Validation Tool

Test brief validation with sample content

Campaign Creation Guide

Learn campaign creation best practices

Ad Context Protocol

Understand industry brief standards