TikTok Ads Updates

Updates on the TikTok Ads data source, including new metrics, dimensions, and other features.

September 2024

2024-09-25

New fields added:

• Total page view content
• Total page view content value
• Cost per page view content

2024-09-19

New metric added:

• 15-second video views (focused view)

April 2024

2024-03-03

New dimension added:

• Post ID

November 2023

2023-11-01

New metric added:

• Clicks (all)

October 2023

2023-10-19

Support for Spark Ads has been enabled. To get Spark Ads creative data, reauthenticate the data source connection and accept the new scope.

New metrics added:

• 6-second video views (focused view)
• Cost per add to cart
• Cost per add to cart (in app)
• Cost per add to cart (onsite)
• Cost per add to cart (SKAN)
• Cost per complete payment (onsite)
• Cost per landing page view
• Duet clicks
• Landing page view rate
• Music clicks
• Stitch clicks
• Total add to cart value (onsite)
• Total complete payment value (onsite)
• Total landing page view

September 2023

2023-09-04

New field added:

• Campaign status

February 2023

2023-02-02

New field was added:

• Advertiser cellphone number

The following fields have been deprecated, please remove them from your reporting:

• Button clicks (app download)
• Button clicks (consultation)
• Button clicks (form)
• Consultation events
• Details page browse events (app download)
• Details page browse events (consultation)
• Details page browse events (form)
• Total button click (consultation) value
• Total button clicks (form) value
• Total consultation value
• Total details page browse (app download) value
• Total details page browse (consultation) value
• Total details page browse (form) value

November 2022

2022-11-15

New dimension added:

• Business center ID

Please note this dimension requires that all three of these conditions must be met for this dimension to work:

• The ad account is owned by the Business Center;
• The user has access to the Business Center;
• The user has Admin/Operator/Analyst permissions for the ad account.

October 2022

2022-10-25

New metrics added:

• Total subscribe

• Total subscribe value

• Cost per subscribe

• Subscribe rate (%)

• Value per subscribe

2022-10-03

New metrics added to support onsite conversion:

• Complete payment ROAS (onsite)

• Complete payment (onsite)

• Initiate checkout (onsite)

• Product details page view (onsite)

• Add to wishlist (onsite)

• Add billing (onsite)

• Add to cart (onsite)

• Form submission (onsite)

• App store click (onsite)

• Total page views (onsite)

• Call-to-action button clicks (onsite)

• Total product clicks (onsite)

Feb. 2022

2022-02-04

New dimensions have been added:

• TikTok app ID
• TikTok app name
• Mobile app name

2022-02-15

New metrics have been added:

• Avg watch time per video view
• Avg watch time per person

Nov. 2021

2021-11-11

New metrics have been added:

• Cost (cash)
• Cost (voucher)

July 2021

2021-07-02 -

New budget dimensions:

• Ad group budget
• Ad group budget mode

April 2021

2021-04-20:

Updated data source to API v1.2.

New fields were added:

• Profile visits
• Paid likes
• Paid comments
• Paid shares
• Paid follows
• Unique generate lead
• Total generate lead
• Total generate lead value
• Unique rate
• Total rate
• Total rate value

March 2021

2021-03-30 - 

Cost currency conversion fields added:

• Cost (EUR)
• Cost (USD)
• Cost (GBP)

SKANetwork fields have been added:

• Results (SKAN)
• Result rate (SKAN)
• Cost per result (SKAN)
• Conversions (SKAN)
• Conversion rate (SKAN)
• Cost per conversion (SKAN)
• App Installs (SKAN)
• Unique registrations (SKAN)
• Registration events (SKAN)
• Unique purchases (SKAN)
• Purchase events (SKAN)
• Total purchase value (SKAN)
• Unique adds to cart (SKAN)
• Add to cart events (SKAN)
• Total add to cart value (SKAN)
• Unique checkouts (SKAN)
• Checkout events (SKAN)
• Total checkout value (SKAN)
• Unique view content (SKAN)
• View content events (SKAN)
• Total view content value (SKAN)
• Unique add payment info (SKAN)
• Add payment info events (SKAN)
• Unique add to wishlist (SKAN)
• Add to wishlist events (SKAN)
• Total add to wishlist value (SKAN)
• Unique launch app (SKAN)
• Launch app events (SKAN)
• Unique complete tutorial (SKAN)
• Complete tutorial events (SKAN)
• Total complete tutorial value (SKAN)
• Unique create group (SKAN)
• Create group events (SKAN)
• Total create group value (SKAN)
• Unique join group (SKAN)
• Join group events (SKAN)
• Total join group value (SKAN)
• Unique create role (SKAN)
• Create role events (SKAN)
• Total create role value (SKAN)
• Unique spend credit (SKAN)
• Spend credit events (SKAN)
• Total spend credit value (SKAN)
• Unique achieve level (SKAN)
• Achieve level events (SKAN)
• Total achieve level value (SKAN)
• Unique unlock achievement (SKAN)
• Unlock achievement events (SKAN)
• Total unlock achievement value (SKAN)
• Unique generate lead (SKAN)
• Total generate lead events (SKAN)
• Total generate lead value (SKAN)
• Unique in app ad click (SKAN)
• In app ad click events (SKAN)
• Total an app ad click value (SKAN)
• Unique in app ad impressions (SKAN)
• In app ad impressions events (SKAN)
• Total in app ad impressions value (SKAN)
• Unique loan apply (SKAN)
• Loan apply event (SKAN)
• Unique loan approval (SKAN)
• Loan approval events (SKAN)
• Unique loan disbursement (SKAN)
• Loan disbursement events (SKAN)
• Unique logins (SKAN)
• Login events (SKAN)
• Unique ratings (SKAN)
• Rate events (SKAN)
• Total rate value (SKAN)
• Unique search (SKAN)
• Search events (SKAN)
• Unique start trial (SKAN)
• Start trial events (SKAN)
• Unique subscribe (SKAN)
• Subscribe events (SKAN)
• Total subscribe value (SKAN)

Feb. 2021

2021-02-11 -

New account dimensions added:

• Advertiser name
• Advertiser ID
• Advertiser contact email
• Advertiser contact phone number
• Advertiser balance
• Advertiser address
• Advertiser country
• Advertiser license number
• Advertiser status
• Company
• Currency
• Time zone