How to Measure Apple Search Ads Campaigns
Apple Search Ads puts your app in front of people who are already searching the App Store for something like it. The hard part starts after the tap: you need to know which campaign, ad group, and keyword produced an install, and then whether that install turned into paying, retained subscribers. This guide separates the two measurement layers, explains what Apple's own reports can and cannot show, and walks through connecting attribution data to subscription analytics.
Two layers of Apple Search Ads measurement
Apple Search Ads (ASA) lets you bid for sponsored placements in App Store search results. Someone looking for a running app, for example, can see your sponsored result when they type a matching term. That intent-level targeting is the appeal of the channel.
Measurement happens at two different levels, and mixing them up is the most common source of bad decisions.
Layer 1 — aggregated campaign metrics. Apple reports totals such as impressions, tap-through rate (TTR), conversion rate (CR), cost per tap (CPT), and cost per acquisition (CPA). These can be sliced by app, campaign, country, or keyword. They answer: is this campaign spending efficiently right now?
Layer 2 — per-install attribution. Apple's in-app frameworks, iAd and AdServices, return details about the individual install: which campaign, ad group, and keyword the user came from. Joined to your subscription data, that answers a different question: what revenue and product usage did this cohort of users actually produce?
Layer 1 tells you what an install cost. Layer 2 tells you what an install was worth. Optimization needs both.
What Apple's reporting provides
Apple offers downloadable reports of aggregated data. What you can pull depends on which ASA product you use.
Basic is aimed at smaller apps. Control is minimal — essentially a toggle to enable, pause, or disable ads for an app. Basic accounts are limited to $10,000 per month per app, and ads run on an automated cost-per-install (CPI) model. Reporting is a single downloadable report on campaign data.
Advanced gives full control over campaigns, including keywords and countries. Advanced users get a Custom Reports tool with built-in templates for keywords, search terms, weekly search term impression share, and more, plus the ability to build reports manually by choosing dimensions, metrics, filters, and generation frequency.
Either way, the output is tabular — spreadsheet exports rather than visualizations. Turning those exports into a trend line or a cohort view is manual work, and Basic accounts see only minimal data in their exports.
Where Apple's reporting stops short
Apple's attribution frameworks collect valuable data. The limitation is in how that data comes back through reporting, not in what is collected.
The central gap is cohort tracking. Apple's exports are organized at the campaign level and are not tied back to specific users, so you cannot follow a group of users acquired from a given campaign, keyword, or ad group over time to see their lifetime value and product usage. That also means you cannot connect those users to later in-app behavior such as feature usage, trials, upgrades, and churn.
A second gap is presentation. Reports arrive as table-format spreadsheets, which pushes the analysis, tracking, and insight extraction onto manual effort. Smaller apps on Basic get the least data of all.
Neither gap makes Apple's reports useless — they are the right source for spend and conversion efficiency. They are simply not a revenue-attribution system on their own.
A decision checklist before you optimize spend
Use this to confirm you have the data needed for a keep / pause / scale decision on any campaign.
- Spend and efficiency are current. Pull impressions, TTR, CR, CPT, and CPA for the campaign, ad group, and keyword you are evaluating.
- Attribution is reaching your backend. Confirm that installs are arriving with campaign, ad group, and keyword attached, not just a generic organic flag.
- Revenue is joined to attribution. Check that you can see subscription events — trials, upgrades, churn — grouped by the same campaign identifiers.
- Cohorts are readable over time. Verify you can view a cohort's revenue trend, not only a single-period total.
- The comparison is fair. Compare cohorts of similar age; a campaign launched last week has not had time to show its retention curve.
- The decision is written down. Record which campaign you are keeping, pausing, or scaling, and which metric drove it.
If step 2 or 3 fails, fix instrumentation before changing bids — otherwise you are optimizing on cost alone.
Worked example: why CPA alone misleads
Suppose two keywords each produce installs at the same CPA. On aggregated data they look equivalent, and a cost-only review would treat them the same.
The difference appears once attribution is joined to subscription data. Keyword A's installs may convert to trials and upgrades quickly; keyword B's may convert more slowly but retain longer. Because Apple's campaign-level exports do not tie metrics back to individual users, that distinction is invisible in the export alone. It becomes visible only when per-install attribution is stored alongside subscription lifecycle events and viewed as a cohort over time.
The practical rule: use CPA to decide whether a keyword is affordable, and cohort revenue to decide whether it is worth keeping.
Connecting attribution to subscription analytics
{{OWNER_BRAND_NAME}} is an app monetization platform for implementing in-app purchases, managing data, and growing revenue across iOS, Android, and the web. It provides a backend and wrapper around Apple's StoreKit and Google Play Billing, handling purchase implementation and maintenance and acting as a cross-platform source of truth — including for ASA data.
The Apple Search Ads integration supports the latest AdServices framework. With it, AdServices attribution data appears inside {{OWNER_PRODUCT_ANALYTICS_NAME}}, the subscription analytics tool, where you can filter, segment, and visually track ASA campaign cohorts over time. Subscription lifecycle can be followed by campaign and ad group, and revenue contribution can be viewed by cohort — for example, a Monthly Recurring Revenue chart segmented by ad campaign.
Setup for existing users follows these steps:
- Add the Apple Search Ads integration from the dashboard.
- Update to the latest SDK version.
- Add one line of code to enable collection of the attribution token.
- Optionally authorize access to your Apple Search Ads data — recommended for Advanced users.
Minimum SDK versions for the attribution token step:
- iOS: purchases-ios 4.10.0
- React Native: react-native-purchases 5.0.0-beta.4
- Flutter: purchases-flutter 4.1.0
- Cordova: cordova-plugin-purchases 3.0.0-rc.5
Full setup details live in the Apple Search Ads documentation.
Telling two failures apart
When campaign data looks wrong, the cause is usually one of two distinct problems, and they have different fixes.
Missing attribution. Installs show up but carry no campaign, ad group, or keyword. This points at the client side: the SDK version is below the minimum, or the attribution-token line was never added. Fix the app build and re-test with a fresh install.
Missing revenue context. Attribution is present, but you cannot see spend or campaign structure alongside it. This points at the account side: the Apple Search Ads authorization step was skipped, which matters most for Advanced accounts that want campaign data joined to subscription data.
Checking which layer is empty tells you whether to ship a build or revisit the integration settings.
Frequently asked questions
What is the difference between Apple Search Ads Basic and Advanced for reporting?
Basic accounts can download a single report on campaign data and have almost no campaign control — just an on/off toggle, a $10,000 per month per app limit, and an automated cost-per-install model. Advanced accounts control keywords and countries and get a Custom Reports tool with templates for keywords, search terms, and weekly search term impression share, plus manual report building with chosen dimensions, metrics, and filters.
Can Apple's reports show lifetime value by campaign?
Not directly. Apple's exports are campaign-level and are not tied back to specific users, so you cannot follow a cohort of users from a given campaign, keyword, or ad group over time to see lifetime value and product usage. That requires joining per-install attribution from AdServices to your own subscription data.
Which SDK versions support the attribution token step?
The minimum versions listed for the attribution token step are purchases-ios 4.10.0, react-native-purchases 5.0.0-beta.4, purchases-flutter 4.1.0, and cordova-plugin-purchases 3.0.0-rc.5. Check the current documentation for later releases.
Is authorizing Apple Search Ads data access required?
It is optional, but recommended for Advanced users. Without it, attribution can still arrive from the app, but campaign-level data is not joined to your subscription analytics.