Apple Search Ads is a powerful platform for advertising your apps on the App Store. Using Whatagraph for analytics, you can integrate Apple Search Ads to track your campaigns and visualize your data in one place. Below is a step-by-step tutorial on how to connect Apple Search Ads to Whatagraph.
Before starting the setup, ensure you have an Apple Search Ads account with the account admin role. The account must be associated with your Apple ID.
Step 1: Invite Users to Apple Search Ads API
Log into Apple Search Ads:
Go to the Apple Search Ads website and sign in using your account credentials.
Once logged in, select Sign In > Advanced and log in as an Account Administrator.
Navigate to User Management:
From the Users menu located in the top-right corner of the dashboard, select the account you want to connect to Whatagraph.
Then, go to Account Settings > User Management.
Invite Users to API:
Click on Invite Users to start the invitation process.(Note: Even if you're managing the main Apple Search Ads account, you must invite yourself as a user to access the API credentials.)
In the User Details section, fill out the user’s first name, last name, and Apple ID.
Under the User Access and Role section, select the API Account Manager role. (Note: If you select the API Read Only role, the public key necessary for Whatagraph integration will not be visible, so it's crucial to select the API Account Manager role.)
After filling out the information, click on Send Invite.
Activate the User’s Account:
The invited user will receive an email with a secure code. To activate the account, the user must follow the instructions in the email.
They must sign in to the secure Apple URL provided in the email and input the activation code.
Step 2: Finding the API Keys
Access API Settings:
Go to the Apple Search Ads login page and log in using the newly created user credentials.
Navigate to Account Settings > API for the user you invited.
Get the Public Key:
Copy the public key: MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEj5877JFRgkApytYtXQ2pg+ootiZVmjzZLRxBoFeQWiqYfbLil7KNc9FcqG3nA9Gev0cGQDMlINPqr3HNKxM/Og==
Go to the Apple Search Ads API settings, and in the Public Key field, paste the public key you copied from the connector setup form.
Save and Retrieve Credentials:
After pasting the public key, click Save. A group of credentials will appear as a code block above the Public Key field. These credentials include:
clientId
teamId
keyId
Copy these three credentials because you will need them for the Whatagraph configuration.
Step 3: Connecting Apple Search Ads to Whatagraph
Log in to Your Whatagraph Account
Access your Whatagraph account by visiting Whatagraph and logging in with your credentials.
Go to the Data Sources Section
Once logged in, navigate to the Data Sources section within your Whatagraph dashboard.
Click on "+ Connect New Source"
In the Data Sources section, locate and click on the + Connect New Source button.
Select Apple Search Ads
From the list of available data sources, select Apple Search Ads. This will prompt you to enter the necessary API credentials to link your account.
Enter Your API Credentials
You will need to enter three essential credentials:
clientId
teamId
keyId
These credentials can be obtained from your Apple Search Ads account, which you should have already set up as part of the integration process.
Click 'Add an Account'
After entering the required credentials, click the 'Add an account' button to establish the connection between Whatagraph and Apple Search Ads.
Once the connection is complete, your Apple Search Ads sources should be visible and data will begin syncing with Whatagraph.
You can now create custom reports, monitor your ad campaign performance, and track important metrics directly from the Whatagraph dashboard.