TikTok MMM: Most-used fields

The table below gives information about most-used fields that you can import from TikTok MMM. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
2_sec_video_views	2_sec_video_views	The number of times a video ad was viewed for at least 2 seconds.	metric
aco_type	aco_type	Represents the type of Ad Creative Optimization (ACO) used for the ad.	dimension
ad_group_id	ad_group_id	The unique identifier for the ad group.	dimension
ad_group_name	ad_group_name	The name of the ad group.	dimension
ad_id	ad_id	The unique identifier for the specific ad.	dimension
ad_id_name	ad_id_name	The name of the specific ad.	dimension
ad_product_position	ad_product_position	Indicates the position or placement of the ad product.	dimension
advertiser_currency_code_cost	advertiser_currency_code_cost	The cost of the ad in the advertiser’s local currency.	metric
advertiser_id	advertiser_id	The unique identifier for the advertiser account.	dimension
advertiser_name	advertiser_name	The name of the advertiser account.	dimension
advertising_objective	advertising_objective	The primary goal or objective set for the advertising campaign, such as Traffic, Video views, Lead Generation, or Sales.	dimension
aeo_type	aeo_type	Refers to the type of Ad Event Optimization (AEO) applied to the ad.	dimension
brand	brand	The brand associated with the advertising campaign.	dimension
campaign_category	campaign_category	The categorized type or theme of the advertising campaign.	dimension
campaign_id	campaign_id	The unique identifier for the advertising campaign.	dimension
campaign_name	campaign_name	The name of the advertising campaign.	dimension
clicks	clicks	The total number of clicks on the ad.	metric
country_code	country_code	The ISO 3166-1 alpha-2 country code where the advertising campaign was targeted or displayed.	dimension
country_name	country_name	The name of the country where the advertising campaign was targeted or displayed.	dimension
currency_code	currency_code	The currency code used for reporting financial metrics.	dimension
custom_audience	custom_audience	The name or identifier of the custom audience targeted by the ad campaign.	dimension
customer_name	customer_name	The name of the customer or advertiser associated with the data.	dimension
date	date	The specific date for which the aggregated data is reported.	dimension
dma_id	dma_id	The unique identifier for the Designated Market Area (DMA), primarily for US-based targeting.	dimension
dma_name	dma_name	The name of the Designated Market Area (DMA).	dimension
dpa_local_audience	dpa_local_audience	Indicates whether the audience targeted for Dynamic Product Ads (DPA) is local.	dimension
impression_type	impression_type	The category of impressions, such as paid or earned.	dimension
impressions	impressions	The total number of times the ad was displayed.	metric
is_spark	is_spark	A boolean indicator specifying if the ad is a Spark Ad.	dimension
lookalike_audience	lookalike_audience	The name or identifier of the lookalike audience targeted by the ad campaign.	dimension
pricing_type	pricing_type	The pricing model or type used for the ad campaign.	dimension
sub_brand	sub_brand	The sub-brand associated with the advertising content.	dimension
targeted_audience_age	targeted_audience_age	The age demographic targeted by the advertising campaign.	dimension
targeted_audience_gender	targeted_audience_gender	The gender demographic targeted by the advertising campaign.	dimension
targeted_audience_interest	targeted_audience_interest	The specific interests targeted for the audience of the advertising campaign.	dimension
targeted_audience_language	targeted_audience_language	The language(s) targeted for the audience of the advertising campaign.	dimension
targeted_audience_platform_type	targeted_audience_platform_type	The platform type where the audience was targeted (e.g., TikTok, Pangle).	dimension
targeted_audience_provinces	targeted_audience_provinces	Specifies the provinces where the advertising campaigns are targeted. This field defines the geographic regions used to filter or segment the audience for which Media Mix Modeling data is collected.	dimension
usd_cost	usd_cost	The cost of the ad campaign in United States Dollars (USD).	metric
video_views	video_views	The total number of times the video ad was viewed.	metric
video_views_100percent	video_views_100percent	The number of times the video ad was viewed to 100% completion.	metric