TikTok Ads Entities and Fields

Hierarchy: advertiser → campaign → adgroup → ad. Report levels: AUCTION_ADVERTISER / AUCTION_CAMPAIGN / AUCTION_ADGROUP / AUCTION_AD.

Hierarchy

Advertiser
└── Campaign
    └── AdGroup (aliases: adset_*)
        └── Ad

Advertiser

Key	Name	Type	Filterable	Sortable
account_id	Account ID	string	Yes	No
account_name	Account name	string	Yes	Yes
account_status	Status	string	No	No
account_currency	Currency	string	No	No
date_start	Date	date	Yes	Yes
date_stop	End date	date	No	No

date_start ← stat_time_day. With daily aggregation, date_stop = date_start.

Campaign

Key	Name	Type	Filterable	Sortable
campaign_id	Campaign ID	string	Yes	No
campaign_name	Campaign name	string	Yes	Yes

Ad Group (adgroup)

Aliases: adset_id / adset_name ← adgroup_id / adgroup_name.

Key	Name	Type	API	Filterable	Sortable
adset_id	Ad group ID	string	adgroup_id	Yes	No
adset_name	Ad group name	string	adgroup_name	Yes	Yes

Ad

Key	Name	Type	Filterable	Sortable
ad_id	Ad ID	string	Yes	No
ad_name	Ad name	string	Yes	Yes

Metric Fields in the Row

The report row also includes: spend, impressions, clicks, ctr, cpc, cpm, conversions/results, cost_per_result, reach, frequency.

Normalization: normalizeTikTokReportRow + code: 0 check via normalizeTikTokApiPayload.

Related Pages

• Metrics
• Advertisers
• Filters