Analytics & Reporting Reference

Bidkernel records auction, bid, impression, viewability, and click events for your properties. This document describes every metric, computed metric, dimension, and event type available in reports and via the Analytics API.

Metrics Link to section

Raw metrics are direct aggregates of events collected across your ad stack.

Auction & Bid Metrics Link to section

Metric	Description
`auctions`	Total number of auction cycles initiated. Each page load or refresh that triggers Prebid counts as one auction.
`bid_requests`	Number of bid requests sent to demand partners. One auction can generate multiple bid requests (one per bidder).
`bid_responses`	Number of bid responses received from demand partners.
`bid_wins`	Number of auctions where a bid was selected as the winner.
`no_bids`	Number of bid requests a demand partner answered with an explicit no-bid.
`bid_timeouts`	Number of bid requests that timed out before the demand partner responded.
`ad_render_failures`	Number of winning ads that failed to render in the browser.

Revenue Metrics Link to section

Metric	Description
`revenue`	Total gross revenue across all winning impressions. Calculated as the sum of each winning bid's CPM divided by 1000. In USD.

Impression & Engagement Metrics Link to section

Metric	Description
`impressions`	Number of ads rendered and counted as served.
`clicks`	Number of user clicks on ads.
`ad_errors`	Number of ad error events recorded (e.g., render failures, creative errors).

Audience Metrics Link to section

Metric	Description
`pageviews`	Approximate number of distinct page loads generating ad activity in the period.
`unique_sessions`	Approximate number of distinct user sessions.
`unique_users`	Approximate number of distinct users, identified by a visitor ID stored in localStorage and a first-party `_{alias}_uid` cookie.
`monetizable_pageviews`	Approximate number of distinct pageviews that initiated at least one ad auction.
`monetizable_sessions`	Approximate number of distinct user sessions that initiated at least one ad auction.

Computed Metrics Link to section

Computed metrics are derived from raw metrics at query time. The reporting endpoints return null when the underlying data is insufficient to produce a meaningful value (e.g., fill_rate is null when there are zero auctions); the query builder API returns 0 instead.

Metric	Formula	Unit	Description
`cpm`	`revenue / bid_wins × 1000`	USD / 1k winning bids	Average bid CPM across winning bids (`BID_WIN` events). In USD.
`rpm`	`revenue / pageviews × 1000`	USD / 1k pageviews	Revenue per thousand pageviews.
`rps`	`revenue / unique_sessions`	USD / session	Revenue per session.
`fill_rate`	`impressions / auctions`	ratio 0–1	Share of auctions that resulted in a rendered impression.
`bid_match_rate`	`bid_wins / bid_responses`	ratio 0–1	Share of bid responses that were selected as the winner.
`bid_rate`	`bid_responses / bid_requests × 100`	percent	Share of bid requests that returned a bid.
`viewability_pct`	`viewable impressions / impressions × 100`	percent	Share of impressions that met the IAB viewability standard : ≥50% of the ad in-view for ≥1 continuous second.
`avg_time_in_view`	`Total recorded in-view duration / TIME_IN_VIEW events`	ms	Average in-view duration (ms) per recorded `TIME_IN_VIEW` event.
`impressions_per_pageview`	`impressions / pageviews`	count	Average number of ads served per page load.
`impressions_per_session`	`impressions / unique_sessions`	count	Average number of ads served per user session.
`ctr`	`clicks / impressions × 100`	percent	Click-through rate: share of impressions resulting in a click.
`ad_error_rate`	`ad_errors / (impressions + ad_errors) × 100`	percent	Share of ad attempts (impressions + ad_errors) that resulted in an error.

Dimensions Link to section

Dimensions are attributes you can use to filter or break down your reports. The reporting endpoints accept propertyIds as a filter; the query builder API (POST /api/v1/analytics/query/run and related endpoints, documented in the API Reference) supports grouping and filtering by all dimensions below.

Property & Inventory Dimensions Link to section

Dimension	Description
`property`	The specific domain or app (e.g., `example.com`). Filter via `propertyIds` in the API.
`domain`	The domain where the ad was served.
`ad_unit_code`	The identifier of the ad slot (e.g., `leaderboard-top`, `sidebar-right`).
`ad_unit_size`	Rendered dimensions of the ad unit in `WxH` format (e.g., `728x90`, `300x250`).
`media_type`	Ad format: `banner`, `video`, or `native`.

Time Dimensions Link to section

Dimension	Description
`date`	Daily time bucket.
`hour`	Hourly time bucket.
`day_of_week`	Day of the week (1-7).
`week`	ISO week number.

Audience & Geography Dimensions Link to section

Dimension	Description
`country`	ISO 3166-1 alpha-3 country code (e.g., `USA`, `GBR`, `DEU`), derived from Cloudflare's request geolocation.
`region`	Subdivision within the country (e.g., state or province).
`city`	City-level geo, where available.
`postal_code`	Postal code.
`device_category`	Classified device category: `desktop`, `mobile`, or `tablet`.
`browser`	Browser name including version (e.g., `Chrome 120`), parsed from the user agent.
`device_manufacturer`	Currently stores the operating system reported by the user agent (e.g., `iOS`, `Windows`).
`device_model`	Device model (e.g., `iPhone 15`, `Galaxy S24`). Available for mobile/tablet.

Bidder & Demand Dimensions Link to section

Dimension	Description
`bidder`	The Prebid bidder adapter name (e.g., `appnexus`, `rubicon`).
`advertiser_domain`	The winning advertiser's domain (e.g., `advertiser.com`).
`creative_id`	The winning creative's identifier, as reported by the bidder.

Event Types Link to section

Bidkernel tracks the following event types, which flow through the pipeline from your pages via the edge worker to the analytics store.

Event Type	Description
`AUCTION_START`	An auction was initiated on the page.
`AUCTION_END`	An auction cycle completed (all bidders responded or timed out).
`BID_REQUEST`	A bid request was sent to a demand partner.
`BID_RESPONSE`	A bid response was received from a demand partner.
`BID_TIMEOUT`	A bid request timed out with no response.
`BID_WIN`	A bid was selected as the auction winner.
`NO_BID`	A demand partner responded with an explicit no-bid.
`AD_RENDER_FAILED`	Prebid failed to render the winning ad.
`IMPRESSION`	A winning ad was rendered in the browser.
`VIEWABLE`	An impression met the IAB viewability threshold (≥50% in-view for ≥1 second).
`TIME_IN_VIEW`	Emitted when a viewable ad's in-view duration is recorded (populates `avg_time_in_view`).
`REFRESH`	An ad slot was refreshed, initiating a new auction on an existing slot.
`SLOT_DEFINED`	An ad slot was defined and registered on the page.
`SLOT_DESTROYED`	An ad slot was destroyed and removed from the page.
`CLICK`	A user clicked on a rendered ad.
`ERROR`	An error occurred during the ad lifecycle (e.g., render failure, creative error).

Data Freshness Link to section

Analytics data is typically available within a few minutes of events occurring. Dashboard charts and API responses reflect data up to the most recently completed processing window.

Analytics API Reference: Endpoint documentation, query parameters, and example responses
Ad Slots: Understanding ad unit codes and slot configuration