TikTok Ads Data Connector User Guide

TikTok Ads Data Connector User Guide

Info
TikTok Ads is a powerful advertising platform that allows marketers to reach TikTok's massive global audience. This guide will walk you through how to connect TikTok Ads to Power My Analytics, create reports, and understand key metrics and considerations for analyzing your TikTok ad performance.



Prerequisites

Before you begin, make sure you have:
  1. Admin access to the TikTok account

Grant Admin Access to a User in TikTok

To grant Admin access to a user:
  1. Go to TikTok Business Center and click on the Users tab.
  2. Open the Members section and click Invite member.
  3. Under Access Settings, select Admin.

Adding TikTok Ads as a Data Source

  1. Navigate to your Hub and select Sources from the menu.
  2. Click + Add new source and choose TikTok Ads from the gallery.
  3. Sign in to your TikTok account to authenticate.

Creating a Data Studio Report

Follow these steps to create a Data Studio report using your TikTok Ads data:
  1. After adding TikTok Ads as a data source in the PMA hub, navigate to Reports > Data Studio
  2. Select TikTok Ads under Create Data Studio Report (this will open the official Data Studio application in a new window)
  3. Google Data Studio Configuration:
    1. Step 1:
      1. Name your data source (e.g. "TikTok Ads - Organization Name")
      2. Choose your Power My Analytics hub from dropdown
      3. Optional: Leave "Use report template for new reports" checked to use the PMA demo template
      4. Click Next
    2. Step 2:
      1. User Account: Select TikTok Ads account (real data) or "Sample Account" (sample data)
      2. Click Next
    3. Step 3: 
      1. Choose "Advertisers" for reports
      2. Optional: Allow "Advertisers" modification in reports
      3. Click Connect (top right) to complete the data source configuration
    4. Step 4: 
      1. Click Create Report (top right)
For a quick start, use our pre-built TikTok Ads demo template.

Key Reports and Fields

TikTok Ads data in Power My Analytics offers a wide range of metrics and dimensions. Here are some popular metrics you can use in your reports:
  • Key Performance Indicators: Account balance, active campaigns/groups/ads, cost, CPC, CPA, impressions, CTR, clicks, conversions, CPM
  • Campaigns: Name, status, budget, cost metrics, performance metrics
  • Ad Groups: Name, status, budget, bid, dates, cost metrics, performance metrics
  • Ads: Image, ad name, cost metrics, performance metrics
  • Demographics: Clicks by age group and gender
  • Placement: Ad placement locations
  • Offline Conversions: Offline Shopping Events, Offline Shopping Events Value, and Contacts (offline), plus Purchase ROAS (offline) and Value per purchase (offline). These come from TikTok's server-side Events API (including offline events you send through a CAPI partner such as Attain).
For a complete list of available TikTok Ads fields, refer to the Schema Explorer.

Limitations and Important Considerations

  1. Cached Data Requests with Unique Metrics and Date Dimension: When a unique metric is paired with the date dimension, this will result in a request for cached data instead of a request for live data. For more information, please see Understanding Cached and Live Data Requests.
  2. Backfilling: 24 months of historical data will be backfilled when you first connect your TikTok Ads account as a data source.
  3. Organic Data: Only ads data is available. For organic data, use our TikTok Organic data connector.
  4. Default time zone: UTC
  5. Images and image IDs: An image will only be returned for ads that are images. Non-image ad types will not return an image or image ID.
  6. Events API is now the primary conversion tracking method: TikTok now recommends its server-side Events API for conversion tracking. If you rely on the TikTok Pixel alone, browser privacy restrictions can lower your conversion match rates and weaken optimization signals. Because Power My Analytics reports the conversion data TikTok measures, lower match rates can cause metrics such as conversions, CPA, and ROAS to under-represent your true results. To keep your conversion reporting accurate, we recommend migrating to (or adding) the TikTok Events API. Offline conversions you send through the Events API (including via a CAPI partner such as Attain) are now available in your reports as offline shopping event metrics (see the Offline Conversions metrics in Key Reports and Fields).
NotesGood to know: Offline conversion metrics only populate for accounts that send offline events to TikTok (through the Events API, an offline event set, or a CAPI partner such as Attain). If your account does not send offline events, these fields will return zero. After enabling or reconnecting an offline source, re-pull a TikTok report so the new metrics flow through.

Recent TikTok Platform Changes (2026)

TikTok has made several platform-level changes that affect how campaigns are created and how conversions are tracked. These changes take place on TikTok's side (in TikTok Ads Manager or the TikTok Marketing API), so Power My Analytics keeps collecting and reporting your TikTok Ads data as usual. We are flagging them here so your reporting and campaign setup stay accurate.

  • Events API is now the primary conversion tracking method. TikTok now recommends its server-side Events API for conversion tracking. If you rely on the TikTok Pixel alone, browser privacy restrictions can lower your conversion match rates and weaken optimization signals. Because Power My Analytics reports the conversion data TikTok measures, lower match rates can cause metrics such as conversions, CPA, and ROAS to under-represent your true results.
  • Custom Identity is being phased out for new campaigns. As of early 2026, new TikTok campaigns must launch from a verified TikTok profile, and Custom Identity is no longer supported for new campaign creation. You set this up in TikTok Ads Manager, not in Power My Analytics, so your PMA reporting is not affected.
  • The legacy Smart+ Campaign Creation API has been deprecated (March 31, 2026). Smart+ campaigns must now be created and managed through TikTok's Upgraded Smart+ API. This mainly affects customers who create or manage Smart+ campaigns programmatically; your Power My Analytics reporting on Smart+ campaign data is not affected.
Alert
If you currently track TikTok conversions with the TikTok Pixel only, we recommend migrating to (or adding) the TikTok Events API so your conversion reporting in Power My Analytics stays accurate.

Unavailable Data

  • Deleted campaigns: Deleted campaigns may appear in TikTok’s UI but are unavailable through the API
  • Paid Likes
  • Comments
  • Shares
  • Organic data
  • Spark Ads images: Spark Ads images are not available through the TikTok API
  • Custom events are not currently supported by the API
  • Custom fields

Adjust Time Zone

TikTok Ads' API defaults to UTC. Use the time zone selector in your Hub to adjust the time zone for your main account to your local time.  Sub-accounts cannot be adjusted individually.
Notes
Data gathered before the time zone adjustment will remain fixed in the previous time zone setting.

Cost Per Follow

Cost Per Follow is not an included field in TikTok's API, but it is easy to create a calculated field to see this information.

Data Studio

  1. Open the Resource menu and go to Manage added data sources.



  2. Click on the icon to open the TikTok Ads data source.



  3. Click Add a field and choose Add calculated field.





  4. Give the new field a name like Cost Per Follow. Use the formula SUM(Total Cost)/SUM(Follows).
  5. Click Save.



  6. Go back to your dashboard and add a Scorecard.
  7. Choose Cost Per Follow as a field and set it to use your country's currency.

Google Sheets or Microsoft Excel

  1. Select Total Cost and Follows for your metrics.



  2. Select the cell in which you wish to display Cost Per Follow.
  3. Create a formula with the cell designation for Total Cost divided by the cell designation for Follows.

Troubleshooting

See our article Basic Troubleshooting for instructions on issues that may affect the TikTok Ads connector.

    • Related Articles

    • How to Connect to TikTok Ads

      Looking to bring your TikTok Ads data into a single, automated reporting workflow? This guide will walk you through connecting TikTok Ads as a data source in Power My Analytics, so you can centralize your TikTok ad performance metrics, create ...

    • Google Ads Data Connector User Guide

      Google Ads is a powerful online advertising platform that allows businesses to reach potential customers across Google's vast network. This guide will walk you through how to connect your Google Ads data to Power My Analytics, create reports in Data ...

    • TikTok Organic Data Connector User Guide

      Get valuable insights into your TikTok organic performance by connecting your TikTok profile data to Power My Analytics. This guide will walk you through setting up and using the TikTok Organic data source. Prerequisites Before you begin, make sure ...

    • Apple Ads Data Connector User Guide

      The following article is a guide to automating reports with your Apple Search Ads connector. It includes information on available data as well as currently unavailable data and tips on how to get the most out of your Apple Search Ads reports. To ...

    • Pinterest Ads Data Connector User Guide

      Pinterest Ads is a powerful advertising platform that allows businesses to promote their products and services to Pinterest's vast user base. This guide will walk you through the process of connecting your Pinterest Ads account to Power My Analytics, ...