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 |
Site |
Site |
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 |
ad_adgroup_id |
ad_adgroup_id |
The unique identifier of the ad group to which the ad belongs. |
dimension |
ad_adgroup_name |
ad_adgroup_name |
The name of the ad group to which the ad belongs. |
dimension |
ad_advertiser_id |
ad_advertiser_id |
The ID of the advertiser account that owns the ad. |
dimension |
ad_app_name |
ad_app_name |
The name of the application associated with the ad, relevant for app promotion campaigns. |
dimension |
ad_call_to_action |
ad_call_to_action |
The call-to-action text displayed on the ad. |
dimension |
ad_call_to_action_id |
ad_call_to_action_id |
The unique identifier for the call to action button used in the ad. |
dimension |
ad_campaign_id |
ad_campaign_id |
The unique identifier of the campaign to which the ad belongs. |
dimension |
ad_campaign_name |
ad_campaign_name |
The name of the campaign to which the ad belongs. |
dimension |
ad_card_id |
ad_card_id |
The ID of the card creative used in the ad. |
dimension |
ad_click_rate |
ad_click_rate |
The rate at which users click on an ad after seeing it (Click-Through Rate). |
metric |
ad_click_tracking_url |
ad_click_tracking_url |
The URL used to track clicks on the ad. |
dimension |
ad_conversion_rate |
ad_conversion_rate |
The rate at which users complete a desired action after interacting with an ad. |
metric |
ad_create_time |
ad_create_time |
The timestamp when the ad was created. |
dimension |
ad_creative_authorized |
ad_creative_authorized |
Indicates whether permission is granted to display ads in the TikTok For Business Creative Center. |
dimension |
ad_creative_image_format |
ad_creative_image_format |
The file format of the image creative used in the ad (e.g., JPG, PNG). |
dimension |
ad_creative_image_height |
ad_creative_image_height |
The height of the image creative used in the ad, in pixels. |
dimension |
ad_creative_image_size |
ad_creative_image_size |
The file size of the image creative used in the ad, in bytes. |
dimension |
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. |
metric |
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. |
dimension |
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_is_aco |
ad_is_aco |
Indicates if the ad utilizes Automated Creative Optimization (ACO) to generate multiple creative variations. |
dimension |
ad_is_new_structure |
ad_is_new_structure |
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_like |
ad_like |
The number of âlikesâ received by 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_text |
ad_text |
The main text content of the ad. |
metric |
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_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_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_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_status |
adgroup_secondary_status |
A secondary status indicator for the ad group, providing more detail than the primary status. |
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_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 |
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_no |
advertiser_license_no |
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_area |
advertiser_promotion_area |
metric |
|
advertiser_promotion_center_province |
advertiser_promotion_center_province |
The province associated with the advertiserâs promotion center or primary business location. |
dimension |
advertiser_role |
advertiser_role |
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 |
anchor_clicks |
anchor_clicks |
The number of clicks on anchors within video ads. |
metric |
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_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_profile_external_app_id |
app_profile_external_app_id |
dimension |
|
app_profile_icon |
app_profile_icon |
dimension |
|
app_promotion_type |
app_promotion_type |
The type of app promotion campaign. |
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 |
behavior_name |
behavior_id |
An identifier for a user behavior or interest. |
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 |
brand_market |
brand_market |
dimension |
|
brand_safety_postbid_partner |
brand_safety_postbid_partner |
The third-party partner used for post-bid brand safety measurement. |
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 |
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. |
metric |
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_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 |
card_id |
card_id |
The unique identifier for the card creative used in the ad. |
metric |
carousel_image_index |
carousel_image_index |
The index of an image within a carousel ad. |
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_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 |
comments |
comments |
The number of comments on an ad. |
dimension |
complete_payment |
complete_payment |
The number of complete payment events attributed to ads. |
metric |
complete_payment_rate |
complete_payment_rate |
The rate of complete payment events attributed to ads. |
metric |
complete_payment_roas |
complete_payment_roas |
The Return on Ad Spend (ROAS) specifically for complete payment events. |
metric |
complete_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 |
conversion |
conversion |
The total number of conversion events attributed to the ad. |
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_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_search_event |
cost_per_offline_search_event |
The cost incurred per offline search event. |
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_online_consult |
cost_per_online_consult |
The average cost incurred for each online consultation event attributed to your ads. |
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 |
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 |
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_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 |
deeplink |
deeplink |
The deeplink URL that directs users to specific content within an app. |
dimension |
deeplink_type |
deeplink_type |
The type of deeplink used for the ad. |
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_model_ids |
device_model_ids |
A list of device model IDs targeted by the ad. |
dimension |
display_name |
display_name |
The user-friendly name for a field or entity. |
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_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 |
fallback_type |
fallback_type |
The fallback mechanism or type used when a primary ad action or destination fails. |
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 or engage with details on a form, typically used for lead generation ads. |
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 |
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 |
identity_authorized_bc_id |
identity_authorized_bc_id |
The ID of the Business Center authorized for the adâs identity. |
metric |
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 |
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 |
interest_category |
interest_category |
The broad category of user interests targeted by the ad group. |
metric |
interest_category_name |
interest_category_name |
The name of the interest category used for targeting the audience. |
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 |
is_aco |
is_aco |
Indicates whether Automated Creative Optimization (ACO) is enabled for the ad. |
dimension |
is_new_structure |
is_new_structure |
Indicates if the campaign uses the new campaign structure. |
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_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 |
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 |
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 |
month |
month |
The month in which the ad data was recorded, used as a time dimension for reporting. |
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 |
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 |
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_complete_registration_events |
offline_complete_registration_events |
The number of complete registration events that occurred offline, attributed to the ad campaign. |
metric |
offline_download_events |
offline_download_events |
The number of offline download events attributed to your ads. |
metric |
offline_form_events |
offline_form_events |
The number of offline form submission events attributed to your ads. |
metric |
offline_place_order_events_value |
offline_place_order_events_value |
The total value of offline place order events attributed to the ad campaign. |
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_total_custom_event_value |
offline_total_custom_event_value |
The total value of all custom offline events attributed to the ad campaign. |
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 |
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_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 at which users add items to their cart from the ad on web-based platforms. |
metric |
onsite_on_web_detail |
onsite_on_web_detail |
The number of onsite product detail page views. |
metric |
onsite_on_web_detail_rate |
onsite_on_web_detail_rate |
The rate at which users view product details pages from the ad on web-based platforms. |
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_product_details_page_view_value |
onsite_total_product_details_page_view_value |
The total value generated from product details page views occurring directly on TikTok or partner sites. |
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 |
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 |
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 |
page_status |
page_status |
dimension |
|
paid_engaged_view |
paid_engaged_view |
The number of times a video ad was played for at least 6 seconds or received at least 1 engagement within one day of a user seeing the ad. |
metric |
paid_engaged_view_15s |
paid_engaged_view_15s |
The number of times a video ad was played for at least 15 seconds or received at least 1 engagement within one day of a user seeing the ad. |
metric |
paid_engagement_engaged_view |
paid_engagement_engaged_view |
The number of engaged views attributed to paid advertising efforts. |
metric |
paid_engagement_engaged_view_15s |
paid_engagement_engaged_view_15s |
The number of engaged views on paid content lasting 15 seconds or more. |
metric |
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 |
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 |
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_specific_type |
product_specific_type |
The specific type or category of product being advertised. |
dimension |
product_status |
product_status |
The current status of the product in the catalog (e.g., active, out of stock). |
dimension |
profile_image |
profile_image |
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_type |
promotion_type |
The type of promotion used in a campaign, such as for GMV Max campaigns. |
metric |
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_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 |
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 |
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 |
roas_bid |
roas_bid |
The target Return On Ad Spend (ROAS) bid. |
metric |
roi |
roi |
The Return On Investment (ROI) from advertising efforts. |
metric |
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 |
schedule_end_time |
schedule_end_time |
The scheduled end date and time for an ad entity (e.g., campaign, ad group). |
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 |
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 |
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_status |
secondary_status |
A secondary status for an ad group, providing more granular information beyond the primary status. |
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 |
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 |
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 |
spend |
spend |
The total amount of money spent on the ad or campaign. |
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 |
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 |
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 |
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 |
|
title |
title |
The title or headline of an ad or creative. |
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_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_purchase_value_day2 |
total_purchase_value_day2 |
The total purchase value attributed to the ad campaign within 2 days of interaction. |
metric |
total_purchase_value_day6 |
total_purchase_value_day6 |
The total purchase value attributed to the ad campaign within 6 days of interaction. |
metric |
total_ratings |
total_ratings |
The total number of ratings given by users. |
metric |
total_ratings_value |
total_ratings_value |
The total value of app rate actions attributed to your ads. |
metric |
total_registration |
total_registration |
The total number of registration events. |
metric |
total_sales_lead |
total_sales_lead |
The total number of sales leads generated. |
metric |
total_sales_lead_value |
total_sales_lead_value |
The total value generated from sales leads. |
metric |
total_search |
total_search |
The total number of search events that are attributed to your ads. |
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_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. |
metric |
tt_account_name |
tt_account_name |
The name of the TikTok account associated with the ad. |
dimension |
tt_account_profile_image_url |
tt_account_profile_image_url |
The URL of the profile image for the TikTok account associated with the ad. |
dimension |
tt_app_id |
tt_app_id |
The unique identifier for the TikTok application. |
dimension |
tt_app_name |
tt_app_name |
The name of the TikTok application. |
metric |
tt_playlist_visit |
tt_playlist_visit |
metric |
|
unique_ad_impression_events |
unique_ad_impression_events |
The number of unique times an ad was displayed to a user. |
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_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_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_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 average value generated for each product detail view on web-based platforms. |
metric |
value_per_onsite_shopping |
value_per_onsite_shopping |
The average value generated per shopping event occurring directly on TikTok or partner sites. |
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_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 |
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 |