> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Channel Integration - Apple Ads

Airbridge supports integration with Apple Ads. With the integration, you can view the Apple Ads campaign performance in Airbridge.

<Info>
  **Attention**

  Apple Ads measures the campaign performance independently from SKAN.
</Info>

## Channel Integration

Your Apple Ads campaigns can be tracked by Airbridge when the Airbridge iOS SDK is installed on your app and the AdServices framework is enabled.

### Airbridge SDK installation

To integrate with Apple Ads, you need to install the Airbridge SDK in your app. The table below lists the minimum required version for the SDKs. Depending on the installation method for the Airbridge SDK, framework configuration may be required. For more details, refer to this [article](/en/developers/ios-sdk-v4#install-sdk).

| SDK               | Minimum Required Version |
| ----------------- | ------------------------ |
| iOS SDK           | 1.15.3                   |
| React Native SDK  | 1.3.1                    |
| Cordova-Ionic SDK | 1.3.2                    |
| Flutter SDK       | 1.3.0                    |
| Expo SDK          | 2.0.0                    |
| Unity SDK         | 1.3.0                    |
| Unreal SDK        | 1.0.0                    |

<Danger>
  **Attention**

  To manually install the [Airbridge iOS SDK](/en/developers/ios-sdk-v4#install-sdk), you need to additionally configure the Airbridge framework and dependency frameworks.
</Danger>

### Attribution rule settings

In the **\[Attribution Rules]** tab, you can view the attribution rules for Apple Ads. Click **Go to edit page** to move to the **\[Management]>\[Attribution Rules]** page, where you can edit the attribution rules. To learn about the detailed instructions on how to set the attribution rules, follow this [article](/en/guides/setting-attribution-window).

<AccordionGroup>
  <Accordion title="Default lookback window">
    The default click lookback window when using device matching is 7 days for all ad channels except Apple Ads, whose default is 30 days. The 30-day lookback window allows you to minimize attribution discrepancy by having Airbridge and Apple Ads share the same lookback window.
  </Accordion>

  <Accordion title="Pre-orders lookback window">
    The lookback window for the [pre-orders](https://developer.apple.com/app-store/pre-orders/) on Apple Ads is fixed to 90 days, regardless of your attribution settings on Airbridge.

    The lookback window for pre-orders can't be viewed or modified in the Airbridge dashboard. If you want to modify the lookback window for pre-orders, contact your Airbridge CSM.  If you don’t have a dedicated CSM, contact the [Airbridge Help Center](https://app.airbridge.io/supports).
  </Accordion>
</AccordionGroup>

## Campaign Management API Integration

Airbridge supports Apple Ads Campaign Management API integration. With the integration, you can view the campaign details, such as the campaign name, ad group name, keyword, and ad creative name in your Airbridge dashboard.

### Why the Campaign Management API integration is necessary

The AdServices framework returns only a limited amount of data because the AdServices REST API does not require any authentication. Through the integration with the Campaign Management API, which requires secured access, the names of the campaign, ad group, keyword, and ad creative can be fetched and made available in your Airbridge dashboard.

* Data available via the AdServices framework:

  * Country, campaign ID, ad group ID, keyword ID, ad creative ID
* Data unavailable via the AdServices framework:

  * Campaign name, ad group name, keyword, ad creative name

<Info>
  **Note**

  Apple’s Campaign Management API is available only to those using Apple Ads Advanced. If you are using Apple Ads Basic, you can't use the Campaign Management API.

  Without the Campaign Management API integration, Airbridge won't be able to fetch the campaign name, ad group name, keyword, and ad creative name. Moreover, cost integration cannot be enabled without the Campaign Management API integration.

  Check your [Apple Ads solution](https://searchads.apple.com/help/apple-search-ads-basic/0001-compare-apple-search-ads-solutions) before proceeding with the integration process.
</Info>

### Enabling the Campaign Management API integration

1. Navigate to **\[Integration]>\[Ad Channel Integration]** and click **Apple Ads**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/apple-search-ads-channel-card.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=905b68d41302f2a55dafefbc14f8bbd3" alt="03-en-AppleSearchAds" width="1400" height="800" data-path="asset/image/apple-search-ads-channel-card.png" />
</Frame>

2. Select the **\[Campaign API]** tab and switch on the **Campaign Management API** toggle.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/apple-search-ads-api-disabled.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=60f9a384e7794f16fe9060d7b2cd852e" alt="04-en-AppleSearchAds (1)" width="1400" height="800" data-path="asset/image/apple-search-ads-api-disabled.png" />
</Frame>

3. Click **Add a campaign group** and log in to your Apple account.

The Apple account must be on the Apple Ads Advanced solution and must have the Account Admin role<em>.</em> Integration is not possible when logging in to Apple accounts with Campaign Group Manager roles. The account must have a recent history of campaign operation.

After logging in, grant access permission to Airbridge by choosing "Account Read Only" to allow Airbridge access data from all campaign groups of the Apple account.

4. The integrated campaign groups will appear on the list when the integration is complete.

### Integration management

<AccordionGroup>
  <Accordion title="Disable Campaign Management API integration">
    <Info>
      **Note**

      Agency users can enable or disable the Campaign Management API integration when [granted permission](/en/guides/agency-setting) to do so. Read on and learn the steps to be followed depending on your user role.

      * Owner or In-house Marketer: Delete all campaign group information except for the campaign group information of the Agency to allow editing the Campaign Management API integration toggle whenever needed. Note that Agency users can only view and delete their own Agency's campaign group information.
      * Agency user: To disable the Campaign Management API integration, delete all campaign group information. After deleting all campaign group information, the Campaign Management API integration can disabled by switching off the toggle. If the toggle cannot be edited, contact the Owner or the In-house Marketer.

      For more information on the app access permission of Agency users, refer to this [article](/en/guides/agency-setting#%EC%A0%91%EA%B7%BC-%EA%B6%8C%ED%95%9C%EC%9D%B4-%ED%97%88%EC%9A%A9%EB%90%9C-%EB%8C%80%ED%96%89%EC%82%AC-%EC%82%AC%EC%9A%A9%EC%9E%90%EC%9D%98-%EA%B6%8C%ED%95%9C).
    </Info>

    Switch off the **Campaign Management API Integration** toggle to disable the integration.

    Once the integration is disabled, Airbridge will no longer pull data from the Campaign Management API. Data already pulled into Airbridge won't be affected.

    You can reconnect with the campaign groups by switching on the toggle again unless the connections to the campaign groups are deleted from the integration list.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/apple-search-ads-api-enabled.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=f8ac9fdf8956a3682538ced05db32176" alt="01-en-AppleSearchAds" width="1400" height="800" data-path="asset/image/apple-search-ads-api-enabled.png" />
    </Frame>
  </Accordion>

  <Accordion title="Delete connections">
    Click **\[…]** in the integration list and click **Delete** to delete a connection.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/apple-search-ads-api-delete-menu.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=5ac287d04c07f50cac25e5fde66acd88" alt="02-en-AppleSearchAds" width="1400" height="800" data-path="asset/image/apple-search-ads-api-delete-menu.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Attention

<AccordionGroup>
  <Accordion title="ATT and Apple Ads campaign data">
    When a user allows data tracking, Apple Ads sends touchpoint data with timestamps to Airbridge. However, if a user opts out of data tracking, the timestamp is not sent. Touchpoints without timestamp data have lower attribution priority than those with timestamp data. Therefore, the ATT opt-in rate can affect the attribution result of the Apple Ads campaigns in Airbridge.

    Refer to the table below for more details.

    | <span style={{ display: 'inline-block', minWidth: '60px' }}>**ATT status**</span> | <span style={{ display: 'inline-block', minWidth: '80px' }}>**Timestamp provided**<br />**by Apple Ads**</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>**Description**</span>                                                                      |
    | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Opt-in                                                                            | O                                                                                                               | The touchpoint is attributed by the [deterministic attribution method](/en/guides/identity-matching#deterministic-approach).                             |
    | Opt-out                                                                           | X                                                                                                               | The touchpoint is given a lower attribution priority than other touchpoints with timestamp data when attributed by the deterministic attribution method. |
  </Accordion>

  <Accordion title="Data discrepancy">
    Discrepancies in data may occur between Airbridge and Apple Ads due to varying reasons such as limited ad tracking features, differences in data processing speed, etc.

    To learn more about the causes of data discrepancy, refer to this [article](/en/guides/apple-search-ads-discrepancy).
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/apple-search-ads-channel-integration" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/apple-search-ads-channel-integration" />
