Channel Integration - Apple Search Ads

Jusang SongWritten by Jusang Song,

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

Attention

Apple Search Ads measures the campaign performance independently from SKAN.

Channel Integration

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

Airbridge iOS SDK installation

To track your Apple Search Ads campaign performance, the Airbridge iOS SDK version 1.15.3 or later must be installed on your app.

If the Airbridge iOS SDK has been installed via CocoaPods or Swift Package Manager, the AdServices framework, which is Apple’s framework for tracking attribution data, will be automatically enabled.

If the Airbridge iOS SDK has been installed directly, add the Airbridge framework and the dependency frameworks to your Xcode project by referring to this article in the developer’s guide.

Campaign Management API Integration

Airbridge supports Apple Search 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

Attention

Apple’s Campaign Management API is available only to those using Apple Search Ads Advanced. If you are using Apple Search 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 Search Ads solution before proceeding with the integration process.

Enabling the Campaign Management API integration

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

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

3. Click Log in to Apple and log in to your Apple account that is using the Apple Search Ads Advanced solution and is the admin account. The account must have a recent history of campaign operation.

After logging in, grant access permission to Airbridge by choosing from the two options:

  • Account Read Only: You allow Airbridge to access the data from all campaign groups.

  • Limited Access: You allow Airbridge to access the data only from selected campaign groups.

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

Integration management

Attention

Was this page helpful?

Have any questions or suggestions?