Connectors

Apple Search Ads

Connect Apple Search Ads to Google Sheets or Google Data Studio

Apple Search Ads logo

The Apple Search Ads connector gets your Apple Search Ads data into Google Sheets and Google Data Studio. Use it to track your key metrics in a spreadsheet or a Google Data Studio report.

What you can report on

Campaign impressions, taps, and installs
Cost per tap (CPT) and cost per acquisition (CPA)
Keyword performance and bid data
Ad group and campaign-level spend breakdowns
Conversion rates and install attribution

Prerequisites

An Apple Search Ads account
The API Account Manager or API Account Read Only role in Apple Search Ads. Only these two roles can generate API credentials. Standard and Account Admin roles cannot
API access enabled in your Apple Search Ads settings

Apple Search Ads authenticates with a public/private key pair. Two Minute Reports generates the public key; you paste it into Apple Search Ads, and Apple gives you back the Client ID, Team ID and Key ID the connection needs.

Keep this page and the Two Minute Reports connection form open side by side. You copy a key out of one and paste three values back into the other.

Step 1: Set up an API user

Skip this step if you already sign in with an API Account Manager or API Account Read Only account.

Sign in to your Apple Search Ads dashboard with your Account Admin account
Select your account name (top right) › Settings
Go to User Management › Invite User
Enter the name and Apple ID of the person to invite
Set the role to API Account Manager or API Account Read Only, then select Send Invite
Ask them to accept the email invite. If they're new to Apple Search Ads, they complete signup first

Step 2: Generate the API credentials

Go to ads.apple.com/advanced, select Sign In, then choose Advanced

Apple Search Ads sign-in page with the Advanced option

Apple Search Ads campaign dashboard after signing in

Select your account name (top right) › Settings. You land on the API Credentials page

Apple Search Ads Settings showing the API Credentials page

In the Two Minute Reports connection form, select Copy under Public key

The Public key field and its Copy button on the Two Minute Reports connection form

Copy the whole key, including the -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY----- lines. The pasted key needs a line break at the end, or authentication fails.

Paste it into the Public Key field on the Apple Search Ads API Credentials page, then select Save. On a new account where the key fields are empty, the button reads Generate API Client

Apple Search Ads API Credentials page with the public key pasted

Apple generates and displays the Client ID, Team ID and Key ID
Copy all three. You enter them in Two Minute Reports in the next section

How to create a connection

In the Hub, open Connections & accounts.
Select Create connection.
Select Apple Search Ads in the connector list.
Select Next.

The Create connection dialog with Apple Search Ads selected

In Name the connection, enter a name.
Enter the Client ID, Team ID and Key ID from Apple Search Ads. If you don't have them yet, see How to get your credentials.
Select Test connection.

The Authenticate step of the Create connection dialog, with the Public key, Client ID, Team ID and Key ID fields

Enable the accounts you want to report on.
Select Done.

The Select accounts step of the Create connection dialog, with an account enabled

Only enabled accounts fetch data, and only enabled accounts count toward your plan. You can enable or disable accounts at any time on the Connections & accounts page.