Documentation menu

Metrics glossary

Definitions for every metric surfaced in Catchbase analytics. Each row lists the metric, its formula, its underlying data source, how fresh the value is, and how it behaves across cohorts. Metric names match what you see in the dashboard.

"MMP" means the mobile measurement partner (Adjust or AppsFlyer), the source of installs and revenue. Metrics are grouped using the same sections the dashboard uses on the columns menu: Ad Performance, Conversions, Cost Metrics, Budget, Revenue, ROAS, and the per-event MMP columns.

Three categories: Apple-standard, Auction Insights, and MMP-driven

The metrics split into three groups, and the distinction matters in practice.

Apple-standard metrics are identical across every Catchbase customer. Impressions, taps, tap installs, spend, tap-through rate, conversion rate, cost-per-tap, and cost-per-install come from Apple Ads' Campaign Management reporting. Every customer pulls the same fields, on the same schedule, with the same definitions Apple uses. If two customers compare notes on "CPI", they are comparing the same thing. See References below.

Auction Insights metrics are also standard across customers, but come from a different Apple API (Impression Share) and from Catchbase's own view of keyword state. Average Share of Voice is Apple's; Total Keywords / Prioritized / Deprioritized are counts Catchbase derives from its own bidding state. See the Auction Insights table for the exact definitions, and note Apple's Impression Share API has a 30-day maximum lookback, so SOV values older than 30 days are not available.

MMP-driven metrics depend on how your MMP is configured. Revenue, cohorted revenue (D0, D1, D7, D14, D30), ROAS (total and cohorted), the per-event Count / Revenue / ROAS / CPA columns, and any CPA or ROAS target based on an event all flow from Adjust or AppsFlyer. What gets measured, how events are named, and which events carry revenue are choices made in your MMP setup. Two customers with the same MMP provider can see different custom events, different revenue attribution windows, and different event-to-revenue mappings. Standard cohort windows (D0 / D1 / D7 / D14 / D30) are normalised by Catchbase so the dashboard column shapes are stable; everything beyond that follows your MMP configuration. For the setup side, see Connect Adjust or Connect AppsFlyer; for custom events specifically, see Custom events.

Ad Performance

MetricFormulaSourceFreshness
ImpressionsCount of ad impressionsApple AdsDaily, Apple-fresh
TapsCount of ad tapsApple AdsDaily, Apple-fresh
Tap-through Rate (TTR)Taps divided by impressionsComputed from Apple AdsSame-day

Conversions

MetricFormulaSourceFreshness
Installs (Tap-Through)Tap-attributed installs reported by AppleApple AdsDaily, typical 1 to 2 day stabilisation
Conversion Rate (CVR)Installs divided by tapsComputed from Apple AdsSame-day

Cost Metrics

MetricFormulaSourceFreshness
SpendAd spend in the campaign's local currencyApple AdsDaily, real-time
Cost-per-Tap (CPT)Spend divided by tapsComputed from Apple AdsSame-day
Cost-per-Install (CPI)Spend divided by installsComputed from Apple AdsSame-day

Budget

MetricFormulaSourceNotes
Total BudgetThe daily budget configured on the campaignApple Ads (written by Catchbase when Budget Allocation or a manual edit applies)Reflects the value currently set on Apple Ads
Budget UtilizationSpend as a share of the daily budget for the current dayComputed from Apple AdsSame-day

Auction Insights

Auction Insights surface how competitive the auction is and where the bidding model is spending its attention across keywords. Average Share of Voice and Average Bid come from Apple; Total Keywords, Prioritized, and Deprioritized are counts Catchbase computes from its own bidding state. All five appear on the keyword-level Analytics views.

MetricFormulaSourceNotes
Average Share of Voice (SOV)Mean share of eligible auctions where your ad was shown, averaged over the selected periodApple Ads Impression Share APIApple's API has a 30-day maximum lookback window; values older than 30 days are not available. Shown as a percentage. Also rendered as "SOV" in the Keyword Overlap table on the Search Terms tab.
Average BidMean of the max-CPT bids across the keywords in scopeCatchbase (from Apple Ads bid records)Currency metric.
Total KeywordsCount of distinct keywords in the current scopeCatchbaseInteger.
PrioritizedCount of keywords the bidding model is actively bidding onCatchbaseInteger.
DeprioritizedCount of keywords the bidding model has reduced bids on for performance or volume reasonsCatchbaseInteger. Low-volume or underperforming keywords typically fall into this count.

Prioritized plus Deprioritized equals Total Keywords within a given scope.

Revenue

All values come from your MMP (Adjust or AppsFlyer). Cohort maturity rules are explained in full on Data freshness.

MetricFormulaSourceCohort behaviour
Revenue (also shown as "Total Revenue")Sum of all revenue attributed to installs in the date range, regardless of how long after install it arrivedMMPLifetime; recent cohorts always incomplete
Revenue D0Revenue on install day onlyMMPMature after 0 days
Revenue D1Revenue within 1 day post-installMMPMatures after 1 day; the most recent 1 day is trimmed
Revenue D7Revenue within 7 days post-installMMPMatures after 7 days; the most recent 7 days are trimmed
Revenue D14Revenue within 14 days post-installMMPMatures after 14 days; the most recent 14 days are trimmed
Revenue D30Revenue within 30 days post-installMMPMatures after 30 days; the most recent 30 days are trimmed

Adjust reports the cohorted windows natively. AppsFlyer does not, so Catchbase synthesises them from raw event records using the install time and event time. The user-facing labels and values are the same either way.

ROAS

All ROAS values are computed as MMP revenue divided by Apple Ads spend. Adjust reports its own pre-computed ROAS, but Catchbase ignores it and divides revenue by spend itself so figures are comparable across Adjust and AppsFlyer tenants.

MetricFormulaSourceCohort behaviour
ROAS (also shown as "Total ROAS")Revenue divided by spendComputed from MMP and Apple AdsMatches lifetime revenue
ROAS D0Revenue D0 divided by spendComputedMatches Revenue D0
ROAS D1Revenue D1 divided by spendComputedMatches Revenue D1
ROAS D7Revenue D7 divided by spendComputedMatches Revenue D7
ROAS D14Revenue D14 divided by spendComputedMatches Revenue D14
ROAS D30Revenue D30 divided by spendComputedMatches Revenue D30

Per-event MMP columns

Each event configured in your MMP produces up to four columns in the analytics tables. The event name is whatever you named it in your MMP (for example, "Purchase", "Signup", "Level Complete"). These columns are tenant-specific by definition.

Column patternWhat it showsSource
<Event> (Count)Count of the named eventMMP
<Event> (Revenue)Sum of revenue attached to the named eventMMP
<Event> (ROAS)Event revenue divided by spendComputed from MMP and Apple Ads
<Event> (CPA)Spend divided by count of the named eventComputed from MMP and Apple Ads

Per-event columns appear in the column selector only for events that are actively tracked in your MMP and selected for Catchbase. The custom events page covers how an event becomes selectable in the dropdown.

Notes on specific metrics

CPA is event-scoped. There is no single CPA metric. Every CPA is scoped to a named MMP event and appears in the UI as <Event> (CPA). A campaign optimising for a cost-per-acquisition target is optimising against a specific event's CPA.

ROAS is always MMP revenue over Apple Ads spend. Adjust reports its own pre-computed ROAS, but Catchbase ignores that and divides revenue by spend itself. Ratios are computed once at the correct level of aggregation, and figures are comparable between Adjust-connected tenants and AppsFlyer-connected tenants.

Lifetime revenue is never fully mature. Unlike the dated cohorts, there is no fixed window after which lifetime revenue stops growing. Recent install cohorts will always understate true lifetime revenue because later events have not yet happened. See Data freshness.

References

External documentation that defines the underlying metrics and events. Every definition Catchbase uses is consistent with these sources.

Apple Ads (Apple-sourced metrics and Auction Insights)

Adjust (MMP-driven metrics)

AppsFlyer (MMP-driven metrics)

Methodology references (used elsewhere in the docs, relevant here)

  • CausalImpact (Brodersen et al. 2015), the method behind the Incrementality section, is not used for these metrics directly but consumes them as its inputs.

Related