Cost Integration - TikTok For Business

NoteSelect “Sub-Publisher” as GroupBy or filter to view the performance of Pangle ads in the Airbridge reports.

Airbridge supports cost integration with TikTok For Business. Airbridge users with Owner or In-house Marketer roles or users who have been granted authorized Agency roles from the [Agency Settings] page can view the cost and touchpoint data of TikTok campaigns in the Airbridge dashboard. Follow the steps below to enable cost integration.

Cost Integration Setup

Navigate to [Integrations]>[Ad Channel Integration] and select TikTok For Business.
In the [Cost Integration] tab, switch on the [TikTok For Business Cost Integration] toggle and click Add an account.
Log in to your TikTok For Business account in the pop-up window.
Decide the level of access you want to give Airbridge and click Confirm. If you want to track the cost and touchpoint data of your TikTok campaigns in Airbridge, check all 4 items.

Select the TikTok For Business ad account you want to integrate with Airbridge and click Complete.
Now, the TikTok For Business ad account you selected will be listed on the cost integration page in Airbridge. The status will show “Waiting” until the next data import, which could take up to 4 hours. If your TikTok For Business ad account is verified within the next 4 hours, the cost data will be pulled into Airbridge, and the status will change to “Active.”

Managing Cost Integration

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

Delete integrated account

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.

Integration status

Upon submitting your ad account information to Airbridge, you can check if the integration is running. The status may show “Waiting” even when the account is successfully added if no data has been pulled yet.

For more details on the data import schedule and integration status, refer to the below information.

Cost data import schedule

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.

Cost integration status

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 campaign-level or ad group-level data pulled from TikTok For Business via cost integration can be viewed in the Actuals Report and Trend Report using the metrics and GroupBys below.

Metrics for cost data

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

GroupBys for cost data

NoteUse 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

If the connected ad account has active campaigns running for multiple apps, the cost data is integrated with Airbridge by individual apps.

Unspecified ad account nameAirbridge receives a null value for the Ad Account ID if a user has not specified the ad account name in the TikTok For Business dashboard. Selecting Ad Account ID as GroupBy in the Actuals Report or the Trend Report may show an empty column.

Attention

App time zone and currency settings

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.

GroupBys for the Cost (Channel) metric

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.

Campaign details advised not to be edited

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

Data of campaigns recently deleted

The cost and touchpoint data of campaigns recently deleted from the TikTok Ads Manager are included in the data Airbridge pulls from TikTok For Business via cost integration.Let’s say you deleted a campaign from the TikTok Ads Manager at 9:00 AM on Jan 1 (UTC). The cost and touchpoint data of the deleted campaign will still be pulled into Airbridge at 11:00 AM on Jan 1 (UTC) because Airbridge pulls data from the past 7 days.The TikTok Ads Manager does not offer any labeling system to allow Airbridge to distinguish deleted campaigns from active ones. Therefore, if you want to view the same data on your Airbridge dashboard and your TikTok Ads Manager dashboard, make sure you enable your TikTok Ads Manager to display the data of deleted campaigns as well.

​Cost Integration Setup

​Managing Cost Integration

​Integration status

​Reporting

Touchpoint

Device

Event Datetime

​Attention

Cost Integration Setup

Managing Cost Integration

Integration status

Reporting

Attention