Skip to main content

Detection Rules Catalog

No rule is active yet

This catalog documents the LENS detection rule library as it is built, not as it is running. No detection rule is currently enabled on customer accounts, so no automated insight or alert is generated today. LENS chat and LENS reports are the live capabilities — see LENS AI.

LENS has a curated set of 25 detection rules ready to enable. Each rule has a stable internal ID (used in the API and in alerts), belongs to one of LENS's categories, and follows one of two execution models:

  • Reactive — analyzes historical data in daily/weekly/monthly batches.
  • Proactive — near real-time checks that surface changes happening right now.
Why only these rules?

LENS includes a much larger internal library of rules, but most require data many accounts don't have (e-commerce product properties, microconversion funnels, content groups, multi-site portfolios, or year-over-year history). The 25 rules below are the first set slated to go live; the rest stay disabled until the required data is available. None of them runs on accounts today.

Categories

LENS organizes rules into these categories:

Category IDLabelFocus
critical_alertsCritical AlertsIssues requiring immediate attention
business_monitoringBusiness MonitoringGeneral business health tracking
risk_managementRisk ManagementStructural business risks
autopilot_checksAutopilot ChecksAutomated monitoring tasks
instant_winsInstant WinsImmediate value from day 1
forecastingForecasting & PredictionAI-powered predictions
growth_upsideGrowth & Revenue UpsideDirect growth opportunities
ecommerceE-commerce PerformanceProduct & catalog insights
user_experienceUser Experience & FunnelUX frictions & behavior
multisiteMulti-site & PortfolioMulti-web management
reportingReportingExecutive summaries

The first-set rules below fall into critical_alerts, autopilot_checks, growth_upside, risk_management, user_experience, and instant_wins. The remaining categories exist for rules that activate once your account has the data they need.


Critical Alerts

Detect when something breaks or changes meaningfully.

Rule IDTypeWhat it detects
traffic_dropReactiveTraffic decreases significantly vs baseline (auto-drills into sources)
traffic_spikeReactiveTraffic increases significantly vs baseline
conversion_dropReactiveConversions decrease significantly vs baseline

Autopilot Checks

Automated data-quality and tracking-health monitoring.

Rule IDTypeWhat it detects
tracking_brokenReactiveTracking events stop firing unexpectedly
tracking_statusReactiveWhether tracking is working correctly (no recent events)
data_healthReactiveOverall data collection issues and quality score

Optimization & Growth

Find where you're leaving money on the table.

Rule IDCategoryTypeWhat it detects
device_gapuser_experienceReactiveMobile converts significantly worse than desktop
landing_page_bounceuser_experienceReactiveLanding pages with bounce rates well above average
top_landing_opportunitygrowth_upsideReactiveHigh-traffic landing pages that could convert better
channel_opportunitygrowth_upsideReactiveChannels with high conversion rate but low traffic share
channel_conversion_efficiencygrowth_upsideReactiveChannels with high efficiency that deserve more investment
concentration_riskrisk_managementReactiveOver-dependence on a single traffic source/campaign
traffic_mixrisk_managementReactivePaid vs organic balance and organic-traffic trends
country_conversion_gapgrowth_upsideReactiveCountries with significant traffic but below-average conversions
browser_compatibility_issueuser_experienceReactiveBrowsers with bounce rates suggesting compatibility issues
high_traffic_low_conversionuser_experienceReactiveHigh-traffic pages/sources with below-average conversion rate

Instant Wins (Quick Wins)

Designed to surface value from day 1, including for new and trial accounts.

Rule IDTypeWhat it detects
quickwin_high_bounce_landingReactiveLanding pages losing visitors immediately (high bounce)
quickwin_mobile_gapReactiveWhether mobile users convert significantly worse than desktop
quickwin_country_opportunityReactiveCountries where you're losing potential customers
quickwin_source_distributionReactiveTraffic sources that could perform better
quickwin_conversion_rateReactiveYour conversion rate compared to benchmarks
quickwin_best_performersReactiveWhat's working well, so you can scale it up

Proactive Alerts

Near real-time checks that catch sudden changes during the day.

Rule IDCategoryTypeWhat it detects
intraday_conversion_dropcritical_alertsProactiveToday's conversions significantly below the same day last week
source_sudden_dropcritical_alertsProactiveA significant traffic source drops dramatically
landing_page_failurecritical_alertsProactiveA landing page shows an abnormally high bounce rate

Rule structure

Every rule shares a common structure:

ComponentDescription
ID (name)Stable identifier used in alerts and the API (e.g. traffic_drop)
CategoryGrouping for organization and display
Typereactive (batch) or proactive (near real-time)
ThresholdThe change that triggers detection — dynamically adjusted by sample size and seasonality (see Configuring Thresholds)
Confidencehigh / medium / low, derived from sample size and the data window

Plan availability

All categories — and every rule, once enabled — will be available on every v2 plan. There are no rule-level or category-level locks by tier; plans differ by data volume, not by which rules run.

Next steps