Reporting Overview

Delivery, VCR, reach and revenue reporting in the dashboard and through the Reporting API.

Core metrics

MetricDefinition
ImpressionsImpression beacons fired by the player (first one per ad request)
StartsPlayback began
VCRCompletes ÷ starts
Quartile ratesFirst quartile, midpoint, third quartile ÷ starts
Skip rateSkips ÷ starts
CTRClicks ÷ impressions
Fill rateFilled ad requests ÷ ad requests
SpendAdvertiser cost of billed impressions (USD)
RevenuePublisher share of billed impressions (USD)
Unique households / frequencyFrom 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/payouts

Data retention

DataKept
Raw beacon events (incl. IP, user agent, device id)No automatic expiry yet — a retention limit is planned
Daily summariesNo expiry
Brand lift studies, attribution eventsNo expiry
Per-household channel summaries90 days
Ad decision traces45 days
Serving statistics (15-minute)90 days; daily roll-ups kept
Audit log1 year

Invalid traffic in reports

Beacons are tagged for invalid traffic, but reports do not yet separate tagged from valid impressions.