Apple App Store Setup Guide

Prerequisites

• An active Apple App Store Connect account with Admin role assignments.

Note: After creating or modifying an Apple account, it can take up to 48 hours for Apple to fully provision the account. During this time, some reports may not be available.

Setup Guide

Step 1: Generate API Key in Apple App Store Connect

1. Log in to your Apple App Store Connect dashboard.
2. Navigate to Users and Access, then click on the Integrations tab.
3. Click the Add button.
4. Complete the Generate API Key form and click Generate.
5. Assign the Admin role to your API key user if you plan to sync analytics reports. For other use cases, the Finance role is sufficient.
6. Save the Issuer ID and Key ID of the generated key and the API Key file. You will need these credentials to configure Matia.

Step 2: Locate Your Vendor Number

1. In the Apple App Store Connect dashboard, navigate to the Reports page.
2. Find the Vendor Number and record it for configuration purposes.
3. If you have multiple accounts, save the Vendor Number for each account you intend to sync.

Step 3: Complete Configuration in Matia

1. Enter an Asset Name.
2. Enter the Key ID and Issuer ID from the API key you created.
3. Upload the API Key file you downloaded from Apple.
4. Click + Add to enter the Vendor Number you located in the Vendor Id field. Multiple Vendor Numbers can be added if needed.
5. Select your Apps sync mode:
   • Choose Sync all apps to sync data for all apps under your Apple account.
   • Choose Sync specific apps to select which apps to sync.
6. In the Historical Sync Time Frame dropdown, select how many months of historical data you'd like to include in the initial sync.
7. (Optional) Enter a Description.
8. (Optional) Assign Tags.
9. Select an Owner.
10. Verify that your Apple App Store Connect account is successfully connected by clicking on Test Connection.
11. Click Connect.