Shape
What happened during each period
Chart · Ads
Ad impressions counts the ads your app displayed in each period. RevenueDot counts one impression for every ad displayed event the SDK sends, by UTC day, week or month. Impressions are the denominator for eCPM and CTR, so they show how much ad inventory your users saw.
Formula
Impressions = number of ad displayed events (rc_ads_ad_displayed) in the period
Shape
What happened during each period
API name
ad_impressions
Measures
Impressions (Count)
Filter and segment by
App, Country, Platform, App version
Definition
RevenueDot counts rc_ads_ad_displayed events. An impression is an ad that was shown, not an ad that was requested or loaded. Your SDK ad tracking sends the events to RevenueDot's /v1/events endpoint, either from an ad network adapter or by manual capture, and RevenueDot drops a repeated event id so one event counts once.
Sandbox and TestFlight builds are stored as sandbox and left out. The count is a flow: it adds up the events that happened in each period, in UTC. The current period is incomplete until it ends.
Filter or segment by app, country, platform and app version. The default resolution is day, and week, month, quarter and year are available. For impressions by network, format and placement, use the Ads page in the dashboard.
Find the chart in the dashboard under Analytics > Charts, or call GET /v2/projects/{project_id}/charts/ad_impressions. The response has the same shape as RevenueCat's Charts API.
Worked example
Illustrative numbers for three days.
| Day | Ad displayed events |
|---|---|
| Monday | 4,200 |
| Tuesday | 3,900 |
| Wednesday | 4,400 |
Impressions for the three days = 4,200 + 3,900 + 4,400 = 12,500.
Why it matters
Impressions are the volume side of ad income. Revenue is impressions times the price per impression, so when ad revenue moves, impressions tell you whether you showed more or fewer ads.
They also show how heavy your ad load is. If impressions grow faster than your active users, each user sees more ads, which can hurt reviews and subscription conversion. Check it after you add a placement, and read it with Clicks and eCPM.
API
Same path and response shape as RevenueCat's Charts API, so existing scripts keep working.
curl "https://api.revenuedot.app/v2/projects/$PROJECT_ID/charts/ad_impressions?resolution=day" \
-H "Authorization: Bearer $SECRET_KEY" # sk_... with charts_metrics:charts:read Reference: Charts guide · REST API v2
FAQ
One ad displayed event sent by your SDK. RevenueDot counts an ad that was shown, not one that was only requested or loaded.
A request is an ad that loaded or failed to load, which Fill Rate uses. An impression is an ad that was displayed. Some loaded ads are never shown.
Turn on the SDK's ad event tracking, through an ad network adapter or manual capture. The SDK posts ad displayed events to RevenueDot's /v1/events endpoint.
RevenueDot has received no ad displayed events for your filters and dates. Check that the SDK sends them, that the build is not a sandbox build, and the date range.
No. Events from sandbox and TestFlight builds are stored as sandbox and left out of the chart.
Get started
Connect your app to RevenueDot Cloud, free up to $10,000 a month in tracked revenue, and all 43 charts fill from your store history after import.
Already have an account? Sign in · Prefer your own servers? Self-host free