Skip to main content

Risk Levels

Every diagnostic issue detected by KlayrAI is assigned a risk level that indicates its severity and urgency. The overall diagnostic risk level is the highest risk among all detected issues.

The four tiers

LOW

Minor issue. No immediate action required. Monitor over the next 1-2 weeks.

MEDIUM

Moderate issue. May require attention within 1-2 weeks if the trend continues.

HIGH

Significant issue actively affecting performance. Action recommended within days.

CRITICAL

Severe issue causing substantial budget waste. Immediate action needed.

Detailed definitions

LOW

Color: Green (#22c55e) A low-risk issue is an early signal that something may be shifting. It does not yet affect campaign performance in a meaningful way but is worth noting. Characteristics:
  • Financial impact is less than 5% of campaign spend
  • Trend is just beginning (1-3 days)
  • Performance metrics are still within acceptable range
  • May resolve on its own without intervention
Examples:
Issue typeLOW threshold
Creative fatigueFrequency 2.0-2.5 with CTR decline < 10%
Learning phase3 days in learning with adequate conversion velocity
PacingDelivery at 80-90% of target budget
Budget degradationCPA increase of 5-10% after budget change
Audience saturationFrequency 2.0-2.5 with stable reach
Typical recommendation tone:
“Worth monitoring. No immediate action needed, but keep an eye on this over the next week.”

MEDIUM

Color: Amber (#f59e0b) A medium-risk issue shows a clear trend that, if left unchecked, will degrade campaign performance. It warrants attention within 1-2 weeks. Characteristics:
  • Financial impact is 5-15% of campaign spend
  • Trend has persisted for 4-7 days
  • Performance metrics are declining but not yet critical
  • Unlikely to resolve without intervention
Examples:
Issue typeMEDIUM threshold
Creative fatigueFrequency 2.5-3.5 with CTR decline 10-20%
Learning phase5 days in learning with slow conversion velocity
Auction overlap40-55% audience overlap between ad sets
PacingDelivery at 70-80% or 120-130% of target budget
Budget degradationCPA increase of 10-20% after budget change
Audience saturationFrequency 2.5-3.0 with declining reach
Typical recommendation tone:
“We recommend taking action within the next few days. The trend is clear and will likely worsen without changes.”

HIGH

Color: Orange (#f97316) A high-risk issue is actively hurting campaign performance. Budget is being wasted or opportunities are being missed. Action should be taken within days. Characteristics:
  • Financial impact is 15-30% of campaign spend
  • Trend has persisted for 7+ days or is accelerating
  • Performance metrics have meaningfully degraded
  • Will continue to worsen without intervention
  • Multiple issues may be compounding
Examples:
Issue typeHIGH threshold
Creative fatigueFrequency > 3.5 with CTR decline > 20%
Learning phase7+ days in learning with insufficient conversions
Auction overlap55-70% audience overlap causing CPM inflation
PacingDelivery at 50-70% or 130-150% of target budget
Budget degradationCPA increase of 20-40% after budget change
Audience saturationFrequency > 3.0 with reach plateau
Typical recommendation tone:
“This is significantly impacting your performance. We recommend making changes within the next 1-2 days to prevent further waste.”

CRITICAL

Color: Red (#ef4444) A critical-risk issue represents a severe problem causing substantial budget waste or campaign failure. Immediate action is required. Characteristics:
  • Financial impact exceeds 30% of campaign spend
  • Issue is causing clear and measurable budget waste
  • Performance has degraded dramatically from baseline
  • May involve multiple compounding issues
  • Every day of inaction compounds the damage
Examples:
Issue typeCRITICAL threshold
Creative fatigueFrequency > 5.0 with CTR collapse > 40%
Learning phase10+ days in learning, campaign effectively stalled
Auction overlap> 70% audience overlap, severe self-competition
PacingDelivery < 50% or > 150% of target budget
Budget degradationCPA increase > 40% with no efficiency recovery
Audience saturationFrequency > 4.0 with declining conversions
Typical recommendation tone:
“This requires immediate attention. You are losing significant budget to this issue every day. Here is what you should do right now.”

How risk levels are calculated

Risk level assignment considers multiple factors:
  1. Metric deviation — How far the current value is from the baseline or target
  2. Trend duration — How long the negative trend has persisted
  3. Trend velocity — Whether the issue is stable, worsening slowly, or accelerating
  4. Financial impact — Estimated wasted spend or missed revenue
  5. Compounding effects — Whether multiple issues interact to amplify impact
Risk levels are relative to each campaign’s own history and targets, not absolute thresholds. A CPA of EUR 20 might be LOW risk for a high-AOV e-commerce brand but CRITICAL for a mobile app install campaign.

Risk level in the API

Diagnostic responses include risk levels at both the issue and diagnostic level:
{
  "riskLevel": "HIGH",
  "issues": [
    {
      "type": "CREATIVE_FATIGUE",
      "severity": "HIGH"
    },
    {
      "type": "LEARNING_PHASE_STALL",
      "severity": "MEDIUM"
    }
  ]
}
The top-level riskLevel is always the maximum severity among all issues.

Filtering by risk level

In both the dashboard and API, you can filter diagnostics by risk level to focus on what matters most:
curl "https://api.klayrai.com/v1/diagnostics?riskLevel=HIGH&riskLevel=CRITICAL" \
  -H "x-api-key: klyr_live_abc123def456ghi789"

Dashboard display

In the KlayrAI dashboard, risk levels are displayed as color-coded badges:
LevelBadge colorBackground
LOWGreen textGreen/10 background
MEDIUMAmber textAmber/10 background
HIGHOrange textOrange/10 background
CRITICALRed textRed/10 background
The risk donut chart on the dashboard overview shows the distribution of risk levels across all recent diagnostics, giving you a quick visual summary of portfolio health.