Run an analytics audit

From the dashboard

Single scenario

Open a scenario → Full audit. Analytics runs alongside Visual, A11y, Perf, SEO, and Security when your plan unlocks those pillars and the scenario has linked analytics coverage.

Whole project

From the project home → Run full quality audit. Same batch engine, all scenarios (or filter in the API).

From CI

Use the CI REST API with type: analytics:

curl -X POST https://visualq.ai/api/ci/run \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VISUALQ_API_KEY" \
  -d '{
    "project": "my-website",
    "type": "analytics",
    "environment": "staging",
    "scenarios": ["Homepage"]
  }'

Legacy alias type: tracking is still accepted.

Dashboard session API

Use these routes from the dashboard or from scripts running in an authenticated browser session:

POST /api/tests/analytics
Content-Type: application/json

{
  "project": "<projectId>",
  "environment": "<optional environment slug>",
  "scenarios": ["Homepage"]
}

Response:

{
  "success": true,
  "message": "Tracking audit started for my-website",
  "project": "my-website",
  "runId": "run_abc123"
}

Run type in activity feed: tracking-test.

Snapshot quota

Analytics audits do not consume snapshot quota in V1 (audit output is JSON, not PNG screenshots).

FRT with analytics verification

POST /api/frt/run
Content-Type: application/json

{
  "projectId": "<projectId>",
  "featureId": "<featureId>",
  "verifyAnalytics": true
}

The FRT timeline shows an Analytics overlay section per scenario (events + variables).

Read results

• Activity tab — filter by analytics / tracking runs
• Analytics tab — pages and events (per-variable detail for events)
• FRT timeline — analytics overlay when verifyAnalytics is set
• MCP: tracking_get_plan for the plan; audit details via run history tools

See also Events via FRT scenarios and Test endpoints.