Run a tracking audit

From the dashboard

Single scenario

Open a scenario → Full audit. Tracking runs alongside Visual, A11y, Perf, SEO, and Security when your plan unlocks those pillars and the scenario has linked tracking 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: tracking:

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": "tracking",
    "environment": "staging",
    "scenarios": ["Homepage"]
  }'

Dashboard session API

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

POST /api/tests/tracking
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

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

FRT with tracking verification

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

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

The FRT timeline shows a Tracking overlay section per scenario (events + variables).

Read results

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

See also Events via FRT scenarios and Test endpoints.