This guide will walk you through how to authenticate or reauthenticate Apple Search Ads with Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.
Before you begin
You need to have a user account with an API Account Read-only or API Account Manager access. Any other access level (for example Admin) will not work. Learn how to invite users in Apple Search Ads.
- An API user can be generated by a user with Account Admin access.
Here's the level of access you require:
Before you can authenticate Apple Search Ads in Supermetrics, follow these steps, download a public key certificate and generate an API key.
Instructions
Open Apple Search Ads in the Supermetrics sidebar. This will open a dialog in a new tab.
Click Click here to download your public key certificate.
Locate the file in your "Downloads" folder. You should see a .pem file.
Right-click on the .pem file. Click Open with and select a text editor (like Notepad on Windows, or TextEdit on Mac).
Instructions
- Log in to Apple Search Ads with your API user account.
- Click on your user name on the top-right, and navigate to Settings.
- Copy the whole text from the public key certificate file you downloaded earlier. The file should include both BEGIN PUBLIC KEY and END PUBLIC KEY.
- Paste the whole text under Public Key, and click Generate API client.
- You'll get the Client ID, Team ID, and Key ID. Click Save to save those credentials.
- Paste the Client ID, Team ID and Key ID to the respective fields in Supermetrics login, and click Start.
Data protection agreement
If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.
Instructions
- Open a new Google Sheets file.
- Click Add-ons → Supermetrics → Launch to open the sidebar.
- Under Data source, select the data source.
- Click Start.
- Enter your Client ID, Team ID and Key ID and click Start.
- Under Select accounts, select the accounts.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Google Sheets.- Open the Supermetrics data source gallery.
- Navigate to the data source and click Try.
- Click Authorize to authorize Supermetrics in Data Studio.
If you're authenticating the data source for the first time, log in with the Google account you use with Supermetrics. Click Allow. - Click Authorize to log in to your data source.
- Enter your Client ID, Team ID and Key ID and click Start.
- Under Select accounts, select your accounts.
- Scroll down to the bottom of the page. To create a report with our template, select Use report template for new reports. To create a blank report, deselect this option.
- Click Connect on the top right-hand side. This will open a full list of fields available in this connector. You can skip this list.
- Click Create report.
- Click Add to report to complete the authentication steps.
Add or remove a user account
- To add or remove a user account go back to the data source settings. Click on the link at the end of the sentence that starts with “To add more/manage user accounts…”
- Click +Add new account to add a new user account.
- Click the Trash icon to remove that specific user account.
- Click Continue to proceed with that user account.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Data Studio.Before you can authenticate the data source in Excel, you need to install the Supermetrics add-on.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select the data source.
- Click Start.
- Enter your Client ID, Team ID and Key ID and click Start.
- Under Select accounts, select the accounts.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Excel.Explore our guides to set up data transfers to various destinations.
- Set up BigQuery
- Set up Data warehouse and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- Set up Supermetrics API
Reauthenticate the data source
Learn how to reauthenticate the data source with Supermetrics API, data warehouse and cloud storage integrations:
Troubleshooting
- If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide.
- If you're missing an account from the drop-down list, follow these steps.
- If you encounter a permission error such as “user permission denied” or similar, follow this guide.