Supermetrics brings all your TikTok Ads data into Google Sheets, Looker Studio, Excel, BigQuery, Snowflake, Redshift, Azure

TikTok Ads Updates

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

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