Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
2_sec_video_viewsMetric

The number of times a video ad was viewed for at least 2 seconds.

aco_typeDimension

Represents the type of Ad Creative Optimization (ACO) used for the ad.

ad_group_idDimension

The unique identifier for the ad group.

ad_group_nameDimension

The name of the ad group.

ad_idDimension

The unique identifier for the specific ad.

ad_id_nameDimension

The name of the specific ad.

ad_product_positionDimension

Indicates the position or placement of the ad product.

advertiser_currency_code_costMetric

The cost of the ad in the advertiser's local currency.

advertiser_idDimension

The unique identifier for the advertiser account.

advertiser_nameDimension

The name of the advertiser account.

advertising_objectiveDimension

The primary goal or objective set for the advertising campaign, such as Traffic, Video views, Lead Generation, or Sales.

aeo_typeDimension

Refers to the type of Ad Event Optimization (AEO) applied to the ad.

brandDimension

The brand associated with the advertising campaign.

campaign_categoryDimension

The categorized type or theme of the advertising campaign.

campaign_idDimension

The unique identifier for the advertising campaign.

campaign_nameDimension

The name of the advertising campaign.

clicksMetric

The total number of clicks on the ad.

country_codeDimension

The ISO 3166-1 alpha-2 country code where the advertising campaign was targeted or displayed.

country_nameDimension

The name of the country where the advertising campaign was targeted or displayed.

currency_codeDimension

The currency code used for reporting financial metrics.

custom_audienceDimension

The name or identifier of the custom audience targeted by the ad campaign.

customer_nameDimension

The name of the customer or advertiser associated with the data.

dateDimension

The specific date for which the aggregated data is reported.

dma_idDimension

The unique identifier for the Designated Market Area (DMA), primarily for US-based targeting.

dma_nameDimension

The name of the Designated Market Area (DMA).

dpa_local_audienceDimension

Indicates whether the audience targeted for Dynamic Product Ads (DPA) is local.

impression_typeDimension

The category of impressions, such as paid or earned.

impressionsMetric

The total number of times the ad was displayed.

is_sparkDimension

A boolean indicator specifying if the ad is a Spark Ad.

lookalike_audienceDimension

The name or identifier of the lookalike audience targeted by the ad campaign.

pricing_typeDimension

The pricing model or type used for the ad campaign.

sub_brandDimension

The sub-brand associated with the advertising content.

targeted_audience_ageDimension

The age demographic targeted by the advertising campaign.

targeted_audience_genderDimension

The gender demographic targeted by the advertising campaign.

targeted_audience_interestDimension

The specific interests targeted for the audience of the advertising campaign.

targeted_audience_languageDimension

The language(s) targeted for the audience of the advertising campaign.

targeted_audience_platform_typeDimension

The platform type where the audience was targeted (e.g., TikTok, Pangle).

targeted_audience_provincesDimension

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.

usd_costMetric

The cost of the ad campaign in United States Dollars (USD).

video_viewsMetric

The total number of times the video ad was viewed.

video_views_100percentMetric

The number of times the video ad was viewed to 100% completion.