# Apple Search Ads

Apple Search Ads is Apple's advertising platform for promoting apps on the App Store. Connect it to Coupler.io to automatically export your campaign performance, keyword data, demographic insights, and more to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT.

## Why connect Apple Search Ads to Coupler.io?

* **Automated reporting** — Schedule daily, weekly, or monthly exports without manual work
* **Flexible report types** — Pull campaign, ad group, keyword, and search term performance data
* **Demographic insights** — Break down performance by age, gender, location, and device
* **Multi-account support** — Combine data from multiple Apple Search Ads accounts in one data flow
* **AI-powered analysis** — Send reports to Claude or ChatGPT for instant insights

## Prerequisites

* Active Apple Search Ads account with at least one ad account
* **API Account Manager** role (or equivalent) assigned to your Apple Search Ads user — account admin permissions alone are not enough
* Access to Apple Search Ads settings to verify API access

{% hint style="warning" %}
Do NOT use your main admin account if it doesn't have the API Account Manager role. Create a dedicated user with the correct API permissions, or ask your Apple Search Ads account owner to assign the role to your current account.
{% endhint %}

## Quick start

{% hint style="success" %}
Start by selecting your ad account and report type (e.g., Campaign performance), then set your date range. A single data flow can pull multiple report types — just set up each one and run them together.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Log in to Coupler.io** and create a new data flow. Choose **Apple Search Ads** as your source.
{% endstep %}

{% step %}
**Sign in with Apple Search Ads.** Click the OAuth button and you'll be redirected to Apple's login page. Sign in with your Apple Search Ads account (the one with API Account Manager role) and authorize Coupler.io to access your data.
{% endstep %}

{% step %}
**Select your ad account(s).** Choose which Apple Search Ads account(s) you want to pull data from. You can select multiple accounts to combine them in one data flow.
{% endstep %}

{% step %}
**Choose a report type.** Pick from Campaign performance, Ad group performance, Ad performance, Keyword performance, Search term performance, or demographic/geographic insights reports.
{% endstep %}

{% step %}
**Set your date range.** Use the date picker to select your start and end dates. You can also use macros (like `{{30daysago}}`) to make the range dynamic.
{% endstep %}

{% step %}
**Choose how to split data.** Select Daily, Weekly, Monthly, or Totals only to control how your metrics are aggregated in the report.
{% endstep %}

{% step %}
**Select dimensions (if applicable).** For demographic and geographic reports, choose dimensions like Age, Gender, Country, or Device class. You can combine dimensions (e.g., Country and Device class together).
{% endstep %}

{% step %}
**Pick your destination.** Choose where to send the data: Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like Claude or ChatGPT.
{% endstep %}

{% step %}
**Run the data flow.** Click **Run** to execute the data flow manually. Once it completes successfully, you can schedule it for recurring exports.
{% endstep %}
{% endstepper %}

## Available report types

| Report Type                       | Best for                           | Includes                                                                            |
| --------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------- |
| Campaign performance              | High-level campaign metrics        | Impressions, taps, conversions, spend, ROI                                          |
| Ad group performance              | Ad group-level analysis            | Performance broken down by ad group                                                 |
| Ad performance                    | Individual ad creative analysis    | Creative-level metrics and performance                                              |
| Keyword performance               | Keyword bid and performance data   | Keyword metrics, CPC, conversion rate                                               |
| Search term performance           | Understanding user search behavior | Actual search terms users typed                                                     |
| Campaign/Ad group demo & geo      | Audience insights                  | Demographics (age, gender), geography (country, locality, admin area), device class |
| Ad/Keyword performance by country | Geographic campaign analysis       | Performance data split by country                                                   |