App Store Connect Analytics Help
Campaign links
Analytics in App Store Connect allows you to generate campaign links for your marketing materials, enabling you to measure specific campaign performance and understand which marketing efforts are driving the most app downloads.
The campaigns feature leverages URL-based campaign parameters. Each link maps traffic back to a specific campaign so you can measure the performance of ads, social promotions, email, and more, in a privacy-friendly way.
When a user clicks a campaign link, they are redirected to your app's product page on the App Store. Analytics captures the impressions, product page views, downloads, usage, sales, and subscriptions tied to each campaign token. This helps you identify which campaigns deliver high-quality users and which drive lower engagement or retention. You can analyze results across a variety of dimensions, including by territory, device, or page type.
Data for a particular campaign will appear in the dashboard once it has generated first-time downloads from at least five individual users.
To export campaign data in bulk, use the Analytics reports in the App Store Analytics API. Data about individual campaigns is only available for export in the detailed reports, which have more rigorous privacy protections than the standard reports.
Create a campaign link
-
In Apps, select the app you want to view.
-
Click the Analytics tab.
-
In the Acquisition section, click Campaigns.
-
Click the add button (+) next to Campaigns.
-
In the Campaign field, enter a campaign name. Your campaign name is your campaign token. You can use up to 30 alphanumeric characters and spaces, and the following punctuation marks and characters:
[ ] / \ - ~ + = <> : ; , . _ ‘ “ * & $ % # @ ? ! | { } ( )A space can’t be used as the first or last character in the campaign token.
-
Copy the campaign link to use in your marketing materials.
Example:
https://apps.apple.com/app/apple-store/id123456789?pt=123456&ct=test1234&mt=8
Use your campaign and provider tokens
When you generate a campaign link, you also receive tokens that you can place in your other campaigns.
-
Media type token (identified by the mt= parameter)
-
Campaign token (identified by the ct= parameter)
-
Provider token (identified with the pt= parameter)
Smart App Banners
To promote your app using Smart App Banners in Safari, add your campaign token and provider token when implementing a Smart App Banner on your website.
StoreKit
To track advertising and campaigns in apps that use the StoreKit framework to load your product page, add your campaign token and provider token using SKStoreProductParameterCampaignToken and SKStoreProductParameterProviderToken.
App Store for iMessage
To direct users to your app's product page on the App Store for iMessage, add the &app=messages parameter to your campaign link. iMessage and sticker pack extensions share their product page with the associated iOS app.
Example: https://apps.apple.com/us/app/apple-store/id439104108?pt=8668&ct=test123&mt=8&app=messages
Measure campaign performance
When a user downloads your app for the first time within 24 hours of using your campaign link or campaign token, they’re counted as a First-Time Download. If a user clicks more than one campaign link within a given timeframe, only the most recent link receives credit for subsequent sales.
-
In Apps, click the Analytics tab.
-
In the sidebar click Metrics.
-
Click Add Filter, then click Campaign. Use the drop-down menu to view data for a specific campaign.
-
Use the dropdown menus at the top of the Analytics view to apply additional filters for more detailed insights into your campaign performance data.
Troubleshooting common issues
Why is my campaign not appearing in Analytics?
In Analytics, campaigns appear only after a minimum of 24 hours since their launch and after receiving at least five first-time downloads. Ensure your campaign includes both a provider token and a campaign token.