View App Analytics

Manage campaigns

App Analytics allows you to generate campaign links for use in 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. When you generate a campaign link, you also receive a campaign token and a provider token to use in other campaigns.

Required role: Account Holder, Admin, Finance, or Sales. View role permissions.

Create a campaign link

  1. From App Analytics, select your app.

  2. In the menu bar, click Acquisition.

  3. Choose Campaigns.

  4. Click the add button (+) next to Campaigns.

  5. In the menu under App, select your app from the list.

  6. In the Campaign field, enter a campaign name. Your campaign name will be 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.

  7. 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 a campaign token (identified by the ct= parameter) and a provider token (identified with the pt= parameter) that you can place in your other campaigns.

Smart App Banners

If you promote your app with Smart App Banners in Safari, you can 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

For targeted campaigns for the App Store for iMessage, add the &app=messages parameter to your campaign link to ensure that the user is directed to your app's product page on the App Store for iMessage. iMessage and sticker pack extensions share a 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 will only show up after at least 24 hours have passed since the campaign was launched, and it has been attributed with at least five first-time downloads. Your campaign must also include your 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 during a certain period, only the most recent campaign link is credited for sales that occur after it's used.

  1. From App Analytics, select your app. The Overview page provides a summary of key metrics about your app.

  2. Click Acquisition.

  3. In the menu on the left, choose Campaigns.

  4. From 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.

  5. 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.