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.
10_second_live_views Metric
The number of views where a live stream ad was watched for at least 10 seconds.
Audience Dimension
The targeted audience for the ad campaign.
Channel Dimension
The advertising channel where the ad is displayed, such as TikTok or other supported placements.
Creative Messaging Dimension
The main text content or message of the ad creative.
Creative Size Length Dimension
The length dimension (e.g., in pixels or ratio) of an ad creative's visual asset.
Date Dimension
The specific date for which the data is reported.
DayofWeek Dimension
The day of the week when the ad data was recorded.
Format Dimension
The format of the ad creative, such as vertical video or square image.
Month Dimension
The number representing the month.
Month-Year Dimension
The year and month for which data is reported, in a format like '2024|3'.
Platform Dimension
The advertising platform where the ad was displayed, such as TikTok.
Targeting Dimension
The set of audience criteria, demographics, interests, and behaviors used to define who sees the advertisements.
WeekAsDate Dimension
The starting date of the week for which the report data is aggregated, often used as a dimension in reports.
WeekNum Metric
The sequential number of the week within a year for which the report data is aggregated.
Year Dimension
The year for which data is reported.
YearMonth Metric
The year and month for which data is reported, in a format like '2024|3'.
account_id Dimension
The unique identifier for the ad account.
account_name Dimension
The name of the ad account.
achieve_level Metric
The number of times a specific achievement level was reached by users.
achieve_level_rate Metric
The rate at which users achieve a specific level, calculated as achievement level completions divided by relevant impressions or clicks.
actions Metric
The total number of user actions or engagements with the ad.
ad_adgroup_id Dimension
The unique identifier of the ad group to which the ad belongs.
ad_adgroup_name Dimension
The name of the ad group to which the ad belongs.
ad_advertiser_id Dimension
The ID of the advertiser account that owns the ad.
ad_app_name Dimension
The name of the application associated with the ad, relevant for app promotion campaigns.
ad_call_to_action Dimension
The call-to-action text displayed on the ad.
ad_call_to_action_id Metric
The unique identifier for the call to action button used in the ad.
ad_campaign_automation_type Dimension
The type of automation applied to an ad campaign, influencing how it runs and optimizes its performance.
ad_campaign_id Dimension
The unique identifier of the campaign to which the ad belongs.
ad_campaign_name Dimension
The name of the campaign to which the ad belongs.
ad_card_id Dimension
The ID of the card creative used in the ad.
ad_click_tracking_url Dimension
The URL used to track clicks on the ad.
ad_create_time Dimension
The timestamp when the ad was created.
ad_creative_authorized Dimension
Indicates whether permission is granted to display ads in the TikTok For Business Creative Center.
ad_creative_image_format Dimension
The file format of the image creative used in the ad (e.g., JPG, PNG).
ad_creative_image_height Metric
The height of the image creative used in the ad, in pixels.
ad_creative_image_size Dimension
The file size of the image creative used in the ad, in bytes.
ad_creative_image_url Dimension
The URL of the image used in the ad creative.
ad_creative_image_width Dimension
The width of the image creative used in the ad, in pixels.
ad_creative_video_bit_rate Metric
The bit rate of the video creative used in the ad.
ad_creative_video_duration Metric
The duration of the video creative used in the ad.
ad_creative_video_format Dimension
The file format of the video creative used in the ad (e.g., MP4, MOV).
ad_creative_video_height Dimension
The height of the video creative used in the ad, in pixels.
ad_creative_video_preview_url Dimension
The URL for a preview of the video creative used in the ad.
ad_creative_video_size Metric
The file size of the video creative used in the ad, in bytes.
ad_creative_video_video_cover_url Dimension
The URL of the cover image for the video creative used in the ad.
ad_creative_video_width Metric
The width of the video creative used in the ad, in pixels.
ad_deeplink Dimension
The deep link URL configured for the ad, used to direct users to specific content within an app.
ad_deeplink_type Dimension
The type of deep link configured for the ad.
ad_display_name Dimension
The display name of the ad.
ad_external_action Dimension
The name of the shallow external action conversion event.
ad_format Dimension
The format of the ad creative (e.g., image, video, carousel).
ad_group_id Dimension
The unique identifier for the ad group.
ad_group_name Dimension
The name of the ad group.
ad_id Dimension
The unique identifier for the ad.
ad_id_v2 Dimension
The unique identifier for an ad, representing a specific ad creative and its settings.
ad_identity_id Dimension
The unique identifier for an individual ad.
ad_identity_type Dimension
The type of identity used for the ad, such as a TikTok account or business profile.
ad_image_ids Dimension
A list of identifiers for images associated with the ad creative.
ad_impression_tracking_url Dimension
The URL used to track impressions of the ad.
ad_is_aco Dimension
Indicates if the ad utilizes Automated Creative Optimization (ACO) to generate multiple creative variations.
ad_landing_page_url Dimension
The primary landing page URL for the ad.
ad_landing_page_urls Dimension
A list of URLs to which users are directed after clicking on the ad.
ad_modify_time Dimension
The timestamp when the ad was last modified.
ad_name Dimension
The name of the ad.
ad_open_url Dimension
The URL that users are directed to when they click on the ad.
ad_operation_status Dimension
The current operational status of the ad, such as active, paused, or deleted.
ad_page_id Dimension
The unique identifier of the page associated with the ad.
ad_pixel_id Dimension
The ID of the TikTok pixel used to track events for the ad.
ad_playable_url Dimension
The URL for the playable ad creative.
ad_profile_image Metric
The URL or identifier of the profile image associated with the ad's identity.
ad_profile_image_url Dimension
The URL of the profile image displayed with the ad.
ad_secondary_status Dimension
The secondary status of the ad, providing more granular information beyond the primary status.
ad_text Dimension
The main text content of the ad.
ad_texts Dimension
A list of text elements used in the ad creative.
ad_tiktok_item_id Metric
The unique identifier for the specific TikTok content item (e.g., video, post) used in the ad.
ad_type Dimension
The type of ad creative (e.g., single image, video, carousel).
ad_url Dimension
The destination URL associated with the ad.
ad_video_id Dimension
The ID of the video creative used in the ad.
add_billing Metric
The number of times users initiated adding billing information, such as credit card details.
add_billing_rate Metric
The percentage of add payment info actions on your website from all clicks attributed to your ads.
add_payment_info Metric
The number of unique 'add payment info' actions attributed to your ads.
add_payment_info_rate Metric
The rate at which users added payment information after interacting with your ads.
add_to_wishlist Metric
The number of unique 'add to wishlist' actions attributed to your ads.
add_to_wishlist_rate Metric
The rate at which users add items to a wishlist.
adgroup_advertiser_id Dimension
The unique identifier of the advertiser account that owns the ad group.
adgroup_age Dimension
The age demographic targeted by the ad group.
adgroup_age_groups Dimension
The age ranges used in targeting for your ad group.
adgroup_app_download_url Dimension
The URL where users are directed to download the app after interacting with an ad in this ad group.
adgroup_app_id Dimension
The application ID associated with the ad group, primarily for app promotion campaigns.
adgroup_app_profile_page_state Dimension
The state of the app profile page associated with the ad group.
adgroup_app_type Dimension
The type of mobile application targeted by the ad group (e.g., iOS, Android).
adgroup_audience Dimension
The audience segments targeted by the ad group.
adgroup_audience_ids Dimension
The unique identifiers for audience lists targeted by the ad group.
adgroup_bid Metric
The bid amount set for the ad group.
adgroup_bid_price Metric
The bid price set for the ad group.
adgroup_bid_type Dimension
The bidding strategy or type configured for the ad group.
adgroup_billing_event Dimension
The billing event type selected for the ad group (e.g., CPM, CPC).
adgroup_brand_safety Dimension
The brand safety settings applied to the ad group.
adgroup_brand_safety_type Dimension
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).
adgroup_budget Metric
The budget allocated to the ad group.
adgroup_budget_mode Dimension
The budget pacing strategy for the ad group, indicating how the budget is allocated over time (e.g., daily or total).
adgroup_campaign_id Dimension
The unique identifier of the campaign to which the ad group belongs.
adgroup_carriers Dimension
The mobile carriers targeted by the ad group.
adgroup_category Dimension
The category assigned to the ad group.
adgroup_click_attribution_window Dimension
The time frame after a click within which a conversion is attributed to the ad group.
adgroup_comment_disabled Dimension
Indicates whether comments are disabled for ads within this ad group.
adgroup_conversion_bid_price Metric
The bid amount set for a conversion event at the ad group level.
adgroup_conversion_id Dimension
The identifier of the conversion event that the ad group is optimized for.
adgroup_conversion_window Dimension
The time window after an ad interaction during which a conversion is attributed to the ad group.
adgroup_create_time Dimension
The timestamp when the ad group was created.
adgroup_creative_material_mode Dimension
The creative material mode setting for the ad group, indicating the type of ad creative format used (e.g., single video, image).
adgroup_dayparting Metric
The scheduling settings that define specific times of day or days of the week for ad delivery within the ad group.
adgroup_deep_bid_type Dimension
The bidding strategy for deep conversions or in-app events within the ad group.
adgroup_deep_cpa_bid Metric
The Cost Per Action (CPA) bid specifically for deep conversion events within the ad group.
adgroup_device_price_ranges Dimension
This field specifies the targeted device price ranges for an ad group, allowing advertisers to reach users with devices within certain price brackets.
adgroup_download_url Dimension
The URL for downloading an app or visiting a website associated with the ad group.
adgroup_excluded_audience_ids Dimension
A list of audience identifiers that are excluded from targeting for this ad group.
adgroup_frequency Metric
The frequency cap setting for the ad group, controlling how often a user sees an ad.
adgroup_frequency_schedule Metric
The frequency capping schedule configured for the ad group.
adgroup_gender Dimension
The genders targeted for your ad group, or the genders of people who engaged with your ad.
adgroup_id Dimension
The unique identifier for the ad group.
adgroup_included_custom_actions Dimension
A list of custom actions that are included for optimization within the ad group.
adgroup_interest_category_ids Dimension
The IDs of interest categories targeted by the ad group.
adgroup_inventory_filter_enabled Dimension
Indicates if inventory filtering is enabled for the ad group to control ad placement.
adgroup_ios14_quota_type Dimension
The iOS 14 quota type for the ad group, related to SKAdNetwork campaign limitations.
adgroup_is_new_structure Dimension
Indicates whether the ad group is configured with the new campaign structure.
adgroup_keywords Dimension
The keywords used for targeting within the ad group.
adgroup_languages Dimension
The languages targeted by the ad group.
adgroup_location Dimension
The geographical location(s) targeted by the ad group.
adgroup_location_ids Dimension
The geographic region IDs targeted by the ad group.
adgroup_modify_time Dimension
The timestamp when the ad group was last modified.
adgroup_name Dimension
The name of the ad group.
adgroup_network_types Dimension
The network types (e.g., Wi-Fi, mobile data) targeted by the ad group.
adgroup_operating_systems Dimension
The operating systems targeted by the ad group.
adgroup_operation_status Dimension
The current operational status of the ad group, indicating whether it is running, paused, or completed.
adgroup_opt_status Dimension
The optimization status of the ad group.
adgroup_optimization_event Dimension
The specific event the ad group is optimized for (e.g., app install, purchase).
adgroup_optimization_goal Dimension
The overall goal for optimization set for the ad group.
adgroup_optimize_goal Dimension
The optimization goal set for the ad group (e.g., conversions, clicks).
adgroup_pacing Dimension
The pacing strategy for the ad group's budget, controlling daily spend distribution.
adgroup_pixel_id Dimension
The Pixel ID used by the ad group for tracking website events.
adgroup_placement_type Dimension
The placement type where the ad group's ads will appear.
adgroup_product_source Dimension
The source of the products advertised in the ad group, such as a product catalog.
adgroup_promotion_type Dimension
The type of promotion or objective for the ad group.
adgroup_purchased_impression Metric
The number of impressions purchased for the ad group.
adgroup_purchased_reach Dimension
The number of unique users reached for the ad group based on purchased media.
adgroup_rf_estimated_cpr Metric
The estimated cost per reach for a Reach and Frequency (RF) ad group.
adgroup_rf_estimated_frequency Metric
The estimated average number of times a user sees an ad from the reservation campaign within the ad group.
adgroup_rf_purchased_type Dimension
The purchased type for a Reach and Frequency (RF) ad group.
adgroup_schedule_end_time Dimension
The scheduled end time for the ad group to run.
adgroup_schedule_start_time Dimension
The scheduled start time for the ad group to run.
adgroup_schedule_type Dimension
The type of schedule applied to the ad group, e.g., always-on or specific hours.
adgroup_scheduled_budget Metric
The total budget allocated for the ad group over its scheduled duration.
adgroup_secondary_optimization_event Dimension
A secondary conversion event defined for the ad group, used for optimization alongside the primary optimization event.
adgroup_secondary_status Dimension
A secondary status indicator for the ad group, providing more detail than the primary status.
adgroup_share_disabled Dimension
Indicates whether sharing to third-party platforms is disabled for ads within this ad group.
adgroup_skip_learning_phase Dimension
Indicates whether the learning phase for the ad group was skipped, which is a period where the ad platform optimizes ad delivery.
adgroup_split_test_adgroup_ids Dimension
Identifiers of ad groups that are part of a split test along with the current ad group.
adgroup_statistic_type Dimension
The statistical type or method used for reporting metrics at the ad group level.
adgroup_status Dimension
The current operational status of the ad group (e.g., enabled, paused).
adgroup_video_download_disabled Dimension
Indicates whether the option to download videos from ads within the ad group is disabled.
adgroup_view_attribution_window Dimension
The time window during which a view of an ad group's ad can be attributed to a conversion.
ads_impression_events Metric
The total number of ad impression events from your mobile app counted as app events and attributed to your ads.
advertiser_account_type Dimension
The type of the advertiser account on the TikTok Ads platform.
advertiser_address Dimension
The physical address of the advertiser.
advertiser_balance Metric
The available balance in the advertiser's account.
advertiser_brand Dimension
The brand name associated with the advertiser.
advertiser_company Dimension
The name of the advertiser's company.
advertiser_country Dimension
The country where the advertiser is located.
advertiser_create_time Dimension
The timestamp when the advertiser account was created.
advertiser_currency Dimension
The currency used by the advertiser's account.
advertiser_description Dimension
A description of the advertiser or their business.
advertiser_display_timezone Dimension
The display timezone configured for the advertiser's account.
advertiser_id Dimension
The unique identifier for the advertiser account.
advertiser_industry Metric
The industry of the advertiser.
advertiser_language Dimension
The language set for the advertiser's account.
advertiser_license_province Dimension
The province where the advertiser's business license is registered.
advertiser_name Dimension
The name of the advertiser.
advertiser_owner_bc_id Dimension
The unique identifier of the Business Center that owns the advertiser account.
advertiser_promotion_center_province Dimension
The province associated with the advertiser's promotion center or primary business location.
advertiser_rejection_reason Dimension
The specific reason provided for the rejection of an ad by the advertiser or the platform.
advertiser_status Dimension
The current status of the advertiser account.
advertiser_timezone Dimension
The timezone configured for the advertiser account.
age Dimension
The age of the targeted audience or users who engaged with the ad.
age_groups Dimension
A list of age groups targeted by the ad.
anchor_click_rate Metric
Percentage of anchor clicks out of all impressions on your ads.
anchor_clicks Metric
The number of clicks on anchors within video ads.
app_download_url Dimension
The URL where the application can be downloaded.
app_event_add_to_cart Metric
The number of add to cart events that occurred within an app, attributed to your ads.
app_event_add_to_cart_rate Metric
The rate at which users add items to their cart within an app.
app_id Dimension
The unique identifier for the application associated with the ad.
app_install Metric
The number of app installs attributed to the ad campaign.
app_name Dimension
The display name of the promoted application.
app_promotion_type Dimension
The type of app promotion, such as app install or deep link.
app_type Dimension
The type of application (e.g., iOS, Android).
attribution_event_count Dimension
The total count of events attributed to an ad.
audience_ids Dimension
The unique identifiers for the audience segments targeted.
audience_rule Dimension
The defined criteria or rules used to target a specific audience for ad delivery.
audience_type Dimension
The type of audience used for targeting, such as custom audience or lookalike audience.
auto_targeting_enabled Dimension
A setting that indicates whether automatic targeting expansion is enabled for an ad group or campaign, allowing the system to find a broader relevant audience.
avatar_icon_web_uri Dimension
The web URI for the avatar icon used in the ad.
average_video_play Metric
The average duration a video ad was played.
average_video_play_per_user Metric
The average time your video was played per unique user, including any time spent replaying the video.
avg_value_per_pageview Metric
The average monetary value generated for each page view event on your website or app, attributed to your ads.
balance Metric
The current financial balance or remaining credit in the advertiser's account.
bc_company Dimension
The company associated with the Business Center in TikTok Ads.
bc_currency Dimension
The currency code used for the Business Center and advertiser account, such as USD.
bc_name Dimension
The name of the Business Center account.
bc_status Dimension
The operational status of the Business Center in TikTok Ads.
bc_timezone Dimension
The time zone set for the Business Center or ad account. This affects all time-related functions like data reporting and ad scheduling and cannot be changed after registration.
bc_type Dimension
The classification or category of the Business Center account (e.g., Advertiser, Agency).
bid Metric
The bid amount set for the ad group or campaign.
bid_display_mode Dimension
The display mode for bids set at the ad group level.
bid_price Metric
The specific bid price set for optimization goals.
bid_strategy Dimension
The bidding strategy employed for the ad group or campaign (e.g., lowest cost, cost cap).
bid_type Dimension
The type of bidding strategy used, such as CPC, CPM, or oCPC.
billed_cost Metric
The actual cost incurred for the ads, which has been billed.
billing_event Dimension
The event type on which billing is based (e.g., clicks, impressions).
brand_safety_partner Dimension
The third-party brand safety partner integrated with the campaign to ensure ads appear in appropriate contexts (e.g., IAS, DoubleVerify).
brand_safety_postbid_partner Dimension
The third-party partner used for post-bid brand safety measurement.
brand_safety_type Dimension
The type of brand safety applied to the ad group.
brand_safety_vast_url Dimension
The VAST URL used by a post-bid third-party partner to measure brand safety.
branded_content_disabled Dimension
Indicates whether branded content features are disabled for the ad or account, impacting content disclosure and monetization.
budget Metric
The allocated budget for a campaign or ad group.
budget_mode Dimension
The mode in which the budget is managed (e.g., daily, lifetime, infinite).
budget_optimize_on Dimension
Indicates whether budget optimization is enabled for a campaign or ad group. This is conceptually similar to 'Budget Optimize Switch' at the campaign level.
button_click Metric
The number of clicks on a button within the ad creative.
button_click_rate Metric
The rate at which users click on buttons within ads.
buying_type Dimension
Refers to the method of buying ads, such as auction or reservation.
call_to_action Dimension
The call-to-action text displayed on the ad, prompting users to take a specific action.
call_to_action_id Dimension
The unique identifier for the specific call-to-action button used in the ad.
campaign Dimension
The name or identifier of the advertising campaign.
campaign_app_profile_page_state Dimension
The state of the app profile page associated with the campaign.
campaign_automation_type Dimension
The automation type configured for the campaign.
campaign_budget Metric
The budget allocated to the campaign.
campaign_budget_mode Dimension
The budget mode for the campaign (e.g., daily, total).
campaign_budget_optimize_on Dimension
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign. This is similar to 'Budget Optimize Switch'.
campaign_create_time Dimension
The timestamp when the campaign was created.
campaign_dedicate_type Metric
The specific type or objective of an advertising campaign, such as an iOS14 Dedicated Campaign.
campaign_deep_bid_type Dimension
The bidding strategy used for deep conversions or in-app events at the campaign level.
campaign_id Dimension
The unique identifier for the campaign.
campaign_is_new_structure Dimension
Indicates if the campaign belongs to a new advertising structure or system.
campaign_is_smart_performance_campaign Dimension
Indicates if the campaign is a Smart Performance Campaign, utilizing automated optimization.
campaign_modify_time Dimension
The timestamp when the campaign was last modified.
campaign_name Dimension
The name of the campaign.
campaign_objective Dimension
The marketing objective of the campaign (e.g., Reach, Traffic, Conversions).
campaign_objective_type Dimension
The primary objective of the advertising campaign, such as reach, traffic, or conversions.
campaign_operation_status Dimension
The current operational status of the campaign, indicating whether it is running, paused, or completed.
campaign_optimization_goal Dimension
The goal for optimization set for the campaign.
campaign_product_source Dimension
The source of the products advertised in the campaign, such as a product catalog.
campaign_rf_campaign_type Dimension
The type of reach and frequency (RF) campaign.
campaign_roas_bid Metric
The target Return On Ad Spend (ROAS) bid set for the campaign.
campaign_secondary_status Dimension
The secondary status of the campaign, providing more granular information beyond the primary status.
campaign_special_industries Dimension
Specifies if the campaign targets or is associated with special industries like Housing, Employment, or Credit.
campaign_status Dimension
The current operational status of the campaign (e.g., active, paused, deleted).
campaign_type Dimension
The type of the campaign.
card_id Dimension
The unique identifier for the card creative used in the ad.
carousel_image_index Dimension
The index of an image within a carousel ad.
carrier_ids Dimension
A list of mobile carrier IDs targeted by the ad group for more precise audience reach.
cash_spend Metric
The total cash amount spent on the ad campaign.
catalog_authorized_bc_id Dimension
The business center ID authorized to manage the product catalog.
catalog_enabled Dimension
Indicates if a product catalog is enabled for the campaign.
catalog_id Dimension
The unique identifier for a product catalog used in shopping ads.
catalog_name Dimension
The name of the product catalog associated with the ad.
category_exclusion_ids Dimension
A list of content category IDs that are excluded from ad placements to enhance brand suitability and avoid undesirable content adjacencies.
checkout Metric
The number of checkout events attributed to the ad.
checkout_rate Metric
The rate at which users initiated or completed a checkout process after interacting with your ads.
click_attribution_window Dimension
The time window during which a click can be attributed to a conversion event.
click_tracking_url Dimension
The URL used to track clicks on the ad.
clicks Metric
The total number of clicks on an ad.
clicks_on_hashtag_challenge Metric
The total number of clicks on the hashtag challenge associated with an ad during its campaign.
clicks_on_music_disc Metric
The number of clicks on the music disc icon within a Spark Ad.
comment_disabled Dimension
Indicates whether comments are allowed on ads for this ad group on platforms like TikTok, Vigo, and Helo.
comments Metric
The number of comments on an ad.
complete_payment Metric
The number of complete payment events attributed to ads.
complete_payment_rate Metric
The rate of complete payment events attributed to ads.
complete_payment_roas Metric
The Return on Ad Spend (ROAS) specifically for complete payment events.
complete_tutorial Metric
The number of times users have completed a tutorial.
complete_tutorial_rate Metric
The rate at which users complete a tutorial after interacting with an ad.
consultation Metric
The number of consultation events.
contextual_tag_ids Dimension
A list of IDs for contextual tags used for targeting. This relates to the 'Contextual Tag' field.
conversion Metric
The total number of conversion events attributed to the ad.
conversion_bid_price Metric
The bid price specifically set for conversion optimization.
conversion_rate Metric
The percentage of users who clicked on your ad and completed a desired action.
conversion_rate_v2 Metric
The rate at which ad interactions lead to a desired conversion event, version 2.
conversions Metric
The total number of conversions attributed to the ad.
cost Metric
The total amount of money spent on advertising.
cost_per_1000_reached Metric
The cost incurred for every 1000 unique users reached by the ad.
cost_per_10_second_live_view Metric
The average cost incurred for each 10-second view of a live stream ad.
cost_per_achieve_level Metric
The average cost for each time a user achieved a specific level within your app, attributed to your ads.
cost_per_add_billing Metric
The average cost for each 'add payment info' action on your website attributed to your ads.
cost_per_add_payment_info Metric
The average cost for each event where a user added payment information after interacting with your ads.
cost_per_add_to_wishlist Metric
The average cost for each time a user added an item to a wishlist after interacting with your ads.
cost_per_app_event_add_to_cart Metric
The average cost incurred for each in-app 'add to cart' event.
cost_per_app_install Metric
The average cost incurred for each app install.
cost_per_button_click Metric
The average cost incurred for each button click on an ad.
cost_per_checkout Metric
The average cost for each checkout event initiated or completed by users after interacting with your ads.
cost_per_complete_payment Metric
The average cost incurred for each completed payment.
cost_per_complete_tutorial Metric
The average cost for each time a user completed a tutorial within your app, attributed to your ads.
cost_per_conversion Metric
The average cost incurred for each conversion attributed to your ads.
cost_per_create_gamerole Metric
The average cost for each time a user created a gamerole within your app, attributed to your ads.
cost_per_create_group Metric
The average cost for each time a user created a group within your app, attributed to your ads.
cost_per_cta_app_install Metric
The average cost incurred for each app install resulting from a Call To Action (CTA).
cost_per_cta_conversion Metric
The average cost incurred for each conversion resulting from a Call To Action (CTA).
cost_per_cta_purchase Metric
The average cost for each payment event attributed to clicks on a Call-to-Action.
cost_per_cta_registration Metric
The average cost incurred for each registration resulting from a Call To Action (CTA).
cost_per_custom_app_event Metric
The average cost incurred for each custom in-app event.
cost_per_custom_page_event Metric
The average cost incurred for each custom page event on a website.
cost_per_download_start Metric
The average cost for each time a user initiated an app download after interacting with your ads.
cost_per_engaged_view_through_conversion Metric
The average cost incurred for each conversion attributed to an engaged view-through.
cost_per_form Metric
The average cost incurred for each form submission.
cost_per_in_app_ad_click Metric
The average cost for each click on an ad displayed within your mobile app, attributed to your ads.
cost_per_in_app_ad_impr Metric
The average cost for each impression of an ad displayed within your mobile app, attributed to your ads.
cost_per_initiate_checkout Metric
The average cost for each time a user initiated the checkout process after interacting with your ads.
cost_per_join_group Metric
The average cost for each time a user joined a group within your app, attributed to your ads.
cost_per_landing_page_view Metric
The average cost incurred for each landing page view.
cost_per_launch_app Metric
The average cost for each time a user launched your app after interacting with your ads.
cost_per_live_view Metric
The average cost incurred for each view of a live stream ad.
cost_per_loan_apply Metric
The average cost for each time a user applied for a loan after interacting with your ads.
cost_per_loan_credit Metric
The average cost for each time a user received loan credit after interacting with your ads.
cost_per_loan_disbursement Metric
The average cost for each time a loan was disbursed to a user after they interacted with your ads.
cost_per_login Metric
The average cost for each time a user logged into your app or service after interacting with your ads.
cost_per_next_day_open Metric
The average cost incurred for each app open on the day following installation.
cost_per_offline_add_payment_info_event Metric
The average cost incurred for each offline 'Add Payment Info' event, attributed to your ads.
cost_per_offline_form_event Metric
The average cost incurred for each offline 'form submission' event.
cost_per_offline_subscribe_event Metric
The average cost incurred for each offline 'subscribe' event.
cost_per_on_web_add_to_wishlist Metric
The average cost incurred for each 'add to wishlist' event that occurred on the website.
cost_per_on_web_order Metric
The average cost incurred for each order placed on a website.
cost_per_on_web_subscribe Metric
The average cost incurred for each 'subscribe' event that occurred on the website.
cost_per_online_consult Metric
The average cost for each online consultation event attributed to your ads.
cost_per_onsite_form Metric
The average cost incurred for each form submission event on the advertiser's website.
cost_per_onsite_initiate_checkout_count Dimension
The average cost incurred for each 'initiate checkout' event that occurred on the advertiser's website.
cost_per_onsite_on_web_cart Metric
The average cost incurred for each 'add to cart' event that occurred on the advertiser's website.
cost_per_onsite_on_web_detail Metric
The average cost incurred for each 'view product detail' event that occurred on the advertiser's website.
cost_per_order Metric
The average cost incurred for each order.
cost_per_page_browse_view Metric
The average cost for each page browse or view event on your website or app, attributed to your ads.
cost_per_page_event_search Metric
The average cost incurred for each search event on a landing page.
cost_per_pageview Metric
The average cost incurred for each page view attributed to the ad.
cost_per_product_details_page_browse Metric
The average cost for each view of a product details page on your website or app, attributed to your ads.
cost_per_purchase Metric
The average cost incurred for each purchase.
cost_per_ratings Metric
The average cost for each time a user submitted a rating after interacting with your ads.
cost_per_registration Metric
The average cost for each new user registration attributed to your ads.
cost_per_result Metric
The average cost incurred for each desired result (e.g., conversion, click) achieved by your ads.
cost_per_sales_lead Metric
The average cost incurred for generating a sales lead, attributed to your ads.
cost_per_search Metric
The average cost incurred for each search action.
cost_per_secondary_goal_result Dimension
The average cost incurred for each achievement of a secondary goal result, attributed to your ads.
cost_per_spend_credits Metric
The average cost for each time a user spent credits within your app or service, attributed to your ads.
cost_per_start_trial Metric
The average cost for each time a user started a trial for your service or product, attributed to your ads.
cost_per_subscribe Metric
The average cost incurred for each subscription event, attributed to your ads.
cost_per_total_achieve_level Metric
The total average cost for all times a user achieved a specific level within your app, attributed to your ads.
cost_per_total_add_to_wishlist Metric
The total average cost for all times a user added an item to a wishlist after interacting with your ads.
cost_per_total_app_event_add_to_cart Metric
The average cost incurred for each 'add to cart' app event.
cost_per_total_checkout Metric
The average cost incurred for each total checkout completion event attributed to your ads.
cost_per_total_complete_tutorial Metric
The total average cost for all times a user completed a tutorial within your app, attributed to your ads.
cost_per_total_create_gamerole Metric
The total average cost for all times a user created a gamerole within your app, attributed to your ads.
cost_per_total_create_group Metric
The total average cost for all times a user created a group within your app, attributed to your ads.
cost_per_total_in_app_ad_click Metric
The total average cost for all clicks on ads displayed within your mobile app, attributed to your ads.
cost_per_total_in_app_ad_impr Metric
The total average cost for all impressions of ads displayed within your mobile app, attributed to your ads.
cost_per_total_join_group Metric
The total average cost for all times a user joined a group within your app, attributed to your ads.
cost_per_total_launch_app Metric
The total average cost for all times a user launched your app after interacting with your ads.
cost_per_total_loan_apply Metric
The total average cost for all times a user applied for a loan after interacting with your ads.
cost_per_total_loan_credit Metric
The total average cost for all times a user received loan credit after interacting with your ads.
cost_per_total_loan_disbursement Metric
The total average cost for all loan disbursements to users after they interacted with your ads.
cost_per_total_login Metric
The total average cost for all times a user logged into your app or service after interacting with your ads.
cost_per_total_next_day_open Metric
The average cost for each Day 1 retention (unique next-day open) of your app attributed to your ads.
cost_per_total_purchase Metric
The average cost for each purchase event attributed to your ads, encompassing all purchases.
cost_per_total_ratings Metric
The total average cost for all user ratings submitted after interacting with your ads.
cost_per_total_registration Metric
The total average cost for all new user registrations attributed to your ads.
cost_per_total_sales_lead Metric
The average cost incurred for each total sales lead generated, attributed to your ads.
cost_per_total_search Metric
The average cost incurred for all search actions.
cost_per_total_subscribe Metric
The average cost incurred for each total subscription event, attributed to your ads.
cost_per_total_view_content Metric
The average cost incurred for all content view events.
cost_per_unique_ad_impression_event Metric
The average cost incurred for each unique ad impression event.
cost_per_unique_custom_app_event Metric
The cost incurred per unique custom app event.
cost_per_view_content Metric
The average cost incurred for each view content event.
cost_per_vta_app_install Metric
The average cost incurred for each app install attributed to a user viewing an ad without clicking on it (view-through attribution). This is a metric calculated from in-app events and attribution data.
cost_per_web_event_add_to_cart Metric
The average cost incurred for each 'add to cart' web event.
cost_total_add_payment_info Metric
The total cost incurred for users initiating adding payment information, attributed to the ad.
cost_usd Metric
The total cost incurred in United States Dollars (USD) for the advertising entity.
countdown_sticker_recall_clicks Metric
Number of clicks on a reminder from the countdown sticker to a specified destination.
country Dimension
The country associated with the ad account or targeted by the ad.
country_code Dimension
The two-letter ISO 3166-1 code for the country associated with the advertiser or targeted by the ad.
cpc Metric
Cost Per Click, the average cost for each click on your ad.
cpm Metric
Cost Per Mille, the average cost for 1000 impressions of your ad.
cpv_video_duration Dimension
The video duration threshold for Cost Per View (CPV) billing at the ad group level.
create_gamerole Metric
The number of unique app create role actions attributed to your ads.
create_group Metric
The number of unique app create group actions attributed to your ads.
create_time Dimension
The timestamp when the object (e.g., campaign, ad group) was created.
creative_authorized Dimension
Indicates if the creative is authorized for use or display in the TikTok Creative Center.
creative_material_mode Dimension
The mode or type of creative material used in the ad.
creative_preview_final_url Dimension
The URL for a preview of the ad creative or its final landing page.
creative_type Dimension
The format or type of the ad creative, such as single image, video, or carousel.
cta_app_install Metric
The number of app installs triggered by a Call To Action (CTA).
cta_conversion Metric
The number of conversions triggered by a Call To Action (CTA).
cta_purchase Metric
The number of purchases attributed to clicks on a Call-to-Action button.
cta_registration Metric
The number of registrations triggered by a Call To Action (CTA).
ctr Metric
Click-Through Rate, the percentage of users who click on your ad after seeing it.
currency Dimension
The currency in which the financial data is reported.
custom_app_event_rate Metric
The rate at which users complete custom in-app events.
custom_app_events Metric
The total number of custom events that occurred within an app, attributed to ads.
custom_app_events_value Metric
The total monetary value associated with custom in-app events.
custom_event_type Dimension
The user-defined type or name of a custom event tracked for conversion or action monitoring.
custom_page_event_rate Metric
The rate at which users complete custom page events on a website.
custom_page_events Metric
The total number of custom events that occurred on a webpage, attributed to ads.
custom_page_events_value Metric
The total monetary value associated with custom webpage events.
dark_post_status Dimension
The status of a 'dark post' ad, which is an unpublished post used for advertising.
date Dimension
The date for which the data is reported.
dayparting Metric
The schedule for displaying ads during specific times of the day or certain days of the week.
deep_bid_type Dimension
The bidding strategy used for in-app events. This is similar to 'Campaign Deep Bid Type'.
deep_cpa_bid Metric
A bidding strategy focused on optimizing for a specific cost-per-action (CPA) for 'deep' conversion events, which occur further down the conversion funnel.
deeplink Dimension
The deeplink URL that directs users to specific content within an app.
deeplink_format_type Dimension
Specifies the format type of the deep link used in the ad.
deeplink_type Dimension
The type of deeplink used for the ad.
deeplink_utm_params Dimension
A list of UTM parameters appended to deep links for tracking campaign performance.
delivery_mode Dimension
The delivery mode for an ad group, affecting how ads are served.
description Dimension
The main text content that provides details about the ad or advertised product/service.
device Dimension
The type of device on which the ad was displayed (e.g., mobile, tablet).
device_brand_id Dimension
The identifier for the brand of the device on which the ad was displayed.
device_brand_name Dimension
The name of the brand of the device on which the ad was displayed.
device_category Dimension
The category of device (e.g., mobile, desktop) on which the ad was displayed.
device_model_ids Dimension
The IDs of specific device models targeted by the campaign or ad group.
device_price_ranges Dimension
Defines the price ranges of user devices that are targeted for ad delivery.
device_type Dimension
The specific type or brand of device used by the audience viewing the ad.
disable_skan_campaign Dimension
Indicates whether SKAdNetwork (SKAN) attribution, Apple's conversion attribution solution for iOS campaigns, is disabled for the campaign. This is similar to 'Campaign Disable SKAN'.
disclaimer_clickable_texts Dimension
A list of clickable text elements and their corresponding URLs for disclaimers in the ad.
disclaimer_text Dimension
The text content of a standard disclaimer displayed in the ad, with a maximum of 90 characters.
disclaimer_type Dimension
The type of disclaimer used in the ad, such as standard, clickable, or AI-generated content.
discount_amount Dimension
The total monetary value of discounts applied to TikTok Shop orders attributed to ads.
discount_percentage Dimension
The percentage of the discount applied to ad charges, often part of an advertiser incentive or coupon program.
discount_type Dimension
The type of discount offered, such as a percentage off or a fixed amount (e.g., Discount Coupon, Ladder Coupon).
display_name Dimension
The user-friendly name for a field or entity.
display_timezone Dimension
The timezone used for displaying report data.
dma_id Dimension
The identifier for the Designated Market Area (DMA) where the ad was shown.
dma_name Dimension
The name of the Designated Market Area (DMA) where the ad was shown.
download_button Metric
The number of clicks on a download button in the ad.
download_start Metric
The number of times a download initiated after ad interaction.
dpa_target_audience_type Metric
The target audience type for Dynamic Product Ads (DPA).
duet_clicks Metric
The number of clicks on the 'Duet' button associated with an ad.
duration Metric
The duration of the video or audio creative in seconds.
dynamic_destination Dimension
The dynamic destination setting for ads, which can include dynamic landing pages.
dynamic_format Dimension
The dynamic format used for ad creatives, often for dynamic product ads.
engaged_view Metric
The number of engaged views on a video ad.
engaged_view_15s Metric
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.
engaged_view_attribution_window Dimension
The time window during which an engaged view can be attributed to a conversion.
engaged_view_through_conversions Metric
The number of conversions attributed to users who saw an ad and engaged with it without clicking, within the attribution window.
engagement_rate Metric
The percentage of engagements (likes, comments, shares, follows, clicks) an ad receives relative to its impressions.
engagements Metric
The total number of engagements with the ad (e.g., likes, comments, shares).
event_name Dimension
The name of a specific event tracked by the TikTok Ads platform.
events Metric
The total number of occurrences for a specific event.
excluded_audience_ids Dimension
The IDs of audience segments that are explicitly excluded from targeting.
excluded_custom_actions Dimension
A list of custom actions or events that are explicitly excluded from being tracked or used for audience targeting and optimization within an ad group.
fallback_type Dimension
The fallback mechanism or type used when a primary ad action or destination fails.
feed_type Dimension
The type of feed associated with the ad group.
follows Metric
The number of new followers gained due to the ad.
form Metric
The number of form submission events.
form_button Metric
The number of times users clicked a form button, attributed to your ads.
form_detail Metric
The number of details page browse events from forms.
form_fills Metric
The total number of form submissions attributed to ad interactions.
form_rate Metric
The percentage of website lead actions from all clicks attributed to your ads.
frequency Metric
The average number of times an ad was shown to a unique user.
frequency_lifetime Metric
The average number of times each unique user saw your ads over the entire lifetime of the campaign.
frequency_mtd Metric
The average number of times a unique user has seen your ad, measured from the beginning of the month to the current date.
frequency_schedule Metric
The schedule configured for the ad group that controls how often a user sees an ad within a specified period (frequency capping).
gender Dimension
The gender of the targeted audience or users who engaged with the ad.
gross_impressions Metric
The total number of times an ad was shown.
gross_revenue Metric
The total revenue generated before any deductions.
household_income Dimension
The estimated household income of the audience reached by the ads, used for targeting or reporting.
identity_authorized_bc_id Dimension
The ID of the Business Center authorized for the ad's identity.
identity_id Metric
The unique identifier for the identity (e.g., brand profile) associated with the ad.
identity_type Dimension
The type of identity (e.g., TikTok account, business profile) used to represent the advertiser in the ad.
image_id Dimension
The unique identifier for an image creative used in an ad.
image_ids Dimension
A list of unique identifiers for images used in the ad creative.
impression_tracking_url Dimension
The URL used to track impressions for the ad.
impressions Metric
The total number of times an ad was shown.
in_app_ad_click Metric
The number of clicks on an ad within an application.
in_app_ad_impr Metric
The number of unique in-app ad impression events attributed to your ads.
included_custom_actions Dimension
A list of custom actions or events that are specifically included for tracking, audience targeting, or optimization purposes within an ad group.
industry Metric
The primary business sector or vertical to which the advertiser belongs or the ad relates.
initiate_checkout Metric
The number of times a user started the checkout process after interacting with an ad.
initiate_checkout_rate Metric
The rate at which users initiated a checkout process, attributed to your ads.
interactive_add_on_activity_clicks Metric
The number of clicks on interactive add-ons within the ad, such as polls, quizzes, or other engagement features.
interactive_add_on_destination_clicks Metric
The number of clicks on destinations linked from interactive add-ons within the ad.
interactive_add_on_impressions Metric
The number of impressions for interactive add-ons in an ad.
interactive_add_on_option_a_clicks Metric
The number of clicks on option A of an interactive add-on in an ad.
interactive_add_on_option_b_clicks Metric
The number of clicks on option B of an interactive add-on in an ad.
interest_category Metric
The broad category of user interests targeted by the ad group.
interest_category_ids Dimension
The IDs of interest categories targeted by the campaign or ad group.
interest_category_name Dimension
The name of the interest category targeted.
interest_category_tier2 Metric
A second-tier category for audience interest targeting.
interest_category_tier3 Metric
The third-tier interest category for audience targeting.
interest_category_tier4 Metric
The fourth tier of a specific interest category targeted by the ad.
interest_keyword_ids Dimension
A list of unique identifiers for specific interests or keywords used to target audiences.
inventory_filter_enabled Dimension
Indicates if inventory filtering is enabled, allowing advertisers to control the type of content next to which their ads appear.
ios14_quota_type Dimension
A field related to the campaign's measurement and attribution settings in the context of iOS 14 privacy changes, affecting ad performance tracking.
ios14_targeting Dimension
Indicates whether targeting specific to iOS 14 privacy settings is enabled or configured.
is_aco Metric
Indicates whether Automated Creative Optimization (ACO) is enabled for the ad.
is_advanced_dedicated_campaign Dimension
Indicates whether the campaign is an Advanced Dedicated Campaign, leveraging advanced delivery models.
is_new_structure Dimension
Indicates if the campaign uses the new campaign structure.
is_search_campaign Dimension
Indicates whether the campaign is a Search Campaign.
is_smart_creative Metric
Indicates whether the ad is a Smart Creative ad.
is_smart_performance_campaign Dimension
Indicates whether the campaign is an automated campaign type.
isp_ids Dimension
A list of Internet Service Provider (ISP) IDs targeted by the ad group.
item_duet_status Dimension
The duet status of the TikTok item used in the ad creative.
item_group_id Dimension
The identifier for a group of items within a product catalog.
item_group_ids Dimension
A list of identifiers used to group product variants, helping to optimize ad recommendations.
item_stitch_status Dimension
The stitch status of the TikTok item used in the ad creative.
ix_average_video_play Metric
The average duration of video playback.
ix_button_click_count Metric
The total number of clicks on buttons within an Instant Experience ad.
ix_page_duration_avg Metric
Average duration users spent on a webpage after interacting with an ad. This is a page event metric.
ix_page_view_count Metric
The total number of page views within an Instant Experience ad.
ix_video_views Metric
The number of video views within an Instant Experience ad.
ix_video_views_p100 Metric
The number of interactive video views completed 100%.
ix_video_views_p25 Metric
The number of interactive video views completed 25%.
ix_video_views_p50 Metric
The number of interactive video views completed 50%.
ix_video_views_p75 Metric
The number of interactive video views completed 75%.
join_group Metric
The number of times users joined a group or community after interacting with an ad.
landing_page_url Dimension
The URL of the landing page where users are directed after clicking the ad.
landing_page_view_rate Metric
The percentage of users who viewed the landing page after interacting with an ad.
language Dimension
The primary language of the advertiser or the ad.
languages Dimension
A list of languages targeted by the ad or campaign.
launch_app Metric
The number of times users launched the app, attributed to your ads.
launch_app_rate Metric
The rate at which users launched the app, attributed to your ads.
likes Metric
The number of likes on an ad.
live_effective_views Metric
The number of times viewers visited your LIVE for more than 10 seconds. Revisits are counted.
live_follows Metric
The number of new followers gained during live stream ads.
live_product_clicks Metric
The number of times viewers clicked a product and viewed its details page during a LIVE ad.
live_unique_views Metric
The number of unique viewers who entered your LIVE stream.
live_views Metric
The total number of times viewers visited your LIVE stream. Revisits are counted.
loan_apply Metric
The number of unique app loan application actions attributed to your ads.
loan_credit Metric
The number of unique app loan approval actions attributed to your ads.
loan_disbursement Metric
The number of unique app loan disbursal actions attributed to your ads.
location_ids Dimension
The IDs of geographic locations targeted by the campaign or ad group.
login Metric
The number of times users have logged into an application or service.
material_id Dimension
The unique identifier for an ad creative asset, such as an image or video, used in a campaign.
max_delivery_budget Metric
The maximum budget allowed for ad delivery.
media_channel Dimension
The advertising channel where the ad is displayed, such as TikTok or other supported placements.
media_channel_group Dimension
A grouping of different media channels where ads are displayed, such as social media or search.
min_android_version Dimension
The minimum Android operating system version targeted.
min_ios_version Dimension
The minimum iOS operating system version targeted.
mobile_app_id Metric
The unique identifier of the mobile application.
modify_time Dimension
The timestamp indicating when the ad, ad group, or campaign was last modified.
music_id Dimension
The unique identifier for the music or audio track used in the ad creative.
name Dimension
The name of the campaign, ad group, or ad.
net_cost Metric
The total advertising cost after any deductions or adjustments.
network_types Dimension
The network types (e.g., Wi-Fi, mobile data) targeted by the campaign.
next_day_open Metric
The number of unique Day 1 retentions attributed to your ads.
next_day_retention Dimension
The number of unique Day 1 retentions attributed to your ads. This refers to users who launch the app again the day after installing.
objective Dimension
The primary advertising objective for the campaign or ad group (e.g., reach, conversions).
objective_type Dimension
The type of objective set for the campaign or ad group.
offline_add_payment_info_event_rate Metric
The rate at which offline 'Add Payment Info' events occur, calculated as the number of such events divided by relevant impressions or clicks.
offline_add_payment_info_events Metric
The total number of offline 'Add Payment Info' events attributed to your ads.
offline_add_payment_info_events_value Metric
The total monetary value generated from offline 'add payment info' events attributed to ad interactions.
offline_add_to_cart_events Metric
The number of offline add to cart events attributed to your ads.
offline_add_to_cart_events_value Metric
The total value of offline add to cart events attributed to your ads.
offline_add_to_wishlist_events_value Metric
The total monetary value generated from offline 'add to wishlist' events attributed to ad interactions.
offline_click_button_events_value Metric
The total monetary value generated from offline 'click button' events attributed to ad interactions.
offline_complete_registration_events Metric
The number of complete registration events recorded offline, attributed to ad interactions.
offline_complete_registration_events_value Metric
The total monetary value generated from offline 'complete registration' events attributed to ad interactions.
offline_contact_events Dimension
The number of contact events (e.g., phone calls, messages) recorded offline, attributed to ad interactions.
offline_contact_events_value Metric
The total monetary value generated from offline 'contact' events attributed to ad interactions.
offline_download_events Metric
The number of offline download events attributed to your ads.
offline_download_events_value Metric
The total monetary value generated from offline 'download' events attributed to ad interactions.
offline_form_event_rate Metric
The rate at which offline 'form submission' events occur, attributed to ad interactions.
offline_form_events Metric
The number of form submission events recorded offline, attributed to ad interactions.
offline_form_events_value Metric
The total monetary value generated from offline 'form submission' events attributed to ad interactions.
offline_initiate_checkout_event_rate Metric
The rate at which offline 'Initiate Checkout' events occur, calculated as the number of such events divided by relevant impressions or clicks.
offline_initiate_checkout_events Metric
The number of 'initiate checkout' events recorded offline, attributed to ad interactions.
offline_initiate_checkout_events_value Metric
The total monetary value generated from offline 'initiate checkout' events attributed to ad interactions.
offline_place_order_events Metric
The number of 'place order' events recorded offline, attributed to ad interactions.
offline_place_order_events_value Metric
The total monetary value generated from offline 'place order' events attributed to ad interactions.
offline_search_events Metric
The number of offline search events attributed to the ad campaign.
offline_search_events_value Metric
The total value generated from offline search events.
offline_shopping_events Metric
The number of offline shopping events attributed to your ads.
offline_shopping_events_roas Metric
The Return On Ad Spend (ROAS) generated from offline shopping events.
offline_shopping_events_value Metric
The total value of offline shopping events attributed to your ads.
offline_subscribe_event_rate Metric
The rate at which offline 'subscribe' events occur, attributed to ad interactions.
offline_subscribe_events Metric
The number of 'subscribe' events recorded offline, attributed to ad interactions.
offline_subscribe_events_value Metric
The total monetary value generated from offline 'subscribe' events attributed to ad interactions.
offline_total_custom_event_value Metric
The total monetary value generated from all custom offline events attributed to ad interactions.
offline_view_content_events Metric
The number of times users viewed content offline that can be attributed to TikTok ads. This includes actions like viewing product details in a physical store or other offline content interactions tracked through the TikTok Offline Events API.
offline_view_content_events_value Metric
The total monetary value generated from offline 'view content' events attributed to ad interactions.
on_web_add_to_wishlist Metric
The number of 'add to wishlist' events that occurred on the website, attributed to ads.
on_web_add_to_wishlist_per_click Metric
The number of 'add to wishlist' web events per click.
on_web_order Metric
The number of order completion events that occurred on the website, attributed to ads.
on_web_order_rate Metric
The rate of orders placed on the website, attributed to your ads.
on_web_subscribe Metric
The number of subscription events that occurred on the website, attributed to ads.
on_web_subscribe_per_click Metric
The percentage of website subscribe actions from all clicks attributed to your ads.
online_consult Metric
The number of online consultation events.
onsite_add_billing Metric
The number of onsite add billing events.
onsite_add_to_wishlist Metric
The number of onsite add to wishlist events.
onsite_destination_visit_rate Metric
The percentage of users who visited an onsite destination (e.g., Instant Page) after interacting with an ad.
onsite_download_start Metric
The number of times an onsite download was initiated.
onsite_form Metric
The number of onsite form submission events.
onsite_form_rate Metric
The rate at which form submission events occur on the advertiser's website, attributed to ad interactions.
onsite_initiate_checkout_count Metric
The number of times users initiated a checkout process directly on the platform (onsite).
onsite_initiate_checkout_count_rate Dimension
The rate at which users initiated a checkout process on the advertiser's website, attributed to ad interactions.
onsite_on_web_cart Metric
The number of onsite add to cart events.
onsite_on_web_cart_rate Metric
The rate at which 'add to cart' events occur on the advertiser's website, attributed to ad interactions.
onsite_on_web_detail Metric
The number of onsite product detail page views.
onsite_on_web_detail_rate Metric
The rate at which 'view product detail' events occur on the advertiser's website, attributed to ad interactions.
onsite_purchase_rate Metric
The rate at which users make purchases on the advertiser's site after engaging with an ad.
onsite_purchases_roas Metric
The return on ad spend generated from purchases made on the advertiser's site.
onsite_shopping Metric
The number of user shopping behaviors that occur on your website or app.
onsite_shopping_roas Metric
The Return On Ad Spend (ROAS) generated from shopping activities directly on the platform (onsite).
onsite_total_add_to_cart Metric
The total number of "add to cart" actions performed on TikTok-owned properties, attributed to your ads.
onsite_total_add_to_cart_value Metric
The total monetary value of 'add to cart' events that occurred on the advertiser's website, attributed to ad interactions.
onsite_total_checkout_initiation Metric
The total number of times users initiated a checkout process on the advertiser's website, attributed to ad interactions.
onsite_total_purchase Metric
The total number of purchases completed on the advertiser's website.
onsite_total_purchase_value Metric
The total monetary value generated from purchases on the advertiser's website.
onsite_value_per_purchase Metric
The average value generated per purchase made on the advertiser's site.
operating_systems Dimension
The operating systems targeted by the campaign.
operation_status Dimension
The operational status of the entity (e.g., campaign, ad group, ad), such as active, paused, or deleted.
opt_status Metric
The status of automated creative optimization for the ad group.
optimization_event Dimension
The primary conversion event that the ad group is optimized for.
optimization_goal Dimension
The primary goal for ad delivery optimization (e.g., conversions, clicks, reach).
orders Metric
The total number of orders placed.
owner_bc_id Dimension
The Business Center ID of the owner associated with the ad account or advertiser.
pacing Dimension
The budget delivery strategy for an ad group, determining how spend is distributed over time.
page_browse_consultation Metric
The number of page browse events leading to a consultation, attributed to your ads.
page_browse_view Metric
The number of page browse events.
page_content_view_event_rate Metric
The percentage of website view content actions from all clicks attributed to your ads.
page_content_view_events Metric
The number of page content view events triggered by ad interactions.
page_event_search Metric
The number of search events that occurred on a webpage, attributed to ads.
page_event_search_rate Metric
The rate at which users perform a search action on a landing page.
page_id Dimension
The unique identifier for a business page or profile associated with the ad.
pageview_rate Metric
The rate at which users view pages on a website after interacting with an ad.
paid_engaged_view Metric
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.
paid_engaged_view_15s Metric
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.
paid_engagement_engaged_view Metric
A view that signifies a certain level of engagement with a paid ad.
paid_engagement_engaged_view_15s Metric
The number of paid engagements where a video ad was viewed for at least 15 seconds.
pixel_id Dimension
The unique identifier of the TikTok pixel used for event tracking.
placement Dimension
The specific location or platform where the ad is displayed.
placement_type Metric
The type of placement where the ad is displayed.
placements Dimension
The locations or platforms where the ads are displayed.
platform Dimension
The operating system or environment where the ad was displayed (e.g., iOS, Android).
platform_name Dimension
The name of the advertising platform where the ad campaign is running.
playable_url Dimension
The URL for interactive playable ad creatives.
postback_window_mode Dimension
The mode that determines which SKAN 4.0 postback (attribution window) is secured for the campaign.
predict_impression Dimension
The predicted number of impressions an ad or campaign is expected to receive.
product_details_page_browse Metric
The number of times viewers clicked a product and viewed its details page.
product_id Dimension
The unique identifier for a product.
product_image_url Dimension
The URL of the image for a product.
product_name Dimension
The name of the product being advertised.
product_set_id Dimension
The unique identifier for a product set within a catalog.
product_source Dimension
The source of products for promotion, such as Catalog, TikTok Shop, or Showcase. This can apply at campaign or ad group level.
product_specific_type Dimension
The specific type or category of product being promoted, relevant for shopping ads and catalog management.
product_status Dimension
The current status of the product in the catalog (e.g., active, out of stock).
profile_image Dimension
The profile image used for the ad. This refers to 'Ad Profile image' or 'Profile Image URL'.
profile_image_url Dimension
The URL of the profile image displayed with the ad.
profile_visits Metric
The number of profile visits attributed to the ad.
profile_visits_rate Metric
The rate of profile visits per impression driven by a paid ad, applicable only to Spark Ads.
promotion_target_type Dimension
The type of objective or goal set for a promotion, such as driving traffic to an app, website, or specific in-app events.
promotion_type Dimension
The type of promotion used in a campaign, such as for GMV Max campaigns.
promotion_website_type Dimension
The type of website or landing page used as the destination for a promotion, categorizing the nature of the promotional destination.
promotional_music_disabled Dimension
Indicates whether the use of music for promotional content is restricted to only commercial music library tracks or if other music is allowed.
province_id Dimension
The geographical ID of the province targeted by the ad.
province_name Dimension
The name of the province targeted by the ad.
purchase Metric
The number of purchase events attributed to the ad.
purchase_intention_keyword_ids Dimension
A list of IDs for keywords related to user purchase intention used for targeting. This relates to the 'Purchase Intention' field.
purchase_rate Metric
The rate at which users make a purchase after interacting with an ad.
purchased_impression Metric
The number of impressions that were purchased or guaranteed, especially relevant for reservation campaigns.
purchased_reach Metric
The number of unique users reached through purchased ad placements.
purchases Metric
The total number of purchases attributed to the ad.
ratings Metric
The number of ratings given by users.
reach Metric
The number of unique users who saw the ad.
reach_lifetime Metric
The number of unique users who saw your ads at least once over the entire lifetime of the campaign.
reach_mtd Metric
The number of unique users who saw your ad at least once, measured from the beginning of the month to the current date.
real_time_app_install Metric
The number of app installs reported in near real-time.
real_time_app_install_cost Metric
The real-time cost associated with app installations, attributed to your ads.
real_time_conversion Metric
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.
real_time_conversion_rate Metric
The percentage of real-time conversions received out of all clicks on your ads, calculated based on when the conversion actually happened.
real_time_cost_per_conversion Metric
The average amount of money spent on a real-time conversion (Real-time CPA), calculated based on when the conversion actually happened.
real_time_cost_per_result Metric
The average cost for each real-time result from your ads, calculated based on when the conversion actually happened.
real_time_result Metric
The number of times your ad achieved an outcome based on the optimization goal selected, with count based on when the conversion actually happened.
real_time_result_rate Metric
The percentage of real-time results achieved out of all views/clicks on your ads, calculated based on when the conversion actually happened.
region Dimension
The geographical region targeted by the advertising.
registration Metric
The number of registration events attributed to the ad.
registration_rate Metric
The rate at which users complete a registration after interacting with an ad.
rejection_reason Dimension
The reason why an ad, ad group, or campaign was rejected.
result Metric
The number of times your ad achieved an outcome, based on the optimization goal you selected.
result_rate Metric
The rate at which the campaign achieves its specified result.
revenue_events Metric
The number of events that generated revenue, attributed to ad interactions.
rf_campaign_type Metric
The type of Reach and Frequency (RF) campaign.
rf_estimated_cpr Dimension
The estimated cost per reach for a Reach and Frequency (RF) campaign.
rf_estimated_frequency Dimension
The estimated average number of times a user sees an ad from a reservation campaign.
rf_purchased_type Dimension
The purchased type for a Reach and Frequency (RF) campaign.
roas_bid Metric
The target Return On Ad Spend (ROAS) bid.
roi Dimension
The Return On Investment (ROI) from advertising efforts.
rta_bid_enabled Dimension
Indicates whether Realtime API (RTA) bid is enabled for the campaign. This is similar to 'Campaign RTA Bid Enabled'.
rta_id Dimension
The Realtime API (RTA) ID, which is the identifier for the RTA strategy used. This is similar to 'Campaign RTA ID'.
rta_product_selection_enabled Dimension
Indicates whether Realtime API (RTA) is enabled to automatically select products for the campaign. This is similar to 'Campaign RTA Product Selection Enabled'.
sales_destination Dimension
The destination where users are directed to complete a sale or conversion.
sales_lead Metric
The number of sales leads generated by the ad campaign.
sales_lead_rate Metric
The percentage of unique generate lead events resulting from ad interactions.
saved_audience_id Dimension
The ID of a saved audience segment.
schedule_end_time Dimension
The scheduled end date and time for an ad entity (e.g., campaign, ad group).
schedule_infos Dimension
Contains detailed information about the ad's delivery schedule, such as start and end times or daily delivery windows.
schedule_start_time Dimension
The scheduled start date and time for an ad entity (e.g., campaign, ad group).
schedule_type Dimension
The type of scheduling applied to an ad entity, such as continuous or specific dates.
scheduled_budget Metric
The budget allocated for an ad campaign or ad group for a specific scheduled period.
search Metric
The number of search events that are attributed to your ads.
search_rate Metric
The rate at which users perform a search action.
search_result_enabled Dimension
A setting that indicates whether an ad is enabled to appear within TikTok's organic search results.
search_terms Metric
The specific keywords or phrases that users entered into search queries, which led to the display and interaction with an advertiser's ads. This can be used as a filter in API queries for ad data.
secondary_goal_result Dimension
The number of times your ad achieved an outcome based on the secondary goal selected.
secondary_goal_result_rate Dimension
The rate at which secondary goal results were achieved, attributed to your ads.
secondary_optimization_event Dimension
The secondary event chosen for campaign optimization.
secondary_status Dimension
A secondary status for an ad group, providing more granular information beyond the primary status.
share_disabled Dimension
Indicates whether sharing to third-party platforms is disabled for the ad.
shares Metric
The number of times an ad was shared.
shop_gross_revenue_by_order_submission Metric
The total gross revenue generated from shop orders that are attributed to ad interactions.
shop_total_items_purchased Metric
The total number of items purchased from a shop, attributed to ads.
shopping_ads_deeplink_type Dimension
The type of deeplink used specifically for shopping ads.
shopping_ads_fallback_type Dimension
The fallback type used for shopping ads when the primary destination is unavailable.
shopping_ads_retargeting_type Dimension
The specific type of retargeting strategy employed for shopping ads, such as retargeting based on website visits, app activity, or cart abandonment.
shopping_ads_type Dimension
The specific format or classification of shopping ads, such as Video Shopping Ads, LIVE Shopping Ads, or Product Shopping Ads.
shopping_ads_video_package_id Dimension
The identifier for a video package specifically used in shopping ads.
showcase_products Dimension
A list of products designated to be featured in a creator's or advertiser's showcase.
skan_achieve_level Metric
The number of times the "achieve level" event occurred, as reported via SKAdNetwork.
skan_add_payment_info Metric
The number of times the "add payment info" event occurred, as reported via SKAdNetwork.
skan_add_payment_info_rate Metric
The rate at which 'Add Payment Info' events are attributed via SKAdNetwork, calculated as the number of SKAN-attributed events divided by relevant impressions or clicks.
skan_add_to_cart Metric
The number of 'add to cart' events reported via SKAdNetwork (SKAN) for iOS app campaigns.
skan_add_to_cart_rate Metric
The rate at which the "add to cart" event occurred, as reported via SKAdNetwork.
skan_add_to_wishlist Metric
The number of times the "add to wishlist" event occurred, as reported via SKAdNetwork.
skan_app_install Metric
The number of app installs reported via SKAdNetwork (SKAN) for iOS app campaigns.
skan_checkout Metric
The number of 'checkout' events reported via SKAdNetwork (SKAN) for iOS app campaigns.
skan_complete_tutorial Metric
The number of times the "complete tutorial" event occurred, as reported via SKAdNetwork.
skan_conversion Metric
The total number of conversion events reported via SKAdNetwork (SKAN) for iOS app campaigns.
skan_cost_per_add_payment_info Metric
The average cost incurred for each 'Add Payment Info' event attributed via SKAdNetwork.
skan_cost_per_app_install Metric
The average cost for each app install attributed through Apple's SKAdNetwork framework.
skan_cost_per_result Metric
The average cost incurred per result (conversion) as reported via SKAdNetwork.
skan_cost_per_sales_lead Metric
The average cost for each sales lead attributed through Apple's SKAdNetwork framework.
skan_cost_per_total_sales_lead Metric
The average cost for each sales lead generated from an ad campaign targeting iOS 14+ users, as reported and attributed through Apple's SKAdNetwork framework.
skan_cost_total_add_payment_info Metric
The total cost associated with 'Add Payment Info' events attributed via SKAdNetwork.
skan_create_gamerole Metric
The number of SKAdNetwork-attributed instances where users created a game role.
skan_create_group Metric
The number of SKAdNetwork-attributed instances where users created a group.
skan_in_app_ad_click Metric
The number of in-app ad clicks, as reported via SKAdNetwork.
skan_in_app_ad_impr Metric
The number of in-app ad impressions, as reported via SKAdNetwork.
skan_join_group Metric
The number of SKAdNetwork-attributed instances where users joined a group.
skan_launch_app Metric
The number of app launches, as reported via SKAdNetwork.
skan_loan_apply Metric
The number of loan application events, as reported via SKAdNetwork.
skan_loan_credit Metric
The number of SKAdNetwork-attributed instances where users received loan credit.
skan_loan_disbursement Metric
The number of SKAdNetwork-attributed loan disbursements.
skan_login Metric
The number of login events, as reported via SKAdNetwork.
skan_purchase Metric
The number of purchase events, as reported via SKAdNetwork.
skan_purchase_rate Metric
The rate of purchase events, as reported via SKAdNetwork.
skan_ratings Metric
The number of rating events, as reported via SKAdNetwork.
skan_registration Metric
The number of user registration events, as reported via SKAdNetwork.
skan_registration_rate Metric
The rate of user registration events, as reported via SKAdNetwork.
skan_result Metric
The final conversion value or result reported via SKAdNetwork (SKAN) for iOS app campaigns.
skan_result_rate Metric
The rate of results (conversions), as reported via SKAdNetwork.
skan_sales_lead Metric
The number of sales lead events, as reported via SKAdNetwork.
skan_sales_lead_rate Metric
The rate at which sales leads are generated, attributed through Apple's SKAdNetwork, often expressed as a percentage of impressions or clicks.
skan_search Metric
The number of search events, as reported via SKAdNetwork.
skan_spend_credits Metric
The number of "spend credits" events, as reported via SKAdNetwork.
skan_start_trial Metric
The number of "start trial" events, as reported via SKAdNetwork.
skan_start_trial_rate Metric
The rate of "start trial" events, as reported via SKAdNetwork.
skan_subscribe Metric
The number of subscription events, as reported via SKAdNetwork.
skan_subscribe_rate Metric
The rate of subscription events, as reported via SKAdNetwork.
skan_total_achieve_level Metric
The total count of "achieve level" events, as reported via SKAdNetwork.
skan_total_achieve_level_value Metric
The total value of SKAdNetwork-attributed instances where users achieved a certain level.
skan_total_add_payment_info Metric
The total count of "add payment info" events, as reported via SKAdNetwork.
skan_total_add_to_cart Metric
The total count of "add to cart" events, as reported via SKAdNetwork.
skan_total_add_to_cart_value Metric
The total value associated with "add to cart" events, as reported via SKAdNetwork.
skan_total_add_to_wishlist Metric
The total count of "add to wishlist" events, as reported via SKAdNetwork.
skan_total_checkout Metric
The total count of "checkout" events, as reported via SKAdNetwork.
skan_total_checkout_value Metric
The total value associated with "checkout" events, as reported via SKAdNetwork.
skan_total_complete_tutorial Metric
The total count of "complete tutorial" events, as reported via SKAdNetwork.
skan_total_complete_tutorial_value Metric
The total value of SKAdNetwork-attributed instances where users completed a tutorial.
skan_total_create_gamerole Metric
The total number of SKAdNetwork-attributed instances where users created a game role.
skan_total_create_group Metric
The total number of SKAdNetwork-attributed instances where users created a group.
skan_total_in_app_ad_click Metric
The total number of in-app ad clicks, attributed via SKAdNetwork.
skan_total_in_app_ad_impr Metric
The total number of in-app ad impressions, attributed via SKAdNetwork.
skan_total_join_group Metric
The total number of times users joined a group, attributed via SKAdNetwork.
skan_total_launch_app Metric
The total number of app launches, attributed via SKAdNetwork.
skan_total_loan_apply Metric
The total number of loan applications, attributed via SKAdNetwork.
skan_total_loan_credit Metric
The total number of loan credits, attributed via SKAdNetwork.
skan_total_loan_disbursement Metric
The total number of loan disbursements, attributed via SKAdNetwork.
skan_total_login Metric
The total number of user logins, attributed via SKAdNetwork.
skan_total_purchase Metric
The total number of purchases, attributed via SKAdNetwork.
skan_total_purchase_value Metric
The total value generated from purchases, attributed via SKAdNetwork.
skan_total_ratings Metric
The total number of user ratings, attributed via SKAdNetwork.
skan_total_registration Metric
The total number of user registrations, attributed via SKAdNetwork.
skan_total_sales_lead Metric
The total number of sales leads, attributed via SKAdNetwork.
skan_total_sales_lead_value Metric
The total value generated from all sales leads attributed through Apple's SKAdNetwork framework.
skan_total_search Metric
The total count of search events based on when the events are returned through the SKAdNetwork API.
skan_total_spend_credits Metric
The total number of times users spent credits, attributed via SKAdNetwork.
skan_total_start_trial Metric
The total number of trial starts, attributed via SKAdNetwork.
skan_total_subscribe Metric
The total number of subscriptions, attributed via SKAdNetwork.
skan_total_view_content Metric
The total number of content views, attributed via SKAdNetwork.
skan_total_view_content_value Metric
The total value generated from content views, attributed via SKAdNetwork.
skan_unlock_achievement Metric
The number of times an achievement was unlocked, attributed via SKAdNetwork.
skan_view_content Metric
The number of content views, attributed via SKAdNetwork.
skan_view_content_rate Metric
The rate at which content was viewed, attributed via SKAdNetwork.
skip_learning_phase Dimension
Indicates if the learning phase is skipped for campaign delivery optimization.
sku_ids Dimension
A list of Stock Keeping Unit (SKU) identifiers, representing unique product items in a catalog.
smart_audience_enabled Dimension
A flag indicating whether smart audience features are enabled for an ad group, allowing for dynamic audience optimization.
smart_interest_behavior_enabled Dimension
A flag indicating whether smart interest and behavior-based targeting features are enabled for an ad group.
smart_target Dimension
The optimization goal set for smart targeting.
sound_usage_clicks Metric
Number of clicks on the 'Use sound' button associated with the ad.
source Dimension
The advertising platform or origin where the ad was run.
special_industries Dimension
Special ad categories that apply to the campaign, such as HOUSING, EMPLOYMENT, or CREDIT. This is similar to 'Campaign Special Industries'.
spend Metric
The total amount of money spent on the ad or campaign.
spend_EUR Metric
The total amount of money spent in Euros for the advertising campaign, ad group, or ad.
spend_credits Metric
The number of unique app spend credit actions attributed to your ads.
spend_credits_rate Metric
The percentage of app spend credit actions from all app installs attributed to your ads.
split_test_group_id Dimension
The unique identifier for a specific group within a split test.
split_test_status Dimension
The current status of a split test.
start_trial Metric
The number of times a trial was started.
start_trial_rate Metric
The rate at which trials were started.
stat_time_day Dimension
The specific day for which the statistics are reported.
stat_time_hour Dimension
The hour of the day for which the statistics are reported.
statistic_type Dimension
The statistical type or method used for reporting metrics.
status Dimension
The operational status of the ad, ad group, or campaign (e.g., active, paused, deleted).
stitch_clicks Metric
The number of clicks on the 'Stitch' button in Spark Ads.
subscribe Metric
The number of subscription events attributed to the ad.
subscribe_rate Metric
The rate at which users subscribe after interacting with an ad.
target_roi_budget Metric
The budget allocated to achieve a specific Return On Investment (ROI) target.
targeting_expansion Dimension
A feature that allows the ad platform to automatically expand targeting beyond manually set criteria to find a broader, relevant audience.
tiktok_item_id Metric
The unique identifier for a TikTok post ID, used specifically for Spark Ads.
tiktok_page_category Dimension
A category assigned to a TikTok page or content, used for targeting audiences based on their engagement with specific content interests.
timezone Dimension
The timezone used for report data.
topview_reach_range Dimension
The estimated range of unique users that a TopView ad is expected to reach, providing a forecast for premium ad placements.
total_achieve_level Metric
The total number of times users achieved a certain level within an app or game, attributed to the ad.
total_achieve_level_value Metric
The total value generated from achieve level events.
total_active_pay_roas Metric
The Return On Ad Spend (ROAS) from actively paying users.
total_add_billing_value Metric
The total value generated from users initiating adding billing information.
total_add_payment_info Metric
The total number of times payment information was added.
total_add_to_wishlist Metric
The total number of 'add to wishlist' events attributed to your ads.
total_add_to_wishlist_value Metric
The total monetary value of 'add to wishlist' events attributed to your ads.
total_app_event_add_to_cart Metric
The total number of 'add to cart' events that occurred within your app, attributed to your ads.
total_app_event_add_to_cart_value Metric
The total monetary value of 'add to cart' events that occurred within your app, attributed to your ads.
total_button_click_value Metric
The total value generated from button clicks on a website or app, attributed to the ad.
total_checkout Metric
The total number of checkout events initiated.
total_checkout_value Metric
The total monetary value of all checkout events.
total_complete_payment_rate Metric
The total rate of complete payment events attributed to ads.
total_complete_tutorial Metric
The total number of times users have completed a tutorial.
total_complete_tutorial_value Metric
The total value of app complete tutorial actions attributed to your ads.
total_create_gamerole Metric
The total number of app create role actions attributed to your ads.
total_create_gamerole_value Metric
The total value of app create role actions attributed to your ads.
total_create_group Metric
The total number of times a group was created.
total_create_group_value Metric
The total value generated from creating groups.
total_download_start_value Metric
The total value of website download actions attributed to your ads.
total_form_value Metric
The total monetary value generated from form submissions.
total_in_app_ad_click Metric
The total number of clicks on an ad within an application.
total_in_app_ad_click_value Metric
The total value of in-app ad clicks attributed to your ads.
total_in_app_ad_impr Metric
The total number of in-app ad impressions.
total_in_app_ad_impr_value Metric
The total value generated from in-app ad impressions.
total_initiate_checkout_value Metric
The total monetary value of all initiate checkout events.
total_join_group Metric
The total number of times a group was joined.
total_join_group_value Metric
The total value generated from joining groups.
total_landing_page_view Metric
The total number of landing page views after ad interaction.
total_launch_app Metric
The total number of times the app was launched by users.
total_loan_apply Metric
The total number of loan applications.
total_loan_credit Metric
The total number of loan credits.
total_loan_disbursement Metric
The total number of loan disbursements.
total_login Metric
The total number of user logins.
total_next_day_open Metric
The total number of times the app was opened the day after installation or engagement.
total_on_web_add_to_wishlist_value Metric
The total value of 'add to wishlist' actions on the website attributed to ads.
total_on_web_order_value Metric
The total monetary value of order events that occurred on the website, attributed to ads.
total_on_web_subscribe_value Metric
The total monetary value of subscription events that occurred on the website, attributed to ads.
total_online_consult_value Metric
The total value generated from online consultation events.
total_onsite_add_billing_value Metric
The total value generated from onsite add billing events.
total_onsite_add_to_wishlist_value Metric
The total value generated from onsite add to wishlist events.
total_onsite_form_value Metric
The total value generated from onsite form submission events.
total_onsite_initiate_checkout_count_value Metric
The total value generated from onsite initiate checkout events.
total_onsite_on_web_cart_value Metric
The total value generated from onsite add to cart events.
total_onsite_shopping_value Metric
The total monetary value of all onsite shopping events.
total_page_event_search_value Metric
The total monetary value of search events that occurred on a webpage, attributed to ads.
total_page_view_content_events_value Metric
The total value associated with page view content events.
total_pageview Dimension
The total number of page views.
total_purchase Metric
The total number of purchases.
total_purchase_roas_day0 Metric
The total Return on Ad Spend (ROAS) for purchases within 0 days of ad interaction.
total_purchase_roas_day6 Metric
The total Return on Ad Spend (ROAS) for purchases within 6 days of ad interaction.
total_purchase_value Metric
The total monetary value of purchases.
total_purchase_value_EUR Metric
The total monetary value of purchases in Euros, attributed to ad interactions.
total_purchase_value_day0 Metric
The total value of all purchase actions attributed to ads within 24 hours of an app install.
total_purchase_value_day2 Metric
The total monetary value of purchases within 2 days of ad interaction.
total_purchase_value_day6 Metric
The total monetary value of purchases within 6 days of ad interaction.
total_ratings Metric
The total number of ratings given by users.
total_ratings_value Metric
The total value of app rate actions attributed to your ads.
total_registration Metric
The total number of registration events.
total_sales_lead Metric
The total number of sales leads generated.
total_sales_lead_value Metric
The total value generated from sales leads.
total_search Dimension
The total number of search events that are attributed to your ads.
total_spend_credits Metric
The total number of app spend credit actions attributed to your ads.
total_spend_credits_value Metric
The total value of app spend credit actions attributed to your ads.
total_start_trial Metric
The total number of times users have started a trial period.
total_subscribe Metric
The total number of subscription events attributed to ads.
total_subscribe_value Metric
The total monetary value of subscription events attributed to ads.
total_unlock_achievement Metric
The total number of app unlock achievement actions attributed to your ads.
total_unlock_achievement_value Metric
The total value of app unlock achievement actions attributed to your ads.
total_user_registration_value Metric
The total value generated from user registrations.
total_value_per_pageview Metric
The total monetary value generated for each page view attributed to the ad.
total_view_content Metric
The total number of view content events attributed to your ads.
total_view_content_value Metric
The total monetary value of view content events attributed to your ads.
total_web_event_add_to_cart_value Metric
The total monetary value of 'add to cart' web events.
tracking_app_id Dimension
The unique identifier of the app used for tracking purposes.
tracking_pixel_id Dimension
The unique identifier of the pixel used for tracking purposes.
tt_account_name Dimension
The name of the TikTok account associated with the ad.
tt_account_profile_image_url Dimension
The URL of the profile image for the TikTok account associated with the ad.
tt_app_id Metric
The unique identifier for the TikTok application.
tt_app_name Metric
The name of the TikTok application.
unique_ad_impression_events Metric
The number of unique times an ad was displayed to users.
unique_custom_app_events Metric
The number of unique custom in-app events recorded.
unlock_achievement Metric
The number of times users unlocked an achievement.
unlock_achievement_rate Metric
The rate at which users unlock achievements.
user_registration Metric
The number of user registration events.
user_registration_rate Metric
The rate at which users complete registration.
value_per_button_click Metric
The value generated per button click.
value_per_checkout Metric
The average value generated per checkout event.
value_per_complete_payment Metric
The monetary value generated for each complete payment.
value_per_form Metric
The average value generated per form submission event.
value_per_initiate_checkout Metric
The average value generated per 'initiate checkout' event.
value_per_offline_form_event Metric
The average monetary value generated for each offline 'form submission' event.
value_per_offline_place_order_event Metric
The average monetary value generated for each offline 'place order' event.
value_per_on_web_add_to_wishlist Metric
The average monetary value generated for each 'add to wishlist' event on the advertiser's website.
value_per_on_web_order Metric
The monetary value generated for each order completed on the website.
value_per_onsite_form Metric
The average monetary value generated for each form submission event on the advertiser's website.
value_per_onsite_initiate_checkout_count Dimension
The average monetary value generated for each 'initiate checkout' event on the advertiser's website.
value_per_onsite_on_web_cart Metric
The average monetary value generated for each 'add to cart' event on the advertiser's website.
value_per_onsite_on_web_detail Metric
The average monetary value generated for each 'view product detail' event on the advertiser's website.
value_per_onsite_shopping Metric
The average monetary value generated from each onsite shopping event, such as an add to cart, checkout initiation, or product page view. from TikTok Ads API onsite shopping value metrics query results
value_per_total_app_event_add_to_cart Metric
The average value generated per 'add to cart' event within the app.
value_per_total_purchase Metric
Total monetary value generated for each purchase attributed to an ad.
value_per_total_sales_lead Metric
The average value generated per sales lead.
value_per_total_spend_credits Metric
The average value generated per 'spend credits' event.
value_per_total_subscribe Metric
The average value generated per subscription event.
value_per_total_view_content Metric
The average value generated per 'view content' event.
value_per_user_registration Metric
The average value generated per user registration.
value_per_web_event_add_to_cart Metric
The average value generated per 'add to cart' web event.
video_id Dimension
The unique identifier for a video creative used in an ad.
video_play_actions Metric
The total number of times users initiated playing a video ad.
video_views_p100 Metric
The total number of times a video was played to completion (100%).
video_views_p25 Metric
The total number of times a video was played to at least 25% of its length.
video_views_p50 Metric
The total number of times a video was played to at least 50% of its length.
video_views_p75 Metric
The total number of times a video was played to at least 75% of its length.
video_watched_2s Metric
The number of times a video ad was watched for at least 2 seconds.
video_watched_6s Metric
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.
video_watched_continuous_2s Metric
The number of times a video was continuously watched for at least 2 seconds.
view_attribution_window Dimension
The time window during which a view of an ad can be attributed to a conversion.
view_completion Metric
The percentage of the ad's content that was viewed.
view_content Metric
The number of times a specific content page or product was viewed after an ad interaction.
view_content_rate Metric
The rate at which users view specific content pages.
vta_conversion Metric
The number of conversions attributed to a view-through action.
vta_purchase Metric
Purchases attributed to a view-through action (user saw the ad but didn't click, then converted later).
vta_registration Metric
The number of registration events attributed to view-through actions (VTA), based on information received from your measurement partner.
web_event_add_to_cart Metric
The number of 'add to cart' events that occurred on the website, attributed to ads.
web_event_add_to_cart_rate Metric
The rate at which users add items to their cart on a website.