Cost Integration - Apple Search Ads

    Airbridge supports cost integration with Apple Search Ads. Only the Owner and In-house marketer users can set up the cost integration and access the cost data.

    To enable cost integration, the Campaign Management API integration must be completed. If you are unable to use Apple's Campaign Management API, refer to this article to learn about how to manually upload ad spend data to Airbridge.

    Note

    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.

    Cost Integration Setup

    1. Navigate to [Integration]>[Ad Channel Integration]>[Apple Search Ads], select the [Cost Integration] tab, and switch on the cost integration toggle.

    2. Click Add an account and log in to your Apple account. The account must be an admin account and have a recent history of campaign operation.

    Login error troubleshooting

    You may experience a login error when trying to log in to 2 different Apple accounts within a single browser. To avoid this error, clear the cache before logging in to a new Apple account.

    3. 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.

     

    Managing Cost Integration

    To disable the integration, switch off the cost integration toggle. No data will be pulled once the integration is disabled. Data already pulled into Airbridge is not affected.

    The account information remains saved to Airbridge unless you remove the ad account from the integrated account list. By switching back the toggle on, the cost integration is enabled again with existing account information.

    Select the ad account you wish to delete from the integrated ad account list and click Delete to delete it.

    If you want to reconnect the deleted ad account, you need to add the ad account and set up the connection from the beginning.

    Click Add a campaign group below the integration list and log in to a new Apple Search Ads account to connect new campaign groups to Airbridge. The Apple Search Ads accounts should run campaigns promoting the same app.

    Integration status

    You can view the current status of your connections in the status column. Even if you have completed the cost integration, the status will show "Waiting" until the cost data is actually imported to Airbridge.

    To ensure accuracy, Airbridge pulls the cost data several times throughout the day.

    • Frequency: Every 4 hours, 6 times a day starting 3:00 PM (UTC)

    • Schedule: 3:00 PM, 7:00 PM, 11:00 PM, 3:00 AM, 7:00 AM, 11:00 AM (UTC)

    • Data pulled: Cost data from the past 7 days, from D-0 to D-6

    The last data update time is found under “Last Updated” in the integrated account list.

    The integration status shows your cost integration and data update status at a glance.

    Reporting

    The cost data imported from Apple Search Ads via cost integration can be viewed in the Actuals Report and Trend Report at the campaign level or ad group level. The following metrics and GroupBys can be used for report configuration.

    Difference between Clicks and Clicks (Channel) metrics

    The Clicks and Clicks (Channel) metrics both indicate the number of ad clicks, but their data collection methods differ.

    • Clicks: Data collected through Airbridge tracking links

    • Clicks (Channel): Data provided by Integrated Channels

    All metrics with (Channel) in their names reflect the measurement reported by Integrated Channels. This rule applies to Impression and Impression (Channel) metrics as well.

    Note

    The Airbridge report supports the following GroupBys to visualize the data imported through cost integration. The GroupBys available for each channel vary.

    Touchpoint

    Device

    Event Datetime

    Attention

    Airbridge pulls the cost data from the past 7 days, every 4 hours, 6 times a day starting at 3:00 PM (UTC). As the updates are not real-time, there may be data discrepancies between Airbridge and the ad channel, depending on the time of reporting.

    The data pulled via cost integration is provided by the app time zone and app standard currency set within Airbridge.

    To minimize data discrepancy, align your app’s currency and time zone settings in your Airbridge dashboard and your ad channel’s dashboard.

    The Cost (Channel) metric, which shows your ad spend reported by the ad channel, displays value only when used with specific GroupBys.

    Below are the GroupBys that can be used in the Actuals Report to view data with the metric:

    • Channel

    • Campaign

    • Ad Group

    • Ad Creative

    Depending on the data reported, the metric may not display any value even if you use the GroupBys above.

    Once the cost integration is enabled, the following campaign details are advised not to be edited to avoid any error in pulling data into Airbridge.

    • Campaign name

    • Ad group

    • Ad creative name

    The campaign group name that appears in the Ad Account Name is unavailable if you have not saved the campaign group name in your Apple Search Ads account.

    The Search Match keywords are unavailable in Airbridge as Apple Search Ads does not provide data on them. For more details about Search Match, refer to this article on Apple Search Ads.