App Store Connect Help
Manage campaigns
App Analytics enables you to generate campaign links for use in your marketing materials. When a user clicks an ad with your campaign link, they’re redirected to your app's product page on the App Store. Generating a campaign link also provides you with a campaign token and a provider token, which can be used in future campaigns.
Required role: Account Holder, Admin, Finance, or Sales. View role permissions.
Create a campaign link
-
In App Analytics, select the app you want to view app.
-
In the menu bar, click Acquisition.
-
Choose Campaigns.
-
Click the add button (+) next to Campaigns.
-
In the menu, under App, select your app from the list.
-
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
View campaign performance
In App 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.
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 App Analytics, select the app you want to view.
-
Click Acquisition.
-
In the menu, on the left, choose Campaigns.
-
In the date picker, on the top-right, choose a date range. You can view a predefined period (for example, Last 7 Days) or enter a custom range. By default, the date picker will display the last 30 days.
-
On the top right, choose an App Purchase Date.
Tip: To export the data in the list, click the download icon on the top right. Keep in mind that this list includes only a limited number of your top referrers. Data will be exported as a CSV file.