Import cost data from TikTok Ads

You can import cost data from TikTok Ads to populate “Ads cost”, “Ads clicks”, and “Ads impressions” metrics for your paid TikTok traffic.

Important: TikTok Cost Data Import data sources created using this guide will attempt to pull at least 24 months of historical TikTok Ads data into your Analytics property. Using this feature alongside previously uploaded manual cost import datasets can lead to duplicated data and inaccurate reports, as Analytics does not attempt to de-duplicate information between these 2 methods. If you have existing TikTok cost data that would overlap, delete those prior datasets before proceeding with this feature.

TikTok Cost Data Import data sources created using this guide will attempt to pull at least 24 months of historical TikTok Ads data into your Analytics property. If the API doesn’t support 24 months of historical data, the maximum available timeframe will be pulled.

Before you begin

You need to have at least the Analyst role for TikTok Ads and at least Editor role in the Google Analytics property.
Make sure the following UTM parameters are included in the destination URLs for your ads in TikTok:
- utm_source (required)
- utm_medium (required)
- utm_campaign (optional, but highly recommended)
- utm_id (optional, but highly recommended)

Note: All of your paid TikTok traffic should be tagged with a single unique value for utm_source and a single unique value for utm_medium. When creating a TikTok Cost Data Import configuration through this flow, the values entered for "Campaign Source" and "Campaign Medium" must exactly match these utm_source and utm_medium values. For example, if all of your TikTok paid traffic is tagged with utm_source=tiktok and utm_medium=paid, then you would enter "tiktok" in the "Campaign source" field and "paid" in the "Campaign medium" field.

How to import cost data from TikTok Ads

Step 1 of 4: Create a new data source

In Admin, under “Data collection and modification”, click Data import.

Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be an Editor or above at the property level to successfully start the import process.
Click Create data source.
Enter a name for your data source.
Select Cost data as the data type.
Under “Upload data for import”, select TikTok as the import source.
Click Next.

Step 2 of 4: Set up connection

In the “Set up connection” screen, click Connect to link TikTok as your data source.
Sign in to TikTok Ads by entering your TikTok user credentials in the pop-up window.
Click Log in.

Step 3 of 4: Configure the data

Select the TikTok “Business” and “Ad account” which manages the TikTok advertising data that you intend to pull into your Analytics property.
Provide “Campaign source” and “Campaign medium” values corresponding to the utm_source and utm_medium parameter values included in the destination URLs of your TikTok ads. Learn more about locating parameters in TikTok Ads.
Note: Values added for "Campaign source" and "Campaign medium" must align with the utm_source and utm_medium parameter values that you specified on your destination URLs for TikTok Ads campaigns.
Click Next. Fields will be automatically mapped for you in the next step.

Step 4 of 4: Review your connection and import

Review all of the fields to make sure that the fields that you want to import are included. You can modify your data source name, import schedule, and any filters that you applied.
Click Finish.
You’ll get confirmation that your data source has been created.
Click Done.

Imports can take up to 30 minutes to complete and up to 24 hours for the data to be available in reports.

How to locate parameters in TikTok Ads

Log in to your TikTok Ads account.
For each ad, check whether utm_source, utm_medium, utm_campaign, and utm_id are specified in the destination URL.

You’ll need these parameters to import cost data from your TikTok Ads account.

Was this helpful?

How can we improve it?