OperationsIntegration Preview

Reporting

Query impressions, clicks, decision outcomes, policy blocks and revenue by source.

Preview

Metric and dimension names are illustrative. Numbers in the examples only show the response format and do not represent real performance.

The Reporting API exposes every Decision Engine decision and its downstream events as aggregated metrics. Beyond how many impressions you served, you can see which requests were blocked and why.

GET/v1/reportsReturns an aggregated report for the given date range, metrics and dimensions.Integration Preview

Query parameters

fromstringrequired
Start date, YYYY-MM-DD.
tostringrequired
End date, YYYY-MM-DD.
metricsstringrequired
Comma-separated metrics: impressions, clicks, decisions, policy_blocks, revenue.
group_bystringoptional
Dimensions: date, placement, outcome, block_reason, source, advertiser, format.
environmentstringoptional
sandbox or live. Defaults to the key's environment.
timezonestringoptional
IANA time zone, e.g. Europe/Istanbul.

Metric	Description
impressions	Number of verified impressions
clicks	Number of verified clicks
decisions	Number of decisions; use group_by=outcome to split into served, house_ad, no_fill and blocked_by_policy
policy_blocks	Blocked requests; use group_by=block_reason to split by reason
revenue	Revenue; use group_by=source to split controlled inventory from programmatic sources

curl -G https://api.reinoads.com/v1/reports \
  -H "Authorization: Bearer sk_live_..." \
  --data-urlencode "from=2026-10-01" \
  --data-urlencode "to=2026-10-05" \
  --data-urlencode "metrics=decisions,policy_blocks" \
  --data-urlencode "group_by=outcome,block_reason" \
  --data-urlencode "timezone=Europe/Istanbul"

Data freshness

How quickly report data updates and how far back you can query are specified in your account-specific documentation; the examples on this page imply no freshness commitment.