# Integrate TikTok Ads with Databox TikTok Ads is a self-serve advertising platform that allows businesses to reach a large and highly engaged global audience through short-form video content across TikTok and its partner networks. It provides tools for campaign management, audience targeting, and performance measurement at the campaign, ad group, and ad level. Connecting TikTok Ads to Databox brings your ad performance data — impressions, clicks, conversions, cost, and more — into a unified reporting environment alongside your other paid channels, so you can monitor spend efficiency and make faster, better-informed decisions. ## Connection ### Before you begin ### Step 1: Add or choose the connection To connect TikTok Ads to your Databox account for the [first time](/add-a-connection), log in using your TikTok for Business credentials. Enter your **Email** and **Password**, then click **Log in**. You can also sign in using the **Log in with TikTok** option if your personal TikTok account is linked to your TikTok for Business account. If you've already established a connection, you can [reuse](/add-a-data-source) it to add new accounts, as long as those accounts are accessible with the existing connection's credentials. tiktok-ads-oauth-login If your TikTok for Business credentials are saved in your browser, the account may be selected automatically during the connection process. If this is not the account you want to connect, we recommend completing the setup in an Incognito window to avoid automatic login. ### Step 2: Select the advertiser account After granting access, select the TikTok advertiser account you want to report on. If you manage multiple advertiser accounts under your TikTok for Business account, you will be prompted to choose the specific account you want to connect to Databox. ## Metric Builder The TikTok Ads integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration. metric-builder To create a custom metric, start by selecting a metric from the **Metric** selector. Next, customize your metric by optionally adding a dimension and applying one or more filters. The available options depend on the selected report type and data type (e.g., number, text, etc.). There are two report types available for custom metric creation: **Basic Report** and **Audience Report**. #### Audience Report Audience Report provides performance data segmented by audience characteristics. Select a **Metric** — options include Total Cost, CPC, CPM, Impressions, Clicks, CTR (%), Conversion, CPA, CVR (%), Result, Cost Per Result, Result Rate (%), and their real-time equivalents. Then choose one or more **Dimensions** to break down your data. Available dimensions include Gender, Age, Country Code, Audience Network, Language, Operating System, and Placement. Optionally, select an **Extra dimension** (Campaign, Adgroup, or Ad) to further segment the report. When an extra dimension is selected, the same Advanced options filter structure as Basic Report becomes available. **In TikTok Ads:** Go to the [Ads Manager](https://ads.tiktok.com/i18n/perf) section. #### Basic Report Basic Report provides access to standard campaign performance data across TikTok's reporting dimensions. Start by selecting a **Metric group** — options include Basic, Video Plays, Engagements, In-App Events, Attribution, and Page Events — and then choose a specific **Metric** from the dynamic list loaded for that group. Optionally, select one or more **Dimensions** (Campaign, Adgroup, or Ad) to segment your data. When a dimension is selected, Advanced options become available, allowing you to add up to 15 filter groups using AND logic. Available filters depend on the selected dimension: - **Campaign:** Filter by Campaign Name, Campaign Type, Campaign Status, or Promotion Type. - **Adgroup:** Filter by Campaign Name, Ad Group Name, Ad Group Status, or Promotion Type. - **Ad:** Filter by Campaign Name, Ad Group Name, Ad Name, Ad Status, or Promotion Type. Filter values for name-based filters (Campaign Name, Ad Group Name, Ad Name) are loaded dynamically from your account. Status filters support values such as Active, Not delivering, Inactive, Deleted, Completed, All statuses (including "Deleted"), and All statuses (excluding "Deleted"). **In TikTok Ads:** Go to the [Ads Manager](https://ads.tiktok.com/i18n/perf) section. ## ![lock](/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg) Datasets The TikTok Ads integration supports the creation of [datasets](/understanding-datasets), which allow you to structure and format your TikTok Ads data for more flexible reporting in Databox. By organizing your data into a tabular format, datasets make it easier to filter, segment, and visualize key metrics across projects, clients, and team members. The entity relationship diagram (ERD) below illustrates how data is organized within the TikTok Ads integration, displaying the available **views** and **columns**, as well as the relationships between them (primary and foreign keys). This diagram represents the **schema**, or structure, of the data and helps you understand the underlying data model. With this context, you can create datasets using the relevant views and columns to build custom metrics tailored to your reporting needs. ## Resources For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below. Yes. When building a Basic Report metric with a Campaign dimension, a **Target Audience Type** filter is available with the options Regular Campaign and SKAN campaign (iOS 14 campaigns). Select the SKAN campaign option to scope your metric to SKAdNetwork campaign data only. Differences can occur due to data attribution windows, time zone settings, or reporting delays. TikTok Ads Manager may apply different attribution lookback windows than the defaults used in Databox metric builder queries. Additionally, TikTok's API may apply a short reporting delay for some metrics, particularly conversion and real-time metrics. Check that the date ranges and attribution settings in both tools are aligned before comparing figures.   Ask Genie Get instant answers or help with your data using the in-app AI assistant. Talk to an expert For customers: Get help with your setup, strategy, or making the most of Databox. Book a demo New to Databox? See how it works and get guidance on getting started. Send an email Reach out to support for help with your account, data, or technical issues.