Skip to main content

​
Overview

Outcomes agents provide advanced optimization capabilities for your advertising campaigns. They use AI-powered algorithms to optimize campaign performance based on your specific business outcomes and KPIs.

​
How It Works

Outcomes agents analyze campaign performance data in real-time and make optimization decisions to improve results. They can:
  • Optimize bidding strategies - Adjust bids based on predicted conversion probability
  • Optimize creative selection - Select the best-performing creatives for each impression
  • Optimize targeting - Refine audience targeting to reach high-value users
  • Optimize budget allocation - Distribute budget across tactics for maximum ROI

​
Managing Your Outcomes Agents

​
List All Outcomes Agents

Agent: Call tool agent_list with body: 
{
  "type": "OUTCOME"
}
Shows all registered outcomes agents with their current status and capabilities.

​
Register a New Outcomes Agent

Register an outcomes agent to enable advanced optimization: Agent: Call tool agent_register with body: 
{
  "name": "Custom Conversion Optimizer",
  "type": "OUTCOME",
  "endpointUrl": "https://optimizer.example.com/api",
  "protocol": "MCP",
  "authenticationType": "API_KEY",
  "description": "Custom optimization for conversion events",
  "authConfig": {
    "auth_token_env": "OPTIMIZER_API_KEY"
  }
}
This creates the outcomes agent in the global registry. Note: organizationId is optional and will be auto-detected from your customer account if not provided.

​
Update Outcomes Agent

The owner of the globally registered outcomes agent can update the agent information: Agent: Call tool agent_update with body: 
{
  "agentId": "agent_456",
  "name": "Updated Optimizer Name",
  "description": "Updated optimization description"
}

​
Unregister Outcomes Agent

Completely unregister an outcomes agent and disable optimization: Agent: Call tool agent_unregister with body: 
{
  "agentId": "agent_456",
  "confirm": true
}
This action disables the optimization agent and stops all automated optimization activities. Only the owner who registered the agent can perform this action.

​
Using Outcomes Agents in Campaigns

Outcomes agents work automatically once registered and configured for your campaigns. They continuously monitor performance and make real-time optimization decisions.

​
Configuration

To enable outcomes optimization for a campaign, specify the outcomes agent when creating or updating tactics: 
{
  "tacticId": "tactic_123",
  "optimizationAgent": "agent_456",
  "optimizationGoal": "CONVERSIONS"
}

​
Monitoring

Track optimization performance through:
  • Campaign summary reports showing before/after metrics
  • Agent-specific performance dashboards
  • Real-time optimization logs and decision history

​
Best Practices

Start with conservative optimization settings and gradually increase aggressiveness as you validate performance improvements.
  1. Test incrementally - Enable outcomes agents on a subset of campaigns first
  2. Monitor closely - Review optimization decisions regularly during the initial period
  3. Set guardrails - Define min/max bounds for automated bid adjustments
  4. Measure impact - Compare performance against control groups without optimization

​
Important Notes

Outcomes agents require sufficient historical data to make effective optimization decisions. We recommend at least 2-4 weeks of baseline performance data before enabling optimization.
When you register your own outcomes agent, you are responsible for the optimization logic and its performance. Scope3 is not responsible for optimization decisions made by third-party agents.

​
Next Steps