TikTok Ads: Most-used fields#
The table below gives information about most-used fields that you can import from TikTok Ads. 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 |
|---|---|---|---|
10_second_live_views |
10_second_live_views |
The number of views where a live stream ad was watched for at least 10 seconds. |
metric |
AGE |
AGE |
The age demographic of the audience interacting with the ad. |
dimension |
Ad Group |
Ad Group |
The name of the ad group. |
dimension |
Ad Set |
Ad Set |
The name or identifier of the ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
Amount Spent |
Amount Spent |
The total amount of money spent on advertising. |
metric |
Audience |
Audience |
The targeted audience for the ad campaign. |
dimension |
Buy Type |
Buy Type |
Refers to the method of buying ads, such as auction or reservation. |
dimension |
Buying Currency |
Buying Currency |
The currency in which the ad spend and costs are reported. |
dimension |
Campaign |
Campaign |
The name of the advertising campaign. |
dimension |
Campaign Country |
Campaign Country |
The country where the advertising campaign is primarily targeted or created. |
dimension |
Campaign Country Code |
Campaign Country Code |
The two-letter country code (e.g., US, GB) where the advertising campaign is targeted or created. |
dimension |
Campaign Description |
Campaign Description |
A textual description of the campaign. |
dimension |
Campaign Name |
Campaign Name |
The name of the advertising campaign. |
dimension |
Campaign Objective |
Campaign Objective |
The primary goal or objective set for the advertising campaign (e.g., brand awareness, conversions). |
dimension |
Campaign Type |
Campaign Type |
The type or objective of the advertising campaign, e.g., iOS14 Dedicated Campaign or a regular campaign. |
dimension |
Channel |
Channel |
The advertising channel where the ad is displayed, such as TikTok or other supported placements. |
dimension |
Clicks |
Clicks |
The total number of clicks on the ad. |
metric |
Comments Social Engagement |
Comments Social Engagement |
The number of comments received on an ad. |
metric |
Creative Dimensions |
Creative Dimensions |
The dimensions (height and width) of the creative asset. |
dimension |
Creative Length for Video/Audio |
Creative Length for Video/Audio |
The duration of the video or audio creative in seconds. |
dimension |
Creative Messaging |
Creative Messaging |
The text content of the ad creative. |
dimension |
Creative Name |
Creative Name |
The name of the ad creative. |
dimension |
Creative Size Length |
Creative Size Length |
dimension |
|
Creative Type |
Creative Type |
The type of ad creative, such as image, video, or carousel. |
dimension |
Date |
Date |
The specific date for which the data is reported. |
dimension |
DayofWeek |
DayofWeek |
The day of the week when the ad data was recorded. |
dimension |
Device |
Device |
The type of device (e.g., mobile, desktop) on which the ad was displayed. |
dimension |
End Date |
End Date |
The end date of the ad campaign or ad group schedule. |
dimension |
Engagement |
Engagement |
The total number of user interactions with an ad, such as clicks, likes, shares, or comments. |
dimension |
Format |
Format |
The format of the ad creative, such as vertical video or square image. |
dimension |
GENDER |
GENDER |
The gender demographic of the audience interacting with the ad. |
dimension |
Impressions |
Impressions |
The total number of times the ad was displayed. |
metric |
Likes Social Engagement |
Likes Social Engagement |
The total number of likes an ad creative received. |
metric |
Market |
Market |
The geographical market or region targeted by the ad. |
dimension |
Measured Impressions |
Measured Impressions |
The total number of times an ad was displayed, based on a measurable standard. |
dimension |
Month |
Month |
The month for which the data is reported. |
dimension |
Month-Year |
Month-Year |
The month and year for which the data is reported. |
dimension |
Placement |
Placement |
The specific location within the TikTok ecosystem or partner network where the ad was displayed. |
dimension |
Platform |
Platform |
The advertising platform where the ad was displayed, such as TikTok. |
dimension |
Reach |
Reach |
The total number of unique users who saw the ad. |
metric |
Shares Social Engagement |
Shares Social Engagement |
The total number of times an ad creative was shared. |
metric |
Site |
Site |
The platform or website where the ad was displayed or directed traffic. |
dimension |
Social Platform |
Social Platform |
The social media platform on which the advertising campaign is running (e.g., TikTok). |
dimension |
Start Date |
Start Date |
The start date of the ad campaign or ad group schedule. |
dimension |
Targeting |
Targeting |
The set of criteria used to define the audience for the ad campaign. |
dimension |
Targeting Category |
Targeting Category |
The interest or demographic category used to target audiences. |
dimension |
Targeting Detail |
Targeting Detail |
This field encompasses the detailed targeting criteria applied to ad groups, such as geographical locations (regions, zip codes), demographics (age, gender), device operating systems, and internet service providers, to define the audience for ad delivery. |
dimension |
TikTok_interactions |
TikTok_interactions |
The total number of interactions with a TikTok ad. |
metric |
Unique Impressions |
Unique Impressions |
The number of unique users who saw the ad. |
dimension |
Video Length |
Video Length |
The duration of the video creative used in the ad. |
dimension |
Video Plays |
Video Plays |
The total number of times the video ad creative was played. |
metric |
Viewability Measured Impressions |
Viewability Measured Impressions |
Impressions that were measured for viewability, meaning the ad was considered viewable by industry standards. |
metric |
Viewable Impressions |
Viewable Impressions |
The number of ad impressions that were actually viewable. |
metric |
Viewable Rate |
Viewable Rate |
The percentage of measured impressions that were considered viewable. |
metric |
WeekAsDate |
WeekAsDate |
The date representing the week for which the data is reported. |
dimension |
WeekNum |
WeekNum |
The week number within the year for which the data is reported. |
metric |
Year |
Year |
The year for which the data is reported. |
dimension |
YearMonth |
YearMonth |
The year and month for which the data is reported. |
metric |
account_id |
account_id |
The unique identifier for the ad account. |
dimension |
account_name |
account_name |
The name of the ad account. |
dimension |
achieve_level |
achieve_level |
The number of times a specific achievement level was reached by users. |
metric |
achieve_level_rate |
achieve_level_rate |
The rate at which users achieve a specific level, calculated as achievement level completions divided by relevant impressions or clicks. |
metric |
action_category |
action_category |
The category of action taken by users, such as purchase or add to cart. |
metric |
action_period |
action_period |
The time period or attribution window within which user actions are recorded. |
metric |
action_type |
action_type |
The type of action performed by a user, such as a click, impression, or conversion event. |
dimension |
actions |
actions |
The total number of user actions or engagements with the ad. |
metric |
actual_device |
actual_device |
The actual device on which the ad was displayed. |
dimension |
ad |
ad |
The name or identifier of the advertisement. |
dimension |
ad_adgroup_id |
ad_adgroup_id |
The unique identifier of the ad group to which the ad belongs. |
dimension |
ad_adgroup_name |
ad_adgroup_name |
The name of the ad group to which the ad belongs. |
dimension |
ad_advertiser_id |
ad_advertiser_id |
The ID of the advertiser account that owns the ad. |
dimension |
ad_app_name |
ad_app_name |
The name of the application associated with the ad, relevant for app promotion campaigns. |
dimension |
ad_call_to_action |
ad_call_to_action |
The call-to-action text displayed on the ad. |
dimension |
ad_call_to_action_id |
ad_call_to_action_id |
The unique identifier for the call to action button used in the ad. |
dimension |
ad_campaign_id |
ad_campaign_id |
The unique identifier of the campaign to which the ad belongs. |
dimension |
ad_campaign_name |
ad_campaign_name |
The name of the campaign to which the ad belongs. |
dimension |
ad_card_id |
ad_card_id |
The ID of the card creative used in the ad. |
dimension |
ad_click_rate |
ad_click_rate |
The rate at which users click on an ad after seeing it (Click-Through Rate). |
metric |
ad_click_tracking_url |
ad_click_tracking_url |
The URL used to track clicks on the ad. |
dimension |
ad_conversion_rate |
ad_conversion_rate |
The rate at which users complete a desired action after interacting with an ad. |
metric |
ad_create_time |
ad_create_time |
The timestamp when the ad was created. |
dimension |
ad_creative_authorized |
ad_creative_authorized |
Indicates whether permission is granted to display ads in the TikTok For Business Creative Center. |
dimension |
ad_creative_image_format |
ad_creative_image_format |
The file format of the image creative used in the ad (e.g., JPG, PNG). |
dimension |
ad_creative_image_height |
ad_creative_image_height |
The height of the image creative used in the ad, in pixels. |
dimension |
ad_creative_image_size |
ad_creative_image_size |
The file size of the image creative used in the ad, in bytes. |
metric |
ad_creative_image_url |
ad_creative_image_url |
The URL of the image used in the ad creative. |
dimension |
ad_creative_image_width |
ad_creative_image_width |
The width of the image creative used in the ad, in pixels. |
dimension |
ad_creative_video_bit_rate |
ad_creative_video_bit_rate |
The bit rate of the video creative used in the ad. |
metric |
ad_creative_video_duration |
ad_creative_video_duration |
The duration of the video creative used in the ad. |
dimension |
ad_creative_video_format |
ad_creative_video_format |
The file format of the video creative used in the ad (e.g., MP4, MOV). |
dimension |
ad_creative_video_height |
ad_creative_video_height |
The height of the video creative used in the ad, in pixels. |
metric |
ad_creative_video_poster_url |
ad_creative_video_poster_url |
The URL of the static image used as a poster for the video ad creative. |
dimension |
ad_creative_video_preview_url |
ad_creative_video_preview_url |
The URL for a preview of the video creative used in the ad. |
dimension |
ad_creative_video_size |
ad_creative_video_size |
The file size of the video creative used in the ad, in bytes. |
dimension |
ad_creative_video_video_cover_url |
ad_creative_video_video_cover_url |
The URL of the cover image for the video creative used in the ad. |
dimension |
ad_creative_video_width |
ad_creative_video_width |
The width of the video creative used in the ad, in pixels. |
metric |
ad_deeplink |
ad_deeplink |
The deep link URL configured for the ad, used to direct users to specific content within an app. |
dimension |
ad_deeplink_type |
ad_deeplink_type |
The type of deep link configured for the ad. |
dimension |
ad_display_name |
ad_display_name |
The display name of the ad. |
dimension |
ad_external_action |
ad_external_action |
The name of the shallow external action conversion event. |
dimension |
ad_format |
ad_format |
The format of the ad creative (e.g., image, video, carousel). |
dimension |
ad_group_audience |
ad_group_audience |
The audience targeted by the ad group. |
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 ad. |
dimension |
ad_identity_id |
ad_identity_id |
The unique identifier for an individual ad. |
dimension |
ad_identity_type |
ad_identity_type |
The type of identity used for the ad, such as a TikTok account or business profile. |
dimension |
ad_image_ids |
ad_image_ids |
A list of identifiers for images associated with the ad creative. |
dimension |
ad_impression_tracking_url |
ad_impression_tracking_url |
The URL used to track impressions of the ad. |
dimension |
ad_invalid_impressions |
ad_invalid_impressions |
Impressions from an ad that are deemed invalid (e.g., bot traffic). |
metric |
ad_invalid_spend |
ad_invalid_spend |
The amount of money spent on an ad that was attributed to invalid impressions. |
metric |
ad_is_aco |
ad_is_aco |
Indicates if the ad utilizes Automated Creative Optimization (ACO) to generate multiple creative variations. |
dimension |
ad_landing_page_url |
ad_landing_page_url |
The primary landing page URL for the ad. |
dimension |
ad_landing_page_urls |
ad_landing_page_urls |
A list of URLs to which users are directed after clicking on the ad. |
dimension |
ad_modify_time |
ad_modify_time |
The timestamp when the ad was last modified. |
dimension |
ad_name |
ad_name |
The name of the ad. |
dimension |
ad_open_url |
ad_open_url |
The URL that users are directed to when they click on the ad. |
dimension |
ad_operation_status |
ad_operation_status |
The current operational status of the ad, such as active, paused, or deleted. |
dimension |
ad_page_id |
ad_page_id |
The unique identifier of the page associated with the ad. |
dimension |
ad_pixel_id |
ad_pixel_id |
The ID of the TikTok pixel used to track events for the ad. |
dimension |
ad_playable_url |
ad_playable_url |
The URL for the playable ad creative. |
dimension |
ad_profile_image |
ad_profile_image |
The URL or identifier of the profile image associated with the ad’s identity. |
metric |
ad_profile_image_url |
ad_profile_image_url |
The URL of the profile image displayed with the ad. |
dimension |
ad_secondary_status |
ad_secondary_status |
The secondary status of the ad, providing more granular information beyond the primary status. |
dimension |
ad_status |
ad_status |
The current operational status of the ad (e.g., enabled, paused, rejected). |
dimension |
ad_text |
ad_text |
The main text content of the ad. |
dimension |
ad_texts |
ad_texts |
A list of text elements used in the ad creative. |
dimension |
ad_tiktok_item_id |
ad_tiktok_item_id |
The unique identifier for the specific TikTok content item (e.g., video, post) used in the ad. |
dimension |
ad_type |
ad_type |
The type of ad creative (e.g., single image, video, carousel). |
dimension |
ad_url |
ad_url |
The destination URL associated with the ad. |
metric |
ad_valid_impressions |
ad_valid_impressions |
The number of impressions deemed valid for an ad. |
metric |
ad_valid_spend |
ad_valid_spend |
The amount of money spent on an ad that was attributed to valid impressions. |
metric |
ad_video_id |
ad_video_id |
The ID of the video creative used in the ad. |
dimension |
ad_video_view_rate_2s |
ad_video_view_rate_2s |
The percentage of ad video plays that reached at least 2 seconds. |
metric |
ad_video_view_rate_6s |
ad_video_view_rate_6s |
The percentage of ad video plays that reached at least 6 seconds. |
metric |
ad_video_view_rate_p100 |
ad_video_view_rate_p100 |
The percentage of ad video plays that were viewed to 100% completion. |
metric |
ad_video_view_rate_p25 |
ad_video_view_rate_p25 |
The percentage of ad video plays that were viewed to 25% completion. |
metric |
ad_video_view_rate_p50 |
ad_video_view_rate_p50 |
The percentage of ad video plays that were viewed to 50% completion. |
metric |
ad_video_view_rate_p75 |
ad_video_view_rate_p75 |
The percentage of ad video plays that were viewed to 75% completion. |
metric |
add_billing |
add_billing |
The number of times users initiated adding billing information, such as credit card details. |
metric |
add_billing_rate |
add_billing_rate |
The percentage of add payment info actions on your website from all clicks attributed to your ads. |
metric |
add_payment_info |
add_payment_info |
The number of unique ‘add payment info’ actions attributed to your ads. |
metric |
add_payment_info_rate |
add_payment_info_rate |
The rate at which users add payment information. |
metric |
add_to_wishlist |
add_to_wishlist |
The number of unique ‘add to wishlist’ actions attributed to your ads. |
metric |
add_to_wishlist_rate |
add_to_wishlist_rate |
The rate at which users add items to a wishlist. |
metric |
adgroup_advertiser_id |
adgroup_advertiser_id |
The unique identifier of the advertiser account that owns the ad group. |
dimension |
adgroup_age |
adgroup_age |
The age demographic targeted by the ad group. |
dimension |
adgroup_age_groups |
adgroup_age_groups |
The age ranges used in targeting for your ad group. |
dimension |
adgroup_app_download_url |
adgroup_app_download_url |
The URL where users are directed to download the app after interacting with an ad in this ad group. |
dimension |
adgroup_app_id |
adgroup_app_id |
The application ID associated with the ad group, primarily for app promotion campaigns. |
dimension |
adgroup_app_profile_page_state |
adgroup_app_profile_page_state |
The state of the app profile page associated with the ad group. |
dimension |
adgroup_app_type |
adgroup_app_type |
The type of mobile application targeted by the ad group (e.g., iOS, Android). |
dimension |
adgroup_audience |
adgroup_audience |
The audience segments targeted by the ad group. |
dimension |
adgroup_audience_ids |
adgroup_audience_ids |
The unique identifiers for audience lists targeted by the ad group. |
dimension |
adgroup_bid |
adgroup_bid |
The bid amount set for the ad group. |
metric |
adgroup_bid_price |
adgroup_bid_price |
The bid price set for the ad group. |
metric |
adgroup_bid_type |
adgroup_bid_type |
The bidding strategy or type configured for the ad group. |
dimension |
adgroup_billing_event |
adgroup_billing_event |
The billing event type selected for the ad group (e.g., CPM, CPC). |
dimension |
adgroup_brand_safety |
adgroup_brand_safety |
The brand safety settings applied to the ad group. |
dimension |
adgroup_brand_safety_type |
adgroup_brand_safety_type |
This field specifies the brand safety solution applied to an ad group, determining the content suitability for ad placements (e.g., no brand safety, standard inventory for most brands, limited inventory for sensitive themes, or third-party solutions). |
dimension |
adgroup_budget |
adgroup_budget |
The budget allocated to the ad group. |
metric |
adgroup_budget_mode |
adgroup_budget_mode |
The budget pacing strategy for the ad group, indicating how the budget is allocated over time (e.g., daily or total). |
dimension |
adgroup_campaign_id |
adgroup_campaign_id |
The unique identifier of the campaign to which the ad group belongs. |
dimension |
adgroup_carriers |
adgroup_carriers |
The mobile carriers targeted by the ad group. |
dimension |
adgroup_category |
adgroup_category |
The category assigned to the ad group. |
dimension |
adgroup_click_attribution_window |
adgroup_click_attribution_window |
The time frame after a click within which a conversion is attributed to the ad group. |
dimension |
adgroup_comment_disabled |
adgroup_comment_disabled |
Indicates whether comments are disabled for ads within this ad group. |
dimension |
adgroup_conversion_bid_price |
adgroup_conversion_bid_price |
The bid amount set for a conversion event at the ad group level. |
metric |
adgroup_conversion_id |
adgroup_conversion_id |
The identifier of the conversion event that the ad group is optimized for. |
dimension |
adgroup_conversion_window |
adgroup_conversion_window |
The time window after an ad interaction during which a conversion is attributed to the ad group. |
dimension |
adgroup_create_time |
adgroup_create_time |
The timestamp when the ad group was created. |
dimension |
adgroup_creative_material_mode |
adgroup_creative_material_mode |
The creative material mode setting for the ad group, indicating the type of ad creative format used (e.g., single video, image). |
dimension |
adgroup_dayparting |
adgroup_dayparting |
The scheduling settings that define specific times of day or days of the week for ad delivery within the ad group. |
dimension |
adgroup_deep_bid_type |
adgroup_deep_bid_type |
The bidding strategy for deep conversions or in-app events within the ad group. |
dimension |
adgroup_deep_cpa_bid |
adgroup_deep_cpa_bid |
The Cost Per Action (CPA) bid specifically for deep conversion events within the ad group. |
metric |
adgroup_device_price_ranges |
adgroup_device_price_ranges |
This field specifies the targeted device price ranges for an ad group, allowing advertisers to reach users with devices within certain price brackets. |
dimension |
adgroup_download_url |
adgroup_download_url |
The URL for downloading an app or visiting a website associated with the ad group. |
metric |
adgroup_excluded_audience_ids |
adgroup_excluded_audience_ids |
A list of audience identifiers that are excluded from targeting for this ad group. |
dimension |
adgroup_frequency |
adgroup_frequency |
The frequency cap setting for the ad group, controlling how often a user sees an ad. |
metric |
adgroup_frequency_schedule |
adgroup_frequency_schedule |
The frequency capping schedule configured for the ad group. |
dimension |
adgroup_gender |
adgroup_gender |
The genders targeted for your ad group, or the genders of people who engaged with your ad. |
dimension |
adgroup_id |
adgroup_id |
The unique identifier for the ad group. |
dimension |
adgroup_included_custom_actions |
adgroup_included_custom_actions |
A list of custom actions that are included for optimization within the ad group. |
dimension |
adgroup_interest_category_ids |
adgroup_interest_category_ids |
The IDs of interest categories targeted by the ad group. |
dimension |
adgroup_inventory_filter_enabled |
adgroup_inventory_filter_enabled |
Indicates if inventory filtering is enabled for the ad group to control ad placement. |
dimension |
adgroup_ios14_quota_type |
adgroup_ios14_quota_type |
The iOS 14 quota type for the ad group, related to SKAdNetwork campaign limitations. |
dimension |
adgroup_is_new_structure |
adgroup_is_new_structure |
Indicates whether the ad group is configured with the new campaign structure. |
dimension |
adgroup_keywords |
adgroup_keywords |
The keywords used for targeting within the ad group. |
dimension |
adgroup_languages |
adgroup_languages |
The languages targeted by the ad group. |
dimension |
adgroup_location |
adgroup_location |
The geographical location(s) targeted by the ad group. |
dimension |
adgroup_location_ids |
adgroup_location_ids |
The geographic region IDs targeted by the ad group. |
dimension |
adgroup_modify_time |
adgroup_modify_time |
The timestamp when the ad group was last modified. |
dimension |
adgroup_name |
adgroup_name |
The name of the ad group. |
dimension |
adgroup_network_types |
adgroup_network_types |
The network types (e.g., Wi-Fi, mobile data) targeted by the ad group. |
dimension |
adgroup_operating_systems |
adgroup_operating_systems |
The operating systems targeted by the ad group. |
dimension |
adgroup_operation_status |
adgroup_operation_status |
The current operational status of the ad group, indicating whether it is running, paused, or completed. |
dimension |
adgroup_opt_status |
adgroup_opt_status |
The optimization status of the ad group. |
dimension |
adgroup_optimization_event |
adgroup_optimization_event |
The specific event the ad group is optimized for (e.g., app install, purchase). |
dimension |
adgroup_optimization_goal |
adgroup_optimization_goal |
The overall goal for optimization set for the ad group. |
dimension |
adgroup_optimize_goal |
adgroup_optimize_goal |
The optimization goal set for the ad group (e.g., conversions, clicks). |
dimension |
adgroup_pacing |
adgroup_pacing |
The pacing strategy for the ad group’s budget, controlling daily spend distribution. |
dimension |
adgroup_pixel_id |
adgroup_pixel_id |
The Pixel ID used by the ad group for tracking website events. |
dimension |
adgroup_placement_type |
adgroup_placement_type |
The placement type where the ad group’s ads will appear. |
dimension |
adgroup_product_source |
adgroup_product_source |
The source of the products advertised in the ad group, such as a product catalog. |
dimension |
adgroup_promotion_type |
adgroup_promotion_type |
The type of promotion or objective for the ad group. |
dimension |
adgroup_purchased_impression |
adgroup_purchased_impression |
The number of impressions purchased for the ad group. |
metric |
adgroup_purchased_reach |
adgroup_purchased_reach |
The number of unique users reached for the ad group based on purchased media. |
metric |
adgroup_rf_estimated_cpr |
adgroup_rf_estimated_cpr |
The estimated cost per reach for a Reach and Frequency (RF) ad group. |
metric |
adgroup_rf_estimated_frequency |
adgroup_rf_estimated_frequency |
The estimated average number of times a user sees an ad from the reservation campaign within the ad group. |
dimension |
adgroup_rf_purchased_type |
adgroup_rf_purchased_type |
The purchased type for a Reach and Frequency (RF) ad group. |
dimension |
adgroup_schedule_end_time |
adgroup_schedule_end_time |
The scheduled end time for the ad group to run. |
dimension |
adgroup_schedule_start_time |
adgroup_schedule_start_time |
The scheduled start time for the ad group to run. |
dimension |
adgroup_schedule_type |
adgroup_schedule_type |
The type of schedule applied to the ad group, e.g., always-on or specific hours. |
dimension |
adgroup_scheduled_budget |
adgroup_scheduled_budget |
The total budget allocated for the ad group over its scheduled duration. |
metric |
adgroup_secondary_optimization_event |
adgroup_secondary_optimization_event |
The secondary event chosen for optimization at the ad group level. |
dimension |
adgroup_secondary_status |
adgroup_secondary_status |
A secondary status indicator for the ad group, providing more detail than the primary status. |
dimension |
adgroup_share_disabled |
adgroup_share_disabled |
dimension |
|
adgroup_skip_learning_phase |
adgroup_skip_learning_phase |
dimension |
|
adgroup_split_test_adgroup_ids |
adgroup_split_test_adgroup_ids |
dimension |
|
adgroup_statistic_type |
adgroup_statistic_type |
The statistical type or method used for reporting metrics at the ad group level. |
dimension |
adgroup_status |
adgroup_status |
The current operational status of the ad group (e.g., enabled, paused). |
dimension |
adgroup_video_download_disabled |
adgroup_video_download_disabled |
dimension |
|
adgroup_view_attribution_window |
adgroup_view_attribution_window |
The time window during which a view of an ad group’s ad can be attributed to a conversion. |
dimension |
ads_impression_events |
ads_impression_events |
The total number of ad impression events from your mobile app counted as app events and attributed to your ads. |
metric |
adset_bidtype |
adset_bidtype |
The bidding strategy used for the ad set (e.g., lowest cost, cost cap). In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_country |
adset_country |
The country targeted by the ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_invalid_impressions |
adset_invalid_impressions |
The number of impressions deemed invalid for an ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
metric |
adset_invalid_spend |
adset_invalid_spend |
The amount of money spent on an ad set that was attributed to invalid impressions. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
metric |
adset_language |
adset_language |
The language(s) targeted by the ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_name |
adset_name |
The name or identifier of the ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_platform |
adset_platform |
The platform where the ad set is running. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_status |
adset_status |
The current operational status of the ad set (e.g., enabled, paused). In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_targeting |
adset_targeting |
Detailed targeting parameters applied to the ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
dimension |
adset_valid_impressions |
adset_valid_impressions |
The number of impressions deemed valid for an ad set. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
metric |
adset_valid_spend |
adset_valid_spend |
The amount of money spent on an ad set that was attributed to valid impressions. In TikTok Ads, an ‘ad set’ is equivalent to an ‘ad group’. |
metric |
advertiser |
advertiser |
The name or identifier of the advertiser. |
dimension |
advertiser_account_type |
advertiser_account_type |
dimension |
|
advertiser_address |
advertiser_address |
The physical address of the advertiser. |
dimension |
advertiser_balance |
advertiser_balance |
The available balance in the advertiser’s account. |
metric |
advertiser_brand |
advertiser_brand |
The brand name associated with the advertiser. |
dimension |
advertiser_company |
advertiser_company |
The name of the advertiser’s company. |
dimension |
advertiser_country |
advertiser_country |
The country where the advertiser is located. |
dimension |
advertiser_create_time |
advertiser_create_time |
The timestamp when the advertiser account was created. |
dimension |
advertiser_currency |
advertiser_currency |
The currency used by the advertiser’s account. |
dimension |
advertiser_description |
advertiser_description |
A description of the advertiser or their business. |
dimension |
advertiser_display_timezone |
advertiser_display_timezone |
The display timezone configured for the advertiser’s account. |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the advertiser account. |
dimension |
advertiser_industry |
advertiser_industry |
The industry of the advertiser. |
metric |
advertiser_language |
advertiser_language |
The language set for the advertiser’s account. |
dimension |
advertiser_license_province |
advertiser_license_province |
The province where the advertiser’s business license is registered. |
dimension |
advertiser_name |
advertiser_name |
The name of the advertiser. |
dimension |
advertiser_owner_bc_id |
advertiser_owner_bc_id |
The Business Center ID of the advertiser account owner. |
dimension |
advertiser_promotion_center_province |
advertiser_promotion_center_province |
The province associated with the advertiser’s promotion center or primary business location. |
dimension |
advertiser_rejection_reason |
advertiser_rejection_reason |
dimension |
|
advertiser_status |
advertiser_status |
The current status of the advertiser account. |
dimension |
advertiser_timezone |
advertiser_timezone |
The timezone configured for the advertiser account. |
dimension |
age |
age |
The age of the targeted audience or users who engaged with the ad. |
dimension |
age_groups |
age_groups |
A list of age groups targeted by the ad. |
dimension |
age_range |
age_range |
The demographic age range targeted by the ad. |
dimension |
anchor_click_rate |
anchor_click_rate |
metric |
|
anchor_clicks |
anchor_clicks |
The number of clicks on anchors within video ads. |
metric |
app_download_url |
app_download_url |
The URL where the application can be downloaded. |
dimension |
app_event_add_to_cart |
app_event_add_to_cart |
The number of add to cart events that occurred within an app, attributed to your ads. |
metric |
app_event_add_to_cart_rate |
app_event_add_to_cart_rate |
The rate at which users add items to their cart within an app. |
metric |
app_id |
app_id |
The unique identifier for the application associated with the ad. |
dimension |
app_install |
app_install |
The number of app installs attributed to the ad campaign. |
metric |
app_name |
app_name |
The display name of the promoted application. |
dimension |
app_profile_country |
app_profile_country |
The country associated with the application profile. |
dimension |
app_profile_external_app_id |
app_profile_external_app_id |
The external ID of the application profile associated with the ad or campaign. |
dimension |
app_profile_icon |
app_profile_icon |
dimension |
|
app_promotion_type |
app_promotion_type |
The type of app promotion, such as app install or deep link. |
metric |
app_type |
app_type |
The type of application (e.g., iOS, Android). |
dimension |
attribution_event_count |
attribution_event_count |
The total count of events attributed to an ad. |
dimension |
attribution_window |
attribution_window |
The time frame after an ad interaction during which conversions are attributed to that ad. |
dimension |
audience_ids |
audience_ids |
The unique identifiers for the audience segments targeted. |
dimension |
audience_name |
audience_name |
The name of the audience segment targeted. |
dimension |
audience_rule |
audience_rule |
dimension |
|
audience_strategy |
audience_strategy |
dimension |
|
audience_type |
audience_type |
The type of audience used for targeting, such as custom audience or lookalike audience. |
dimension |
auto_targeting_enabled |
auto_targeting_enabled |
dimension |
|
avatar_icon_web_uri |
avatar_icon_web_uri |
The web URI for the avatar icon used in the ad. |
dimension |
average_video_play |
average_video_play |
The average duration a video ad was played. |
dimension |
average_video_play_per_user |
average_video_play_per_user |
The average time your video was played per unique user, including any time spent replaying the video. |
metric |
avg_value_per_pageview |
avg_value_per_pageview |
The average monetary value generated for each page view attributed to the ad. |
metric |
balance |
balance |
metric |
|
behavior_name |
behavior_id |
The unique identifier for a specific user behavior targeted or observed. |
metric |
bid |
bid |
The bid amount set for the ad group or campaign. |
metric |
bid_display_mode |
bid_display_mode |
The display mode for bids set at the ad group level. |
dimension |
bid_price |
bid_price |
The specific bid price set for optimization goals. |
metric |
bid_secondary_goal |
bid_secondary_goal |
metric |
|
bid_strategy |
bid_strategy |
The bidding strategy employed for the ad group or campaign (e.g., lowest cost, cost cap). |
dimension |
bid_type |
bid_type |
The type of bidding strategy used, such as CPC, CPM, or oCPC. |
dimension |
billed_cost |
billed_cost |
The actual cost incurred for the ads, which has been billed. |
metric |
billing_event |
billing_event |
The event type on which billing is based (e.g., clicks, impressions). |
dimension |
brand |
brand |
The brand name associated with the advertising campaign. |
dimension |
brand_safety_partner |
brand_safety_partner |
dimension |
|
brand_safety_postbid_partner |
brand_safety_postbid_partner |
The third-party partner used for post-bid brand safety measurement. |
dimension |
brand_safety_type |
brand_safety_type |
The type of brand safety applied to the ad group. |
dimension |
brand_safety_vast_url |
brand_safety_vast_url |
The VAST URL used by a post-bid third-party partner to measure brand safety. |
dimension |
branded_content_disabled |
branded_content_disabled |
dimension |
|
budget |
budget |
The allocated budget for a campaign or ad group. |
metric |
budget_mode |
budget_mode |
The mode in which the budget is managed (e.g., daily, lifetime, infinite). |
dimension |
budget_optimize_on |
budget_optimize_on |
dimension |
|
budget_type |
budget_type |
The type of budget set for a campaign or ad group (e.g., daily, total). |
dimension |
button_click |
button_click |
The number of clicks on a button within the ad creative. |
metric |
button_click_consultation |
button_click_consultation |
The number of clicks on consultation-related buttons within ads. |
metric |
button_click_consultation_rate |
button_click_consultation_rate |
The rate of clicks on consultation-related buttons within ads. |
metric |
button_click_rate |
button_click_rate |
The rate at which users click on buttons within ads. |
metric |
call_to_action |
call_to_action |
The call-to-action text displayed on the ad, prompting users to take a specific action. |
dimension |
call_to_action_id |
call_to_action_id |
The unique identifier for the specific call-to-action button used in the ad. |
dimension |
campaign |
campaign |
The name or identifier of the advertising campaign. |
dimension |
campaign_app_profile_page_state |
campaign_app_profile_page_state |
The state of the app profile page associated with the campaign. |
dimension |
campaign_automation_type |
campaign_automation_type |
The automation type configured for the campaign. |
dimension |
campaign_budget |
campaign_budget |
The budget allocated to the campaign. |
dimension |
campaign_budget_mode |
campaign_budget_mode |
The budget mode for the campaign (e.g., daily, total). |
dimension |
campaign_budget_optimize_on |
campaign_budget_optimize_on |
dimension |
|
campaign_category |
campaign_category |
The category assigned to the campaign. |
dimension |
campaign_channel |
campaign_channel |
dimension |
|
campaign_create_time |
campaign_create_time |
The timestamp when the campaign was created. |
dimension |
campaign_dedicate_type |
campaign_dedicate_type |
The specific type of dedicated campaign, often related to the attribution network (e.g., SAN, SKAN) used for optimizing bids. |
metric |
campaign_deep_bid_type |
campaign_deep_bid_type |
The bidding strategy used for deep conversions or in-app events at the campaign level. |
dimension |
campaign_destination |
campaign_destination |
The landing page or app users are directed to after interacting with the campaign. |
dimension |
campaign_funnel |
campaign_funnel |
dimension |
|
campaign_geo |
campaign_geo |
The geographic targeting or region for the campaign. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the campaign. |
dimension |
campaign_invalid_impressions |
campaign_invalid_impressions |
Impressions from a campaign that are deemed invalid. |
metric |
campaign_invalid_spend |
campaign_invalid_spend |
The amount of money spent on a campaign that was attributed to invalid impressions. |
metric |
campaign_is_new_structure |
campaign_is_new_structure |
Indicates if the campaign belongs to a new advertising structure or system. |
dimension |
campaign_is_smart_performance_campaign |
campaign_is_smart_performance_campaign |
Indicates if the campaign is a Smart Performance Campaign, utilizing automated optimization. |
dimension |
campaign_modify_time |
campaign_modify_time |
The timestamp when the campaign was last modified. |
dimension |
campaign_name |
campaign_name |
The name of the campaign. |
dimension |
campaign_objective |
campaign_objective |
The marketing objective of the campaign (e.g., Reach, Traffic, Conversions). |
dimension |
campaign_objective_type |
campaign_objective_type |
The primary objective of the advertising campaign, such as reach, traffic, or conversions. |
dimension |
campaign_operation_status |
campaign_operation_status |
The current operational status of the campaign, indicating whether it is running, paused, or completed. |
dimension |
campaign_opt_status |
campaign_opt_status |
The optimization status of the campaign. |
dimension |
campaign_optimization_goal |
campaign_optimization_goal |
The goal for optimization set for the campaign. |
dimension |
campaign_product_source |
campaign_product_source |
The source of the products advertised in the campaign, such as a product catalog. |
dimension |
campaign_rf_campaign_type |
campaign_rf_campaign_type |
The type of reach and frequency (RF) campaign. |
dimension |
campaign_roas_bid |
campaign_roas_bid |
The target Return On Ad Spend (ROAS) bid set for the campaign. |
metric |
campaign_secondary_status |
campaign_secondary_status |
The secondary status of the campaign, providing more granular information beyond the primary status. |
dimension |
campaign_special_industries |
campaign_special_industries |
Specifies if the campaign targets or is associated with special industries like Housing, Employment, or Credit. |
dimension |
campaign_split_test_variable |
campaign_split_test_variable |
The variable used for A/B testing or split testing within a campaign. |
dimension |
campaign_status |
campaign_status |
The current operational status of the campaign (e.g., active, paused, deleted). |
dimension |
campaign_type |
campaign_type |
The type of the campaign. |
dimension |
campaign_valid_impressions |
campaign_valid_impressions |
The number of impressions deemed valid for a campaign. |
metric |
campaign_valid_spend |
campaign_valid_spend |
The amount of money spent on a campaign that was attributed to valid impressions. |
metric |
card_id |
card_id |
The unique identifier for the card creative used in the ad. |
dimension |
carousel_image_index |
carousel_image_index |
The index of an image within a carousel ad. |
dimension |
carrier_ids |
carrier_ids |
dimension |
|
cash_spend |
cash_spend |
The total cash amount spent on the ad campaign. |
metric |
catalog_authorized_bc_id |
catalog_authorized_bc_id |
The business center ID authorized to manage the product catalog. |
dimension |
catalog_enabled |
catalog_enabled |
Indicates if a product catalog is enabled for the campaign. |
dimension |
catalog_id |
catalog_id |
The unique identifier for a product catalog used in shopping ads. |
dimension |
catalog_name |
catalog_name |
The name of the product catalog associated with the ad. |
dimension |
category |
category |
The category associated with an ad group or creative. |
dimension |
category_exclusion_ids |
category_exclusion_ids |
dimension |
|
checkout |
checkout |
The number of checkout events attributed to the ad. |
metric |
checkout_rate |
checkout_rate |
The rate at which users complete the checkout process. |
metric |
click_attribution_window |
click_attribution_window |
The time window during which a click can be attributed to a conversion event. |
dimension |
click_tracking_url |
click_tracking_url |
The URL used to track clicks on the ad. |
dimension |
clicks |
clicks |
The total number of clicks on an ad. |
metric |
clicks_on_hashtag_challenge |
clicks_on_hashtag_challenge |
The total number of clicks on the hashtag challenge associated with an ad during its campaign. |
metric |
clicks_on_music_disc |
clicks_on_music_disc |
The number of clicks on the music disc icon within a Spark Ad. |
metric |
comment_disabled |
comment_disabled |
dimension |
|
comments |
comments |
The number of comments on an ad. |
metric |
company |
company |
The name of the company associated with the advertiser account. |
dimension |
complete_payment |
complete_payment |
The number of complete payment events attributed to ads. |
metric |
complete_payment_rate |
complete_payment_rate |
The rate of complete payment events attributed to ads. |
metric |
complete_payment_roas |
complete_payment_roas |
The Return on Ad Spend (ROAS) specifically for complete payment events. |
metric |
complete_payment_value |
complete_payment_value |
The total value of completed payment events. |
metric |
complete_tutorial |
complete_tutorial |
The number of times users have completed a tutorial. |
metric |
complete_tutorial_rate |
complete_tutorial_rate |
The rate at which users complete a tutorial after interacting with an ad. |
metric |
consultation |
consultation |
The number of consultation events. |
metric |
consultation_rate |
consultation_rate |
The rate of consultation events. |
metric |
contextual_tag_ids |
contextual_tag_ids |
dimension |
|
conversion |
conversion |
The total number of conversion events attributed to the ad. |
metric |
conversion_bid_price |
conversion_bid_price |
The bid price specifically set for conversion optimization. |
metric |
conversion_rate |
conversion_rate |
The percentage of users who clicked on your ad and completed a desired action. |
metric |
conversion_rate_v2 |
conversion_rate_v2 |
The rate at which ad interactions lead to a desired conversion event, version 2. |
metric |
conversions |
conversions |
The total number of conversions attributed to the ad. |
metric |
cost |
cost |
The total amount of money spent on advertising. |
metric |
cost_per_1000_reached |
cost_per_1000_reached |
The cost incurred for every 1000 unique users reached by the ad. |
dimension |
cost_per_10_second_live_view |
cost_per_10_second_live_view |
The average cost incurred for each 10-second view of a live stream ad. |
metric |
cost_per_achieve_level |
cost_per_achieve_level |
The average cost incurred for each achievement level reached. |
metric |
cost_per_add_billing |
cost_per_add_billing |
The average cost incurred for each instance of adding billing information. |
metric |
cost_per_add_payment_info |
cost_per_add_payment_info |
The average cost incurred for each instance of adding payment information. |
metric |
cost_per_add_to_wishlist |
cost_per_add_to_wishlist |
The average cost incurred for each ‘add to wishlist’ event. |
metric |
cost_per_app_event_add_to_cart |
cost_per_app_event_add_to_cart |
The average cost incurred for each in-app ‘add to cart’ event. |
metric |
cost_per_app_install |
cost_per_app_install |
The average cost incurred for each app install. |
metric |
cost_per_button_click |
cost_per_button_click |
The average cost incurred for each button click on an ad. |
metric |
cost_per_button_click_consultation |
cost_per_button_click_consultation |
The average cost incurred for each click on a consultation button. |
metric |
cost_per_checkout |
cost_per_checkout |
The average cost incurred for each completed checkout. |
metric |
cost_per_complete_payment |
cost_per_complete_payment |
The average cost incurred for each completed payment. |
metric |
cost_per_complete_tutorial |
cost_per_complete_tutorial |
The average cost incurred for each tutorial completion. |
metric |
cost_per_consultation |
cost_per_consultation |
The average cost incurred for each consultation event. |
metric |
cost_per_conversion |
cost_per_conversion |
The average cost incurred for each conversion attributed to your ads. |
metric |
cost_per_create_gamerole |
cost_per_create_gamerole |
The average cost incurred for each creation of a game role. |
metric |
cost_per_create_group |
cost_per_create_group |
The average cost incurred for each group creation event. |
metric |
cost_per_cta_app_install |
cost_per_cta_app_install |
The average cost incurred for each app install resulting from a Call To Action (CTA). |
metric |
cost_per_cta_conversion |
cost_per_cta_conversion |
The average cost incurred for each conversion resulting from a Call To Action (CTA). |
metric |
cost_per_cta_purchase |
cost_per_cta_purchase |
The average cost for each payment event attributed to clicks on a Call-to-Action. |
metric |
cost_per_cta_registration |
cost_per_cta_registration |
The average cost incurred for each registration resulting from a Call To Action (CTA). |
metric |
cost_per_custom_app_event |
cost_per_custom_app_event |
The average cost incurred for each custom in-app event. |
metric |
cost_per_custom_page_event |
cost_per_custom_page_event |
The average cost incurred for each custom page event on a website. |
metric |
cost_per_download_button |
cost_per_download_button |
The average cost incurred for each click on a download button. |
metric |
cost_per_download_detail |
cost_per_download_detail |
The average cost incurred for each view of download details. |
metric |
cost_per_download_start |
cost_per_download_start |
The average cost incurred for each download start event. |
metric |
cost_per_engaged_view_through_conversion |
cost_per_engaged_view_through_conversion |
The average cost incurred for each conversion attributed to an engaged view-through. |
metric |
cost_per_form |
cost_per_form |
The average cost incurred for each form submission. |
metric |
cost_per_form_button |
cost_per_form_button |
The average cost incurred for each click on a form submission button. |
metric |
cost_per_form_detail |
cost_per_form_detail |
The average cost incurred for each view of form details. |
metric |
cost_per_in_app_ad_click |
cost_per_in_app_ad_click |
The average cost incurred for each click on an ad displayed within an app. |
metric |
cost_per_in_app_ad_impr |
cost_per_in_app_ad_impr |
The average cost incurred for each impression of an ad displayed within an app. |
metric |
cost_per_initiate_checkout |
cost_per_initiate_checkout |
The average cost incurred for each initiated checkout process. |
metric |
cost_per_join_group |
cost_per_join_group |
The average cost incurred for each group join event. |
metric |
cost_per_landing_page_view |
cost_per_landing_page_view |
The average cost incurred for each landing page view. |
metric |
cost_per_launch_app |
cost_per_launch_app |
The average cost incurred for each app launch. |
metric |
cost_per_live_view |
cost_per_live_view |
The average cost incurred for each view of a live stream ad. |
metric |
cost_per_loan_apply |
cost_per_loan_apply |
The average cost incurred for each loan application. |
metric |
cost_per_loan_credit |
cost_per_loan_credit |
The average cost incurred for each loan credit event. |
metric |
cost_per_loan_disbursement |
cost_per_loan_disbursement |
The average cost incurred for each loan disbursement. |
metric |
cost_per_login |
cost_per_login |
The average cost incurred for each user login. |
metric |
cost_per_next_day_open |
cost_per_next_day_open |
The average cost incurred for each app open on the day following installation. |
metric |
cost_per_offline_add_to_cart_event |
cost_per_offline_add_to_cart_event |
The average cost incurred for each offline ‘add to cart’ event. |
metric |
cost_per_offline_contact_event |
cost_per_offline_contact_event |
The average cost incurred for each offline ‘contact’ event. |
metric |
cost_per_offline_form_event |
cost_per_offline_form_event |
The average cost incurred for each offline ‘form submission’ event. |
metric |
cost_per_offline_search_event |
cost_per_offline_search_event |
The cost incurred for each offline search event. |
metric |
cost_per_offline_subscribe_event |
cost_per_offline_subscribe_event |
The average cost incurred for each offline ‘subscribe’ event. |
metric |
cost_per_on_web_add_to_wishlist |
cost_per_on_web_add_to_wishlist |
The average cost incurred for each ‘add to wishlist’ event that occurred on the website. |
metric |
cost_per_on_web_order |
cost_per_on_web_order |
The average cost incurred for each order placed on a website. |
metric |
cost_per_on_web_subscribe |
cost_per_on_web_subscribe |
The average cost incurred for each ‘subscribe’ event that occurred on the website. |
metric |
cost_per_online_consult |
cost_per_online_consult |
The average cost incurred for each online consultation event attributed to your ads. |
metric |
cost_per_onsite_form |
cost_per_onsite_form |
The average cost incurred for each form submission event on the advertiser’s website. |
metric |
cost_per_onsite_initiate_checkout_count |
cost_per_onsite_initiate_checkout_count |
The average cost incurred for each ‘initiate checkout’ event that occurred on the advertiser’s website. |
metric |
cost_per_onsite_on_web_cart |
cost_per_onsite_on_web_cart |
The average cost incurred for each ‘add to cart’ event that occurred on the advertiser’s website. |
metric |
cost_per_onsite_on_web_detail |
cost_per_onsite_on_web_detail |
The average cost incurred for each ‘view product detail’ event that occurred on the advertiser’s website. |
metric |
cost_per_order |
cost_per_order |
The average cost incurred for each order. |
metric |
cost_per_page_browse_consultation |
cost_per_page_browse_consultation |
The average cost incurred for each page browse resulting in a consultation, attributed to your ads. |
metric |
cost_per_page_browse_view |
cost_per_page_browse_view |
The average cost incurred for each page browse view event attributed to your ads. |
metric |
cost_per_page_event_search |
cost_per_page_event_search |
The average cost incurred for each search event on a landing page. |
metric |
cost_per_pageview |
cost_per_pageview |
The average cost incurred for each page view attributed to the ad. |
metric |
cost_per_product_details_page_browse |
cost_per_product_details_page_browse |
The average cost incurred for each view of a product details page, attributed to your ads. |
metric |
cost_per_purchase |
cost_per_purchase |
The average cost incurred for each purchase. |
metric |
cost_per_ratings |
cost_per_ratings |
The average cost incurred for each rating event attributed to your ads. |
metric |
cost_per_registration |
cost_per_registration |
The average cost incurred for each user registration event attributed to your ads. |
metric |
cost_per_result |
cost_per_result |
The average cost incurred for each desired result (e.g., conversion, click) achieved by your ads. |
metric |
cost_per_sales_lead |
cost_per_sales_lead |
The average cost incurred for generating a sales lead, attributed to your ads. |
metric |
cost_per_search |
cost_per_search |
The average cost incurred for each search action. |
metric |
cost_per_secondary_goal_result |
cost_per_secondary_goal_result |
The average cost incurred for each achievement of a secondary goal result, attributed to your ads. |
dimension |
cost_per_spend_credits |
cost_per_spend_credits |
The average cost incurred for each instance where a user spends credits, attributed to your ads. |
metric |
cost_per_start_trial |
cost_per_start_trial |
The average cost incurred for each trial initiation, attributed to your ads. |
metric |
cost_per_subscribe |
cost_per_subscribe |
The average cost incurred for each subscription event, attributed to your ads. |
metric |
cost_per_total_achieve_level |
cost_per_total_achieve_level |
The cost incurred for each instance where a user achieved a certain level within an app or game, attributed to the ad. |
metric |
cost_per_total_add_to_wishlist |
cost_per_total_add_to_wishlist |
The average cost incurred for each total add-to-wishlist event attributed to your ads. |
metric |
cost_per_total_app_event_add_to_cart |
cost_per_total_app_event_add_to_cart |
The average cost incurred for each ‘add to cart’ app event. |
metric |
cost_per_total_checkout |
cost_per_total_checkout |
The average cost incurred for each total checkout completion event attributed to your ads. |
metric |
cost_per_total_complete_tutorial |
cost_per_total_complete_tutorial |
The average cost incurred for each total tutorial completion event attributed to your ads. |
metric |
cost_per_total_create_gamerole |
cost_per_total_create_gamerole |
The average cost per app create role action attributed to your ads. |
metric |
cost_per_total_create_group |
cost_per_total_create_group |
The average cost per app create group action attributed to your ads. |
metric |
cost_per_total_in_app_ad_click |
cost_per_total_in_app_ad_click |
The average cost incurred for each total in-app ad click event attributed to your ads. |
metric |
cost_per_total_in_app_ad_impr |
cost_per_total_in_app_ad_impr |
The average cost incurred for each total in-app ad impression event attributed to your ads. |
metric |
cost_per_total_join_group |
cost_per_total_join_group |
The average cost per app join group action attributed to your ads. |
metric |
cost_per_total_launch_app |
cost_per_total_launch_app |
The average cost incurred for each total app launch event attributed to your ads. |
metric |
cost_per_total_loan_apply |
cost_per_total_loan_apply |
The average cost incurred for each total loan application event attributed to your ads. |
metric |
cost_per_total_loan_credit |
cost_per_total_loan_credit |
The average cost per app loan approval action attributed to your ads. |
metric |
cost_per_total_loan_disbursement |
cost_per_total_loan_disbursement |
The average cost per app loan disbursal action attributed to your ads. |
metric |
cost_per_total_login |
cost_per_total_login |
The average cost incurred for each total user login event attributed to your ads. |
metric |
cost_per_total_next_day_open |
cost_per_total_next_day_open |
The average cost per Day 1 retention attributed to your ad. |
metric |
cost_per_total_purchase |
cost_per_total_purchase |
The average cost incurred for each total purchase event attributed to your ads. |
metric |
cost_per_total_ratings |
cost_per_total_ratings |
The average cost incurred for each total rating event attributed to your ads. |
metric |
cost_per_total_registration |
cost_per_total_registration |
The average cost incurred for each total user registration event attributed to your ads. |
metric |
cost_per_total_sales_lead |
cost_per_total_sales_lead |
The average cost incurred for each total sales lead generated, attributed to your ads. |
metric |
cost_per_total_search |
cost_per_total_search |
The average cost incurred for all search actions. |
metric |
cost_per_total_spend_credits |
cost_per_total_spend_credits |
The average cost incurred for each total spend credits event attributed to your ads. |
metric |
cost_per_total_start_trial |
cost_per_total_start_trial |
The average cost incurred for each total trial initiation, attributed to your ads. |
metric |
cost_per_total_subscribe |
cost_per_total_subscribe |
The average cost incurred for each total subscription event, attributed to your ads. |
metric |
cost_per_total_unlock_achievement |
cost_per_total_unlock_achievement |
The average cost per app unlock achievement action attributed to your ads. |
metric |
cost_per_total_view_content |
cost_per_total_view_content |
The average cost incurred for all content view events. |
metric |
cost_per_unique_ad_impression_event |
cost_per_unique_ad_impression_event |
The average cost incurred for each unique ad impression event. |
metric |
cost_per_unique_custom_app_event |
cost_per_unique_custom_app_event |
The cost incurred per unique custom app event. |
metric |
cost_per_unlock_achievement |
cost_per_unlock_achievement |
The average cost per unique app unlock achievement action attributed to your ads. |
metric |
cost_per_user_registration |
cost_per_user_registration |
The average cost incurred for each user registration event attributed to your ads. |
metric |
cost_per_view_content |
cost_per_view_content |
The average cost incurred for each view content event. |
metric |
cost_per_vta_conversion |
cost_per_vta_conversion |
The average cost incurred for each view-through conversion, where a user converts after viewing an ad without clicking on it. |
metric |
cost_per_vta_purchase |
cost_per_vta_purchase |
The average cost incurred for each view-through purchase, where a user purchases after viewing an ad without clicking on it. |
metric |
cost_per_vta_registration |
cost_per_vta_registration |
The average cost incurred for each view-through registration, where a user registers after viewing an ad without clicking on it. |
metric |
cost_per_web_event_add_to_cart |
cost_per_web_event_add_to_cart |
The average cost incurred for each ‘add to cart’ web event. |
metric |
cost_total_add_payment_info |
cost_total_add_payment_info |
The total cost incurred for users initiating adding payment information, attributed to the ad. |
metric |
cost_usd |
cost_usd |
The total cost incurred in United States Dollars (USD) for the advertising entity. |
metric |
costs |
costs |
The total cost or spend for the ad, ad group, or campaign. |
metric |
countdown_sticker_recall_clicks |
countdown_sticker_recall_clicks |
metric |
|
country |
country |
The country associated with the ad account or targeted by the ad. |
dimension |
country_code |
country_code |
The two-letter ISO 3166-1 code for the country associated with the advertiser or targeted by the ad. |
dimension |
cpc |
cpc |
Cost Per Click, the average cost for each click on your ad. |
metric |
cpm |
cpm |
Cost Per Mille, the average cost for 1000 impressions of your ad. |
metric |
cpv_video_duration |
cpv_video_duration |
The video duration threshold for Cost Per View (CPV) billing at the ad group level. |
dimension |
create_gamerole |
create_gamerole |
The number of unique app create role actions attributed to your ads. |
metric |
create_gamerole_rate |
create_gamerole_rate |
The percentage of app create role actions from all app installs attributed to your ads. |
metric |
create_group |
create_group |
The number of unique app create group actions attributed to your ads. |
metric |
create_group_rate |
create_group_rate |
The percentage of app create group actions from all app installs attributed to your ads. |
metric |
create_time |
create_time |
The timestamp when the object (e.g., campaign, ad group) was created. |
dimension |
creative_authorized |
creative_authorized |
Indicates if the creative is authorized for use or display in the TikTok Creative Center. |
dimension |
creative_delivery_status |
creative_delivery_status |
The current delivery status of a creative asset. |
dimension |
creative_material_mode |
creative_material_mode |
The mode or type of creative material used in the ad. |
dimension |
creative_preview_final_url |
creative_preview_final_url |
The URL for a preview of the ad creative or its final landing page. |
dimension |
creative_type |
creative_type |
The format or type of the ad creative, such as single image, video, or carousel. |
dimension |
cta_app_install |
cta_app_install |
The number of app installs triggered by a Call To Action (CTA). |
metric |
cta_conversion |
cta_conversion |
The number of conversions triggered by a Call To Action (CTA). |
metric |
cta_purchase |
cta_purchase |
The number of purchases attributed to clicks on a Call-to-Action button. |
metric |
cta_registration |
cta_registration |
The number of registrations triggered by a Call To Action (CTA). |
metric |
ctr |
ctr |
Click-Through Rate, the percentage of users who click on your ad after seeing it. |
metric |
currency |
currency |
The currency in which the financial data is reported. |
dimension |
custom_app_event_rate |
custom_app_event_rate |
The rate at which users complete custom in-app events. |
metric |
custom_app_events |
custom_app_events |
The total number of custom events that occurred within an app, attributed to ads. |
metric |
custom_app_events_value |
custom_app_events_value |
The total monetary value associated with custom in-app events. |
metric |
custom_event_type |
custom_event_type |
The user-defined type or name of a custom event tracked for conversion or action monitoring. |
dimension |
custom_page_event_rate |
custom_page_event_rate |
The rate at which users complete custom page events on a website. |
metric |
custom_page_events |
custom_page_events |
The total number of custom events that occurred on a webpage, attributed to ads. |
metric |
custom_page_events_value |
custom_page_events_value |
The total monetary value associated with custom webpage events. |
metric |
dark_post_status |
dark_post_status |
The status of a ‘dark post’ ad, which is an unpublished post used for advertising. |
dimension |
date |
date |
The date for which the data is reported. |
dimension |
date_start |
date_start |
The start date of the reporting period for the ad or campaign. |
dimension |
date_stop |
date_stop |
The end date of the reporting period for the ad or campaign. |
dimension |
datetime |
datetime |
The date and time for which the data is reported. |
dimension |
day |
day |
The day for which the data is reported. |
dimension |
dayofweek |
dayofweek |
The day of the week when the ad data was recorded. |
dimension |
dayparting |
dayparting |
metric |
|
deep_bid_type |
deep_bid_type |
dimension |
|
deep_cpa_bid |
deep_cpa_bid |
metric |
|
deeplink |
deeplink |
The deeplink URL that directs users to specific content within an app. |
dimension |
deeplink_format_type |
deeplink_format_type |
Specifies the format type of the deep link used in the ad. |
dimension |
deeplink_type |
deeplink_type |
The type of deeplink used for the ad. |
dimension |
deeplink_utm_params |
deeplink_utm_params |
A list of UTM parameters appended to deep links for tracking campaign performance. |
dimension |
delivery_mode |
delivery_mode |
The delivery mode for an ad group, affecting how ads are served. |
dimension |
description |
description |
A textual description of the campaign, ad group, or ad. |
dimension |
destination |
destination |
The target URL or application where users are directed after interacting with the ad. |
dimension |
destination_type |
destination_type |
The type of destination, such as website, app, or instant experience. |
dimension |
device |
device |
The type of device on which the ad was displayed (e.g., mobile, tablet). |
dimension |
device_brand_id |
device_brand_id |
The identifier for the brand of the device on which the ad was displayed. |
dimension |
device_brand_name |
device_brand_name |
The name of the brand of the device on which the ad was displayed. |
dimension |
device_category |
device_category |
The category of device (e.g., mobile, desktop) on which the ad was displayed. |
dimension |
device_model_ids |
device_model_ids |
The IDs of specific device models targeted by the campaign or ad group. |
dimension |
device_price_ranges |
device_price_ranges |
dimension |
|
device_type |
device_type |
The specific type or brand of device used by the audience viewing the ad. |
dimension |
disable_skan_campaign |
disable_skan_campaign |
Indicates if the SKAdNetwork campaign tracking is disabled. |
dimension |
disclaimer_clickable_texts |
disclaimer_clickable_texts |
A list of clickable text elements and their corresponding URLs for disclaimers in the ad. |
dimension |
disclaimer_text |
disclaimer_text |
The text content of a standard disclaimer displayed in the ad, with a maximum of 90 characters. |
dimension |
disclaimer_type |
disclaimer_type |
The type of disclaimer used in the ad, such as standard, clickable, or AI-generated content. |
dimension |
discount_amount |
discount_amount |
dimension |
|
discount_percentage |
discount_percentage |
dimension |
|
discount_type |
discount_type |
dimension |
|
display_name |
display_name |
The user-friendly name for a field or entity. |
dimension |
display_timezone |
display_timezone |
The timezone used for displaying report data. |
dimension |
dma_id |
dma_id |
The identifier for the Designated Market Area (DMA) where the ad was shown. |
dimension |
dma_name |
dma_name |
The name of the Designated Market Area (DMA) where the ad was shown. |
dimension |
download_button |
download_button |
The number of clicks on a download button in the ad. |
metric |
download_button_rate |
download_button_rate |
The rate at which users click on a download button in the ad. |
metric |
download_detail_rate |
download_detail_rate |
The rate at which users download something after interacting with an ad. |
metric |
download_start |
download_start |
The number of times a download initiated after ad interaction. |
metric |
download_start_rate |
download_start_rate |
The percentage of download start actions from all app installs attributed to your ads. |
metric |
dpa_target_audience_type |
dpa_target_audience_type |
The target audience type for Dynamic Product Ads (DPA). |
metric |
duet_clicks |
duet_clicks |
The number of clicks on the ‘Duet’ button associated with an ad. |
metric |
duration |
duration |
The duration of the video or audio creative in seconds. |
metric |
dynamic_destination |
dynamic_destination |
The dynamic destination setting for ads, which can include dynamic landing pages. |
dimension |
dynamic_format |
dynamic_format |
The dynamic format used for ad creatives, often for dynamic product ads. |
dimension |
engaged_view |
engaged_view |
The number of engaged views on a video ad. |
dimension |
engaged_view_15s |
engaged_view_15s |
The number of times a video has been played at least 15 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad. |
metric |
engaged_view_attribution_window |
engaged_view_attribution_window |
The time window during which an engaged view can be attributed to a conversion. |
dimension |
engaged_view_through_conversions |
engaged_view_through_conversions |
The number of conversions attributed to users who saw an ad and engaged with it without clicking, within the attribution window. |
metric |
engagement_rate |
engagement_rate |
The percentage of engagements (likes, comments, shares, follows, clicks) an ad receives relative to its impressions. |
metric |
engagements |
engagements |
The total number of engagements with the ad (e.g., likes, comments, shares). |
metric |
engagements_total |
engagements_total |
The total number of user engagements with the ad, such as clicks, likes, or shares. |
metric |
event_name |
event_name |
The name of a specific event tracked by the TikTok Ads platform. |
dimension |
events |
events |
The total number of occurrences for a specific event. |
metric |
excluded_audience_ids |
excluded_audience_ids |
The IDs of audience segments that are explicitly excluded from targeting. |
dimension |
excluded_custom_actions |
excluded_custom_actions |
dimension |
|
fallback_type |
fallback_type |
The fallback mechanism or type used when a primary ad action or destination fails. |
dimension |
feed_type |
feed_type |
The type of feed associated with the ad group. |
dimension |
flight_type |
flight_type |
dimension |
|
follows |
follows |
The number of new followers gained due to the ad. |
metric |
form |
form |
The number of form submission events. |
dimension |
form_button |
form_button |
The number of times users clicked a form button, attributed to your ads. |
metric |
form_button_rate |
form_button_rate |
The rate at which users clicked a form button, attributed to your ads. |
metric |
form_detail |
form_detail |
The number of details page browse events from forms. |
metric |
form_detail_rate |
form_detail_rate |
The rate at which users complete or engage with details on a form, typically used for lead generation ads. |
metric |
form_fills |
form_fills |
The total number of form submissions attributed to ad interactions. |
metric |
form_rate |
form_rate |
The percentage of website lead actions from all clicks attributed to your ads. |
metric |
format |
format |
The format of the ad creative (e.g., single image, video, carousel). |
dimension |
format_type |
format_type |
dimension |
|
frequency |
frequency |
The average number of times an ad was shown to a unique user. |
metric |
frequency_lifetime |
frequency_lifetime |
The average number of times each unique user saw your ads over the entire lifetime of the campaign. |
metric |
frequency_mtd |
frequency_mtd |
The average number of times a unique user has seen your ad, measured from the beginning of the month to the current date. |
metric |
frequency_schedule |
frequency_schedule |
The schedule or settings for ad frequency capping. |
metric |
gender |
gender |
The gender of the targeted audience or users who engaged with the ad. |
dimension |
gross_impressions |
gross_impressions |
The total number of times an ad was shown. |
dimension |
gross_revenue |
gross_revenue |
The total revenue generated before any deductions. |
metric |
household_income |
household_income |
dimension |
|
identity_authorized_bc_id |
identity_authorized_bc_id |
The ID of the Business Center authorized for the ad’s identity. |
dimension |
identity_id |
identity_id |
The unique identifier for the identity (e.g., brand profile) associated with the ad. |
dimension |
identity_type |
identity_type |
The type of identity (e.g., TikTok account, business profile) used to represent the advertiser in the ad. |
dimension |
image_id |
image_id |
The unique identifier for an image creative used in an ad. |
dimension |
image_ids |
image_ids |
A list of unique identifiers for images used in the ad creative. |
dimension |
impression_tracking_url |
impression_tracking_url |
The URL used to track impressions for the ad. |
dimension |
impressions |
impressions |
The total number of times an ad was shown. |
metric |
in_app_ad_click |
in_app_ad_click |
The number of clicks on an ad within an application. |
metric |
in_app_ad_click_rate |
in_app_ad_click_rate |
The rate at which users clicked on an in-app ad, attributed to your ads. |
metric |
in_app_ad_impr |
in_app_ad_impr |
The number of unique in-app ad impression events attributed to your ads. |
metric |
in_app_ad_impr_rate |
in_app_ad_impr_rate |
The rate at which in-app ads were displayed (impressions), attributed to your ads. |
metric |
included_custom_actions |
included_custom_actions |
dimension |
|
industry |
industry |
metric |
|
initiate_checkout |
initiate_checkout |
The number of times a user started the checkout process after interacting with an ad. |
metric |
initiate_checkout_rate |
initiate_checkout_rate |
The rate at which users initiated a checkout process, attributed to your ads. |
metric |
installs |
installs |
The total number of app installs attributed to the ad. |
metric |
interactive_add_on_activity_clicks |
interactive_add_on_activity_clicks |
The number of clicks on interactive add-ons within the ad, such as polls, quizzes, or other engagement features. |
metric |
interactive_add_on_destination_clicks |
interactive_add_on_destination_clicks |
The number of clicks on destinations linked from interactive add-ons within the ad. |
metric |
interactive_add_on_impressions |
interactive_add_on_impressions |
The number of impressions for interactive add-ons in an ad. |
metric |
interactive_add_on_option_a_clicks |
interactive_add_on_option_a_clicks |
The number of clicks on option A of an interactive add-on in an ad. |
metric |
interactive_add_on_option_b_clicks |
interactive_add_on_option_b_clicks |
The number of clicks on option B of an interactive add-on in an ad. |
metric |
interest_category |
interest_category |
The broad category of user interests targeted by the ad group. |
metric |
interest_category_ids |
interest_category_ids |
The IDs of interest categories targeted by the campaign or ad group. |
dimension |
interest_category_name |
interest_category_name |
The name of the interest category targeted. |
dimension |
interest_category_tier2 |
interest_category_tier2 |
A second-tier category for audience interest targeting. |
metric |
interest_category_tier3 |
interest_category_tier3 |
The third-tier interest category for audience targeting. |
metric |
interest_category_tier4 |
interest_category_tier4 |
The fourth tier of a specific interest category targeted by the ad. |
metric |
interest_keyword_ids |
interest_keyword_ids |
dimension |
|
inventory_filter_enabled |
inventory_filter_enabled |
dimension |
|
ios14_quota_type |
ios14_quota_type |
The type of iOS 14 quota for campaign measurement. |
dimension |
ios14_targeting |
ios14_targeting |
Indicates if the campaign is optimized or configured for iOS 14 targeting. |
dimension |
is_aco |
is_aco |
Indicates whether Automated Creative Optimization (ACO) is enabled for the ad. |
metric |
is_advanced_dedicated_campaign |
is_advanced_dedicated_campaign |
dimension |
|
is_new_structure |
is_new_structure |
Indicates if the campaign uses the new campaign structure. |
dimension |
is_search_campaign |
is_search_campaign |
dimension |
|
is_smart_creative |
is_smart_creative |
metric |
|
is_smart_performance_campaign |
is_smart_performance_campaign |
dimension |
|
isp_ids |
isp_ids |
dimension |
|
item_duet_status |
item_duet_status |
The duet status of the TikTok item used in the ad creative. |
dimension |
item_group_id |
item_group_id |
The identifier for a group of items within a product catalog. |
dimension |
item_group_ids |
item_group_ids |
A list of identifiers used to group product variants, helping to optimize ad recommendations. |
dimension |
item_id |
item_id |
The unique identifier for a specific item within a product catalog. |
dimension |
item_stitch_status |
item_stitch_status |
The stitch status of the TikTok item used in the ad creative. |
dimension |
ix_average_video_play |
ix_average_video_play |
The average duration of video playback. |
metric |
ix_button_click_count |
ix_button_click_count |
The total number of clicks on buttons within an Instant Experience ad. |
metric |
ix_page_duration_avg |
ix_page_duration_avg |
Average duration users spent on a webpage after interacting with an ad. This is a page event metric. |
metric |
ix_page_view_count |
ix_page_view_count |
The total number of page views within an Instant Experience ad. |
metric |
ix_product_click_count |
ix_product_click_count |
The total number of clicks on products displayed within an Instant Experience ad. |
metric |
ix_video_views |
ix_video_views |
The number of video views within an Instant Experience ad. |
metric |
ix_video_views_p100 |
ix_video_views_p100 |
The number of interactive video views completed 100%. |
metric |
ix_video_views_p25 |
ix_video_views_p25 |
The number of interactive video views completed 25%. |
metric |
ix_video_views_p50 |
ix_video_views_p50 |
The number of interactive video views completed 50%. |
metric |
ix_video_views_p75 |
ix_video_views_p75 |
The number of interactive video views completed 75%. |
metric |
join_group |
join_group |
The number of times users joined a group or community after interacting with an ad. |
metric |
join_group_rate |
join_group_rate |
The percentage of app join group actions from all app installs attributed to your ads. |
metric |
landing_page_url |
landing_page_url |
The URL of the landing page where users are directed after clicking the ad. |
dimension |
landing_page_view_rate |
landing_page_view_rate |
The percentage of users who viewed the landing page after interacting with an ad. |
metric |
language |
language |
The primary language of the advertiser or the ad. |
dimension |
languages |
languages |
A list of languages targeted by the ad or campaign. |
dimension |
launch_app |
launch_app |
The number of times users launched the app, attributed to your ads. |
metric |
launch_app_rate |
launch_app_rate |
The rate at which users launched the app, attributed to your ads. |
metric |
likes |
likes |
The number of likes on an ad. |
metric |
link_clicks |
link_clicks |
The number of clicks on your ad that directed users to a destination, such as your website or app. |
metric |
live_duration |
live_duration |
The total duration of live streams associated with ads. |
dimension |
live_effective_views |
live_effective_views |
The number of times viewers visited your LIVE for more than 10 seconds. Revisits are counted. |
metric |
live_follows |
live_follows |
The number of new followers gained during live stream ads. |
metric |
live_launched_time |
live_launched_time |
The timestamp when a live stream associated with an ad was launched. |
dimension |
live_name |
live_name |
The name or title of the live stream associated with an ad. |
dimension |
live_product_clicks |
live_product_clicks |
The number of times viewers clicked a product and viewed its details page during a LIVE ad. |
metric |
live_status |
live_status |
The current status of a live stream associated with an ad (e.g., live, ended). |
dimension |
live_unique_views |
live_unique_views |
The number of unique viewers who entered your LIVE stream. |
metric |
live_views |
live_views |
The total number of times viewers visited your LIVE stream. Revisits are counted. |
metric |
loan_apply |
loan_apply |
The number of unique app loan application actions attributed to your ads. |
metric |
loan_apply_rate |
loan_apply_rate |
The rate at which users applied for a loan, attributed to your ads. |
metric |
loan_credit |
loan_credit |
The number of unique app loan approval actions attributed to your ads. |
metric |
loan_credit_rate |
loan_credit_rate |
The percentage of app loan approval actions from all app installs attributed to your ads. |
metric |
loan_disbursement |
loan_disbursement |
The number of unique app loan disbursal actions attributed to your ads. |
metric |
loan_disbursement_rate |
loan_disbursement_rate |
The percentage of app loan disbursal actions from all app installs attributed to your ads. |
metric |
location_ids |
location_ids |
The IDs of geographic locations targeted by the campaign or ad group. |
dimension |
login |
login |
The number of times users have logged into an application or service. |
metric |
login_rate |
login_rate |
The rate at which users logged in, attributed to your ads. |
metric |
market |
market |
The specific geographic or demographic market targeted by the ad. |
dimension |
market_name |
market_name |
The name of the market where the ad is served. |
dimension |
material_id |
material_id |
The unique identifier for an ad material or asset. |
dimension |
max_delivery_budget |
max_delivery_budget |
The maximum budget allowed for ad delivery. |
metric |
media_channel |
media_channel |
dimension |
|
media_channel_group |
media_channel_group |
dimension |
|
media_platform_id |
media_platform_id |
dimension |
|
min_android_version |
min_android_version |
The minimum Android operating system version targeted. |
dimension |
min_ios_version |
min_ios_version |
The minimum iOS operating system version targeted. |
dimension |
mobile_app_id |
mobile_app_id |
The unique identifier of the mobile application. |
dimension |
modify_time |
modify_time |
The timestamp indicating when the ad, ad group, or campaign was last modified. |
dimension |
music_id |
music_id |
The unique identifier for the music or audio track used in the ad creative. |
dimension |
name |
name |
The name of the campaign, ad group, or ad. |
dimension |
net_cost |
net_cost |
The total advertising cost after any deductions or adjustments. |
metric |
network_types |
network_types |
The network types (e.g., Wi-Fi, mobile data) targeted by the campaign. |
dimension |
next_day_open |
next_day_open |
The number of unique Day 1 retentions attributed to your ads. |
metric |
next_day_open_rate |
next_day_open_rate |
The percentage of unique Day 1 retentions out of all app install events. |
metric |
next_day_retention |
next_day_retention |
dimension |
|
num_ads |
num_ads |
The total number of ads within a campaign or ad group. |
metric |
objective |
objective |
The primary advertising objective for the campaign or ad group (e.g., reach, conversions). |
dimension |
objective_type |
objective_type |
The type of objective set for the campaign or ad group. |
dimension |
offline_add_payment_info_events_value |
offline_add_payment_info_events_value |
The total monetary value generated from offline ‘add payment info’ events attributed to ad interactions. |
metric |
offline_add_to_cart_event_rate |
offline_add_to_cart_event_rate |
The rate of offline add-to-cart events, indicating users adding items to their cart outside of online tracking, attributed to your ads. |
metric |
offline_add_to_cart_events |
offline_add_to_cart_events |
The number of offline add to cart events attributed to your ads. |
metric |
offline_add_to_cart_events_value |
offline_add_to_cart_events_value |
The total value of offline add to cart events attributed to your ads. |
metric |
offline_add_to_wishlist_events_value |
offline_add_to_wishlist_events_value |
The total monetary value generated from offline ‘add to wishlist’ events attributed to ad interactions. |
metric |
offline_click_button_events_value |
offline_click_button_events_value |
The total monetary value generated from offline ‘click button’ events attributed to ad interactions. |
metric |
offline_complete_registration_events |
offline_complete_registration_events |
The number of complete registration events recorded offline, attributed to ad interactions. |
metric |
offline_complete_registration_events_value |
offline_complete_registration_events_value |
The total monetary value generated from offline ‘complete registration’ events attributed to ad interactions. |
metric |
offline_contact_event_rate |
offline_contact_event_rate |
The rate at which offline ‘contact’ events occur, attributed to ad interactions. |
metric |
offline_contact_events |
offline_contact_events |
The number of contact events (e.g., phone calls, messages) recorded offline, attributed to ad interactions. |
metric |
offline_contact_events_value |
offline_contact_events_value |
The total monetary value generated from offline ‘contact’ events attributed to ad interactions. |
metric |
offline_download_events |
offline_download_events |
The number of offline download events attributed to your ads. |
metric |
offline_download_events_value |
offline_download_events_value |
The total monetary value generated from offline ‘download’ events attributed to ad interactions. |
metric |
offline_form_event_rate |
offline_form_event_rate |
The rate at which offline ‘form submission’ events occur, attributed to ad interactions. |
metric |
offline_form_events |
offline_form_events |
The number of form submission events recorded offline, attributed to ad interactions. |
metric |
offline_form_events_value |
offline_form_events_value |
The total monetary value generated from offline ‘form submission’ events attributed to ad interactions. |
metric |
offline_initiate_checkout_events |
offline_initiate_checkout_events |
The number of ‘initiate checkout’ events recorded offline, attributed to ad interactions. |
metric |
offline_initiate_checkout_events_value |
offline_initiate_checkout_events_value |
The total monetary value generated from offline ‘initiate checkout’ events attributed to ad interactions. |
metric |
offline_place_order_events |
offline_place_order_events |
The number of ‘place order’ events recorded offline, attributed to ad interactions. |
metric |
offline_place_order_events_value |
offline_place_order_events_value |
The total monetary value generated from offline ‘place order’ events attributed to ad interactions. |
metric |
offline_search_event_rate |
offline_search_event_rate |
The rate at which offline search events occur. |
metric |
offline_search_events |
offline_search_events |
The number of offline search events attributed to the ad campaign. |
metric |
offline_search_events_value |
offline_search_events_value |
The total value generated from offline search events. |
metric |
offline_shopping_events |
offline_shopping_events |
The number of offline shopping events attributed to your ads. |
metric |
offline_shopping_events_roas |
offline_shopping_events_roas |
The Return On Ad Spend (ROAS) generated from offline shopping events. |
metric |
offline_shopping_events_value |
offline_shopping_events_value |
The total value of offline shopping events attributed to your ads. |
metric |
offline_subscribe_event_rate |
offline_subscribe_event_rate |
The rate at which offline ‘subscribe’ events occur, attributed to ad interactions. |
metric |
offline_subscribe_events |
offline_subscribe_events |
The number of ‘subscribe’ events recorded offline, attributed to ad interactions. |
metric |
offline_subscribe_events_value |
offline_subscribe_events_value |
The total monetary value generated from offline ‘subscribe’ events attributed to ad interactions. |
metric |
offline_total_custom_event_value |
offline_total_custom_event_value |
The total monetary value generated from all custom offline events attributed to ad interactions. |
metric |
offline_total_custom_events |
offline_total_custom_events |
The total number of custom offline events tracked. |
metric |
offline_view_content_events |
offline_view_content_events |
The number of offline view content events tracked. |
metric |
offline_view_content_events_value |
offline_view_content_events_value |
The total monetary value generated from offline ‘view content’ events attributed to ad interactions. |
metric |
on_web_add_to_wishlist |
on_web_add_to_wishlist |
The number of ‘add to wishlist’ events that occurred on the website, attributed to ads. |
metric |
on_web_add_to_wishlist_per_click |
on_web_add_to_wishlist_per_click |
The number of ‘add to wishlist’ web events per click. |
metric |
on_web_order |
on_web_order |
The number of order completion events that occurred on the website, attributed to ads. |
metric |
on_web_order_rate |
on_web_order_rate |
The rate of orders placed on the website, attributed to your ads. |
metric |
on_web_subscribe |
on_web_subscribe |
The number of subscription events that occurred on the website, attributed to ads. |
metric |
on_web_subscribe_per_click |
on_web_subscribe_per_click |
metric |
|
online_consult |
online_consult |
The number of online consultation events. |
metric |
online_consult_rate |
online_consult_rate |
The rate at which online consultation events occurred, attributed to your ads. |
metric |
onsite_add_billing |
onsite_add_billing |
The number of onsite add billing events. |
metric |
onsite_add_to_wishlist |
onsite_add_to_wishlist |
The number of onsite add to wishlist events. |
metric |
onsite_download_start |
onsite_download_start |
The number of times an onsite download was initiated. |
metric |
onsite_form |
onsite_form |
The number of onsite form submission events. |
metric |
onsite_form_rate |
onsite_form_rate |
The rate at which form submission events occur on the advertiser’s website, attributed to ad interactions. |
metric |
onsite_initiate_checkout_count |
onsite_initiate_checkout_count |
The number of times users initiated a checkout process directly on the platform (onsite). |
metric |
onsite_initiate_checkout_count_rate |
onsite_initiate_checkout_count_rate |
The rate at which users initiated a checkout process on the advertiser’s website, attributed to ad interactions. |
metric |
onsite_on_web_cart |
onsite_on_web_cart |
The number of onsite add to cart events. |
metric |
onsite_on_web_cart_rate |
onsite_on_web_cart_rate |
The rate at which ‘add to cart’ events occur on the advertiser’s website, attributed to ad interactions. |
metric |
onsite_on_web_detail |
onsite_on_web_detail |
The number of onsite product detail page views. |
metric |
onsite_on_web_detail_rate |
onsite_on_web_detail_rate |
The rate at which ‘view product detail’ events occur on the advertiser’s website, attributed to ad interactions. |
metric |
onsite_purchase_rate |
onsite_purchase_rate |
The rate at which users make purchases on the advertiser’s site after engaging with an ad. |
metric |
onsite_purchases_roas |
onsite_purchases_roas |
The return on ad spend generated from purchases made on the advertiser’s site. |
metric |
onsite_shopping |
onsite_shopping |
The number of user shopping behaviors that occur on your website or app. |
metric |
onsite_shopping_roas |
onsite_shopping_roas |
The Return On Ad Spend (ROAS) generated from shopping activities directly on the platform (onsite). |
metric |
onsite_total_add_to_cart |
onsite_total_add_to_cart |
The total number of “add to cart” actions performed on TikTok-owned properties, attributed to your ads. |
metric |
onsite_total_add_to_cart_value |
onsite_total_add_to_cart_value |
The total monetary value of ‘add to cart’ events that occurred on the advertiser’s website, attributed to ad interactions. |
metric |
onsite_total_checkout_initiation |
onsite_total_checkout_initiation |
The total number of times users initiated a checkout process on the advertiser’s website, attributed to ad interactions. |
metric |
onsite_total_purchase |
onsite_total_purchase |
The total number of purchases completed on the advertiser’s website. |
metric |
onsite_total_purchase_value |
onsite_total_purchase_value |
The total monetary value generated from purchases on the advertiser’s website. |
metric |
onsite_value_per_purchase |
onsite_value_per_purchase |
The average value generated per purchase made on the advertiser’s site. |
metric |
operating_systems |
operating_systems |
The operating systems targeted by the campaign. |
dimension |
operation_status |
operation_status |
The operational status of the entity (e.g., campaign, ad group, ad), such as active, paused, or deleted. |
dimension |
opt_status |
opt_status |
The optimization status of an ad, ad group, or campaign. |
metric |
optimization_event |
optimization_event |
The primary conversion event that the ad group is optimized for. |
dimension |
optimization_goal |
optimization_goal |
The primary goal for ad delivery optimization (e.g., conversions, clicks, reach). |
dimension |
orders |
orders |
The total number of orders placed. |
metric |
owner_bc_id |
owner_bc_id |
dimension |
|
pacing |
pacing |
The budget delivery strategy for an ad group, determining how spend is distributed over time. |
dimension |
page_browse_consultation |
page_browse_consultation |
The number of page browse events leading to a consultation, attributed to your ads. |
metric |
page_browse_consultation_rate |
page_browse_consultation_rate |
The rate of page browse events leading to a consultation, attributed to your ads. |
metric |
page_browse_view |
page_browse_view |
The number of page browse events. |
metric |
page_browse_view_rate |
page_browse_view_rate |
The rate of page browse view events, attributed to your ads. |
metric |
page_content_view_events |
page_content_view_events |
The number of page content view events triggered by ad interactions. |
metric |
page_event_search |
page_event_search |
The number of search events that occurred on a webpage, attributed to ads. |
metric |
page_event_search_rate |
page_event_search_rate |
The rate at which users perform a search action on a landing page. |
metric |
page_id |
page_id |
The unique identifier for a business page or profile associated with the ad. |
dimension |
page_status |
page_status |
The status of the associated application profile page. |
dimension |
paid_engaged_view |
paid_engaged_view |
The number of times a video ad was played for at least 6 seconds or received at least 1 engagement within one day of a user seeing the ad. |
metric |
paid_engaged_view_15s |
paid_engaged_view_15s |
The number of times a video ad was played for at least 15 seconds or received at least 1 engagement within one day of a user seeing the ad. |
metric |
paid_engagement_engaged_view |
paid_engagement_engaged_view |
A view that signifies a certain level of engagement with a paid ad. |
metric |
paid_engagement_engaged_view_15s |
paid_engagement_engaged_view_15s |
The number of paid engagements where a video ad was viewed for at least 15 seconds. |
metric |
pixel_id |
pixel_id |
The unique identifier of the TikTok pixel used for event tracking. |
dimension |
placement |
placement |
The specific location or platform where the ad is displayed. |
dimension |
placement_name |
placement_name |
The name of the placement where the ad is displayed (e.g., TikTok feed, audience network). |
dimension |
placement_type |
placement_type |
The type of placement where the ad is displayed. |
metric |
placements |
placements |
The locations or platforms where the ads are displayed. |
dimension |
platform |
platform |
The operating system or environment where the ad was displayed (e.g., iOS, Android). |
dimension |
platform_buytype |
platform_buytype |
The method of buying ads on the platform, such as auction or reservation. |
dimension |
platform_id |
platform_id |
dimension |
|
platform_name |
platform_name |
The name of the advertising platform where the ad is served. |
dimension |
platform_objective |
platform_objective |
The advertising objective set on the platform for a campaign or ad group. |
dimension |
platform_objectivetype |
platform_objectivetype |
The objective type defined by the advertising platform for the campaign. |
dimension |
playable_url |
playable_url |
The URL for interactive playable ad creatives. |
dimension |
postback_window_mode |
postback_window_mode |
dimension |
|
predict_impression |
predict_impression |
dimension |
|
product_click_rate |
product_click_rate |
The rate at which users click on products shown in ads. |
metric |
product_clicks |
product_clicks |
The total number of clicks on products shown in ads. |
metric |
product_details_page_browse |
product_details_page_browse |
The number of times viewers clicked a product and viewed its details page. |
metric |
product_details_page_browse_rate |
product_details_page_browse_rate |
The rate of product details page browse events, attributed to your ads. |
metric |
product_image_url |
product_image_url |
The URL of the image for a product. |
dimension |
product_impressions |
product_impressions |
The total number of times products were displayed in ads. |
metric |
product_name |
product_name |
The name of the product being advertised. |
dimension |
product_set_id |
product_set_id |
The unique identifier for a product set within a catalog. |
dimension |
product_source |
product_source |
dimension |
|
product_specific_type |
product_specific_type |
The specific type or category of product being advertised. |
dimension |
product_status |
product_status |
The current status of the product in the catalog (e.g., active, out of stock). |
dimension |
profile_image |
profile_image |
metric |
|
profile_image_url |
profile_image_url |
The URL of the profile image displayed with the ad. |
dimension |
profile_visits |
profile_visits |
The number of profile visits attributed to the ad. |
dimension |
profile_visits_rate |
profile_visits_rate |
The rate of profile visits per impression driven by a paid ad, applicable only to Spark Ads. |
metric |
promotion_target_type |
promotion_target_type |
dimension |
|
promotion_type |
promotion_type |
The type of promotion used in a campaign, such as for GMV Max campaigns. |
metric |
promotion_website_type |
promotion_website_type |
dimension |
|
promotional_music_disabled |
promotional_music_disabled |
dimension |
|
province_id |
province_id |
The geographical ID of the province targeted by the ad. |
dimension |
province_name |
province_name |
The name of the province targeted by the ad. |
dimension |
purchase |
purchase |
The number of purchase events attributed to the ad. |
metric |
purchase_intention_keyword_ids |
purchase_intention_keyword_ids |
dimension |
|
purchase_rate |
purchase_rate |
The rate at which users make a purchase after interacting with an ad. |
metric |
purchase_sale_amount |
purchase_sale_amount |
The total sales amount generated from purchases attributed to the ad. |
metric |
purchased_impression |
purchased_impression |
dimension |
|
purchased_reach |
purchased_reach |
The number of unique users reached through purchased ad placements. |
dimension |
purchases |
purchases |
The total number of purchases attributed to the ad. |
metric |
ratings |
ratings |
The number of ratings given by users. |
metric |
ratings_rate |
ratings_rate |
The rate at which users provide ratings or reviews. |
metric |
reach |
reach |
The number of unique users who saw the ad. |
metric |
reach_lifetime |
reach_lifetime |
The number of unique users who saw your ads at least once over the entire lifetime of the campaign. |
metric |
reach_mtd |
reach_mtd |
The number of unique users who saw your ad at least once, measured from the beginning of the month to the current date. |
metric |
real_time_app_install |
real_time_app_install |
The number of app installs reported in near real-time. |
metric |
real_time_app_install_cost |
real_time_app_install_cost |
The real-time cost associated with app installations, attributed to your ads. |
metric |
real_time_conversion |
real_time_conversion |
The number of times your ad achieved an outcome, based on the objective and settings you selected, with count based on when the conversion actually happened. |
metric |
real_time_conversion_rate |
real_time_conversion_rate |
The percentage of real-time conversions received out of all clicks on your ads, calculated based on when the conversion actually happened. |
metric |
real_time_cost_per_conversion |
real_time_cost_per_conversion |
The average amount of money spent on a real-time conversion (Real-time CPA), calculated based on when the conversion actually happened. |
metric |
real_time_cost_per_result |
real_time_cost_per_result |
The average cost for each real-time result from your ads, calculated based on when the conversion actually happened. |
metric |
real_time_result |
real_time_result |
The number of times your ad achieved an outcome based on the optimization goal selected, with count based on when the conversion actually happened. |
metric |
real_time_result_rate |
real_time_result_rate |
The percentage of real-time results achieved out of all views/clicks on your ads, calculated based on when the conversion actually happened. |
metric |
recency |
recency |
dimension |
|
region |
region |
The geographical region targeted by the advertising. |
dimension |
registration |
registration |
The number of registration events attributed to the ad. |
metric |
registration_rate |
registration_rate |
The rate at which users complete a registration after interacting with an ad. |
metric |
rejection_reason |
rejection_reason |
The reason why an ad, ad group, or campaign was rejected. |
dimension |
related_adgroup_ids |
related_adgroup_ids |
dimension |
|
report_id |
report_id |
dimension |
|
result |
result |
The number of times your ad achieved an outcome, based on the optimization goal you selected. |
metric |
result_rate |
result_rate |
The rate at which the campaign achieves its specified result. |
metric |
revenue_events |
revenue_events |
The number of events that generated revenue, attributed to ad interactions. |
metric |
rf_campaign_type |
rf_campaign_type |
The type of Reach and Frequency (RF) campaign. |
metric |
rf_estimated_cpr |
rf_estimated_cpr |
The estimated cost per reach for a Reach and Frequency (RF) campaign. |
metric |
rf_estimated_frequency |
rf_estimated_frequency |
The estimated average number of times a user sees an ad from a reservation campaign. |
metric |
rf_purchased_type |
rf_purchased_type |
The purchased type for a Reach and Frequency (RF) campaign. |
dimension |
roas_bid |
roas_bid |
The target Return On Ad Spend (ROAS) bid. |
metric |
roi |
roi |
The Return On Investment (ROI) from advertising efforts. |
metric |
rta_bid_enabled |
rta_bid_enabled |
Indicates whether Real-Time Bidding (RTA) is enabled for the ad group or campaign. |
dimension |
rta_id |
rta_id |
The unique identifier for Real-Time Bidding (RTA) configuration. |
dimension |
rta_product_selection_enabled |
rta_product_selection_enabled |
Indicates whether product selection for Real-Time Bidding (RTA) is enabled. |
dimension |
run_date |
run_date |
The date when the ad or campaign ran. |
dimension |
run_time |
run_time |
dimension |
|
sales_destination |
sales_destination |
The destination where users are directed to complete a sale or conversion. |
dimension |
sales_lead |
sales_lead |
The number of sales leads generated by the ad campaign. |
metric |
sales_lead_rate |
sales_lead_rate |
The rate at which ads generate sales leads. |
metric |
saved_audience_id |
saved_audience_id |
The ID of a saved audience segment. |
dimension |
schedule_end_time |
schedule_end_time |
The scheduled end date and time for an ad entity (e.g., campaign, ad group). |
dimension |
schedule_infos |
schedule_infos |
dimension |
|
schedule_start_time |
schedule_start_time |
The scheduled start date and time for an ad entity (e.g., campaign, ad group). |
dimension |
schedule_type |
schedule_type |
The type of scheduling applied to an ad entity, such as continuous or specific dates. |
dimension |
scheduled_budget |
scheduled_budget |
metric |
|
search |
search |
The number of search events that are attributed to your ads. |
metric |
search_rate |
search_rate |
The rate at which users perform a search action. |
metric |
search_result_enabled |
search_result_enabled |
dimension |
|
search_terms |
search_terms |
metric |
|
secondary_goal_result |
secondary_goal_result |
The number of times your ad achieved an outcome based on the secondary goal selected. |
dimension |
secondary_goal_result_rate |
secondary_goal_result_rate |
The rate at which secondary goal results were achieved, attributed to your ads. |
dimension |
secondary_optimization_event |
secondary_optimization_event |
The secondary event chosen for campaign optimization. |
dimension |
secondary_status |
secondary_status |
A secondary status for an ad group, providing more granular information beyond the primary status. |
dimension |
share_disabled |
share_disabled |
dimension |
|
shares |
shares |
The number of times an ad was shared. |
metric |
shop_gross_revenue_by_order_submission |
shop_gross_revenue_by_order_submission |
The total gross revenue generated from shop orders that are attributed to ad interactions. |
dimension |
shop_total_items_purchased |
shop_total_items_purchased |
The total number of items purchased via the TikTok Shop integration. |
dimension |
shopping_ads_deeplink_type |
shopping_ads_deeplink_type |
The type of deeplink used specifically for shopping ads. |
dimension |
shopping_ads_fallback_type |
shopping_ads_fallback_type |
The fallback type used for shopping ads when the primary destination is unavailable. |
dimension |
shopping_ads_retargeting_type |
shopping_ads_retargeting_type |
dimension |
|
shopping_ads_type |
shopping_ads_type |
dimension |
|
shopping_ads_video_package_id |
shopping_ads_video_package_id |
The identifier for a video package specifically used in shopping ads. |
dimension |
showcase_products |
showcase_products |
A list of products designated to be featured in a creator’s or advertiser’s showcase. |
dimension |
skan_achieve_level |
skan_achieve_level |
The number of times the “achieve level” event occurred, as reported via SKAdNetwork. |
metric |
skan_achieve_level_rate |
skan_achieve_level_rate |
The rate at which the “achieve level” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_payment_info |
skan_add_payment_info |
The number of times the “add payment info” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_payment_info_rate |
skan_add_payment_info_rate |
The rate at which the “add payment info” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_to_cart |
skan_add_to_cart |
The number of ‘add to cart’ events reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_add_to_cart_rate |
skan_add_to_cart_rate |
The rate at which the “add to cart” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_to_wishlist |
skan_add_to_wishlist |
The number of times the “add to wishlist” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_to_wishlist_rate |
skan_add_to_wishlist_rate |
The rate at which the “add to wishlist” event occurred, as reported via SKAdNetwork. |
metric |
skan_app_install |
skan_app_install |
The number of app installs reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_checkout |
skan_checkout |
The number of ‘checkout’ events reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_checkout_rate |
skan_checkout_rate |
The rate at which the “checkout” event occurred, as reported via SKAdNetwork. |
metric |
skan_complete_tutorial |
skan_complete_tutorial |
The number of times the “complete tutorial” event occurred, as reported via SKAdNetwork. |
metric |
skan_complete_tutorial_rate |
skan_complete_tutorial_rate |
The rate at which the “complete tutorial” event occurred, as reported via SKAdNetwork. |
metric |
skan_conversion |
skan_conversion |
The total number of conversion events reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_conversion_rate |
skan_conversion_rate |
The rate of conversions, as reported via SKAdNetwork. |
metric |
skan_cost_per_achieve_level |
skan_cost_per_achieve_level |
The average cost incurred for each “achieve level” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_add_payment_info |
skan_cost_per_add_payment_info |
The average cost incurred for each “add payment info” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_add_to_cart |
skan_cost_per_add_to_cart |
The average cost incurred for each “add to cart” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_add_to_wishlist |
skan_cost_per_add_to_wishlist |
The average cost incurred for each “add to wishlist” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_app_install |
skan_cost_per_app_install |
The average cost incurred for each app installation, as reported via SKAdNetwork. |
metric |
skan_cost_per_checkout |
skan_cost_per_checkout |
The average cost incurred for each “checkout” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_complete_tutorial |
skan_cost_per_complete_tutorial |
The average cost incurred for each “complete tutorial” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_conversion |
skan_cost_per_conversion |
The average cost incurred for each conversion, as reported via SKAdNetwork. |
metric |
skan_cost_per_create_gamerole |
skan_cost_per_create_gamerole |
The SKAdNetwork-attributed cost for each instance of a user creating a game role. |
metric |
skan_cost_per_create_group |
skan_cost_per_create_group |
The SKAdNetwork-attributed cost for each instance of a user creating a group. |
metric |
skan_cost_per_in_app_ad_click |
skan_cost_per_in_app_ad_click |
The average cost incurred for each in-app ad click, as reported via SKAdNetwork. |
metric |
skan_cost_per_in_app_ad_impr |
skan_cost_per_in_app_ad_impr |
The average cost incurred for each in-app ad impression, as reported via SKAdNetwork. |
metric |
skan_cost_per_join_group |
skan_cost_per_join_group |
The SKAdNetwork-attributed cost for each instance of a user joining a group. |
metric |
skan_cost_per_launch_app |
skan_cost_per_launch_app |
The average cost incurred for each app launch event, as reported via SKAdNetwork. |
metric |
skan_cost_per_loan_apply |
skan_cost_per_loan_apply |
The average cost incurred for each loan application event, as reported via SKAdNetwork. |
metric |
skan_cost_per_loan_credit |
skan_cost_per_loan_credit |
The SKAdNetwork-attributed cost for each instance of a user receiving loan credit. |
metric |
skan_cost_per_loan_disbursement |
skan_cost_per_loan_disbursement |
The SKAdNetwork-attributed cost for each loan disbursement. |
metric |
skan_cost_per_login |
skan_cost_per_login |
The average cost incurred for each login event, as reported via SKAdNetwork. |
metric |
skan_cost_per_purchase |
skan_cost_per_purchase |
The average cost incurred for each purchase event, as reported via SKAdNetwork. |
metric |
skan_cost_per_ratings |
skan_cost_per_ratings |
The average cost incurred for each rating event, as reported via SKAdNetwork. |
metric |
skan_cost_per_registration |
skan_cost_per_registration |
The average cost incurred for each registration event, as reported via SKAdNetwork. |
metric |
skan_cost_per_result |
skan_cost_per_result |
The average cost incurred per result (conversion) as reported via SKAdNetwork. |
metric |
skan_cost_per_sales_lead |
skan_cost_per_sales_lead |
The average cost incurred for each sales lead, as reported via SKAdNetwork. |
metric |
skan_cost_per_search |
skan_cost_per_search |
The average cost incurred for each search event, as reported via SKAdNetwork. |
metric |
skan_cost_per_spend_credits |
skan_cost_per_spend_credits |
The average cost incurred for each “spend credits” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_start_trial |
skan_cost_per_start_trial |
The average cost incurred for each “start trial” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_subscribe |
skan_cost_per_subscribe |
The average cost incurred for each subscription event, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_achieve_level |
skan_cost_per_total_achieve_level |
The average cost incurred for all “achieve level” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_add_to_cart |
skan_cost_per_total_add_to_cart |
The average cost incurred for all “add to cart” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_add_to_wishlist |
skan_cost_per_total_add_to_wishlist |
The average cost incurred for all “add to wishlist” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_checkout |
skan_cost_per_total_checkout |
The average cost incurred for all “checkout” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_complete_tutorial |
skan_cost_per_total_complete_tutorial |
The average cost incurred for all “complete tutorial” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_create_gamerole |
skan_cost_per_total_create_gamerole |
The total SKAdNetwork-attributed cost for all instances of users creating game roles. |
metric |
skan_cost_per_total_create_group |
skan_cost_per_total_create_group |
The total SKAdNetwork-attributed cost for all instances of users creating groups. |
metric |
skan_cost_per_total_in_app_ad_click |
skan_cost_per_total_in_app_ad_click |
The average cost incurred for all in-app ad clicks, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_in_app_ad_impr |
skan_cost_per_total_in_app_ad_impr |
The average cost incurred for all in-app ad impressions, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_join_group |
skan_cost_per_total_join_group |
The total SKAdNetwork-attributed cost for all instances of users joining groups. |
metric |
skan_cost_per_total_launch_app |
skan_cost_per_total_launch_app |
The average cost incurred for all app launch events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_loan_apply |
skan_cost_per_total_loan_apply |
The average cost incurred for all loan application events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_loan_credit |
skan_cost_per_total_loan_credit |
The total SKAdNetwork-attributed cost for all instances of users receiving loan credits. |
metric |
skan_cost_per_total_loan_disbursement |
skan_cost_per_total_loan_disbursement |
The total SKAdNetwork-attributed cost for all loan disbursements. |
metric |
skan_cost_per_total_login |
skan_cost_per_total_login |
The average cost incurred for all login events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_purchase |
skan_cost_per_total_purchase |
The average cost incurred for all purchase events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_ratings |
skan_cost_per_total_ratings |
The average cost incurred for all rating events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_registration |
skan_cost_per_total_registration |
The average cost incurred for all registration events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_sales_lead |
skan_cost_per_total_sales_lead |
The average cost incurred for all sales lead events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_search |
skan_cost_per_total_search |
The average cost incurred for all search events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_spend_credits |
skan_cost_per_total_spend_credits |
The cost per spend credit, measured through SKAdNetwork (SKAN). |
metric |
skan_cost_per_total_start_trial |
skan_cost_per_total_start_trial |
The average cost incurred for all “start trial” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_subscribe |
skan_cost_per_total_subscribe |
The average cost incurred for all subscription events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_unlock_achievement |
skan_cost_per_total_unlock_achievement |
The total SKAdNetwork-attributed cost for all achievements unlocked by users. |
metric |
skan_cost_per_total_view_content |
skan_cost_per_total_view_content |
The average cost incurred for all “view content” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_unlock_achievement |
skan_cost_per_unlock_achievement |
The SKAdNetwork-attributed cost for each achievement unlocked by a user. |
metric |
skan_cost_per_view_content |
skan_cost_per_view_content |
The average cost incurred for each “view content” event, as reported via SKAdNetwork. |
metric |
skan_cost_total_add_payment_info |
skan_cost_total_add_payment_info |
The total cost incurred for all “add payment info” events, as reported via SKAdNetwork. |
metric |
skan_create_gamerole |
skan_create_gamerole |
The number of SKAdNetwork-attributed instances where users created a game role. |
metric |
skan_create_gamerole_rate |
skan_create_gamerole_rate |
The SKAdNetwork-attributed rate at which users created a game role. |
metric |
skan_create_group |
skan_create_group |
The number of SKAdNetwork-attributed instances where users created a group. |
metric |
skan_create_group_rate |
skan_create_group_rate |
The SKAdNetwork-attributed rate at which users created a group. |
metric |
skan_in_app_ad_click |
skan_in_app_ad_click |
The number of in-app ad clicks, as reported via SKAdNetwork. |
metric |
skan_in_app_ad_click_rate |
skan_in_app_ad_click_rate |
The rate of in-app ad clicks, as reported via SKAdNetwork. |
metric |
skan_in_app_ad_impr |
skan_in_app_ad_impr |
The number of in-app ad impressions, as reported via SKAdNetwork. |
metric |
skan_in_app_ad_impr_rate |
skan_in_app_ad_impr_rate |
The rate of in-app ad impressions, as reported via SKAdNetwork. |
metric |
skan_join_group |
skan_join_group |
The number of SKAdNetwork-attributed instances where users joined a group. |
metric |
skan_join_group_rate |
skan_join_group_rate |
The SKAdNetwork-attributed rate at which users joined a group. |
metric |
skan_launch_app |
skan_launch_app |
The number of app launches, as reported via SKAdNetwork. |
metric |
skan_launch_app_rate |
skan_launch_app_rate |
The rate of app launches, as reported via SKAdNetwork. |
metric |
skan_loan_apply |
skan_loan_apply |
The number of loan application events, as reported via SKAdNetwork. |
metric |
skan_loan_apply_rate |
skan_loan_apply_rate |
The rate of loan application events, as reported via SKAdNetwork. |
metric |
skan_loan_credit |
skan_loan_credit |
The number of SKAdNetwork-attributed instances where users received loan credit. |
metric |
skan_loan_credit_rate |
skan_loan_credit_rate |
The SKAdNetwork-attributed rate at which users received loan credit. |
metric |
skan_loan_disbursement |
skan_loan_disbursement |
The number of SKAdNetwork-attributed loan disbursements. |
metric |
skan_loan_disbursement_rate |
skan_loan_disbursement_rate |
The SKAdNetwork-attributed rate at which loans were disbursed. |
metric |
skan_login |
skan_login |
The number of login events, as reported via SKAdNetwork. |
metric |
skan_login_rate |
skan_login_rate |
The rate of login events, as reported via SKAdNetwork. |
metric |
skan_purchase |
skan_purchase |
The number of purchase events, as reported via SKAdNetwork. |
metric |
skan_purchase_rate |
skan_purchase_rate |
The rate of purchase events, as reported via SKAdNetwork. |
metric |
skan_ratings |
skan_ratings |
The number of rating events, as reported via SKAdNetwork. |
metric |
skan_ratings_rate |
skan_ratings_rate |
The rate of rating events, as reported via SKAdNetwork. |
metric |
skan_registration |
skan_registration |
The number of user registration events, as reported via SKAdNetwork. |
metric |
skan_registration_rate |
skan_registration_rate |
The rate of user registration events, as reported via SKAdNetwork. |
metric |
skan_result |
skan_result |
The final conversion value or result reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_result_rate |
skan_result_rate |
The rate of results (conversions), as reported via SKAdNetwork. |
metric |
skan_sales_lead |
skan_sales_lead |
The number of sales lead events, as reported via SKAdNetwork. |
metric |
skan_sales_lead_rate |
skan_sales_lead_rate |
The rate of sales lead events, as reported via SKAdNetwork. |
metric |
skan_search |
skan_search |
The number of search events, as reported via SKAdNetwork. |
metric |
skan_search_rate |
skan_search_rate |
The rate of search events, as reported via SKAdNetwork. |
metric |
skan_spend_credits |
skan_spend_credits |
The number of “spend credits” events, as reported via SKAdNetwork. |
metric |
skan_spend_credits_rate |
skan_spend_credits_rate |
The rate of “spend credits” events, as reported via SKAdNetwork. |
metric |
skan_start_trial |
skan_start_trial |
The number of “start trial” events, as reported via SKAdNetwork. |
metric |
skan_start_trial_rate |
skan_start_trial_rate |
The rate of “start trial” events, as reported via SKAdNetwork. |
metric |
skan_subscribe |
skan_subscribe |
The number of subscription events, as reported via SKAdNetwork. |
metric |
skan_subscribe_rate |
skan_subscribe_rate |
The rate of subscription events, as reported via SKAdNetwork. |
metric |
skan_total_achieve_level |
skan_total_achieve_level |
The total count of “achieve level” events, as reported via SKAdNetwork. |
metric |
skan_total_achieve_level_value |
skan_total_achieve_level_value |
The total value of SKAdNetwork-attributed instances where users achieved a certain level. |
metric |
skan_total_add_payment_info |
skan_total_add_payment_info |
The total count of “add payment info” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_cart |
skan_total_add_to_cart |
The total count of “add to cart” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_cart_value |
skan_total_add_to_cart_value |
The total value associated with “add to cart” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_wishlist |
skan_total_add_to_wishlist |
The total count of “add to wishlist” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_wishlist_value |
skan_total_add_to_wishlist_value |
The total value associated with “add to wishlist” events, as reported via SKAdNetwork. |
metric |
skan_total_checkout |
skan_total_checkout |
The total count of “checkout” events, as reported via SKAdNetwork. |
metric |
skan_total_checkout_value |
skan_total_checkout_value |
The total value associated with “checkout” events, as reported via SKAdNetwork. |
metric |
skan_total_complete_tutorial |
skan_total_complete_tutorial |
The total count of “complete tutorial” events, as reported via SKAdNetwork. |
metric |
skan_total_complete_tutorial_value |
skan_total_complete_tutorial_value |
The total value of SKAdNetwork-attributed instances where users completed a tutorial. |
metric |
skan_total_create_gamerole |
skan_total_create_gamerole |
The total number of SKAdNetwork-attributed instances where users created a game role. |
metric |
skan_total_create_gamerole_value |
skan_total_create_gamerole_value |
The total value of SKAdNetwork-attributed instances where users created a game role. |
metric |
skan_total_create_group |
skan_total_create_group |
The total number of SKAdNetwork-attributed instances where users created a group. |
metric |
skan_total_create_group_value |
skan_total_create_group_value |
The total value generated from users creating a group, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_click |
skan_total_in_app_ad_click |
The total number of in-app ad clicks, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_click_value |
skan_total_in_app_ad_click_value |
The total value generated from in-app ad clicks, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_impr |
skan_total_in_app_ad_impr |
The total number of in-app ad impressions, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_impr_value |
skan_total_in_app_ad_impr_value |
The total value generated from in-app ad impressions, attributed via SKAdNetwork. |
metric |
skan_total_join_group |
skan_total_join_group |
The total number of times users joined a group, attributed via SKAdNetwork. |
metric |
skan_total_join_group_value |
skan_total_join_group_value |
The total value generated from users joining a group, attributed via SKAdNetwork. |
metric |
skan_total_launch_app |
skan_total_launch_app |
The total number of app launches, attributed via SKAdNetwork. |
metric |
skan_total_loan_apply |
skan_total_loan_apply |
The total number of loan applications, attributed via SKAdNetwork. |
metric |
skan_total_loan_credit |
skan_total_loan_credit |
The total number of loan credits, attributed via SKAdNetwork. |
metric |
skan_total_loan_disbursement |
skan_total_loan_disbursement |
The total number of loan disbursements, attributed via SKAdNetwork. |
metric |
skan_total_login |
skan_total_login |
The total number of user logins, attributed via SKAdNetwork. |
metric |
skan_total_purchase |
skan_total_purchase |
The total number of purchases, attributed via SKAdNetwork. |
metric |
skan_total_purchase_value |
skan_total_purchase_value |
The total value generated from purchases, attributed via SKAdNetwork. |
metric |
skan_total_ratings |
skan_total_ratings |
The total number of user ratings, attributed via SKAdNetwork. |
metric |
skan_total_ratings_value |
skan_total_ratings_value |
The total value generated from user ratings, attributed via SKAdNetwork. |
metric |
skan_total_registration |
skan_total_registration |
The total number of user registrations, attributed via SKAdNetwork. |
metric |
skan_total_sales_lead |
skan_total_sales_lead |
The total number of sales leads, attributed via SKAdNetwork. |
metric |
skan_total_sales_lead_value |
skan_total_sales_lead_value |
The total value generated from sales leads, attributed via SKAdNetwork. |
metric |
skan_total_search |
skan_total_search |
The total count of search events based on when the events are returned through the SKAdNetwork API. |
metric |
skan_total_spend_credits |
skan_total_spend_credits |
The total number of times users spent credits, attributed via SKAdNetwork. |
metric |
skan_total_spend_credits_value |
skan_total_spend_credits_value |
The total value generated from spending credits, attributed via SKAdNetwork. |
metric |
skan_total_start_trial |
skan_total_start_trial |
The total number of trial starts, attributed via SKAdNetwork. |
metric |
skan_total_subscribe |
skan_total_subscribe |
The total number of subscriptions, attributed via SKAdNetwork. |
metric |
skan_total_subscribe_value |
skan_total_subscribe_value |
The total value generated from subscriptions, attributed via SKAdNetwork. |
metric |
skan_total_unlock_achievement |
skan_total_unlock_achievement |
The total number of times users unlocked an achievement, attributed via SKAdNetwork. |
metric |
skan_total_unlock_achievement_value |
skan_total_unlock_achievement_value |
The total value generated from unlocking achievements, attributed via SKAdNetwork. |
metric |
skan_total_view_content |
skan_total_view_content |
The total number of content views, attributed via SKAdNetwork. |
metric |
skan_total_view_content_value |
skan_total_view_content_value |
The total value generated from content views, attributed via SKAdNetwork. |
metric |
skan_unlock_achievement |
skan_unlock_achievement |
The number of times an achievement was unlocked, attributed via SKAdNetwork. |
metric |
skan_unlock_achievement_rate |
skan_unlock_achievement_rate |
The rate at which achievements were unlocked, attributed via SKAdNetwork. |
metric |
skan_view_content |
skan_view_content |
The number of content views, attributed via SKAdNetwork. |
metric |
skan_view_content_rate |
skan_view_content_rate |
The rate at which content was viewed, attributed via SKAdNetwork. |
metric |
skip_learning_phase |
skip_learning_phase |
Indicates if the learning phase is skipped for campaign delivery optimization. |
dimension |
sku_ids |
sku_ids |
A list of Stock Keeping Unit (SKU) identifiers, representing unique product items in a catalog. |
dimension |
smart_audience_enabled |
smart_audience_enabled |
dimension |
|
smart_interest_behavior_enabled |
smart_interest_behavior_enabled |
dimension |
|
smart_plus_ad_id |
smart_plus_ad_id |
The unique identifier for a Smart Plus ad, which is a specific type of ad within the TikTok advertising platform that often leverages automation for enhanced performance. |
dimension |
smart_plus_ad_name |
smart_plus_ad_name |
The name assigned to a Smart Plus ad for identification and management purposes within the TikTok advertising platform. |
dimension |
smart_target |
smart_target |
metric |
|
sound_usage_clicks |
sound_usage_clicks |
metric |
|
source |
source |
The advertising platform or origin where the ad was run. |
dimension |
special_industries |
special_industries |
dimension |
|
spend |
spend |
The total amount of money spent on the ad or campaign. |
metric |
spend_EUR |
spend_EUR |
The total amount of money spent in Euros for the advertising campaign, ad group, or ad. |
metric |
spend_credits |
spend_credits |
The number of unique app spend credit actions attributed to your ads. |
metric |
spend_credits_rate |
spend_credits_rate |
The percentage of app spend credit actions from all app installs attributed to your ads. |
metric |
split_test_group_id |
split_test_group_id |
dimension |
|
split_test_status |
split_test_status |
dimension |
|
start_trial |
start_trial |
The number of times a trial was started. |
metric |
start_trial_rate |
start_trial_rate |
The rate at which trials were started. |
metric |
stat_cost |
stat_cost |
The total cost incurred for the advertising entity. |
metric |
stat_time_day |
stat_time_day |
The specific day for which the statistics are reported. |
dimension |
stat_time_hour |
stat_time_hour |
The hour of the day for which the statistics are reported. |
dimension |
statistic_type |
statistic_type |
The statistical type or method used for reporting metrics. |
dimension |
status |
status |
The operational status of the ad, ad group, or campaign (e.g., active, paused, deleted). |
dimension |
stitch_clicks |
stitch_clicks |
The number of clicks on the ‘Stitch’ button in Spark Ads. |
metric |
subscribe |
subscribe |
The number of subscription events attributed to the ad. |
metric |
subscribe_rate |
subscribe_rate |
The rate at which users subscribe after interacting with an ad. |
metric |
target_roi_budget |
target_roi_budget |
The budget allocated to achieve a specific Return On Investment (ROI) target. |
metric |
targeting_expansion |
targeting_expansion |
dimension |
|
tiktok_comments |
tiktok_comments |
The number of comments received on the TikTok ad creative. |
metric |
tiktok_cost_usd |
tiktok_cost_usd |
The total cost incurred in United States Dollars (USD) specifically on the TikTok platform. |
metric |
tiktok_costs |
tiktok_costs |
The total cost incurred for ads running on the TikTok platform. |
metric |
tiktok_creative_id |
tiktok_creative_id |
The unique identifier for the TikTok creative. |
dimension |
tiktok_engagements |
tiktok_engagements |
The total number of user engagements with the ad on the TikTok platform. |
metric |
tiktok_item_id |
tiktok_item_id |
The unique identifier for a TikTok post ID, used specifically for Spark Ads. |
dimension |
tiktok_likes |
tiktok_likes |
The number of likes received on a TikTok ad. |
metric |
tiktok_link_id |
tiktok_link_id |
dimension |
|
tiktok_page_category |
tiktok_page_category |
dimension |
|
tiktok_reach |
tiktok_reach |
The number of unique users who saw the TikTok ad. |
metric |
tiktok_shares |
tiktok_shares |
The number of times the TikTok ad creative was shared by users. |
metric |
tiktok_video_start |
tiktok_video_start |
The number of times the TikTok video ad started playing. |
metric |
tiktok_vtr_100 |
tiktok_vtr_100 |
The percentage of times the TikTok video ad was played to 100% completion. |
metric |
tiktok_vtr_25 |
tiktok_vtr_25 |
The percentage of times the TikTok video ad was played to 25% completion. |
metric |
tiktok_vtr_50 |
tiktok_vtr_50 |
The percentage of times the TikTok video ad was played to 50% completion. |
metric |
tiktok_vtr_75 |
tiktok_vtr_75 |
The percentage of times the TikTok video ad was played to 75% completion. |
metric |
timezone |
timezone |
The timezone used for report data. |
dimension |
title |
title |
The title or headline of an ad or creative. |
dimension |
topview_reach_range |
topview_reach_range |
The estimated reach range for TopView ad placements. |
dimension |
total_achieve_level |
total_achieve_level |
The total number of times users achieved a certain level within an app or game, attributed to the ad. |
metric |
total_achieve_level_value |
total_achieve_level_value |
The total value generated from achieve level events. |
metric |
total_active_days |
total_active_days |
metric |
|
total_active_pay_roas |
total_active_pay_roas |
The Return On Ad Spend (ROAS) from actively paying users. |
metric |
total_ad_impression_roas |
total_ad_impression_roas |
The total Return on Ad Spend (ROAS) calculated based on ad impressions. |
metric |
total_add_billing_value |
total_add_billing_value |
The total value generated from users initiating adding billing information. |
metric |
total_add_payment_info |
total_add_payment_info |
The total number of times payment information was added. |
metric |
total_add_to_wishlist |
total_add_to_wishlist |
The total number of ‘add to wishlist’ events attributed to your ads. |
metric |
total_add_to_wishlist_value |
total_add_to_wishlist_value |
The total monetary value of ‘add to wishlist’ events attributed to your ads. |
metric |
total_app_event_add_to_cart |
total_app_event_add_to_cart |
The total number of ‘add to cart’ events that occurred within your app, attributed to your ads. |
metric |
total_app_event_add_to_cart_value |
total_app_event_add_to_cart_value |
The total monetary value of ‘add to cart’ events that occurred within your app, attributed to your ads. |
metric |
total_button_click_value |
total_button_click_value |
The total value generated from button clicks on a website or app, attributed to the ad. |
metric |
total_checkout |
total_checkout |
The total number of checkout events initiated. |
metric |
total_checkout_value |
total_checkout_value |
The total monetary value of all checkout events. |
metric |
total_complete_payment_rate |
total_complete_payment_rate |
The total rate of complete payment events attributed to ads. |
metric |
total_complete_tutorial |
total_complete_tutorial |
The total number of times users have completed a tutorial. |
metric |
total_complete_tutorial_value |
total_complete_tutorial_value |
The total value of app complete tutorial actions attributed to your ads. |
metric |
total_consultation_value |
total_consultation_value |
The total value generated from consultations. |
metric |
total_create_gamerole |
total_create_gamerole |
The total number of app create role actions attributed to your ads. |
metric |
total_create_gamerole_value |
total_create_gamerole_value |
The total value of app create role actions attributed to your ads. |
metric |
total_create_group |
total_create_group |
The total number of times a group was created. |
metric |
total_create_group_value |
total_create_group_value |
The total value generated from creating groups. |
metric |
total_download_start_value |
total_download_start_value |
The total value of website download actions attributed to your ads. |
metric |
total_form_value |
total_form_value |
The total monetary value generated from form submissions. |
metric |
total_in_app_ad_click |
total_in_app_ad_click |
The total number of clicks on an ad within an application. |
metric |
total_in_app_ad_click_value |
total_in_app_ad_click_value |
The total value of in-app ad clicks attributed to your ads. |
metric |
total_in_app_ad_impr |
total_in_app_ad_impr |
The total number of in-app ad impressions. |
metric |
total_in_app_ad_impr_value |
total_in_app_ad_impr_value |
The total value generated from in-app ad impressions. |
metric |
total_initiate_checkout_value |
total_initiate_checkout_value |
The total monetary value of all initiate checkout events. |
metric |
total_join_group |
total_join_group |
The total number of times a group was joined. |
metric |
total_join_group_value |
total_join_group_value |
The total value generated from joining groups. |
metric |
total_landing_page_view |
total_landing_page_view |
The total number of landing page views after ad interaction. |
metric |
total_launch_app |
total_launch_app |
The total number of times the app was launched by users. |
metric |
total_loan_apply |
total_loan_apply |
The total number of loan applications. |
metric |
total_loan_credit |
total_loan_credit |
The total number of loan credits. |
metric |
total_loan_disbursement |
total_loan_disbursement |
The total number of loan disbursements. |
metric |
total_login |
total_login |
The total number of user logins. |
metric |
total_next_day_open |
total_next_day_open |
The total number of times the app was opened the day after installation or engagement. |
metric |
total_on_web_add_to_wishlist_value |
total_on_web_add_to_wishlist_value |
The total value of ‘add to wishlist’ actions on the website attributed to ads. |
metric |
total_on_web_order_value |
total_on_web_order_value |
The total monetary value of order events that occurred on the website, attributed to ads. |
metric |
total_on_web_subscribe_value |
total_on_web_subscribe_value |
The total monetary value of subscription events that occurred on the website, attributed to ads. |
metric |
total_online_consult_value |
total_online_consult_value |
The total value generated from online consultation events. |
metric |
total_onsite_add_billing_value |
total_onsite_add_billing_value |
The total value generated from onsite add billing events. |
metric |
total_onsite_add_to_wishlist_value |
total_onsite_add_to_wishlist_value |
The total value generated from onsite add to wishlist events. |
metric |
total_onsite_form_value |
total_onsite_form_value |
The total value generated from onsite form submission events. |
metric |
total_onsite_initiate_checkout_count_value |
total_onsite_initiate_checkout_count_value |
The total value generated from onsite initiate checkout events. |
metric |
total_onsite_on_web_cart_value |
total_onsite_on_web_cart_value |
The total value generated from onsite add to cart events. |
metric |
total_onsite_shopping_value |
total_onsite_shopping_value |
The total monetary value of all onsite shopping events. |
metric |
total_page_event_search_value |
total_page_event_search_value |
The total monetary value of search events that occurred on a webpage, attributed to ads. |
metric |
total_page_view_content_events_value |
total_page_view_content_events_value |
The total value associated with page view content events. |
metric |
total_pageview |
total_pageview |
The total number of page views. |
metric |
total_purchase |
total_purchase |
The total number of purchases. |
metric |
total_purchase_roas_day0 |
total_purchase_roas_day0 |
The total Return on Ad Spend (ROAS) for purchases within 0 days of ad interaction. |
metric |
total_purchase_roas_day2 |
total_purchase_roas_day2 |
The total Return on Ad Spend (ROAS) for purchases within 2 days of ad interaction. |
metric |
total_purchase_roas_day6 |
total_purchase_roas_day6 |
The total Return on Ad Spend (ROAS) for purchases within 6 days of ad interaction. |
metric |
total_purchase_value |
total_purchase_value |
The total monetary value of purchases. |
metric |
total_purchase_value_EUR |
total_purchase_value_EUR |
The total monetary value of purchases in Euros, attributed to ad interactions. |
metric |
total_purchase_value_day0 |
total_purchase_value_day0 |
The total value of purchases made on day 0 (the day of the ad click/view). |
metric |
total_purchase_value_day2 |
total_purchase_value_day2 |
The total monetary value of purchases within 2 days of ad interaction. |
metric |
total_purchase_value_day6 |
total_purchase_value_day6 |
The total monetary value of purchases within 6 days of ad interaction. |
metric |
total_ratings |
total_ratings |
The total number of ratings given by users. |
metric |
total_ratings_value |
total_ratings_value |
The total value of app rate actions attributed to your ads. |
metric |
total_registration |
total_registration |
The total number of registration events. |
metric |
total_sales_lead |
total_sales_lead |
The total number of sales leads generated. |
metric |
total_sales_lead_value |
total_sales_lead_value |
The total value generated from sales leads. |
metric |
total_search |
total_search |
The total number of search events that are attributed to your ads. |
dimension |
total_spend_credits |
total_spend_credits |
The total number of app spend credit actions attributed to your ads. |
metric |
total_spend_credits_value |
total_spend_credits_value |
The total value of app spend credit actions attributed to your ads. |
metric |
total_start_trial |
total_start_trial |
The total number of times users have started a trial period. |
metric |
total_subscribe |
total_subscribe |
The total number of subscription events attributed to ads. |
metric |
total_subscribe_value |
total_subscribe_value |
The total monetary value of subscription events attributed to ads. |
metric |
total_unlock_achievement |
total_unlock_achievement |
The total number of app unlock achievement actions attributed to your ads. |
metric |
total_unlock_achievement_value |
total_unlock_achievement_value |
The total value of app unlock achievement actions attributed to your ads. |
metric |
total_user_registration_value |
total_user_registration_value |
The total value generated from user registrations. |
metric |
total_value_per_pageview |
total_value_per_pageview |
The total monetary value generated for each page view attributed to the ad. |
metric |
total_view_content |
total_view_content |
The total number of view content events attributed to your ads. |
metric |
total_view_content_value |
total_view_content_value |
The total monetary value of view content events attributed to your ads. |
metric |
total_web_event_add_to_cart_value |
total_web_event_add_to_cart_value |
The total monetary value of ‘add to cart’ web events. |
metric |
tracking_app_id |
tracking_app_id |
The unique identifier of the app used for tracking purposes. |
dimension |
tracking_pixel_id |
tracking_pixel_id |
The unique identifier of the pixel used for tracking purposes. |
dimension |
tt_account_name |
tt_account_name |
The name of the TikTok account associated with the ad. |
dimension |
tt_account_profile_image_url |
tt_account_profile_image_url |
The URL of the profile image for the TikTok account associated with the ad. |
dimension |
tt_app_id |
tt_app_id |
The unique identifier for the TikTok application. |
dimension |
tt_app_name |
tt_app_name |
The name of the TikTok application. |
metric |
tt_playlist_visit |
tt_playlist_visit |
metric |
|
unique_ad_impression_events |
unique_ad_impression_events |
The number of unique times an ad was displayed to users. |
metric |
unique_checkouts |
unique_checkouts |
The number of unique checkout events attributed to the ad. |
metric |
unique_custom_app_events |
unique_custom_app_events |
The number of unique custom in-app events recorded. |
metric |
unique_purchases |
unique_purchases |
The number of unique purchase events attributed to the ad. |
metric |
unique_view_content |
unique_view_content |
The number of unique users who viewed the content. |
metric |
unlock_achievement |
unlock_achievement |
The number of times users unlocked an achievement. |
metric |
unlock_achievement_rate |
unlock_achievement_rate |
The rate at which users unlock achievements. |
metric |
user_action |
user_action |
The type of action performed by a user in response to an ad. |
metric |
user_registration |
user_registration |
The number of user registration events. |
metric |
user_registration_rate |
user_registration_rate |
The rate at which users complete registration. |
metric |
value_per_add_billing |
value_per_add_billing |
The average value generated per ‘add billing information’ event. |
metric |
value_per_button_click |
value_per_button_click |
The value generated per button click. |
metric |
value_per_checkout |
value_per_checkout |
The average value generated per checkout event. |
metric |
value_per_complete_payment |
value_per_complete_payment |
The monetary value generated for each complete payment. |
metric |
value_per_complete_payment_EUR |
value_per_complete_payment_EUR |
The value generated per complete payment event, specified in EUR. |
metric |
value_per_consultation |
value_per_consultation |
The average value generated per consultation event. |
metric |
value_per_download_start |
value_per_download_start |
The average value generated per download start event. |
metric |
value_per_form |
value_per_form |
The average value generated per form submission event. |
metric |
value_per_initiate_checkout |
value_per_initiate_checkout |
The average value generated per ‘initiate checkout’ event. |
metric |
value_per_offline_form_event |
value_per_offline_form_event |
The average monetary value generated for each offline ‘form submission’ event. |
metric |
value_per_offline_place_order_event |
value_per_offline_place_order_event |
The average monetary value generated for each offline ‘place order’ event. |
metric |
value_per_on_web_add_to_wishlist |
value_per_on_web_add_to_wishlist |
The average monetary value generated for each ‘add to wishlist’ event on the advertiser’s website. |
metric |
value_per_on_web_order |
value_per_on_web_order |
The monetary value generated for each order completed on the website. |
metric |
value_per_online_consult |
value_per_online_consult |
The average value generated per online consultation event. |
metric |
value_per_onsite_form |
value_per_onsite_form |
The average monetary value generated for each form submission event on the advertiser’s website. |
metric |
value_per_onsite_initiate_checkout_count |
value_per_onsite_initiate_checkout_count |
The average monetary value generated for each ‘initiate checkout’ event on the advertiser’s website. |
metric |
value_per_onsite_on_web_cart |
value_per_onsite_on_web_cart |
The average monetary value generated for each ‘add to cart’ event on the advertiser’s website. |
metric |
value_per_onsite_on_web_detail |
value_per_onsite_on_web_detail |
The average monetary value generated for each ‘view product detail’ event on the advertiser’s website. |
metric |
value_per_onsite_shopping |
value_per_onsite_shopping |
The average monetary value generated for each shopping event that occurred on the advertiser’s website. |
metric |
value_per_page_event_search |
value_per_page_event_search |
The average value generated per page event search. |
metric |
value_per_total_achieve_level |
value_per_total_achieve_level |
The average value generated per ‘achieve level’ event. |
metric |
value_per_total_add_to_wishlist |
value_per_total_add_to_wishlist |
The average value generated per ‘add to wishlist’ event. |
metric |
value_per_total_app_event_add_to_cart |
value_per_total_app_event_add_to_cart |
The average value generated per ‘add to cart’ event within the app. |
metric |
value_per_total_complete_tutorial |
value_per_total_complete_tutorial |
The average value generated per ‘complete tutorial’ event. |
metric |
value_per_total_create_gamerole |
value_per_total_create_gamerole |
The average value generated per ‘create game role’ event. |
metric |
value_per_total_create_group |
value_per_total_create_group |
The average value generated per ‘create group’ event. |
metric |
value_per_total_in_app_ad_click |
value_per_total_in_app_ad_click |
The average value generated per in-app ad click. |
metric |
value_per_total_in_app_ad_impr |
value_per_total_in_app_ad_impr |
The average value generated per in-app ad impression. |
metric |
value_per_total_join_group |
value_per_total_join_group |
The average value generated per ‘join group’ event. |
metric |
value_per_total_purchase |
value_per_total_purchase |
Total monetary value generated for each purchase attributed to an ad. |
metric |
value_per_total_ratings |
value_per_total_ratings |
The average value generated per rating event. |
metric |
value_per_total_sales_lead |
value_per_total_sales_lead |
The average value generated per sales lead. |
metric |
value_per_total_spend_credits |
value_per_total_spend_credits |
The average value generated per ‘spend credits’ event. |
metric |
value_per_total_subscribe |
value_per_total_subscribe |
The average value generated per subscription event. |
metric |
value_per_total_unlock_achievement |
value_per_total_unlock_achievement |
The average value generated per ‘unlock achievement’ event. |
metric |
value_per_total_view_content |
value_per_total_view_content |
The average value generated per ‘view content’ event. |
metric |
value_per_user_registration |
value_per_user_registration |
The average value generated per user registration. |
metric |
value_per_web_event_add_to_cart |
value_per_web_event_add_to_cart |
The average value generated per ‘add to cart’ web event. |
metric |
vertical |
vertical |
dimension |
|
video_2s_views |
video_2s_views |
The number of times the video creative was viewed for at least 2 seconds. |
metric |
video_6s_views |
video_6s_views |
The number of times the video creative was viewed for at least 6 seconds. |
metric |
video_completions |
video_completions |
The number of times the video creative was watched to completion. |
metric |
video_id |
video_id |
The unique identifier for a video creative used in an ad. |
dimension |
video_play_actions |
video_play_actions |
The total number of times users initiated playing a video ad. |
metric |
video_quartile_25_views |
video_quartile_25_views |
The number of times the video creative was viewed up to the 25% mark. |
metric |
video_quartile_50_views |
video_quartile_50_views |
The number of times the video creative was viewed up to the 50% mark. |
metric |
video_quartile_75_views |
video_quartile_75_views |
The number of times the video creative was viewed up to the 75% mark. |
metric |
video_starts |
video_starts |
The number of times the video creative began playing. |
metric |
video_views_p100 |
video_views_p100 |
The total number of times a video was played to completion (100%). |
metric |
video_views_p25 |
video_views_p25 |
The total number of times a video was played to at least 25% of its length. |
metric |
video_views_p50 |
video_views_p50 |
The total number of times a video was played to at least 50% of its length. |
metric |
video_views_p75 |
video_views_p75 |
The total number of times a video was played to at least 75% of its length. |
metric |
video_watched_2s |
video_watched_2s |
The number of times a video ad was watched for at least 2 seconds. |
metric |
video_watched_6s |
video_watched_6s |
The number of times a video has been played for at least 6 seconds, or played in full if it is less than 6 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad. |
metric |
video_watched_continuous_2s |
video_watched_continuous_2s |
The number of times a video was continuously watched for at least 2 seconds. |
metric |
view_attribution_window |
view_attribution_window |
The time window during which a view of an ad can be attributed to a conversion. |
dimension |
view_completion |
view_completion |
The percentage of the ad’s content that was viewed. |
metric |
view_content |
view_content |
The number of times a specific content page or product was viewed after an ad interaction. |
metric |
view_content_rate |
view_content_rate |
The rate at which users view specific content pages. |
metric |
virtual_objective_type |
virtual_objective_type |
The virtual objective type set for the campaign. |
dimension |
vta_conversion |
vta_conversion |
The number of conversions attributed to a view-through action. |
metric |
vta_purchase |
vta_purchase |
Purchases attributed to a view-through action (user saw the ad but didn’t click, then converted later). |
metric |
vta_registration |
vta_registration |
The number of registration events attributed to view-through actions (VTA), based on information received from your measurement partner. |
metric |
web_event_add_to_cart |
web_event_add_to_cart |
The number of ‘add to cart’ events that occurred on the website, attributed to ads. |
metric |
web_event_add_to_cart_rate |
web_event_add_to_cart_rate |
The rate at which users add items to their cart on a website. |
metric |