Open navigation

TikTok Ads: Query setup guide

This guide covers the basic functionality of the Supermetrics TikTok Ads connector, and gives examples of how to set up a query for Google Sheets, Data Studio, and Excel. 

Before you begin

To connect Supermetrics to TikTok, you need:

Available fields

Visit our documentation site for a full list of the metrics and dimensions Supermetrics can pull from the data source. 

  • Field label is the name that appears in the sidebar. 
  • Metrics can be found under type - “met”.
  • Dimensions can be found under type - “dim” .

Main features

  • Fetches all the main advertising metrics: impressions, clicks, CTR, cost, CPC, CPM, reach, conversions, conversion rates, CPA, and more.
  • Splits the data by campaign, ad group, ad, or by time. It also supports hourly granularity.
  • Inspects results by targeting demographics: location, language, age, gender, device, interest, and more.
  • Fetches detailed conversion data for all the different in-app events or page events.


Google Sheets Data Studio Excel Data Integrations
  1. Authenticate the data source in Google Sheets. 
  2. Select Dates. Choose one date range (today, yesterday, last week, etc.). To select a custom date, you can insert the date manually in the Start and End fields in the calendar bar.
  3. Select Metrics
  4. Select Split by Dimensions. You can choose to split your data into rows and/or columns, reflect the number of rows or columns to be fetched, and define how the data is sorted.
  5. Click Get Data to Table to create your query and pull your data.

Advanced options for Google Sheets

  1. You can filter your data by selecting the field, operator, and value to filter by. Learn more about filters.
  2. Under Options, you can add additional features to your query.
  • Replace blank metric values with zeros.
  • Combine new results with old.
  • Format results for Data Studio (to import data from Google Sheets to Data Studio).
  • No header row.
  • Highlight values with colours (green, red, etc.).
  • Advanced settings.


  • We support only campaigns that use auction as buying type. Reservation ads are not supported at the moment.
  • If you see an error about metrics and dimensions not fetching together, or fields being incompatible, follow these steps to fix the issue.
  • If you see errors relating to quotas, or “daily query quotas”, read this guide.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.