Analytics & Reporting Reference

Bidkernel tracks the complete lifecycle of every ad auction, from the first bid request through to impression, viewability, and click, across all 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.

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 (based on 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. They are null when the underlying data is insufficient to produce a meaningful value (e.g., fill_rate is null when there are zero auctions).

Metric	Formula	Unit	Description
`cpm`	`revenue / impressions × 1000`	USD / 1k impressions	Average CPM of winning bids only. In USD.
`rpm`	`revenue / pageviews × 1000`	USD / 1k pageviews	Revenue per thousand pageviews. Measures site-level monetization efficiency.
`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.
`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 viewable duration / viewable impressions`	ms	Average time (ms) that viewable ads remained in-view after becoming viewable.
`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 Analytics API accepts propertyIds as a filter; additional dimension slicing is available in the dashboard.

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-2 country code derived from the request IP (e.g., `US`, `GB`, `DE`).
`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 (e.g., `Chrome`, `Safari`, `Firefox`).
`device_manufacturer`	Device make (e.g., `Apple`, `Samsung`). Available for mobile/tablet.
`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.
`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.
`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
SDK Integration Guide: How the client-side tracking is initialized
Ad Slots: Understanding ad unit codes and slot configuration