Skip to main content

Description

The Platform - TikTok dataset contains TikTok ad platform performance metrics at the hourly, ad-level granularity.

Partition Keys

  • identifier
  • date
💡 Note: Leverage partition keys when querying the table to improve query efficiency.

Logical Primary Key

These fields uniquely identify a record. While data warehouses do not enforce primary key constraints, this combination functions as the logical primary key for the table.
  • identifier
  • date
  • utc_hour
  • ad_id

Field Reference


Nested Fields

The following fields are nested JSON objects keyed by Facebook conversion event name:
  • conversions

Example Stored Object

Nested Field Definitions

  • conversion — attributed conversion events based on the ad group’s configured attribution window (finalized reporting metric).
  • real_time_conversion — near real-time conversion events reported before the full attribution window has matured; primarily used for in-flight pacing, rapid performance checks, and short-term bid/budget adjustments.
  • result — Attributed events tied specifically to the campaign’s selected optimization objective (the primary KPI metric).
  • real_time_result — near real-time version of the objective-based result metric; used by marketers to monitor live optimization performance and make same-day creative or budget decisions.

Snowflake - Querying Nested Fields

Extract a Single Event

Flatten All Events Into Rows

Redshift - Querying Nested Fields (SUPER type)

Extract a Single Event

Flatten All Events Into Rows

BigQuery - Querying Nested Fields (JSON type)

Extract a Single Event

Flatten All Events Into Rows