Appearance
Metrics Reference
Raw metrics (from Aggregation API)
| Metric | API key | Description |
|---|---|---|
| Impressions | impressions | Total creative loads |
| Interacted | interacted | Impressions with user engagement |
| Started | started | Users who began the conversational flow |
| Continued | continued | Users who progressed past step 1 |
| Creative Actions | creative_actions | Total actions (votes, submissions, etc.) |
| Link Clicks | link_clicks | Clicks to external URLs |
| Header Clicks | header_clicks | Clicks on the creative header |
| Background Clicks | background_clicks | Clicks on the creative background |
| Reached End | reached_end | Times the final flow step was reached |
| Plays | plays | Video play starts |
| Watched 25/50/75/100% | watched_25 etc. | Video quartile completion |
| Viewable Impressions | viewable_impressions | IAB viewability standard met |
| Seconds in View | seconds_in_view | Total seconds creative was in viewport |
Calculated metrics (derived in report)
| Metric | Formula | Notes |
|---|---|---|
| Interaction Rate | interacted / impressions | Shown as percentage |
| CTR | clickthrough / impressions | clickthrough = link + header + background clicks |
| Started % | started / impressions | |
| Viewability | viewable_impressions / impressions | IAB standard: 50% pixels, 1s |
| Avg. Time Spent | seconds_in_view / viewable_impressions | Per viewable impression |
| Avg. Rounds | reached_end / continued | Only shown when > 1.0 (replay behavior) |
Metric base
Passing metrics: ["base"] to cavai_get_buckets or cavai_make_report returns all available raw metrics. This is the recommended default.
Active day filtering
The HTML report filters out days with < 500 impressions (ACTIVE_DAY_THRESHOLD). This affects:
- KPI totals
- Chart data
- Date range in header
- Row count in footer
The threshold can be adjusted in html-report.ts. The Excel/CSV report (make-report.ts) does NOT filter — it returns all data as-is.