> ## 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.
# Cost Integration - Apple Ads
Airbridge supports cost integration with Apple 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](/en/guides/apple-search-ads-channel-integration#enabling-the-campaign-management-api-integration) must be completed. If you are unable to use Apple's Campaign Management API, refer to this [article](/en/guides/data-upload-ad-spend) 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 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.
## Cost Integration Setup
1. Navigate to **\[Integration]>\[Ad Channel Integration]>\[Apple 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](https://support.google.com/accounts/answer/32050?hl=en\&co=GENIE.Platform%3DDesktop\&sjid=15323096860549662518-AP) 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
Turn off the toggle to pause the integration. Airbridge stops collecting cost data once the integration is paused.
Any data collected before the pause remains available in Airbridge reports.
Airbridge retains the credentials of the integrated account, so you can resume the integration at any time by turning the toggle on. However, deleting the integrated account removes these credentials.
Select the account from the integrated account list and click **Delete** to remove the account. To re-integrate the account after deletion, set up the integration from the beginning.
Click **Add a campaign group** below the integration list and log in to a new Apple Ads account to connect new campaign groups to Airbridge. The Apple 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.
* Frequency: Every 4 hours, 6 times a day, starting at 3:00 PM UTC
* Import times: 3:00 PM, 7:00 PM, 11:00 PM, 3:00 AM, 7:00 AM, 11:00 AM UTC
* Data range: Current day (D-0) to 6 days ago (D-6)
**\[Last Updated]** shows the last time Airbridge actually received the data.
| Status | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Waiting | Integration set up successfully. Pending data import. This may take up to 4 hours. |
| Success | Import complete. New data received from the ad channel. The **\[Last Updated]** timestamp reflects the latest import. |
| No new data | Import complete, but no new data was available from the ad channel. Check again at the next import. |
| Failed | Import failed. Possible causes: - The ad channel API is not responding. - The ad account details are incorrect. - The ad channel permissions are not configured correctly. |
## Reporting
The cost data imported from Apple 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.
| Metrics | Description |
| --------------------- | ---------------------------------------------------- |
| Clicks (Channel) | The number of clicks provided by the ad channel |
| Impressions (Channel) | The number of impressions provided by the ad channel |
| Cost (Channel) | The ad spend provided by the ad channel |
**Difference between Clicks and Clicks (Channel)**
Both **Clicks** and **Clicks (Channel)** show click count, but the data source differs:
* **Clicks**: Collected through Airbridge tracking links
* **Clicks (Channel)**: Provided by the ad channel
Any metric with **(Channel)** in its name represents data provided by the integrated ad channel. The same applies to **Impressions** and **Impressions (Channel)**.
**Note**
Use the groupBys below to break down cost data in Airbridge reports. Available groupBys vary by ad channel.
###### Touchpoint
| GroupBy | Description |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| Channel | The media source of the winning touchpoint |
| Campaign | The name of the campaign of the winning touchpoint |
| Ad Group | The name of the ad group of the winning touchpoint |
| Ad Creative | The name of the ad creative of the winning touchpoint |
| Term | The term, or the search keyword, of the winning touchpoint (Only available for search ads or keyword ads) |
| Campaign ID | The unique ID assigned to the campaign of the winning touchpoint |
| Ad Group ID | The unique ID assigned to the ad group of the winning touchpoint |
| Term ID | The unique ID assigned to the term, or the search keyword, of the winning touchpoint |
| Ad Account ID | The unique ID assigned to the ad account of the winning touchpoint |
| Sub Publisher | The second-tier media source of the winning touchpoint |
###### Device
| GroupBy | Description |
| ------- | --------------------------------------------------- |
| Country | The country code for the mobile device |
| OS Name | The operating system installed on the mobile device |
###### Event Datetime
| GroupBy | Description |
| ---------------------- | -------------------------------------------------------------------- |
| Event Hour | The hour the event occurred in a 24-hour format |
| Event Date | The day the event occurred (YYYY-MM-DD) |
| Event Year | The year the event occurred (YYYY) |
| Event Month | The month the event occurred (MM) |
| Event Week | The week the event occurred (WW) |
| Event Day of the month | The day of the month the event occurred (DD) |
| Event Day of the week | The day of the week the event occurred in three-letter abbreviations |
## 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.
* [App Time Zone Setup](/en/guides/set-app-timezone)
* [App Standard Currency Setup](/en/guides/set-app-standard-currency)
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
* If you do not enter a campaign group name in Apple Ads, the **\[Campaign Group (Campaign Group ID)]** column will be blank.
* Keywords, or search terms, from Search Match are not provided as Apple Ads does not share them. This applies to Maximize Conversions search results campaigns as well, since they use Search Match by default and Term IDs are not shared. See the [Apple Ads documentation](https://ads.apple.com/app-store/help/campaigns/0006-understand-search-match) for more details.