superwall · DreamingInBinary · Aug 18, 2026 · Aug 13, 2026 · Aug 13, 2026 · Aug 13, 2026
diff --git a/content/docs/dashboard/charts/ad-spend.mdx b/content/docs/dashboard/charts/ad-spend.mdx
@@ -0,0 +1,20 @@
+---
+title: "Ad Spend"
+description: "Learn what the Ad Spend chart measures and when to use it."
+---
+
+<Frame>![Ad Spend chart](/images/charts/ad-spend.jpg)</Frame>
+
+## What it shows
+
+Ad Spend shows the daily spend reported by your connected ad network accounts, currently Meta.
+
+## How to use it
+
+Track what your campaigns cost alongside what they return. Break down by Acquisition Campaign to compare campaigns, or view it next to [ROAS](/dashboard/charts/roas).
+
+## Good to know
+
+Spend syncs from Meta once a day, starting from the date you connected your Meta account. Earlier spend is not imported.
+
+Advertising charts appear once performance marketing is enabled for your app. See [Meta Ads](/integrations/meta-ads).
diff --git a/content/docs/dashboard/charts/blended-cpt.mdx b/content/docs/dashboard/charts/blended-cpt.mdx
@@ -0,0 +1,22 @@
+---
+title: "Blended CPT"
+description: "Learn what the Blended CPT chart measures and when to use it."
+---
+
+<Frame>![Blended CPT chart](/images/charts/blended-cpt.jpg)</Frame>
+
+## What it shows
+
+Blended CPT shows your total ad spend across all campaigns divided by all trial starts, paid and organic.
+
+## How to use it
+
+Use it to see what a trial costs you overall, counting the organic trials that paid acquisition may also be driving.
+
+## Good to know
+
+Blended CPT is a single blended figure and intentionally has no breakdown. Splitting it per campaign would turn it into plain [CPT](/dashboard/charts/cpt).
+
+Because values are cohorted by install date, the chart defaults to weekly intervals.
+
+Advertising charts appear once performance marketing is enabled for your app. See [Meta Ads](/integrations/meta-ads).
diff --git a/content/docs/dashboard/charts/cpm.mdx b/content/docs/dashboard/charts/cpm.mdx
@@ -0,0 +1,20 @@
+---
+title: "CPM"
+description: "Learn what the CPM chart measures and when to use it."
+---
+
+<Frame>![CPM chart](/images/charts/cpm.jpg)</Frame>
+
+## What it shows
+
+CPM shows your cost per 1,000 ad impressions, from the spend and impressions your connected ad accounts report.
+
+## How to use it
+
+Monitor what reach costs over time and compare it across campaigns. A rising CPM with flat results means you're paying more for the same audience.
+
+## Good to know
+
+CPM comes from spend and impressions alone. It doesn't depend on install attribution, so it works even for campaigns with no attributed installs yet.
+
+Advertising charts appear once performance marketing is enabled for your app. See [Meta Ads](/integrations/meta-ads).
diff --git a/content/docs/dashboard/charts/cpp.mdx b/content/docs/dashboard/charts/cpp.mdx
@@ -0,0 +1,20 @@
+---
+title: "CPP (Cost per Paid User)"
+description: "Learn what the CPP chart measures and when to use it."
+---
+
+<Frame>![CPP chart](/images/charts/cpp.jpg)</Frame>
+
+## What it shows
+
+CPP shows ad spend per new paying user, cohorted by install date.
+
+## How to use it
+
+Break down by Acquisition Campaign to compare what a paying user costs you from each campaign. This is the number to watch if your app sells without trials.
+
+## Good to know
+
+Because values are cohorted by install date, daily buckets miss most spend-to-purchase matches. The chart defaults to weekly intervals and warns you when Daily is selected.
+
+Advertising charts appear once performance marketing is enabled for your app. See [Meta Ads](/integrations/meta-ads).
diff --git a/content/docs/dashboard/charts/cpt.mdx b/content/docs/dashboard/charts/cpt.mdx
@@ -0,0 +1,24 @@
+---
+title: "CPT (Cost per Trial)"
+description: "Learn what the CPT chart measures and when to use it."
+---
+
+<Frame>![CPT chart](/images/charts/cpt.jpg)</Frame>
+
+*The example above is flat because this app doesn't offer trials.*
+
+## What it shows
+
+CPT shows ad spend per trial start, cohorted by install date.
+
+## How to use it
+
+Break down by Acquisition Campaign to compare what a trial costs you from each campaign.
+
+## Good to know
+
+Because values are cohorted by install date, daily buckets miss most spend-to-trial matches. The chart defaults to weekly intervals and warns you when Daily is selected.
+
+If your app doesn't offer trials, use [CPP](/dashboard/charts/cpp) instead.
+
+Advertising charts appear once performance marketing is enabled for your app. See [Meta Ads](/integrations/meta-ads).
diff --git a/content/docs/dashboard/charts/index.mdx b/content/docs/dashboard/charts/index.mdx
@@ -54,6 +54,14 @@ Currently, we offer the following charts:
 - [**Refund Rate**](/dashboard/charts/refund-rate): Ratio of refunds to gross proceeds, cohorted by first purchase date.
 - [**Subscription Retention**](/dashboard/charts/subscription-retention): Subscription retention by cohort over time.
 
+#### Advertising Charts
+- [**Ad Spend**](/dashboard/charts/ad-spend): Daily spend from your connected ad network accounts.
+- [**ROAS**](/dashboard/charts/roas): Return on ad spend: proceeds cohorted by install date, divided by spend.
+- [**CPM**](/dashboard/charts/cpm): Cost per 1,000 ad impressions.
+- [**CPT (Cost per Trial)**](/dashboard/charts/cpt): Ad spend per trial start.
+- [**CPP (Cost per Paid User)**](/dashboard/charts/cpp): Ad spend per new paying user.
+- [**Blended CPT**](/dashboard/charts/blended-cpt): Total ad spend divided by all trial starts, paid and organic.
+
 ### Filtering chart data
 To filter data on a chart, **click** the **Filter** button at the top right:
 

diff --git a/content/docs/dashboard/charts/meta.json b/content/docs/dashboard/charts/meta.json
@@ -30,6 +30,13 @@
         "---Retention & Churn---",
         "subscriber-churn",
         "refund-rate",
-        "subscription-retention"
+        "subscription-retention",
+        "---Advertising---",
+        "ad-spend",
+        "roas",
+        "cpm",
+        "cpt",
+        "cpp",
+        "blended-cpt"
     ]
 }
diff --git a/content/docs/dashboard/charts/roas.mdx b/content/docs/dashboard/charts/roas.mdx
@@ -0,0 +1,22 @@
+---
+title: "ROAS"
+description: "Learn what the ROAS chart measures and when to use it."
+---
+
+<Frame>![ROAS chart](/images/charts/roas.jpg)</Frame>
+
+## What it shows
+
+ROAS shows your return on ad spend: proceeds cohorted by install date, divided by ad spend.
+
+## How to use it
+
+Break down by Acquisition Campaign to see which campaigns pay back. A value above 1 means a cohort has earned back more than it cost to acquire.
+
+## Good to know
+
+ROAS defaults to an Acquisition Campaign breakdown so you can see which campaigns pay back. Without a breakdown it shows one blended figure across every network with ad spend, which hides how individual campaigns perform.
+
+Because values are cohorted by install date, daily buckets read close to zero. The chart defaults to weekly intervals and warns you when Daily is selected.
+
+Advertising charts appear once performance marketing is enabled for your app. See [Meta Ads](/integrations/meta-ads).
diff --git a/content/docs/images/charts/ad-spend.jpg b/content/docs/images/charts/ad-spend.jpg
diff --git a/content/docs/images/charts/blended-cpt.jpg b/content/docs/images/charts/blended-cpt.jpg
diff --git a/content/docs/images/charts/cpm.jpg b/content/docs/images/charts/cpm.jpg
diff --git a/content/docs/images/charts/cpp.jpg b/content/docs/images/charts/cpp.jpg
diff --git a/content/docs/images/charts/cpt.jpg b/content/docs/images/charts/cpt.jpg
diff --git a/content/docs/images/charts/roas.jpg b/content/docs/images/charts/roas.jpg
diff --git a/content/docs/images/mmp_advertising_chart_section.jpg b/content/docs/images/mmp_advertising_chart_section.jpg
diff --git a/content/docs/images/mmp_meta_ad_links.jpg b/content/docs/images/mmp_meta_ad_links.jpg
diff --git a/content/docs/images/mmp_meta_ad_website_url.jpg b/content/docs/images/mmp_meta_ad_website_url.jpg
diff --git a/content/docs/images/mmp_meta_adset_conversion.jpg b/content/docs/images/mmp_meta_adset_conversion.jpg
diff --git a/content/docs/images/mmp_meta_campaign_objective.jpg b/content/docs/images/mmp_meta_campaign_objective.jpg
diff --git a/content/docs/images/mmp_meta_dataset_token.jpg b/content/docs/images/mmp_meta_dataset_token.jpg
diff --git a/content/docs/images/mmp_meta_events_confirmed.jpg b/content/docs/images/mmp_meta_events_confirmed.jpg
diff --git a/content/docs/images/mmp_meta_events_to_send.jpg b/content/docs/images/mmp_meta_events_to_send.jpg
diff --git a/content/docs/images/mmp_performance_marketing_section.jpg b/content/docs/images/mmp_performance_marketing_section.jpg