Reporting Overview
Delivery, VCR, reach and revenue reporting in the dashboard and through the Reporting API.
Core metrics
| Metric | Definition |
|---|---|
| Impressions | Impression beacons fired by the player (first one per ad request) |
| Starts | Playback began |
| VCR | Completes ÷ starts |
| Quartile rates | First quartile, midpoint, third quartile ÷ starts |
| Skip rate | Skips ÷ starts |
| CTR | Clicks ÷ impressions |
| Fill rate | Filled ad requests ÷ ad requests |
| Spend | Advertiser cost of billed impressions (USD) |
| Revenue | Publisher share of billed impressions (USD) |
| Unique households / frequency | From the Reach & Frequency report — only for requests that carried a householdId |
Reports in the dashboard
- Advertiser: Reporting, VCR, Reach & Frequency, Attribution, Brand Lift.
- Publisher: Revenue report, Fill Rate analytics, Payouts.
- Ad network: RTB reports and exchange analytics (win rate, bid landscape, supply health).
- Network admin: Platform reporting, Pacing, Serving Monitor (how every ad request ended).
Report tables can be downloaded as CSV.
Data freshness
Beacons are stored within seconds and added to the daily summary every 5 minutes. Spend and revenue are written as each impression is billed. Daily summaries use UTC days.
Reporting API
Authenticate with an API key from Dashboard → Settings → API Keys(Authorization: Bearer ltv_live_…). Results are scoped to your account and network.
# Daily delivery rows (line item × channel × UTC day)
GET https://api.ltvadx.com/api/v1/reports/delivery
?from=2026-09-01&to=2026-09-30
&campaignId=… # optional; also lineItemId, channelId
# → JSON array. Rates (vcr, skipRate, ctr, fillRate, winRate) are 0–1 ratios;
# money fields are USD micros (÷ 1,000,000).
# VCR aggregate — rates as percentages
GET https://api.ltvadx.com/api/v1/reports/vcr?campaignId=…&from=…&to=…
# Totals for a date range
GET https://api.ltvadx.com/api/v1/reports/summary?from=…&to=…
# Reach & frequency (campaignId required)
GET https://api.ltvadx.com/api/v1/reports/reach-frequency?campaignId=…&from=…&to=…
# Publisher payouts (monthly)
GET https://api.ltvadx.com/api/v1/payoutsData retention
| Data | Kept |
|---|---|
| Raw beacon events (incl. IP, user agent, device id) | No automatic expiry yet — a retention limit is planned |
| Daily summaries | No expiry |
| Brand lift studies, attribution events | No expiry |
| Per-household channel summaries | 90 days |
| Ad decision traces | 45 days |
| Serving statistics (15-minute) | 90 days; daily roll-ups kept |
| Audit log | 1 year |
Invalid traffic in reports
Beacons are tagged for invalid traffic, but reports do not yet separate tagged from valid impressions.