Apple Search Ads

This guide explains how to set up the Apple Search Ads integration in the Magify analytics system.

The integration enables automated import of user acquisition data, including spend, impressions, taps, installs, campaigns, and search terms, directly from Apple Search Ads into Magify.

Creating an Apple Search Ads Grabber

To create an Apple Search Ads grabber:

1. In the Magify interface, go to Configurations > Integrations > UA Grabbers.
2. Find Apple Search Ads in the list of available integrations.
3. Click Connect.

An Apple Search Ads UA Grabber will be created, and the integration card will open.

Getting Started

The Apple Search Ads card is used to connect Magify to your Apple Search Ads account using OAuth authentication.

All required configuration parameters are described below.

Apple Search Ads Account Setup (OAuth)

Apple Search Ads API uses OAuth 2.0 with JWT-based authentication.

The complete OAuth setup process is described in the official Apple documentation: Implementing OAuth for the Apple Search Ads

Follow the official instructions to generate all required credentials.

Step 1. Create an API Key

1. Log in to your Apple Search Ads account.
2. Go to Account Settings.
3. Create a new API key.
4. Download the generated Private Key (.pem file).
5. Upload the Private Key in Account Settings.

During this process, Apple provides:

• Key ID
• Team ID

Step 2. Generate OAuth Credentials

According to the official Apple documentation, also generate:

• Client ID
• Client Secret
• Public Key

These values are used by Magify to generate the access token and authenticate API requests.

General Settings

Name

A descriptive name for the grabber configuration.

Organization

Select the organization associated with this integration.

Client ID

The Apple Search Ads client identifier.

Obtained from Account Settings.

Team ID

Your Apple Developer Team identifier.

Key ID

The identifier of the Apple Search Ads API key.

Private Key

The .pem private key generated in Apple Search Ads.

Public Key

The public key generated during OAuth setup.

Client Secret

OAuth client secret used for API authorization.

Client Secret Expires On

The expiration date and time of the Client Secret.

This value is defined by Apple and indicates how long the Client Secret remains valid.

After the expiration date, a new Client Secret must be generated in Apple Search Ads and updated in the grabber settings.

This field is informational and is not calculated automatically.

Automatically Populated Fields

The following fields are populated automatically after saving the configuration and the first successful grabber run.

Access Token

Generated automatically based on:

• Client ID
• Key ID
• Team ID
• Private Key

Expires On

The expiration date and time of the Access Token.

Org IDs

A list of Organization IDs available in your Apple Search Ads account.

Additional Apple Search Ads Grabbers

Additional grabbers are configured within the Apple Search Ads card and reuse the existing authorization.

Apple Search Ads Campaign Grabber

Used to load data at the campaign level.

Is Enabled

Enable this option to start data collection immediately.

Apple Search Ads Search Terms Grabber

Used to load search terms–level data.

Is Enabled

Enable this option to start data collection immediately.

Saving the Configuration

Once all required fields are filled in, click Save to complete the setup.

The enabled grabber will then begin collecting data from Apple Search Ads according to the configured schedule.

By default, each grabber is set to load data for one day upon creation.

If you need to collect data for a longer period (for example, during initial setup or data recovery), please contact us. We can manually adjust this value for you.