Create Monitor

Create a monitoring alert for your campaigns. Checked daily.

Supported metrics: roas, ctr, cpc, cpa, cpm, cpv, spend, conversions, impressions, clicks, cost_per_lead, conversion_rate, budget_utilization, video_views, engagement_rate

Operators: less_than, greater_than, less_than_or_equal, greater_than_or_equal, changes_by

Advanced features:

• Multiple conditions with AND/OR: Use conditions array with conditions_logic: "AND" or "OR"
• Consecutive days: Add consecutive_days: 3 to only trigger after 3 days in a row
• Relative thresholds: Set threshold_type: "relative" with threshold_multiplier: 1.5 to mean “50% above average”
• % change detection: Use operator: "changes_by" with direction: "decrease" and threshold: 30 for “dropped 30%”
• Campaign targeting: Use campaign_ids to monitor specific campaigns only
• Auto-actions (coming soon): auto_action: "pause_campaign" or "increase_budget" with auto_action_value: 20

Examples:

1. Simple: “Alert me if ROAS drops below 2” → metric: “roas”, operator: “less_than”, threshold: 2.0

2. Consecutive days: “Alert if CPA exceeds $50 for 3 days straight” → metric: “cpa”, operator: “greater_than”, threshold: 50, consecutive_days: 3

3. Compound AND: “Alert if CTR < 0.8% AND spend > $200” → conditions: [ {metric: "ctr", operator: "less_than", threshold: 0.8}, {metric: "spend", operator: "greater_than", threshold: 200} ], conditions_logic: “AND”

4. Relative: “Alert if CPA goes 50% above my 30-day average” → metric: “cpa”, operator: “greater_than”, threshold_type: “relative”, threshold_multiplier: 1.5, threshold_timeframe: “last_30d”

5. % drop: “Notify me if cost per lead drops 30% in a day” → metric: “cost_per_lead”, operator: “changes_by”, threshold: 30, direction: “decrease”, timeframe: “vs_previous_day”

IMPORTANT:

• If user doesn’t specify an email for alerts, ASK them. Do not guess.
• If user doesn’t specify platforms, default to all their connected platforms.
• If user doesn’t specify campaigns, default to all campaigns.
• Do not assume timeframe — ask if unclear.
• Do not assume threshold values — ask if the user doesn’t specify a number.
• ROAS monitors are skipped on traffic/awareness/engagement campaigns automatically.
• CPA monitors are skipped on campaigns with zero conversions automatically.