diff --git a/docs/dashboard-and-metrics/charts/ad-clicks-chart.md b/docs/dashboard-and-metrics/charts/ad-clicks-chart.md new file mode 100644 index 000000000..bfa7c6035 --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-clicks-chart.md @@ -0,0 +1,33 @@ +--- +title: Ad Clicks Chart +slug: ad-clicks-chart +hidden: false +--- + +The Ad Clicks chart tracks the number of times users clicked on ads in your app. Clicks indicate user engagement with ads and can help you understand which ad placements and formats are most effective. + +### Measures + +**Clicks**: The total number of times users clicked on ads. Each click represents a user interaction with an advertisement. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by ad-specific dimensions like Ad Network, Ad Mediator, Ad Placement, and Ad Unit. See [Ad Impressions](/dashboard-and-metrics/charts/ad-impressions-chart#ad-dimensions) for details. + +## How to use Ad Clicks in your business + +Ad clicks help you measure user engagement with your advertising: + +- Track click trends over time to see how ad engagement evolves +- Segment by platform or country to identify where users are most likely to engage with ads +- Compare clicks against impressions to calculate click-through rate (CTR) +- Use alongside revenue metrics to understand which clicks are most valuable + +## Calculation + +For each period, we measure the total count of user clicks on ads. Each individual click is counted, representing a moment when a user actively engaged with an advertisement. diff --git a/docs/dashboard-and-metrics/charts/ad-ctr-chart.md b/docs/dashboard-and-metrics/charts/ad-ctr-chart.md new file mode 100644 index 000000000..19756495e --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-ctr-chart.md @@ -0,0 +1,45 @@ +--- +title: Ad CTR Chart +slug: ad-ctr-chart +hidden: false +--- + +The Ad CTR (Click-Through Rate) chart measures how often users click on ads after seeing them. A higher CTR indicates your ads are relevant and engaging to users. + +### Measures + +**Clicks**: The total number of times users clicked on ads. + +**Impressions**: The total number of times ads were displayed to users. + +### Calculations + +**CTR**: The percentage of ad impressions that resulted in clicks, calculated as (Clicks ÷ Impressions) × 100. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by ad-specific dimensions like Ad Network, Ad Mediator, Ad Placement, and Ad Unit. See [Ad Impressions](/dashboard-and-metrics/charts/ad-impressions-chart#ad-dimensions) for details. + +## How to use Ad CTR in your business + +Click-through rate is a key indicator of ad relevance and user engagement: + +- Monitor CTR trends to assess whether ad placements and formats are resonating with users +- Segment by country or platform to identify where ads perform best +- Compare CTR across different app versions to see if UI changes affect ad engagement +- A declining CTR may indicate ad fatigue or poor ad placement, while an increasing CTR suggests effective monetization + +## Calculation + +For each period, we calculate: + +1. Total clicks on ads +2. Total ad impressions +3. CTR = (Clicks ÷ Impressions) × 100 + +CTR is expressed as a percentage with two decimal places of precision. diff --git a/docs/dashboard-and-metrics/charts/ad-fill-rate-chart.md b/docs/dashboard-and-metrics/charts/ad-fill-rate-chart.md new file mode 100644 index 000000000..d402aa71d --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-fill-rate-chart.md @@ -0,0 +1,49 @@ +--- +title: Ad Fill Rate Chart +slug: ad-fill-rate-chart +hidden: false +--- + +The Ad Fill Rate chart shows how successfully ad requests are being fulfilled with actual ads. A higher fill rate means more opportunities to monetize your users. Low fill rates may indicate targeting issues or limited ad inventory availability. + +### Measures + +**Ads Requested**: The total number of times your app requested an ad from the ad network. Each request represents a monetization opportunity. + +**Ads Loaded**: The number of ads that successfully loaded and were ready to display. This represents fulfilled monetization opportunities. + +**Ads Failed to Load**: The number of ad requests that couldn't be filled with an ad. Failed requests represent missed monetization opportunities. + +### Calculations + +**Fill Rate**: The percentage of ad requests that were successfully filled with ads, calculated as (Ads Loaded ÷ Ads Requested) × 100. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by ad-specific dimensions like Ad Network, Ad Mediator, Ad Placement, and Ad Unit. See [Ad Impressions](/dashboard-and-metrics/charts/ad-impressions-chart#ad-dimensions) for details. + +## How to use Ad Fill Rate in your business + +Fill rate helps you understand how well you're capitalizing on monetization opportunities: + +- Monitor fill rate trends to identify issues with ad inventory or targeting +- Segment by country to see if certain regions have lower ad availability +- Compare fill rates across platforms to optimize your ad integration +- Low fill rates may indicate you need to add more ad networks or adjust your targeting settings +- Track "Ads Failed to Load" to quantify missed revenue opportunities + +## Calculation + +For each period, we calculate: + +1. Total ad requests made by your app +2. Total ads that successfully loaded +3. Total ads that failed to load +4. Fill Rate = (Ads Loaded ÷ Ads Requested) × 100 + +Fill rate is expressed as a percentage with two decimal places of precision. diff --git a/docs/dashboard-and-metrics/charts/ad-impressions-chart.md b/docs/dashboard-and-metrics/charts/ad-impressions-chart.md new file mode 100644 index 000000000..fda3bda2b --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-impressions-chart.md @@ -0,0 +1,50 @@ +--- +title: Ad Impressions Chart +slug: ad-impressions-chart +hidden: false +--- + +The Ad Impressions chart tracks the total number of times ads were displayed to users in your app. Impressions represent your ad exposure and are the foundation for calculating other key metrics like CTR and RPM. + +:::warning Data differences with ad networks and mediators +RevenueCat's ad data comes from real-time SDK callbacks and will not match the numbers in your ad network or mediator dashboards. Ad networks and mediators apply post-processing, deduplication, and fraud filtering that can take 24-48 hours to finalize, resulting in different totals. Use RevenueCat for real-time tracking and unified revenue reporting, and your ad platform dashboards for final reconciliation. +::: + +### Measures + +**Impressions**: The total number of times ads were successfully displayed to users. Each impression represents one instance of an ad being shown. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by several ad-specific dimensions: + +- **Ad Network**: The advertising network that served the ad (e.g., Google Ads, Facebook Audience Network, Unity Ads) +- **Ad Mediator**: The mediation platform managing multiple ad networks (e.g., AdMob, AppLovin) +- **Ad Placement**: The contextual placement where the ad appears in your app (optional) +- **Ad Unit**: A unique identifier for a specific ad slot or format in your app + +## How to use Ad Impressions in your business + +Ad impressions help you understand the scale of your ad monetization efforts: + +- Monitor impression trends to see how ad exposure changes as your user base grows +- Segment by platform or country to understand where most of your ad inventory is being consumed +- Compare impressions against ad revenue to identify variations in monetization efficiency +- Use with Fill Rate to understand how well you're capitalizing on ad opportunities + +## Calculation + +For each period, we measure the total count of ad impressions where ads were successfully displayed to users. Each impression is counted individually, even if shown to the same user multiple times. + +## FAQs + +| Question | Answer | +| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Why don't RevenueCat's ad numbers match my ad network dashboard? | RevenueCat reports ad data from real-time SDK callbacks as they occur. Ad networks and mediators (like AdMob, AppLovin, ironSource) process their data over 24-48 hours, applying deduplication, fraud filtering, and other adjustments that can reduce reported totals. This means RevenueCat may show higher numbers than your ad platform. Use RevenueCat for real-time insights and unified revenue tracking, and your ad platform for final billing reconciliation. | +| Can I reconcile RevenueCat's ad data with my ad network? | Exact reconciliation is not possible due to the different data processing methodologies. RevenueCat captures raw SDK events in real-time, while ad networks apply various filters and adjustments. For financial reporting, rely on your ad network's finalized numbers. Use RevenueCat's data to understand real-time trends and combine ad revenue with subscription revenue in a single dashboard. | +| Which ad metrics are most reliable for decision-making? | Focus on relative trends and comparisons rather than absolute numbers. For example, comparing RPM across countries or tracking CTR trends over time in RevenueCat will give you actionable insights, even if the absolute impression counts differ from your ad platform. | diff --git a/docs/dashboard-and-metrics/charts/ad-monetized-customers-chart.md b/docs/dashboard-and-metrics/charts/ad-monetized-customers-chart.md new file mode 100644 index 000000000..000f4b92a --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-monetized-customers-chart.md @@ -0,0 +1,39 @@ +--- +title: Ad Monetized Customers Chart +slug: ad-monetized-customers-chart +hidden: false +--- + +The Ad Monetized Customers chart tracks the number of unique customers who generated ad revenue by viewing or interacting with ads. This helps you understand the size of your actively monetized user base and identify trends in user engagement with ads. + +### Measures + +**Ad Monetized Customers**: The count of unique customers who generated ad revenue through impressions or clicks. Each customer is counted once per period, regardless of how many ads they viewed. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by ad-specific dimensions like Ad Network, Ad Mediator, Ad Placement, and Ad Unit. See [Ad Impressions](/dashboard-and-metrics/charts/ad-impressions-chart#ad-dimensions) for details. + +## How to use Ad Monetized Customers in your business + +This metric helps you understand user engagement with your ad monetization: + +- Track how many of your users are actively contributing to ad revenue +- Compare ad monetized customers against total active users to understand ad exposure +- Segment by country or platform to see where your ad-engaged users are located +- Monitor trends to see if ad monetization is expanding or contracting in your user base +- Combine with ad revenue to calculate average revenue per ad monetized customer +- Use this metric to ensure you're not over-monetizing a small subset of users + +## Calculation + +For each period, we count the distinct number of customers who generated any ad revenue through impressions or clicks. Each customer is counted only once per period, regardless of how many times they viewed or clicked ads. + +## Example + +If the same customer views 100 ads in a day, they are counted as 1 ad monetized customer for that day, not 100. This gives you an accurate count of your monetized user base rather than total ad activity. diff --git a/docs/dashboard-and-metrics/charts/ad-revenue-chart.md b/docs/dashboard-and-metrics/charts/ad-revenue-chart.md new file mode 100644 index 000000000..366d9e1ab --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-revenue-chart.md @@ -0,0 +1,42 @@ +--- +title: Ad Revenue Chart +slug: ad-revenue-chart +hidden: false +--- + +The Ad Revenue chart tracks the total revenue generated from ads in your app. This is your primary ad monetization metric, showing how much income your ad placements are generating. + +### Measures + +**Revenue**: The total amount earned from ads during the period. + +**Clicks**: The total number of times users clicked on ads. + +**Impressions**: The total number of times ads were displayed to users. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by ad-specific dimensions like Ad Network, Ad Mediator, Ad Placement, and Ad Unit. See [Ad Impressions](/dashboard-and-metrics/charts/ad-impressions-chart#ad-dimensions) for details. + +## How to use Ad Revenue in your business + +Ad revenue is the bottom-line metric for measuring your advertising monetization success: + +- Track revenue trends to understand the financial impact of your ad strategy +- Segment by country or platform to identify your most valuable markets +- Compare ad revenue against subscription revenue to understand your monetization mix +- Monitor revenue alongside impressions and clicks to see what drives revenue changes +- Use with RPM to normalize revenue across different impression volumes + +## Calculation + +For each period, we measure the total revenue generated from ad impressions and clicks. Revenue is reported in your display currency and rounded to two decimal places. + +:::info Ad Revenue in Total Revenue +Ad revenue is automatically included in the main [Revenue chart](/dashboard-and-metrics/charts/revenue-chart) alongside subscription and non-subscription purchase revenue, giving you a complete view of your app's monetization. +::: diff --git a/docs/dashboard-and-metrics/charts/ad-rpm-chart.md b/docs/dashboard-and-metrics/charts/ad-rpm-chart.md new file mode 100644 index 000000000..03622db0d --- /dev/null +++ b/docs/dashboard-and-metrics/charts/ad-rpm-chart.md @@ -0,0 +1,59 @@ +--- +title: Ad RPM Chart +slug: ad-rpm-chart +hidden: false +--- + +The Ad RPM (Revenue Per Mille) chart shows how much you earn for every 1,000 ad impressions. This metric helps you compare monetization efficiency across different time periods, countries, or platforms regardless of total impression volume. + +### Measures + +**Revenue**: The total amount earned from ads during the period. + +**Impressions**: The total number of times ads were displayed to users. + +**Impressions in thousands**: The total number of impressions divided by 1,000, used to calculate RPM. + +### Calculations + +**RPM**: The average revenue earned per 1,000 ad impressions, calculated as (Revenue ÷ Impressions) × 1,000. Higher RPM indicates more effective monetization. + +### Available settings + +- Filters: Yes +- Segments: Yes + +### Ad dimensions + +Ad charts can be filtered and segmented by ad-specific dimensions like Ad Network, Ad Mediator, Ad Placement, and Ad Unit. See [Ad Impressions](/dashboard-and-metrics/charts/ad-impressions-chart#ad-dimensions) for details. + +## How to use Ad RPM in your business + +RPM is essential for understanding monetization efficiency independent of scale: + +- Compare RPM across countries to identify high-value markets worth targeting +- Track RPM trends to see if monetization efficiency is improving over time +- Segment by platform to optimize ad strategies for iOS vs Android +- Use RPM to evaluate the impact of ad placement changes or new ad formats +- A stable or growing RPM while impressions increase indicates healthy ad monetization +- Compare RPM across app versions to see if updates affect monetization + +## Calculation + +For each period, we calculate: + +1. Total ad revenue +2. Total ad impressions +3. Impressions in thousands = Impressions ÷ 1,000 +4. RPM = Revenue ÷ Impressions in thousands + +RPM is expressed in your display currency with two decimal places of precision. + +## Example + +If you earned $500 from 100,000 ad impressions: + +- Impressions in thousands = 100,000 ÷ 1,000 = 100 +- RPM = $500 ÷ 100 = $5.00 + +This means you earned $5 for every 1,000 ad impressions. diff --git a/sidebars.ts b/sidebars.ts index 09b125af4..8522915d7 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -740,6 +740,22 @@ const chartsCategory = Category({ link: "dashboard-and-metrics/charts/subscriptions", }, }), + SubCategory({ + label: "Ads", + items: [ + Page({ slug: "charts/ad-impressions-chart" }), + Page({ slug: "charts/ad-clicks-chart" }), + Page({ slug: "charts/ad-revenue-chart" }), + Page({ slug: "charts/ad-ctr-chart" }), + Page({ slug: "charts/ad-rpm-chart" }), + Page({ slug: "charts/ad-fill-rate-chart" }), + Page({ slug: "charts/ad-monetized-customers-chart" }), + ], + index: { + title: "Ads", + link: "dashboard-and-metrics/charts/ads", + }, + }), SubCategory({ label: "Cohorts and LTV", items: [