Open navigation

Apple Search Ads: Authentication and reauthentication guide

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

To connect Supermetrics to Apple Search Ads, you need:

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


Step 1: Download public key certificate

Instructions

  1. Open Apple Search Ads in the Supermetrics sidebar. This will open a dialog in a new tab.

  2. Click Click here to download your public key certificate.

  3. Locate the file in your "Downloads" folder. You should see a .pem file.



  4. Right-click on the .pem file. Click Open with and select a text editor (like Notepad on Windows, or TextEdit on Mac). 

Step 2: Generate API client

Instructions

  1. Log in to Apple Search Ads with your API user account.
  2. Click on your username on the top-right, and navigate to Settings.
  3. 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.



  4. Paste the whole text under Public Key, and click Generate API client.



  5. You'll get the Client ID, Team ID, and Key ID. Click Save to save those credentials.



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


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Click Add-ons → Supermetrics → Launch to open the sidebar.
  3. Under Data source, select the data source.
  4. Click Start. 
  5. Enter your Client ID, Team ID and Key ID and click Start.
  6. Under Select accounts, select the accounts.

Reauthenticate

Learn how to reauthenticate the data source with Supermetrics in Google Sheets.


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.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.