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
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 Name	Campaign Name	The name of the advertising campaign.	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
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 Name	Creative Name	The name of the ad creative.	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
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
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
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.	dimension
Start Date	Start Date	The start date of the ad campaign or ad group schedule.	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
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
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 a conversion action, e.g., purchase, add to cart.	metric
action_period	action_period	The defined time window or period within which a specific action or conversion is attributed to an ad.	metric
actions	actions	A general category of user interactions or conversions attributed to ads, such as clicks, likes, or purchases.	metric
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_automation_type	ad_campaign_automation_type	The automation type configured for the campaign to which the ad belongs.	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_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_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_id_v2	ad_id_v2	Unique identifier for an 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	The number of impressions deemed invalid at the ad level.	metric
ad_invalid_spend	ad_invalid_spend	The amount of spend deemed invalid at the ad level.	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_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, such as active, paused, or deleted.	dimension
ad_text	ad_text	The main text content of the ad.	metric
ad_texts	ad_texts	The main text content(s) 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).	metric
ad_url	ad_url	The destination URL associated with the ad.	metric
ad_valid_impressions	ad_valid_impressions	The number of impressions deemed valid at the ad level.	metric
ad_valid_spend	ad_valid_spend	The amount of spend deemed valid at the ad level.	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_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	Indicates the status or 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_ids	adgroup_audience_ids	The unique identifiers for audience lists targeted by the ad group.	dimension
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_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_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.	metric
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_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.	metric
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_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 where ads in this ad group can be displayed (e.g., TikTok feed, audience network).	dimension
adgroup_operating_systems	adgroup_operating_systems	The operating systems targeted by an 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_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_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 campaign at the ad group level.	metric
adgroup_rf_estimated_frequency	adgroup_rf_estimated_frequency	The estimated average number of times an ad is shown to a unique user within an ad group’s Reach and Frequency campaign.	metric
adgroup_rf_purchased_type	adgroup_rf_purchased_type	The purchased type specifically for Reach and Frequency campaigns within the 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 conversion event selected 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	Indicates if sharing to third-party platforms is disabled for ads within this ad group.	dimension
adgroup_skip_learning_phase	adgroup_skip_learning_phase	Indicates whether the learning phase is skipped for the ad group, affecting how the system optimizes ad delivery.	dimension
adgroup_split_test_adgroup_ids	adgroup_split_test_adgroup_ids	A list of ad group identifiers that are part of a split test along with this ad group.	dimension
adgroup_statistic_type	adgroup_statistic_type	The statistical type or method used for reporting metrics at the ad group level.	dimension
adgroup_video_download_disabled	adgroup_video_download_disabled	Indicates whether users are prevented from downloading video ads within this ad group.	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_invalid_impressions	adset_invalid_impressions	The number of impressions deemed invalid at the ad group level.	metric
adset_invalid_spend	adset_invalid_spend	The amount of spend deemed invalid at the ad group level.	metric
adset_name	adset_name	The name of the ad set (ad group).	dimension
adset_status	adset_status	The current operational status of the ad set (ad group), such as enabled, disabled, or frozen.	dimension
adset_valid_impressions	adset_valid_impressions	The number of impressions deemed valid at the ad group level.	metric
adset_valid_spend	adset_valid_spend	The amount of spend deemed valid at the ad group level.	metric
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 unique identifier for the Business Center that owns the advertiser account.	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	The reason provided for the rejection or disapproval of an advertiser’s content or account.	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	The age demographic groups targeted by the ad.	dimension
anchor_click_rate	anchor_click_rate	The percentage of times viewers performed a click after seeing an anchor in an ad.	metric
anchor_clicks	anchor_clicks	The number of clicks on anchors within video ads.	metric
app_download_url	app_download_url	The URL where users are directed to download the app after interacting with an ad.	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 promoted mobile application.	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 app profile.	dimension
app_promotion_type	app_promotion_type	The type of app promotion campaign.	metric
app_type	app_type	The type of mobile application promoted by the ad, such as iOS or Android.	dimension
attribution_event_count	attribution_event_count	The method used for counting attribution events within a specified window.	dimension
audience_ids	audience_ids	A list of unique identifiers for the target audiences used in the ad group.	dimension
audience_rule	audience_rule	The rule or criteria used to define a custom audience for targeting.	dimension
audience_type	audience_type	The type of audience being targeted, such as custom, lookalike, or saved audiences.	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.	metric
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
balance	balance	The available balance in the ad account or Business Center used to fund ad campaigns.	metric
behavior_name	behavior_id	An identifier for a user behavior or interest.	metric
bid_display_mode	bid_display_mode		dimension
bid_price	bid_price	The price set for a bid in the ad auction, such as Cost-Per-Click (CPC) or Cost-Per-Mille (CPM).	metric
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 (e.g., impressions, clicks) upon which the ad campaign is billed.	dimension
brand_safety_partner	brand_safety_partner	The third-party partner used for brand safety measurement and verification.	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 brand safety setting applied to the ad, controlling content adjacency.	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 total budget allocated for a campaign or ad group.	metric
budget_mode	budget_mode	The budgeting strategy used, such as daily budget, total lifetime budget, or unlimited.	dimension
budget_optimize_on	budget_optimize_on	Indicates if budget optimization is enabled for the campaign or ad group.	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_app_profile_page_state	campaign_app_profile_page_state	Indicates the status of the app profile page associated with the campaign.	dimension
campaign_automation_type	campaign_automation_type	The automation type configured for a campaign, influencing how ad performance is boosted.	dimension
campaign_budget	campaign_budget	The budget allocated to the campaign.	metric
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	Indicates if campaign budget optimization is enabled, allowing the system to automatically manage budgets across ad groups.	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_id	campaign_id	The unique identifier for the campaign.	dimension
campaign_invalid_impressions	campaign_invalid_impressions	The number of impressions deemed invalid at the campaign level.	metric
campaign_invalid_spend	campaign_invalid_spend	The amount of spend deemed invalid at the campaign level.	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 at the campaign level.	metric
campaign_valid_spend	campaign_valid_spend	The amount of spend deemed valid at the campaign level.	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	A list of identifiers for mobile network carriers targeted by the ad group.	dimension
catalog_authorized_bc_id	catalog_authorized_bc_id	The ID of the Business Center authorized to access the catalog.	dimension
catalog_enabled	catalog_enabled	Indicates whether a product catalog is enabled for the campaign to promote products.	dimension
catalog_id	catalog_id	The unique identifier for a product catalog.	dimension
category_exclusion_ids	category_exclusion_ids	Identifiers for content categories excluded from ad placement for brand safety.	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 on an ad can be attributed to a conversion.	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	Indicates whether comments are disabled for the ad.	dimension
comments	comments	The number of comments on an ad.	metric
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_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	A list of identifiers for contextual tags used for targeting.	dimension
conversion	conversion	The total number of conversion events attributed to the ad.	metric
conversion_bid_price	conversion_bid_price	The bid price set for conversions, typically used with oCPM bidding.	metric
conversion_rate	conversion_rate	The percentage of users who clicked on your ad and completed a desired action.	metric
conversions	conversions	The number of times an ad achieved an outcome, based on the secondary goal selected for the campaign.	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_ix_product_click_count	cost_per_ix_product_click_count	The average cost incurred for each product click within an Instant Experience.	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_form_event	cost_per_offline_form_event	The average cost incurred for each offline form submission event attributed to the ad.	metric
cost_per_offline_search_event	cost_per_offline_search_event	The cost incurred per offline search event.	metric
cost_per_offline_subscribe_event	cost_per_offline_subscribe_event	The average cost incurred for each offline ‘subscribe’ event attributed to the ad.	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 website subscription event attributed to ads.	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 occurring on TikTok’s properties.	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_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_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
costs	costs	The total estimated amount of money spent on the campaign, ad group, or ad.	metric
countdown_sticker_recall_clicks	countdown_sticker_recall_clicks	The number of clicks on a countdown sticker within an ad that prompt a user recall action.	metric
country	country	The country associated with the advertiser account or target audience.	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 optimized video playback duration for Cost Per View (CPV) ads.	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 strategy for creative material management.	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.	metric
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
datetime	datetime	The date and time of a reported event.	dimension
day	day	The specific day for which the ad data is reported.	dimension
dayparting	dayparting	The specific time periods of the day when ads are scheduled to be delivered.	metric
deep_bid_type	deep_bid_type	The bidding strategy used for in-app events, typically part of deep optimization.	dimension
deep_cpa_bid	deep_cpa_bid	The cost-per-action (CPA) bid specifically for deep in-app events.	metric
deeplink	deeplink	The deeplink URL that directs users to specific content within an app.	dimension
deeplink_format_type	deeplink_format_type	The format type of the deeplink.	dimension
deeplink_type	deeplink_type	The type of deeplink used for the ad.	dimension
deeplink_utm_params	deeplink_utm_params	UTM parameters appended to the deeplink URL for tracking purposes.	dimension
delivery_mode	delivery_mode	The mode of ad delivery.	dimension
description	description	A description of the ad, campaign, or product.	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 devices targeted by an ad group, such as mobile or desktop.	dimension
device_model_ids	device_model_ids	A list of device model IDs targeted by the ad.	dimension
device_price_ranges	device_price_ranges	The price ranges of devices targeted by the ad.	dimension
disable_skan_campaign	disable_skan_campaign	Indicates whether an SKAN (SKAdNetwork) campaign is disabled.	dimension
disclaimer_clickable_texts	disclaimer_clickable_texts	The clickable text elements within an ad’s disclaimer.	dimension
disclaimer_text	disclaimer_text	The disclaimer text displayed with the ad.	dimension
disclaimer_type	disclaimer_type	The type of disclaimer used for the ad.	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 setting for displaying data related to the advertiser account.	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	download_detail	The number of details page browse events for app downloads. This field is deprecated.	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
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.	metric
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 of an ad (e.g., 6 seconds or more) 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
excluded_audience_ids	excluded_audience_ids	A list of unique identifiers for audiences explicitly excluded from targeting.	dimension
excluded_custom_actions	excluded_custom_actions	A list of custom actions that are excluded from optimization or reporting.	dimension
fallback_type	fallback_type	The fallback mechanism or type used when a primary ad action or destination fails.	dimension
feed_type	feed_type		dimension
follows	follows	The number of new followers gained due to the ad.	metric
form	form	The number of form submission events.	metric
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 a form, likely after interacting with an ad.	metric
form_rate	form_rate	The percentage of website lead actions from all clicks attributed to your ads.	metric
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	Controls how often users see an ad, typically in conjunction with a frequency cap.	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 gross impressions for the ad.	metric
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	A list of custom actions that are included for optimization or reporting.	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 number of times your mobile app was installed and attributed to your ads.	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 times interactive add-ons within an ad were displayed to users.	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 within 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 within 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	A list of identifiers for interest categories targeted by the ad group.	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_keyword_ids	interest_keyword_ids	A list of identifiers for interest keywords used for targeting.	dimension
inventory_filter_enabled	inventory_filter_enabled	Indicates if the TikTok Inventory Filter, a brand safety solution, is enabled.	dimension
ios14_quota_type	ios14_quota_type	The type of SKAN 4.0 postback quota mode selected for iOS14 campaigns.	dimension
ios14_targeting	ios14_targeting	Indicates if the campaign or ad group is specifically targeting iOS 14 or later versions.	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	Indicates whether the campaign is a Search Campaign, serving ads on TikTok’s search results page.	dimension
is_smart_performance_campaign	is_smart_performance_campaign	Indicates if the campaign is a Smart+ (automated performance) campaign type.	dimension
isp_ids	isp_ids	A list of identifiers for Internet Service Providers (ISPs) targeted by the ad.	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 for groups of items, typically used for product catalogs.	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_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 ad creative.	dimension
languages	languages	A list of languages targeted by the ad group.	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
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	A list of unique identifiers for geographical locations targeted by the ad.	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
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	The media channel where the advertisement is displayed.	dimension
media_channel_group	media_channel_group	A grouping or category for the media channel where ads are displayed.	dimension
min_android_version	min_android_version	The minimum Android operating system version targeted by the ad.	dimension
min_ios_version	min_ios_version	The minimum iOS operating system version targeted by the ad.	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 ad, ad group, campaign, or other entity.	dimension
net_cost	net_cost	The total advertising cost after any deductions or adjustments.	metric
network_types	network_types		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	The retention rate of users on the day following an app install or specific action.	dimension
num_ads	num_ads	The number of ads associated with a particular campaign or ad group.	metric
objective	objective	The marketing objective selected for the campaign, such as Reach, Traffic, or Conversions.	dimension
objective_type	objective_type	The type of objective set for the campaign or ad group.	dimension
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_download_events	offline_download_events	The number of offline download events attributed to your ads.	metric
offline_form_event_rate	offline_form_event_rate	The rate at which offline form submission events occur, calculated as the number of events divided by a relevant base metric.	metric
offline_form_events	offline_form_events	The number of offline form submission events attributed to your ads.	metric
offline_form_events_value	offline_form_events_value	The total monetary value generated from offline form submission events attributed to the ad.	metric
offline_search_event_rate	offline_search_event_rate	The rate of offline search events.	metric
offline_search_events	offline_search_events	The number of offline search events attributed to your ads.	metric
offline_search_events_value	offline_search_events_value	The total value of offline search events attributed to your ads.	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 of offline subscribe events.	metric
offline_subscribe_events	offline_subscribe_events	The number of offline subscribe events attributed to your ads.	metric
offline_subscribe_events_value	offline_subscribe_events_value	The total value of offline subscribe events attributed to your ads.	metric
offline_total_custom_events	offline_total_custom_events	The total number of custom offline events attributed to your ads.	metric
offline_view_content_events	offline_view_content_events	The number of offline view content events attributed to your ads.	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	The number of website subscription events per click on an ad.	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 users submit forms on the advertiser’s website after interacting with an ad.	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_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 of ‘add to cart’ actions occurring on the website for users reached by ads.	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 of ‘detail view’ actions occurring on the website for users reached by ads.	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’ events on the advertiser’s website.	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 on the advertiser’s website.	metric
operating_systems	operating_systems	The operating systems targeted by the ad group or 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
optimization_event	optimization_event	The primary conversion event that the ad group is optimized for.	dimension
optimization_goal	optimization_goal	The specific goal for optimizing ad delivery, such as conversions or app installs.	dimension
orders	orders	The total number of orders placed.	metric
owner_bc_id	owner_bc_id	The Business Center ID of the owner of the ad account or asset.	dimension
pacing	pacing	The pacing strategy for budget delivery, controlling 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_event_rate	page_content_view_event_rate	The rate at which users view content on a page after interacting with an ad, calculated as the number of page content view events divided by a relevant base metric.	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
pageview_rate	pageview_rate	The rate at which users view pages, calculated as page views divided by impressions or clicks.	metric
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	The number of engaged views attributed to paid advertising efforts.	metric
pixel_id	pixel_id	The unique identifier of the TikTok Pixel used to track website events.	dimension
placement	placement	The specific location or platform where the ad is displayed.	dimension
placement_type	placement_type	The type of placement where the ad is displayed.	dimension
placements	placements	The specific locations or platforms (e.g., TikTok feed) where ads will be displayed.	dimension
platform	platform	The operating system or environment where the ad was displayed (e.g., iOS, Android).	dimension
playable_url	playable_url	The URL for interactive playable ad creatives.	dimension
postback_window_mode	postback_window_mode	The mode determining the attribution window and postback mechanism for SKAdNetwork campaigns.	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	The source from which products are promoted, such as a product catalog or TikTok Shop.	dimension
product_specific_type	product_specific_type		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	The URL or ID of the profile image associated with the ad or advertiser.	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.	metric
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	The type of object being promoted (e.g., app, website).	dimension
promotion_type	promotion_type	The type of promotion used in a campaign, such as for GMV Max campaigns.	dimension
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 monetary value of a sale resulting from a purchase conversion event.	metric
purchased_impression	purchased_impression	The number of impressions that were purchased for the ad.	dimension
purchased_reach	purchased_reach	The number of unique users reached through purchased ad placements.	dimension
purchases	purchases	The number of purchase actions attributed to the ads.	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
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 for the rejection or disapproval of an ad.	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
rf_campaign_type	rf_campaign_type	The specific type of Reach and Frequency (RF) campaign.	metric
rf_estimated_cpr	rf_estimated_cpr	The estimated cost per reach for a Reach and Frequency campaign at the campaign level.	dimension
rf_estimated_frequency	rf_estimated_frequency	The estimated average number of times an ad is shown to a unique user in a Reach and Frequency campaign.	dimension
rf_purchased_type	rf_purchased_type	The billing method or purchased type for Reach and Frequency ad groups or campaigns.	dimension
roas_bid	roas_bid	The target Return On Ad Spend (ROAS) bid.	dimension
roi	roi	The Return On Investment (ROI) from advertising efforts.	metric
rta_bid_enabled	rta_bid_enabled	Indicates whether Realtime API (RTA) bidding is enabled for the campaign.	dimension
rta_id	rta_id	The Realtime API (RTA) ID, serving as the identifier for the RTA strategy.	dimension
rta_product_selection_enabled	rta_product_selection_enabled	Indicates whether Realtime API (RTA) product selection is enabled to automatically select products for promotion.	dimension
sales_destination	sales_destination	The target destination for sales conversions, such as TikTok Shop, website, or app.	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 unique identifier for a saved or custom 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	Information regarding the schedule and timing of ad delivery.	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	Indicates if the ad is enabled to appear on TikTok’s search results page.	dimension
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 conversion event optimized for.	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	Indicates whether the sharing functionality is disabled for the ad.	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 from TikTok Shop orders, attributed by order submission.	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	The retargeting type employed for shopping ads.	dimension
shopping_ads_type	shopping_ads_type	The specific type of shopping ad, such as video shopping ads or live shopping ads.	dimension
shopping_ads_video_package_id	shopping_ads_video_package_id	The ID of the video package used for shopping ads.	dimension
showcase_products	showcase_products	Products featured in a TikTok Showcase or for showcase ads.	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 whether the learning phase is skipped for the ad or ad group.	dimension
sku_ids	sku_ids	A list of Stock Keeping Unit (SKU) identifiers for products.	dimension
smart_audience_enabled	smart_audience_enabled	Indicates if smart audience targeting features are 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
sound_usage_clicks	sound_usage_clicks	The number of clicks on the ‘Use this sound’ button within TikTok.	metric
source	source	The advertising platform or origin where the ad was run.	dimension
special_industries	special_industries	Special ad categories (e.g., Housing, Employment, Credit) associated with an ad group or ad.	dimension
spend	spend	The total amount of money spent on the ad or campaign.	metric
spend_EUR	spend_EUR	The total advertising spend, reported in EUR.	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	The unique identifier for a split test group.	dimension
split_test_status	split_test_status	The current status of a split test.	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_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 statistical data is reported.	dimension
statistic_type	statistic_type	The statistical type used for conversion bids.	dimension
status	status	The current operational status of the campaign, ad group, or ad (e.g., enabled, disabled, frozen).	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_item_id	tiktok_item_id	The unique identifier for a TikTok post ID, used specifically for Spark Ads.	dimension
tiktok_page_category	tiktok_page_category		dimension
timezone	timezone	The timezone used for reporting and data retrieval.	dimension
title	title	The title or headline of an ad or creative.	dimension
topview_reach_range	topview_reach_range	The estimated reach range for a TopView campaign.	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_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 generated from all page content view 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) from purchases attributed to ads on day 0.	metric
total_purchase_value	total_purchase_value	The total monetary value of purchases.	metric
total_purchase_value_day0	total_purchase_value_day0	Total value of all purchase actions attributed to ads within 24 hours (Day 0) of an app install.	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.	metric
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 per page view.	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
unique_checkouts	unique_checkouts	The number of unique app checkout actions attributed to your ads.	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 in your app attributed to your ads.	metric
unique_view_content	unique_view_content	The number of unique times a user viewed content in your mobile app attributed to your ads.	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 a user takes in response to an ad, such as a click, download, or purchase.	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 completed payment action, reported 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 attributed to the ad.	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 value generated per form submission event occurring on TikTok’s properties.	metric
value_per_onsite_on_web_cart	value_per_onsite_on_web_cart	The value generated per ‘add to cart’ action occurring on the website for users reached by ads.	metric
value_per_onsite_on_web_detail	value_per_onsite_on_web_detail	The value generated per ‘detail view’ action occurring on the website for users reached by ads.	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
video_2s_views	video_2s_views	The number of times your video was played for at least 2 seconds, excluding replays.	metric
video_6s_views	video_6s_views	The number of times your video played for at least 6 seconds or completely, excluding replays.	metric
video_completions	video_completions	The number of times your video was played 100% of its length.	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 your video was played at least 25% of its length.	metric
video_quartile_50_views	video_quartile_50_views	The number of times your video was played at least 50% of its length.	metric
video_quartile_75_views	video_quartile_75_views	The number of times your video was played at least 75% of its length.	metric
video_starts	video_starts	The number of times an ad’s 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_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		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