Apple Search Ads Setup Guide

Follow our setup guide to connect Apple Search Ads to Fivetran.

Fivetran supports two authorization modes, the legacy OAuth and OAuth 2. How we connect to Apple Search Ads depends on the authorization mode you are using. Follow the setup instructions for your authorization mode:

• Legacy OAuth

• OAuth 2

Setup instructions for legacy OAuthlink

Prerequisiteslink

To connect Apple Search Ads to Fivetran, you need:

• An Apple Search Ads account associated with your Apple ID.
• To use Search Ads, you must link your account-associated Apple ID to your iTunes Connect account.

Download certificateslink

1. Log in to Apple Search Ads.

2. Click the Account Settings in the top right corner.

   

3. Click Actions, then select Download certificate from the drop-down list.

   

4. The certificates will be downloaded in a .zip file that contains 2 separate files, certificate_name.pem and certificate_name.key.

Finish Fivetran configurationlink

1. Enter your chosen destination schema name in the connector setup form.
2. Upload your PEM File that you downloaded in Step 1.
3. Upload your Key File that you downloaded in Step 1.
4. Click Validate to save and test your credentials.
5. Choose the sync mode: Sync All Organizations or Sync Specific Organizations. If you choose Sync Specific Organizations, select which specific organizations you’d like to sync.
6. Select how many months of reporting data you’d like to include in your initial sync.
7. Click Save and Test. Fivetran will take it from here and sync data from your Apple Search Ads account.

Setup instructions for OAuth 2link

Prerequisiteslink

To connect Apple Search Ads to Fivetran, you need:

• An Apple Search Ads account with the account admin role. The account must be associated with your Apple ID.
• To use Search Ads, you must link your account-associated Apple ID to your iTunes Connect account.

Invite userslink

NOTE: Each API user account can only be invited to one connector.

1. Log in to Apple Search Ads. Select Sign In > Advanced and log in as an account administrator.
2. In the Users menu in the top-right corner, select the account that you want to invite users to.
3. Select Account Settings > User Management.
4. Click Invite Users to invite a user to your Apple Search Ads organization.
5. In the User Details section, enter the user’s first name, last name, and Apple ID.
6. In the User Access and Role section, select an API user role.
7. Click Send Invite. The invited user receives an email with a secure code. The user can then sign in to the secure Apple URL in the email and input the provided code to activate their account.

Upload a public keylink

1. In your connector setup form, set the OAuth 2 toggle to ON and copy the automatically-generated public key.

   

2. In the Search Ads dashboard, choose Account Settings > API for the user you invited in Step 1.

3. In the Public Key field, paste the public key you copied from the connector setup form.

4. Click Save. A group of credentials displays as a code block above the Public Key field. Copy the clientId, teamId, and keyId values. You will need them to configure Fivetran.

Finish Fivetran configurationlink

1. In the connector setup form, enter your chosen destination schema name.
2. Enter the clientId that you found in Step 2.
3. Enter the teamId that you found in Step 2.
4. Enter the keyId that you found in Step 2.
5. Click Validate to save and test your credentials.
6. Choose the sync mode: Sync All Organizations or Sync Specific Organizations. If you choose Sync Specific Organizations, select which specific organizations you’d like to sync.
7. Select how many months of reporting data you’d like to include in your initial sync.
8. Click Save and Test. Fivetran will take it from here and sync data from your Apple Search Ads account.

Related Contentlink

description Connector Overview

account_tree Schema Information

assignment Release Notes

settings API Connector Configuration

home Documentation Home