Updates on the TikTok Ads data source, including new metrics, dimensions, and other features.
October 2025
We have now added all offline conversion metrics:
CRM events
Cost per CRM event
CRM event rate
Value per CRM event
CRM event value
Purchases (offline)
Cost per purchase (offline)
Unique purchase rate (offline)
Value per purchase (offline)
Purchase value (offline)
Purchase ROAS (offline)
Contacts (offline)
Cost per contact (offline)
Unique contact rate (offline)
Value per contact (offline)
Contact value (offline)
Subscriptions (offline)
Cost per subscription (offline)
Unique subscription rate (offline)
Value per subscription (offline)
Subscription value (offline)
Form submissions (offline)
Cost per form submitted (offline)
Unique form submission rate (offline)
Value per form submitted (offline)
Form submission value (offline)
Payment info adds (offline)
Cost per payment info add (offline)
Unique payment info add rate (offline)
Value per payment info add (offline)
Payment info add value (offline)
Adds to cart (offline)
Cost per add to cart (offline)
Unique add to cart rate (offline)
Value per add to cart (offline)
Add to cart value (offline)
Adds to wishlist (offline)
Cost per add to wishlist (offline)
Unique add to wishlist rate (offline)
Value per add to wishlist (offline)
Add to wishlist value (offline)
Button clicks (offline)
Cost per button click (offline)
Unique button click rate (offline)
Value per button click (offline)
Button click value (offline)
Registrations (offline)
Cost per registration (offline)
Unique registration rate (offline)
Value per registration (offline)
Registration value (offline)
Downloads (offline)
Cost per download (offline)
Unique download rate (offline)
Value per download (offline)
Download value (offline)
Checkouts initiated (offline)
Cost per checkout initiated (offline)
Unique checkout initiation rate (offline)
Value per checkout initiated (offline)
Checkout initiation value (offline)
Orders placed (offline)
Cost per order placed (offline)
Unique orders placed rate (offline)
Value per order placed (offline)
Orders placed value (offline)
Searches (offline)
Cost per search (offline)
Unique search rate (offline)
Value per search (offline)
Search value (offline)
Content views (offline)
Cost per content view (offline)
Unique content view rate (offline)
Value per content view (offline)
Content view value (offline)
Preferred leads (offline)
Cost per preferred leads (offline)
Preferred leads rate (offline)
Total find location (offline)
Cost per find location (offline)
Find location rate (offline)
Value per find location (offline)
Total find location value (offline)
Total schedule (offline)
Cost per schedule (offline)
Schedule rate (offline)
Value per schedule (offline)
Total schedule value (offline)
Total customize product (offline)
Cost per customize product (offline)
Customize product rate (offline)
Value per customize product (offline)
Total customize product value (offline)
Custom events (offline)
Cost per custom event (offline)
Custom event rate (offline)
Value per custom event (offline)
Custom event value (offline)
August 2025
2025-08-29
Support for GMV Max Ads has been added.
At least one of the following GMV Max Ads fields must be included in the query for the GMV Max report type to be used and GMV Max Ads data returned:
gmv_max_ads_spend
gmv_max_ads_billed_cost
roi_protection_compensation_status
March 2025
2025-03-19
The following dimensions have been added:
Business center name
Business center company name
Business center currency
Business center timezone
Business center registration country code
Business center name country
Business center type
Business center status
2025-03-14
New dimension added:
Post URL
December 2024
2024-12-13
New dimensions added:
Ad identity type
Creative format
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