TikTok Ads: Most-used fields#
The table below gives information about most-used fields that you can import from TikTok Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
10_second_live_views |
10_second_live_views |
The number of views where a live stream ad was watched for at least 10 seconds. |
metric |
AUDIENCE |
Audience |
The specific audience segment targeted by the ad campaign. |
dimension |
Ad ID |
Ad ID |
The unique identifier for an individual ad. |
metric |
Ad Set |
Ad Set |
The name of the ad set within an advertising campaign. |
dimension |
Ad Type |
Ad Type |
The type of ad being run, distinguishing between different ad formats or objectives. |
dimension |
Ad group |
Ad group |
The name of the ad group to which an ad belongs. |
dimension |
Ad group ID |
Ad group ID |
The unique identifier for an ad group. |
metric |
Ad name |
Ad name |
The name of the individual ad. |
dimension |
Amount Spent |
Amount Spent |
The total amount of money spent on advertising. |
metric |
Buying Currency |
Buying Currency |
The currency in which the ad spend and costs are reported. |
dimension |
CAMPAIGN |
Campaign |
The name of the advertising campaign. |
dimension |
CPM |
CPM |
Cost Per Mille (or Cost Per Thousand Impressions), representing the cost for one thousand ad impressions. |
dimension |
Campaign Country |
Campaign Country |
The country where the advertising campaign is targeted or operating. |
dimension |
Campaign Country Code |
Campaign Country Code |
The ISO country code for the campaign’s target country. |
dimension |
Campaign Description |
Campaign Description |
A descriptive text providing details about the advertising campaign. |
dimension |
Campaign Goal |
Campaign Goal |
The overall goal or objective defined for the advertising campaign. |
dimension |
Campaign ID |
Campaign ID |
The unique identifier for an advertising campaign. |
metric |
Campaign Name |
Campaign Name |
The name of the advertising campaign. |
dimension |
Campaign Objective |
Campaign Objective |
The primary goal or desired outcome of the advertising campaign. |
dimension |
Campaign Type |
Campaign Type |
The type or objective of the advertising campaign, e.g., iOS14 Dedicated Campaign or a regular campaign. |
dimension |
Campaign_goal |
Campaign_goal |
The primary objective or desired outcome of the advertising campaign. |
dimension |
Clicks |
Clicks |
The number of clicks on your ads. |
metric |
Cost |
Cost |
The total amount of money spent on advertising. |
metric |
Country |
Country |
The country where the ad was displayed or where the associated data originates. |
dimension |
Country code |
Country code |
The ISO country code for the country where the ad was displayed or targeted. |
dimension |
Creative Name |
Creative Name |
The name of the ad creative. |
dimension |
Creative Type |
Creative Type |
The type of ad creative, such as image, video, or carousel. |
dimension |
Currency |
Currency |
The currency in which financial data, such as cost or spend, is reported. |
dimension |
DAY |
Day |
The specific day for which the data is reported, used as a breakdown dimension. |
dimension |
Data Source |
Data Source |
The origin of the data collected (e.g., TikTok Ads API). |
dimension |
Date |
Date |
The specific date for which the data is reported. |
dimension |
DayofWeek |
DayofWeek |
The day of the week when the ad event occurred (e.g., Monday, Tuesday). |
dimension |
Device |
Device |
The type of device (e.g., mobile, desktop) on which the ad was displayed. |
dimension |
End Date |
End Date |
The end date of the ad campaign or ad group schedule. |
dimension |
Engagement |
Engagement |
The total number of user interactions with an ad, such as clicks, likes, shares, or comments. |
dimension |
Format |
Format |
The format of the ad creative, such as vertical video or square image. |
dimension |
Impressions |
Impressions |
The number of times your ads were on screen. |
metric |
Language |
Language |
The language targeted by the ad or associated with the ad creative. |
dimension |
Language code |
Language code |
The language code of the targeted audience or creative content. |
dimension |
Month |
Month |
The calendar month for which the data is reported. |
metric |
Month-Year |
Month-Year |
The month and year of the ad event (e.g., Jan-2023). |
dimension |
Placement |
Placement |
The specific location within the TikTok ecosystem or partner network where the ad was displayed. |
dimension |
Platform |
Platform |
The advertising platform where the ad was run. |
dimension |
Reach |
Reach |
The number of unique users who saw your ad. |
metric |
Region |
Region |
The geographical region relevant to the ad campaign. |
dimension |
Social Platform |
Social Platform |
The specific social media platform where the ad was displayed. |
dimension |
Start Date |
Start Date |
The start date of the ad campaign or ad group schedule. |
dimension |
Targeting Strategy |
Targeting Strategy |
The approach or method used to define and reach the target audience. |
dimension |
Targeting Type |
Targeting Type |
The method or category of audience targeting applied to an ad group or campaign. |
dimension |
TikTok_interactions |
TikTok_interactions |
The total number of interactions users had with the ad on TikTok, including likes, comments, shares, and clicks. |
metric |
Unique Impressions |
Unique Impressions |
The number of unique users who saw the ad. |
dimension |
Video Length |
Video Length |
The duration of the video creative used in the ad. |
dimension |
Video Plays |
Video Plays |
The number of times the video ad creative was played. |
metric |
WeekAsDate |
WeekAsDate |
dimension |
|
WeekNum |
WeekNum |
The week number for which the data is reported, used as a breakdown dimension. |
metric |
Year |
Year |
The year to which the reported data pertains. |
metric |
Year Month |
Year Month |
The year and month for which the ad data is reported. |
dimension |
account_id |
account_id |
The unique identifier for the advertiser account. |
dimension |
account_name |
account_name |
The name of the advertiser account. |
dimension |
achieve_level |
achieve_level |
The number of times a specific achievement level was reached by users. |
metric |
achieve_level_rate |
achieve_level_rate |
The rate at which users achieve a specific level, calculated as achievement level completions divided by relevant impressions or clicks. |
metric |
action_type |
action_type |
The type of action performed by a user, such as a click or conversion. |
dimension |
actions |
actions |
The number of user actions, such as clicks, conversions, or engagements, attributed to the ad. |
dimension |
actual_device |
actual_device |
The type of device (e.g., mobile, desktop) on which the ad was displayed. |
dimension |
ad |
ad |
A high-level object containing metadata and performance information for a specific ad. |
dimension |
ad_adgroup_id |
ad_adgroup_id |
The unique identifier of the ad group to which the ad belongs. |
dimension |
ad_adgroup_name |
ad_adgroup_name |
The name of the ad group to which the ad belongs. |
dimension |
ad_advertiser_id |
ad_advertiser_id |
The ID of the advertiser account that owns the ad. |
dimension |
ad_app_name |
ad_app_name |
The name of the application associated with the ad, relevant for app promotion campaigns. |
dimension |
ad_call_to_action |
ad_call_to_action |
The call-to-action text displayed on the ad. |
dimension |
ad_call_to_action_id |
ad_call_to_action_id |
The unique identifier for the call to action button used in the ad. |
dimension |
ad_campaign_automation_type |
ad_campaign_automation_type |
dimension |
|
ad_campaign_id |
ad_campaign_id |
The unique identifier of the campaign to which the ad belongs. |
dimension |
ad_campaign_name |
ad_campaign_name |
The name of the campaign to which the ad belongs. |
dimension |
ad_card_id |
ad_card_id |
The ID of the card creative used in the ad. |
dimension |
ad_click_rate |
ad_click_rate |
The rate at which users click on an ad after seeing it (Click-Through Rate). |
metric |
ad_click_tracking_url |
ad_click_tracking_url |
The URL used to track clicks on the ad. |
dimension |
ad_comment |
ad_comment |
The number of comments received on an ad. |
metric |
ad_conversion_rate |
ad_conversion_rate |
The rate at which users complete a desired action after interacting with an ad. |
metric |
ad_create_time |
ad_create_time |
The timestamp when the ad was created. |
dimension |
ad_creative_authorized |
ad_creative_authorized |
dimension |
|
ad_creative_image_format |
ad_creative_image_format |
The file format of the image creative used in the ad (e.g., JPG, PNG). |
dimension |
ad_creative_image_height |
ad_creative_image_height |
The height of the image creative used in the ad, in pixels. |
dimension |
ad_creative_image_size |
ad_creative_image_size |
The file size of the image creative used in the ad, in bytes. |
dimension |
ad_creative_image_url |
ad_creative_image_url |
The URL of the image used in the ad creative. |
dimension |
ad_creative_image_width |
ad_creative_image_width |
The width of the image creative used in the ad, in pixels. |
dimension |
ad_creative_video_bit_rate |
ad_creative_video_bit_rate |
The bit rate of the video creative used in the ad. |
metric |
ad_creative_video_duration |
ad_creative_video_duration |
The duration of the video creative used in the ad. |
metric |
ad_creative_video_format |
ad_creative_video_format |
The file format of the video creative used in the ad (e.g., MP4, MOV). |
dimension |
ad_creative_video_height |
ad_creative_video_height |
The height of the video creative used in the ad, in pixels. |
metric |
ad_creative_video_poster_url |
ad_creative_video_poster_url |
The URL of the poster image for a video ad creative. |
dimension |
ad_creative_video_preview_url |
ad_creative_video_preview_url |
The URL for a preview of the video creative used in the ad. |
dimension |
ad_creative_video_size |
ad_creative_video_size |
The file size of the video creative used in the ad, in bytes. |
metric |
ad_creative_video_url |
ad_creative_video_url |
The URL of the video file for an ad creative. |
dimension |
ad_creative_video_video_cover_url |
ad_creative_video_video_cover_url |
The URL of the cover image for the video creative used in the ad. |
dimension |
ad_creative_video_width |
ad_creative_video_width |
The width of the video creative used in the ad, in pixels. |
metric |
ad_deeplink |
ad_deeplink |
The deep link URL configured for the ad, used to direct users to specific content within an app. |
dimension |
ad_deeplink_type |
ad_deeplink_type |
The type of deep link configured for the ad. |
dimension |
ad_display_name |
ad_display_name |
The display name of the ad. |
dimension |
ad_external_action |
ad_external_action |
dimension |
|
ad_format |
ad_format |
The format of the ad creative (e.g., image, video, carousel). |
dimension |
ad_format_type |
ad_format_type |
The specific format of the ad, such as single image, single video, or carousel. |
dimension |
ad_group_audience |
ad_group_audience |
The demographic and interest-based targeting information for the ad group, including characteristics of the targeted users. |
dimension |
ad_group_bid_type |
ad_group_bid_type |
The bid type configured for the ad group. |
dimension |
ad_group_budget |
ad_group_budget |
The budget set for the ad group. |
dimension |
ad_group_carriers |
ad_group_carriers |
dimension |
|
ad_group_deep_bid_type |
ad_group_deep_bid_type |
The type of deep bid optimization used for the ad group, influencing how bids are optimized for in-app events. |
dimension |
ad_group_id |
ad_group_id |
The unique identifier for the ad group. |
dimension |
ad_group_name |
ad_group_name |
The name of the ad group. |
dimension |
ad_id |
ad_id |
The unique identifier for the ad. |
dimension |
ad_identity_id |
ad_identity_id |
The unique identifier for an individual ad. |
dimension |
ad_identity_type |
ad_identity_type |
The type of identity used for the ad, such as a TikTok account or business profile. |
dimension |
ad_image_ids |
ad_image_ids |
A list of identifiers for images associated with the ad creative. |
dimension |
ad_impression_tracking_url |
ad_impression_tracking_url |
The URL used to track impressions of the ad. |
dimension |
ad_invalid_impressions |
ad_invalid_impressions |
metric |
|
ad_invalid_spend |
ad_invalid_spend |
metric |
|
ad_is_aco |
ad_is_aco |
Indicates if the ad utilizes Automated Creative Optimization (ACO) to generate multiple creative variations. |
dimension |
ad_is_creative_authorized |
ad_is_creative_authorized |
dimension |
|
ad_is_new_structure |
ad_is_new_structure |
Indicates if the ad belongs to a new advertising structure or system. |
dimension |
ad_landing_page_url |
ad_landing_page_url |
The primary landing page URL for the ad. |
dimension |
ad_landing_page_urls |
ad_landing_page_urls |
A list of URLs to which users are directed after clicking on the ad. |
dimension |
ad_like |
ad_like |
The number of likes received on an ad. |
metric |
ad_modify_time |
ad_modify_time |
The timestamp when the ad was last modified. |
dimension |
ad_name |
ad_name |
The name of the ad. |
metric |
ad_open_url |
ad_open_url |
The URL that opens when a user clicks on the ad. |
dimension |
ad_open_url_type |
ad_open_url_type |
The type of URL used for opening the ad, such as a deeplink or website URL. |
dimension |
ad_operation_status |
ad_operation_status |
The current operational status of the ad, such as active, paused, or deleted. |
dimension |
ad_page_id |
ad_page_id |
The unique identifier of the page associated with the ad. |
dimension |
ad_pixel_id |
ad_pixel_id |
The ID of the TikTok pixel used to track events for the ad. |
dimension |
ad_playable_url |
ad_playable_url |
The URL for the playable ad creative. |
dimension |
ad_profile_image |
ad_profile_image |
The URL or identifier of the profile image associated with the ad’s identity. |
metric |
ad_profile_image_url |
ad_profile_image_url |
The URL of the profile image displayed with the ad. |
dimension |
ad_secondary_status |
ad_secondary_status |
The secondary status of the ad, providing more granular information beyond the primary status. |
dimension |
ad_share |
ad_share |
The number of times an ad was shared. |
metric |
ad_status |
ad_status |
The current operational status of the ad (e.g., enabled, disabled, deleted). |
dimension |
ad_text |
ad_text |
The main text content of the ad. |
metric |
ad_texts |
ad_texts |
The text content used in the ad creative. |
dimension |
ad_tiktok_item_id |
ad_tiktok_item_id |
The unique identifier for the specific TikTok content item (e.g., video, post) used in the ad. |
dimension |
ad_type |
ad_type |
The type of ad creative (e.g., single image, video, carousel). |
metric |
ad_url |
ad_url |
The destination URL associated with the ad. |
metric |
ad_valid_impressions |
ad_valid_impressions |
dimension |
|
ad_valid_spend |
ad_valid_spend |
dimension |
|
ad_video_id |
ad_video_id |
The ID of the video creative used in the ad. |
dimension |
ad_video_view_rate_2s |
ad_video_view_rate_2s |
The percentage of ad video plays that reached at least 2 seconds. |
metric |
ad_video_view_rate_6s |
ad_video_view_rate_6s |
The percentage of ad video plays that reached at least 6 seconds. |
metric |
ad_video_view_rate_p100 |
ad_video_view_rate_p100 |
The percentage of ad video plays that were viewed to 100% completion. |
metric |
ad_video_view_rate_p25 |
ad_video_view_rate_p25 |
The percentage of ad video plays that were viewed to 25% completion. |
metric |
ad_video_view_rate_p50 |
ad_video_view_rate_p50 |
The percentage of ad video plays that were viewed to 50% completion. |
metric |
ad_video_view_rate_p75 |
ad_video_view_rate_p75 |
The percentage of ad video plays that were viewed to 75% completion. |
metric |
add_billing |
add_billing |
The number of times users initiated adding billing information, such as credit card details. |
metric |
add_billing_rate |
add_billing_rate |
The rate at which users initiated adding billing information, typically calculated as a percentage of clicks or impressions. |
metric |
add_payment_info |
add_payment_info |
The number of unique ‘add payment info’ actions attributed to your ads. |
metric |
add_payment_info_rate |
add_payment_info_rate |
The rate at which users add payment information. |
metric |
add_to_wishlist |
add_to_wishlist |
The number of unique ‘add to wishlist’ actions attributed to your ads. |
metric |
add_to_wishlist_rate |
add_to_wishlist_rate |
The rate at which users add items to a wishlist. |
metric |
adgroup_advertiser_id |
adgroup_advertiser_id |
The unique identifier of the advertiser account that owns the ad group. |
dimension |
adgroup_age |
adgroup_age |
The age demographic targeted at the ad group level. |
dimension |
adgroup_age_groups |
adgroup_age_groups |
The age ranges used in targeting for your ad group. |
dimension |
adgroup_app_download_url |
adgroup_app_download_url |
The URL where users are directed to download the app after interacting with an ad in this ad group. |
dimension |
adgroup_app_id |
adgroup_app_id |
The application ID associated with the ad group, primarily for app promotion campaigns. |
dimension |
adgroup_app_profile_page_state |
adgroup_app_profile_page_state |
The status of the app profile page for an ad group, indicating its operational state. |
dimension |
adgroup_app_type |
adgroup_app_type |
The type of app targeted by the ad group, e.g., iOS or Android. |
dimension |
adgroup_audience |
adgroup_audience |
The audience segment targeted at the ad group level. |
dimension |
adgroup_audience_ids |
adgroup_audience_ids |
dimension |
|
adgroup_bid |
adgroup_bid |
The bid amount set at the ad group level. |
metric |
adgroup_bid_price |
adgroup_bid_price |
The bid price set for the ad group. |
metric |
adgroup_bid_type |
adgroup_bid_type |
The bidding strategy or type configured for the ad group. |
dimension |
adgroup_billing_event |
adgroup_billing_event |
The billing event type selected for the ad group (e.g., CPM, CPC). |
dimension |
adgroup_brand_safety |
adgroup_brand_safety |
dimension |
|
adgroup_brand_safety_type |
adgroup_brand_safety_type |
dimension |
|
adgroup_budget |
adgroup_budget |
The budget allocated to the ad group. |
metric |
adgroup_budget_mode |
adgroup_budget_mode |
The budget pacing strategy for the ad group, indicating how the budget is allocated over time (e.g., daily or total). |
dimension |
adgroup_campaign_id |
adgroup_campaign_id |
The unique identifier for the campaign to which the ad group belongs. |
dimension |
adgroup_campaign_name |
adgroup_campaign_name |
The name of the campaign to which the ad group belongs. |
dimension |
adgroup_carriers |
adgroup_carriers |
dimension |
|
adgroup_category |
adgroup_category |
The category assigned to the ad group. |
dimension |
adgroup_click_attribution_window |
adgroup_click_attribution_window |
The time frame after a click within which a conversion is attributed to the ad group. |
dimension |
adgroup_comment_disabled |
adgroup_comment_disabled |
Indicates whether comments are disabled for ads within this ad group. |
dimension |
adgroup_conversion_bid_price |
adgroup_conversion_bid_price |
The bid amount set for a conversion event at the ad group level. |
metric |
adgroup_conversion_id |
adgroup_conversion_id |
The identifier of the conversion event that the ad group is optimized for. |
dimension |
adgroup_conversion_window |
adgroup_conversion_window |
dimension |
|
adgroup_create_time |
adgroup_create_time |
The timestamp when the ad group was created. |
dimension |
adgroup_dayparting |
adgroup_dayparting |
metric |
|
adgroup_deep_bid_type |
adgroup_deep_bid_type |
The bidding strategy for deep conversions or in-app events within the ad group. |
dimension |
adgroup_deep_cpa_bid |
adgroup_deep_cpa_bid |
The Cost Per Action (CPA) bid specifically for deep conversion events within the ad group. |
metric |
adgroup_device_price_ranges |
adgroup_device_price_ranges |
The targeted price ranges of devices for the ad group. |
dimension |
adgroup_download_url |
adgroup_download_url |
The download URL associated with the ad group, typically for app install campaigns. |
metric |
adgroup_excluded_audience_ids |
adgroup_excluded_audience_ids |
A list of audience identifiers that are excluded from targeting for this ad group. |
dimension |
adgroup_frequency |
adgroup_frequency |
The frequency cap setting for the ad group, controlling how often a user sees an ad. |
metric |
adgroup_frequency_schedule |
adgroup_frequency_schedule |
The frequency capping schedule configured for the ad group. |
metric |
adgroup_gender |
adgroup_gender |
The genders targeted for your ad group, or the genders of people who engaged with your ad. |
dimension |
adgroup_id |
adgroup_id |
The unique identifier for the ad group. |
dimension |
adgroup_included_custom_actions |
adgroup_included_custom_actions |
A list of custom actions that are included for optimization within the ad group. |
dimension |
adgroup_interest_category_ids |
adgroup_interest_category_ids |
The IDs of interest categories targeted by the ad group. |
dimension |
adgroup_inventory_filter_enabled |
adgroup_inventory_filter_enabled |
Indicates if inventory filtering is enabled for the ad group to control ad placement. |
dimension |
adgroup_ios14_quota_type |
adgroup_ios14_quota_type |
The iOS 14 quota type for the ad group, related to SKAdNetwork campaign limitations. |
dimension |
adgroup_is_new_structure |
adgroup_is_new_structure |
Indicates whether the ad group is configured with the new campaign structure. |
dimension |
adgroup_keywords |
adgroup_keywords |
The keywords used for targeting within the ad group. |
dimension |
adgroup_languages |
adgroup_languages |
The languages targeted by the ad group. |
dimension |
adgroup_location |
adgroup_location |
The geographical location targeted at the ad group level. |
dimension |
adgroup_location_ids |
adgroup_location_ids |
The geographic region IDs targeted by the ad group. |
dimension |
adgroup_modify_time |
adgroup_modify_time |
The timestamp when the ad group was last modified. |
dimension |
adgroup_name |
adgroup_name |
The name of the ad group. |
metric |
adgroup_network_types |
adgroup_network_types |
The network types where ads in this ad group can be displayed (e.g., TikTok feed, audience network). |
dimension |
adgroup_operating_systems |
adgroup_operating_systems |
The operating systems targeted by the ad group. |
dimension |
adgroup_operation_status |
adgroup_operation_status |
The current operational status of the ad group, indicating whether it is running, paused, or completed. |
dimension |
adgroup_opt_status |
adgroup_opt_status |
The optimization status of the ad group. |
dimension |
adgroup_optimization_event |
adgroup_optimization_event |
The specific event the ad group is optimized for (e.g., app install, purchase). |
dimension |
adgroup_optimization_goal |
adgroup_optimization_goal |
The overall goal for optimization set for the ad group. |
dimension |
adgroup_optimize_goal |
adgroup_optimize_goal |
The optimization goal set for the ad group. |
dimension |
adgroup_pacing |
adgroup_pacing |
The pacing strategy for the ad group’s budget, controlling daily spend distribution. |
dimension |
adgroup_pixel_id |
adgroup_pixel_id |
The Pixel ID used by the ad group for tracking website events. |
dimension |
adgroup_placement |
adgroup_placement |
The specific placement where ads in the ad group are shown (e.g., TikTok For You Feed, Series). |
dimension |
adgroup_placement_type |
adgroup_placement_type |
The placement type where the ad group’s ads will appear. |
dimension |
adgroup_product_source |
adgroup_product_source |
The source of the products advertised in the ad group, such as a product catalog. |
dimension |
adgroup_promotion_type |
adgroup_promotion_type |
The type of promotion or objective for the ad group. |
dimension |
adgroup_purchased_impression |
adgroup_purchased_impression |
The number of impressions purchased for the ad group. |
metric |
adgroup_purchased_reach |
adgroup_purchased_reach |
The number of unique users reached for the ad group based on purchased media. |
metric |
adgroup_rf_estimated_cpr |
adgroup_rf_estimated_cpr |
The estimated Cost Per Result (CPR) for Reach and Frequency campaigns at the ad group level. |
metric |
adgroup_rf_estimated_frequency |
adgroup_rf_estimated_frequency |
The estimated average number of times an ad is shown to a unique user in an ad group’s Reach and Frequency campaign. |
metric |
adgroup_rf_purchased_type |
adgroup_rf_purchased_type |
The purchased type for Reach and Frequency campaigns within the ad group. |
dimension |
adgroup_schedule_end_time |
adgroup_schedule_end_time |
The scheduled end time for the ad group to run. |
dimension |
adgroup_schedule_start_time |
adgroup_schedule_start_time |
The scheduled start time for the ad group to run. |
dimension |
adgroup_schedule_type |
adgroup_schedule_type |
The type of schedule applied to the ad group, e.g., always-on or specific hours. |
dimension |
adgroup_scheduled_budget |
adgroup_scheduled_budget |
The total budget allocated for the ad group over its scheduled duration. |
metric |
adgroup_secondary_optimization_event |
adgroup_secondary_optimization_event |
The secondary optimization event selected for the ad group, used for bidding strategies. |
dimension |
adgroup_secondary_status |
adgroup_secondary_status |
The secondary status of the ad group, providing more granular information beyond the primary status. |
dimension |
adgroup_share_disabled |
adgroup_share_disabled |
Indicates whether sharing of ads within this ad group is disabled. |
dimension |
adgroup_skip_learning_phase |
adgroup_skip_learning_phase |
Indicates whether the ad group is configured to skip the learning phase. |
dimension |
adgroup_split_test_adgroup_ids |
adgroup_split_test_adgroup_ids |
A list of ad group identifiers that are part of a split test with this ad group. |
dimension |
adgroup_statistic_type |
adgroup_statistic_type |
The type of statistics reported for the ad group. |
dimension |
adgroup_status |
adgroup_status |
The current operational status of the ad group, such as enabled, disabled, or frozen. |
dimension |
adgroup_video_download |
adgroup_video_download |
Indicates if video downloads are enabled for ads within the ad group. |
dimension |
adgroup_video_download_disabled |
adgroup_video_download_disabled |
Indicates whether video download is disabled for ads within this ad group. |
dimension |
adgroup_view_attribution_window |
adgroup_view_attribution_window |
The time frame after an impression (view) within which a conversion is attributed to the ad group. |
dimension |
ads_impression_events |
ads_impression_events |
The total number of ad impression events from your mobile app counted as app events and attributed to your ads. |
metric |
adset_age |
adset_age |
The age demographic targeted by the ad set. |
dimension |
adset_bidtype |
adset_bidtype |
The bidding strategy or method applied at the ad set level. |
dimension |
adset_campaign_name |
adset_campaign_name |
The name of the campaign to which the ad set belongs. |
dimension |
adset_country |
adset_country |
The country targeted by the ad set. |
dimension |
adset_gender |
adset_gender |
The gender demographic targeted by the ad set. |
dimension |
adset_invalid_impressions |
adset_invalid_impressions |
metric |
|
adset_invalid_spend |
adset_invalid_spend |
metric |
|
adset_language |
adset_language |
The language targeted by the ad set. |
dimension |
adset_name |
adset_name |
The name of the ad set. |
dimension |
adset_platform |
adset_platform |
The platform where the ad set’s ads are displayed. |
dimension |
adset_platform_name |
adset_platform_name |
dimension |
|
adset_status |
adset_status |
The current status of the ad set, e.g., active, paused, or deleted. |
dimension |
adset_targeting |
adset_targeting |
The targeting criteria configured for the ad set, defining the audience. |
dimension |
adset_valid_impressions |
adset_valid_impressions |
dimension |
|
adset_valid_spend |
adset_valid_spend |
dimension |
|
advertiser |
advertiser |
The name or ID of the advertiser account. |
dimension |
advertiser_account_type |
advertiser_account_type |
The type of the ad account, with values including RESERVATION or AUCTION. |
dimension |
advertiser_address |
advertiser_address |
The physical address of the advertiser. |
dimension |
advertiser_balance |
advertiser_balance |
The available balance in the advertiser’s account. |
metric |
advertiser_brand |
advertiser_brand |
The brand name associated with the advertiser. |
dimension |
advertiser_cellphone_number |
advertiser_cellphone_number |
The contact mobile number of the advertiser, with data potentially desensitized. |
dimension |
advertiser_company |
advertiser_company |
The name of the advertiser’s company. |
dimension |
advertiser_country |
advertiser_country |
The country where the advertiser is located. |
dimension |
advertiser_create_time |
advertiser_create_time |
The timestamp when the advertiser account was created. |
dimension |
advertiser_currency |
advertiser_currency |
The currency used by the advertiser’s account. |
dimension |
advertiser_currency_cost |
advertiser_currency_cost |
The currency in which the advertiser’s costs are reported. |
metric |
advertiser_description |
advertiser_description |
A description of the advertiser’s business. |
dimension |
advertiser_display_timezone |
advertiser_display_timezone |
The display timezone configured for the advertiser’s account. |
dimension |
advertiser_email |
advertiser_email |
The contact email address of the advertiser. |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the advertiser account. |
dimension |
advertiser_industry |
advertiser_industry |
The industry category of the advertiser. |
metric |
advertiser_language |
advertiser_language |
dimension |
|
advertiser_license_no |
advertiser_license_no |
The advertiser company license number. |
dimension |
advertiser_license_province |
advertiser_license_province |
The province where the advertiser’s business license is registered. |
dimension |
advertiser_name |
advertiser_name |
The name of the advertiser. |
dimension |
advertiser_owner_bc_id |
advertiser_owner_bc_id |
The Business Center ID of the owner of the advertiser account. |
dimension |
advertiser_promotion_center_province |
advertiser_promotion_center_province |
dimension |
|
advertiser_rejection_reason |
advertiser_rejection_reason |
The reason(s) an advertiser’s ads or account may have been rejected. |
dimension |
advertiser_status |
advertiser_status |
The current status of the advertiser account. |
dimension |
advertiser_telephone_number |
advertiser_telephone_number |
The fixed phone number of the advertiser, with data potentially desensitized. |
dimension |
advertiser_timezone |
advertiser_timezone |
The timezone configured for the advertiser account. |
dimension |
age |
age |
The age of the targeted audience or users who engaged with the ad. |
dimension |
age_groups |
age_groups |
The demographic age ranges targeted by the ad or ad group. |
dimension |
age_range |
age_range |
The age demographic targeted by the ad. |
dimension |
anchor_click_rate |
anchor_click_rate |
The percentage of times viewers clicked on an anchor after seeing it in a video. |
metric |
anchor_clicks |
anchor_clicks |
The number of clicks on anchors within video ads. |
metric |
app_download_url |
app_download_url |
The URL for downloading the app promoted by the ad. |
dimension |
app_event_add_to_cart |
app_event_add_to_cart |
The number of add to cart events that occurred within an app, attributed to your ads. |
metric |
app_event_add_to_cart_rate |
app_event_add_to_cart_rate |
The rate at which users add items to their cart within an app. |
metric |
app_id |
app_id |
The unique identifier for the promoted application. |
dimension |
app_install |
app_install |
The number of app installs attributed to the ad campaign. |
metric |
app_name |
app_name |
The name of the advertised application. |
dimension |
app_profile_country |
app_profile_country |
The country associated with the app profile. |
dimension |
app_promotion_type |
app_promotion_type |
The type of app promotion campaign. |
metric |
app_type |
app_type |
The type of application promoted by the ad (e.g., iOS, Android). |
dimension |
attribution_event_count |
attribution_event_count |
The total number of attributed conversion events. |
dimension |
attribution_window |
attribution_window |
dimension |
|
audience_ids |
audience_ids |
The unique identifiers for the target audience segments. |
dimension |
audience_name |
audience_name |
The name of the targeted audience. |
dimension |
audience_segment |
audience_segment |
A specific group of users identified for ad targeting based on shared characteristics. |
dimension |
audience_strategy |
audience_strategy |
The approach or method used to define and reach the target audience. |
dimension |
audience_type |
audience_type |
The type of audience targeted, such as custom or lookalike. |
dimension |
auto_targeting_enabled |
auto_targeting_enabled |
Indicates whether auto-targeting features are enabled for the ad group. |
dimension |
avatar_icon_web_uri |
avatar_icon_web_uri |
The URI for the avatar icon used in the ad creative. |
dimension |
average_video_play |
average_video_play |
The average duration a video ad was played. |
metric |
average_video_play_per_user |
average_video_play_per_user |
The average time your video was played per unique user, including any time spent replaying the video. |
metric |
avg_value_per_pageview |
avg_value_per_pageview |
The average value generated per page view. |
metric |
behavior_name |
behavior_name |
The name of the user behavior targeted or observed. |
dimension |
bid |
bid |
The bid amount set for an ad or ad group. |
metric |
bid_display_mode |
bid_display_mode |
The display mode for bidding strategies. |
dimension |
bid_price |
bid_price |
The monetary amount bid for ad impressions or actions. |
metric |
bid_secondary_goal |
bid_secondary_goal |
The bid amount or strategy for the secondary optimization goal of an ad group. |
metric |
bid_strategy |
bid_strategy |
The bidding strategy used for the campaign or ad group (e.g., lowest cost, cost cap). |
metric |
bid_type |
bid_type |
The type of bidding strategy used, such as CPC, CPM, or oCPC. |
dimension |
billed_cost |
billed_cost |
The actual cost incurred for the ads, which has been billed. |
metric |
billing_event |
billing_event |
The event type on which billing is based, such as impressions or clicks. |
dimension |
brand_name |
brand_name |
dimension |
|
brand_safety_partner |
brand_safety_partner |
The third-party partner used for brand safety measurement. |
dimension |
brand_safety_postbid_partner |
brand_safety_postbid_partner |
The brand safety partner used for post-bid verification. |
dimension |
brand_safety_type |
brand_safety_type |
The brand safety settings or category applied to the ad. |
dimension |
brand_safety_vast_url |
brand_safety_vast_url |
The VAST URL for brand safety measurement. |
dimension |
branded_content_disabled |
branded_content_disabled |
Indicates whether branded content features are disabled. |
dimension |
budget |
budget |
The total budget allocated for a campaign or ad group. |
metric |
budget_mode |
budget_mode |
The budgeting strategy, such as daily budget, total lifetime budget, or dynamic daily budget. |
dimension |
budget_optimize_on |
budget_optimize_on |
The optimization goal for the budget (e.g., conversions, clicks). |
dimension |
budget_type |
budget_type |
The type of budget set for the campaign or ad group (e.g., daily budget, total budget). |
dimension |
button_click |
button_click |
The number of clicks on a button within the ad creative. |
metric |
button_click_consultation |
button_click_consultation |
The number of clicks on consultation-related buttons within ads. |
metric |
button_click_consultation_rate |
button_click_consultation_rate |
The rate of clicks on consultation-related buttons within ads. |
metric |
button_click_rate |
button_click_rate |
The rate at which users click on buttons within ads. |
metric |
buy_type |
buy_type |
The purchasing method for the ad (e.g., auction, reach & frequency). |
dimension |
call_to_action |
call_to_action |
The call-to-action text displayed on the ad (e.g., ‘Shop Now’, ‘Learn More’). |
dimension |
call_to_action_id |
call_to_action_id |
The unique identifier for the call-to-action used in the ad. |
dimension |
campaign |
campaign |
The name of the advertising campaign. |
dimension |
campaign name |
campaign name |
The name of the advertising campaign. |
dimension |
campaign_app_profile_page_state |
campaign_app_profile_page_state |
The state of the app profile page associated with the campaign. |
dimension |
campaign_budget |
campaign_budget |
The budget allocated to the campaign. |
metric |
campaign_budget_mode |
campaign_budget_mode |
The budget mode for the campaign (e.g., daily, total). |
dimension |
campaign_budget_optimize_on |
campaign_budget_optimize_on |
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign, which automatically distributes budget across ad groups to get the best results. |
dimension |
campaign_create_time |
campaign_create_time |
The timestamp when the campaign was created. |
dimension |
campaign_dedicate_type |
campaign_dedicate_type |
The type of dedicated campaign, often related to specific campaign goals or features. |
metric |
campaign_deep_bid_type |
campaign_deep_bid_type |
The bidding strategy used for deep conversions or in-app events at the campaign level. |
dimension |
campaign_destination |
campaign_destination |
The destination linked to the campaign, such as a website or app store. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the campaign. |
dimension |
campaign_invalid_impressions |
campaign_invalid_impressions |
metric |
|
campaign_invalid_spend |
campaign_invalid_spend |
metric |
|
campaign_is_new_structure |
campaign_is_new_structure |
Indicates if the campaign belongs to a new advertising structure or system. |
dimension |
campaign_is_smart_performance_campaign |
campaign_is_smart_performance_campaign |
Indicates if the campaign is a Smart Performance Campaign, utilizing automated optimization. |
dimension |
campaign_modify_time |
campaign_modify_time |
The timestamp when the campaign was last modified. |
dimension |
campaign_name |
campaign_name |
The name of the campaign. |
metric |
campaign_objective |
campaign_objective |
The marketing objective of the campaign (e.g., Reach, Traffic, Conversions). |
dimension |
campaign_objective_type |
campaign_objective_type |
The primary objective of the advertising campaign, such as reach, traffic, or conversions. |
dimension |
campaign_operation_status |
campaign_operation_status |
The current operational status of the campaign, indicating whether it is running, paused, or completed. |
dimension |
campaign_opt_status |
campaign_opt_status |
The optimization status of the campaign. |
dimension |
campaign_optimization |
campaign_optimization |
The optimization strategy or goal applied at the campaign level. |
dimension |
campaign_optimization_goal |
campaign_optimization_goal |
The goal for optimization set for the campaign. |
dimension |
campaign_product_source |
campaign_product_source |
The source of the products advertised in the campaign, such as a product catalog. |
dimension |
campaign_rf_campaign_type |
campaign_rf_campaign_type |
The type of reach and frequency (RF) campaign. |
dimension |
campaign_roas_bid |
campaign_roas_bid |
The target Return On Ad Spend (ROAS) bid set for the campaign. |
metric |
campaign_secondary_status |
campaign_secondary_status |
The secondary status of the campaign, providing more granular information beyond the primary status. |
dimension |
campaign_special_industries |
campaign_special_industries |
A list of special industries that the campaign targets or is associated with. |
dimension |
campaign_status |
campaign_status |
The current operational status of the campaign (e.g., active, paused, deleted). |
dimension |
campaign_type |
campaign_type |
The type of the campaign. |
dimension |
campaign_valid_impressions |
campaign_valid_impressions |
dimension |
|
campaign_valid_spend |
campaign_valid_spend |
dimension |
|
card_id |
card_id |
The unique identifier for a card creative. |
dimension |
carrier_ids |
carrier_ids |
dimension |
|
cash_spend |
cash_spend |
The estimated amount of money spent on a campaign, ad group, or ad during its schedule, charged by cash. |
metric |
catalog_authorized_bc_id |
catalog_authorized_bc_id |
The Business Center ID authorized to manage the catalog. |
dimension |
catalog_id |
catalog_id |
The unique identifier for a product catalog. |
dimension |
catalog_name |
catalog_name |
The name of the product catalog. |
dimension |
category_exclusion_ids |
category_exclusion_ids |
A list of category IDs to be excluded from targeting. |
dimension |
checkout |
checkout |
The number of checkout events attributed to the ad. |
metric |
checkout_rate |
checkout_rate |
The rate at which users complete the checkout process. |
metric |
click_attribution_window |
click_attribution_window |
The time period after a click during which a conversion can be attributed to the ad. |
dimension |
click_cnt |
click_cnt |
The total number of clicks on the ad. |
metric |
click_tracking_url |
click_tracking_url |
The URL used for tracking clicks on the ad. |
dimension |
clicks |
clicks |
The total number of clicks on an ad. |
metric |
clicks_cost |
clicks_cost |
The cost associated with clicks on the ad. |
metric |
clicks_on_hashtag_challenge |
clicks_on_hashtag_challenge |
The total number of clicks on the hashtag challenge associated with an ad during its campaign. |
metric |
clicks_on_music_disc |
clicks_on_music_disc |
The number of clicks on the music disc icon within a Spark Ad. |
metric |
comment_disabled |
comment_disabled |
Indicates whether comments are disabled for the ad or creative. |
dimension |
comments |
comments |
The number of comments on an ad. |
metric |
complete_payment |
complete_payment |
The number of complete payment events attributed to ads. |
metric |
complete_payment_rate |
complete_payment_rate |
The rate of complete payment events attributed to ads. |
metric |
complete_payment_roas |
complete_payment_roas |
The Return on Ad Spend (ROAS) specifically for complete payment events. |
metric |
complete_tutorial |
complete_tutorial |
The number of times an in-app tutorial was completed, attributed to ads. |
metric |
complete_tutorial_rate |
complete_tutorial_rate |
The rate at which users complete a tutorial after interacting with an ad. |
metric |
consultation |
consultation |
The number of consultation events. |
metric |
consultation_rate |
consultation_rate |
The rate of consultation events. |
metric |
contextual_tag_ids |
contextual_tag_ids |
A list of contextual tag IDs used for targeting. |
dimension |
conversion |
conversion |
The total number of conversion events attributed to the ad. |
metric |
conversion_bid_price |
conversion_bid_price |
The bid price set to optimize for conversions. |
metric |
conversion_cost |
conversion_cost |
The total cost incurred for conversions. |
metric |
conversion_rate |
conversion_rate |
The percentage of users who clicked on your ad and completed a desired action. |
metric |
conversions |
conversions |
The number of times an ad achieved an outcome, based on the secondary goal selected for the campaign. |
dimension |
convert_cnt |
convert_cnt |
The total number of conversions. |
metric |
cost |
cost |
The total amount of money spent on advertising. |
metric |
cost_per_1000_reached |
cost_per_1000_reached |
The cost incurred for every 1000 unique users reached by the ad. |
metric |
cost_per_10_second_live_view |
cost_per_10_second_live_view |
The average cost incurred for each 10-second view of a live stream ad. |
metric |
cost_per_achieve_level |
cost_per_achieve_level |
The average cost incurred for each achievement level reached. |
metric |
cost_per_add_billing |
cost_per_add_billing |
The average cost incurred for each instance of adding billing information. |
metric |
cost_per_add_payment_info |
cost_per_add_payment_info |
The average cost incurred for each instance of adding payment information. |
metric |
cost_per_add_to_wishlist |
cost_per_add_to_wishlist |
The average cost incurred for each ‘add to wishlist’ event. |
metric |
cost_per_app_event_add_to_cart |
cost_per_app_event_add_to_cart |
The average cost incurred for each in-app ‘add to cart’ event. |
metric |
cost_per_app_install |
cost_per_app_install |
The average cost incurred for each app install. |
metric |
cost_per_button_click |
cost_per_button_click |
The average cost incurred for each button click on an ad. |
metric |
cost_per_button_click_consultation |
cost_per_button_click_consultation |
The average cost incurred for each click on a consultation button. |
metric |
cost_per_checkout |
cost_per_checkout |
The average cost incurred for each completed checkout. |
metric |
cost_per_complete_payment |
cost_per_complete_payment |
The average cost incurred for each completed payment. |
metric |
cost_per_complete_tutorial |
cost_per_complete_tutorial |
The average cost incurred for each tutorial completion. |
metric |
cost_per_consultation |
cost_per_consultation |
The average cost incurred for each consultation event. |
metric |
cost_per_conversion |
cost_per_conversion |
The average cost incurred for each conversion attributed to your ads. |
metric |
cost_per_create_gamerole |
cost_per_create_gamerole |
The average cost incurred for each creation of a game role. |
metric |
cost_per_create_group |
cost_per_create_group |
The average cost incurred for each group creation event. |
metric |
cost_per_cta_app_install |
cost_per_cta_app_install |
The average cost incurred for each app install resulting from a Call To Action (CTA). |
metric |
cost_per_cta_conversion |
cost_per_cta_conversion |
The average cost incurred for each conversion resulting from a Call To Action (CTA). |
metric |
cost_per_cta_purchase |
cost_per_cta_purchase |
The average cost for each payment event attributed to clicks on a Call-to-Action. |
metric |
cost_per_cta_registration |
cost_per_cta_registration |
The average cost incurred for each registration resulting from a Call To Action (CTA). |
metric |
cost_per_custom_app_event |
cost_per_custom_app_event |
The average cost incurred for each custom in-app event. |
metric |
cost_per_custom_page_event |
cost_per_custom_page_event |
The average cost incurred for each custom page event on a website. |
metric |
cost_per_download_button |
cost_per_download_button |
The average cost incurred for each click on a download button. |
metric |
cost_per_download_detail |
cost_per_download_detail |
The average cost incurred for each view of download details. |
metric |
cost_per_download_start |
cost_per_download_start |
The average cost incurred for each download start event. |
metric |
cost_per_engaged_view_through_conversion |
cost_per_engaged_view_through_conversion |
The average cost incurred for each conversion attributed to an engaged view-through. |
metric |
cost_per_form |
cost_per_form |
The average cost incurred for each form submission. |
metric |
cost_per_form_button |
cost_per_form_button |
The average cost incurred for each click on a form submission button. |
metric |
cost_per_form_detail |
cost_per_form_detail |
The average cost incurred for each view of form details. |
metric |
cost_per_in_app_ad_click |
cost_per_in_app_ad_click |
The average cost incurred for each click on an ad displayed within an app. |
metric |
cost_per_in_app_ad_impr |
cost_per_in_app_ad_impr |
The average cost incurred for each impression of an ad displayed within an app. |
metric |
cost_per_initiate_checkout |
cost_per_initiate_checkout |
The average cost incurred for each initiated checkout process. |
metric |
cost_per_ix_button_click_count |
cost_per_ix_button_click_count |
The cost incurred for each interactive button click. |
metric |
cost_per_ix_page_view_count |
cost_per_ix_page_view_count |
The cost incurred for each interactive page view. |
metric |
cost_per_ix_product_click_count |
cost_per_ix_product_click_count |
The cost incurred for each interactive product click. |
metric |
cost_per_join_group |
cost_per_join_group |
The average cost incurred for each group join event. |
metric |
cost_per_landing_page_view |
cost_per_landing_page_view |
The average cost incurred for each landing page view. |
metric |
cost_per_launch_app |
cost_per_launch_app |
The average cost incurred for each app launch. |
metric |
cost_per_live_view |
cost_per_live_view |
The average cost incurred for each view of a live stream ad. |
metric |
cost_per_loan_apply |
cost_per_loan_apply |
The average cost incurred for each loan application. |
metric |
cost_per_loan_credit |
cost_per_loan_credit |
The average cost incurred for each loan credit event. |
metric |
cost_per_loan_disbursement |
cost_per_loan_disbursement |
The average cost incurred for each loan disbursement. |
metric |
cost_per_login |
cost_per_login |
The average cost incurred for each user login. |
metric |
cost_per_next_day_open |
cost_per_next_day_open |
The average cost incurred for each app open on the day following installation. |
metric |
cost_per_offline_add_payment_info_event |
cost_per_offline_add_payment_info_event |
The cost incurred per offline ‘add payment info’ event. |
metric |
cost_per_offline_add_to_cart_event |
cost_per_offline_add_to_cart_event |
The average cost incurred for each offline ‘add to cart’ event. |
metric |
cost_per_offline_add_to_wishlist_event |
cost_per_offline_add_to_wishlist_event |
The cost incurred per offline ‘add to wishlist’ event. |
metric |
cost_per_offline_click_button_event |
cost_per_offline_click_button_event |
The cost incurred per offline button click event. |
metric |
cost_per_offline_complete_registration_event |
cost_per_offline_complete_registration_event |
The cost incurred per offline complete registration event. |
metric |
cost_per_offline_contact_event |
cost_per_offline_contact_event |
The cost incurred per offline contact event. |
metric |
cost_per_offline_download_event |
cost_per_offline_download_event |
The cost incurred per offline download event. |
metric |
cost_per_offline_form_event |
cost_per_offline_form_event |
The cost incurred per offline form submission event. |
metric |
cost_per_offline_initiate_checkout_event |
cost_per_offline_initiate_checkout_event |
The cost incurred per offline ‘initiate checkout’ event. |
metric |
cost_per_offline_place_order_event |
cost_per_offline_place_order_event |
The cost incurred per offline ‘place order’ event. |
metric |
cost_per_offline_search_event |
cost_per_offline_search_event |
The cost incurred per offline search event. |
metric |
cost_per_offline_shopping_event |
cost_per_offline_shopping_event |
The cost incurred per offline shopping event. |
metric |
cost_per_offline_subscribe_event |
cost_per_offline_subscribe_event |
The cost incurred per offline subscribe event. |
metric |
cost_per_offline_view_content_event |
cost_per_offline_view_content_event |
The cost incurred per offline ‘view content’ event. |
metric |
cost_per_on_web_add_to_wishlist |
cost_per_on_web_add_to_wishlist |
The cost incurred per ‘add to wishlist’ event on the web. |
metric |
cost_per_on_web_order |
cost_per_on_web_order |
The average cost incurred for each order placed on a website. |
metric |
cost_per_on_web_subscribe |
cost_per_on_web_subscribe |
The cost incurred per subscription event on the web. |
metric |
cost_per_online_consult |
cost_per_online_consult |
The average cost incurred for each online consultation event attributed to your ads. |
metric |
cost_per_onsite_add_billing |
cost_per_onsite_add_billing |
The cost incurred per ‘add billing information’ event directly on the ad platform’s site. |
metric |
cost_per_onsite_add_to_wishlist |
cost_per_onsite_add_to_wishlist |
The cost incurred per ‘add to wishlist’ event directly on the ad platform’s site. |
metric |
cost_per_onsite_destination_visit |
cost_per_onsite_destination_visit |
The cost incurred per visit to the onsite destination from the ad. |
metric |
cost_per_onsite_download_start |
cost_per_onsite_download_start |
The cost incurred per download start event directly on the ad platform’s site. |
metric |
cost_per_onsite_form |
cost_per_onsite_form |
The cost incurred per form submission event directly on the ad platform’s site. |
metric |
cost_per_onsite_initiate_checkout_count |
cost_per_onsite_initiate_checkout_count |
The cost incurred per ‘initiate checkout’ event count directly on the ad platform’s site. |
metric |
cost_per_onsite_on_web_cart |
cost_per_onsite_on_web_cart |
The cost incurred per ‘add to cart’ web event directly on the ad platform’s site. |
metric |
cost_per_onsite_on_web_detail |
cost_per_onsite_on_web_detail |
The cost incurred per web detail view directly on the ad platform’s site. |
metric |
cost_per_onsite_shopping |
cost_per_onsite_shopping |
The cost incurred per shopping event directly on the ad platform’s site. |
metric |
cost_per_order |
cost_per_order |
The average cost incurred for each order. |
metric |
cost_per_page_browse_consultation |
cost_per_page_browse_consultation |
The average cost incurred for each page browse resulting in a consultation, attributed to your ads. |
metric |
cost_per_page_browse_view |
cost_per_page_browse_view |
The average cost incurred for each page browse view event attributed to your ads. |
metric |
cost_per_page_content_view_event |
cost_per_page_content_view_event |
The cost incurred per page content view event. |
metric |
cost_per_page_event_search |
cost_per_page_event_search |
The average cost incurred for each search event on a landing page. |
metric |
cost_per_pageview |
cost_per_pageview |
The cost incurred per page view. |
metric |
cost_per_product_details_page_browse |
cost_per_product_details_page_browse |
The average cost incurred for each view of a product details page, attributed to your ads. |
metric |
cost_per_purchase |
cost_per_purchase |
The average cost incurred for each purchase. |
metric |
cost_per_ratings |
cost_per_ratings |
The average cost incurred for each rating event attributed to your ads. |
metric |
cost_per_registration |
cost_per_registration |
The average cost incurred for each user registration event attributed to your ads. |
metric |
cost_per_result |
cost_per_result |
The average cost incurred for each desired result (e.g., conversion, click) achieved by your ads. |
metric |
cost_per_sales_lead |
cost_per_sales_lead |
The average cost incurred for generating a sales lead, attributed to your ads. |
metric |
cost_per_search |
cost_per_search |
The average cost incurred for each search action. |
metric |
cost_per_secondary_goal_result |
cost_per_secondary_goal_result |
The average cost incurred for each achievement of a secondary goal result, attributed to your ads. |
dimension |
cost_per_spend_credits |
cost_per_spend_credits |
The average cost incurred for each instance where a user spends credits, attributed to your ads. |
metric |
cost_per_start_trial |
cost_per_start_trial |
The average cost incurred for each trial initiation, attributed to your ads. |
metric |
cost_per_subscribe |
cost_per_subscribe |
The average cost incurred for each subscription event, attributed to your ads. |
metric |
cost_per_total_achieve_level |
cost_per_total_achieve_level |
The cost incurred for each instance where a user achieved a certain level within an app or game, attributed to the ad. |
metric |
cost_per_total_add_to_wishlist |
cost_per_total_add_to_wishlist |
The average cost incurred for each total add-to-wishlist event attributed to your ads. |
metric |
cost_per_total_app_event_add_to_cart |
cost_per_total_app_event_add_to_cart |
The average cost incurred for each ‘add to cart’ app event. |
metric |
cost_per_total_checkout |
cost_per_total_checkout |
The average cost incurred for each total checkout completion event attributed to your ads. |
metric |
cost_per_total_complete_tutorial |
cost_per_total_complete_tutorial |
The average cost incurred for each total tutorial completion event attributed to your ads. |
metric |
cost_per_total_create_gamerole |
cost_per_total_create_gamerole |
The cost incurred for each time a user created a game role, attributed to the ad. |
metric |
cost_per_total_create_group |
cost_per_total_create_group |
The cost incurred for each time a user created a group, attributed to the ad. |
metric |
cost_per_total_in_app_ad_click |
cost_per_total_in_app_ad_click |
The average cost incurred for each total in-app ad click event attributed to your ads. |
metric |
cost_per_total_in_app_ad_impr |
cost_per_total_in_app_ad_impr |
The average cost incurred for each total in-app ad impression event attributed to your ads. |
metric |
cost_per_total_join_group |
cost_per_total_join_group |
The cost incurred for each time a user joined a group, attributed to the ad. |
metric |
cost_per_total_launch_app |
cost_per_total_launch_app |
The average cost incurred for each total app launch event attributed to your ads. |
metric |
cost_per_total_loan_apply |
cost_per_total_loan_apply |
The average cost incurred for each total loan application event attributed to your ads. |
metric |
cost_per_total_loan_credit |
cost_per_total_loan_credit |
The cost incurred for each time a user received a loan credit, attributed to the ad. |
metric |
cost_per_total_loan_disbursement |
cost_per_total_loan_disbursement |
The cost incurred for each loan disbursement, attributed to the ad. |
metric |
cost_per_total_login |
cost_per_total_login |
The average cost incurred for each total user login event attributed to your ads. |
metric |
cost_per_total_next_day_open |
cost_per_total_next_day_open |
The cost incurred for each time a user opened the app the day after installation, attributed to the ad. |
metric |
cost_per_total_purchase |
cost_per_total_purchase |
The average cost incurred for each total purchase event attributed to your ads. |
metric |
cost_per_total_ratings |
cost_per_total_ratings |
The average cost incurred for each total rating event attributed to your ads. |
metric |
cost_per_total_registration |
cost_per_total_registration |
The average cost incurred for each total user registration event attributed to your ads. |
metric |
cost_per_total_sales_lead |
cost_per_total_sales_lead |
The average cost incurred for each total sales lead generated, attributed to your ads. |
metric |
cost_per_total_search |
cost_per_total_search |
The average cost incurred for all search actions. |
metric |
cost_per_total_spend_credits |
cost_per_total_spend_credits |
The average cost incurred for each total spend credits event attributed to your ads. |
metric |
cost_per_total_start_trial |
cost_per_total_start_trial |
The average cost incurred for each total trial initiation, attributed to your ads. |
metric |
cost_per_total_subscribe |
cost_per_total_subscribe |
The average cost incurred for each total subscription event, attributed to your ads. |
metric |
cost_per_total_unlock_achievement |
cost_per_total_unlock_achievement |
The cost incurred for each achievement unlocked by a user, attributed to the ad. |
metric |
cost_per_total_view_content |
cost_per_total_view_content |
The average cost incurred for all content view events. |
metric |
cost_per_unique_ad_impression_event |
cost_per_unique_ad_impression_event |
The cost incurred per unique ad impression event. |
metric |
cost_per_unique_custom_app_event |
cost_per_unique_custom_app_event |
The cost incurred per unique custom app event. |
metric |
cost_per_unlock_achievement |
cost_per_unlock_achievement |
The cost incurred for each instance of a user unlocking an achievement, attributed to the ad. |
metric |
cost_per_user_registration |
cost_per_user_registration |
The average cost incurred for each user registration event attributed to your ads. |
metric |
cost_per_view_content |
cost_per_view_content |
The average cost incurred for each view content event. |
metric |
cost_per_vta_app_install |
cost_per_vta_app_install |
The cost incurred per view-through attribution (VTA) app install. |
metric |
cost_per_vta_conversion |
cost_per_vta_conversion |
The average cost incurred for each view-through conversion, where a user converts after viewing an ad without clicking on it. |
metric |
cost_per_vta_purchase |
cost_per_vta_purchase |
The average cost incurred for each view-through purchase, where a user purchases after viewing an ad without clicking on it. |
metric |
cost_per_vta_registration |
cost_per_vta_registration |
The average cost incurred for each view-through registration, where a user registers after viewing an ad without clicking on it. |
metric |
cost_per_web_event_add_to_cart |
cost_per_web_event_add_to_cart |
The average cost incurred for each ‘add to cart’ web event. |
metric |
cost_pre_ad_impression_event |
cost_pre_ad_impression_event |
The cost associated with a pre-ad impression event. |
metric |
cost_total_add_payment_info |
cost_total_add_payment_info |
The total cost incurred for users initiating adding payment information, attributed to the ad. |
metric |
cost_usd |
cost_usd |
The cost incurred for the ad, reported in United States Dollars (USD). |
metric |
costs_usd |
costs_usd |
The total cost incurred for the ads in United States Dollars (USD). |
metric |
countdown_sticker_recall_clicks |
countdown_sticker_recall_clicks |
The number of clicks on countdown stickers for ad recall. |
metric |
country |
country |
The country associated with the advertiser account or target audience. |
dimension |
country_code |
country_code |
The two-letter ISO 3166-1 code for the country associated with the advertiser or targeted by the ad. |
dimension |
cpc |
cpc |
Cost Per Click, the average cost for each click on your ad. |
metric |
cpm |
cpm |
Cost Per Mille, the average cost for 1000 impressions of your ad. |
metric |
cpv_video_duration |
cpv_video_duration |
Optimized video playback duration, with values like SIX_SECONDS or TWO_SECONDS. |
dimension |
create_gamerole |
create_gamerole |
The number of times users created a game role. |
metric |
create_gamerole_rate |
create_gamerole_rate |
The rate at which users created a game role, typically as a percentage of clicks or impressions. |
metric |
create_group |
create_group |
The number of times users created a group. |
metric |
create_group_rate |
create_group_rate |
The rate at which users created a group, typically as a percentage of clicks or impressions. |
metric |
create_time |
create_time |
The timestamp when the object (e.g., campaign, ad group) was created. |
dimension |
creative |
creative |
Details pertaining to the ad creative used in the campaign, such as video or image assets. |
dimension |
creative_authorized |
creative_authorized |
Indicates whether the creative is authorized for use. |
dimension |
creative_delivery_status |
creative_delivery_status |
dimension |
|
creative_material_mode |
creative_material_mode |
The mode of creative material, indicating how creative assets are managed. |
dimension |
creative_type |
creative_type |
The overall type of the creative (e.g., VIDEO, IMAGE, CAROUSEL). |
dimension |
creative_video_poster_url |
creative_video_poster_url |
The URL of the poster image for a video creative. |
dimension |
creative_video_size |
creative_video_size |
The file size of the video creative. |
metric |
cta_app_install |
cta_app_install |
The number of app installs triggered by a Call To Action (CTA). |
metric |
cta_conversion |
cta_conversion |
The number of conversions triggered by a Call To Action (CTA). |
metric |
cta_purchase |
cta_purchase |
The number of purchases attributed to clicks on a Call-to-Action button. |
metric |
cta_registration |
cta_registration |
The number of registrations triggered by a Call To Action (CTA). |
metric |
ctr |
ctr |
Click-Through Rate, the percentage of users who click on your ad after seeing it. |
metric |
currency |
currency |
The currency in which the financial data is reported. |
dimension |
currency_type |
currency_type |
The type of currency used for financial transactions or reporting. |
dimension |
custom_app_event_rate |
custom_app_event_rate |
The rate at which users complete custom in-app events. |
metric |
custom_app_events |
custom_app_events |
The total number of custom events that occurred within an app, attributed to ads. |
metric |
custom_app_events_value |
custom_app_events_value |
The total monetary value associated with custom in-app events. |
metric |
custom_event_type |
custom_event_type |
The type of custom event being tracked. |
metric |
custom_page_event_rate |
custom_page_event_rate |
The rate at which users complete custom page events on a website. |
metric |
custom_page_events |
custom_page_events |
The total number of custom events that occurred on a webpage, attributed to ads. |
metric |
custom_page_events_value |
custom_page_events_value |
The total monetary value associated with custom webpage events. |
metric |
customized_ad_impression_event_rate |
customized_ad_impression_event_rate |
The rate of customized ad impression events. |
metric |
dark_post_status |
dark_post_status |
The status of a dark post (unpublished ad) creative. |
dimension |
date |
date |
The date for which the data is reported. |
dimension |
date_start |
date_start |
The start date for a reporting period or entity’s active period. |
dimension |
date_stop |
date_stop |
The end date for a reporting period or entity’s active period. |
dimension |
day |
day |
The specific day for which the ad data is reported. |
dimension |
dayofweek |
dayofweek |
The day of the week for which the ad data is reported. |
dimension |
dayparting |
dayparting |
The schedule for showing ads at specific times of day or days of the week. |
metric |
deep_bid_type |
deep_bid_type |
The bidding strategy or method used for deep conversion events within an ad group. |
dimension |
deep_cpa_bid |
deep_cpa_bid |
The Cost Per Action (CPA) bid specifically for deep conversion events. |
metric |
deeplink |
deeplink |
The deep link URL used for directly opening content within an app. |
dimension |
deeplink_format_type |
deeplink_format_type |
dimension |
|
deeplink_type |
deeplink_type |
The type of deep link used for the ad. |
dimension |
deeplink_utm_params |
deeplink_utm_params |
dimension |
|
delivery_mode |
delivery_mode |
The method or strategy for ad delivery, such as standard or accelerated. |
dimension |
description |
description |
A descriptive text for the campaign, ad group, or creative. |
dimension |
destination |
destination |
The specific destination URL or app used for the ad. |
dimension |
destination_type |
destination_type |
The type of destination (e.g., WEBSITE, APP). |
dimension |
device |
device |
The device type (e.g., mobile, tablet) targeted by the ad. |
dimension |
device_brand_id |
device_brand_id |
The identifier for the brand of the device on which the ad was displayed. |
dimension |
device_brand_name |
device_brand_name |
The name of the brand of the device on which the ad was displayed. |
dimension |
device_model_ids |
device_model_ids |
A list of device model IDs targeted by the ad. |
dimension |
device_price_ranges |
device_price_ranges |
The price ranges of devices targeted by the ad. |
dimension |
device_type |
device_type |
The type of device (e.g., mobile, tablet) on which the ad was displayed. |
dimension |
disclaimer_clickable_texts |
disclaimer_clickable_texts |
The clickable text elements within an ad disclaimer. |
dimension |
disclaimer_text |
disclaimer_text |
The disclaimer text displayed with the ad. |
dimension |
disclaimer_type |
disclaimer_type |
The type of disclaimer used for the ad. |
dimension |
display_name |
display_name |
The user-friendly name for a field or entity. |
dimension |
display_timezone |
display_timezone |
The timezone used for displaying data in reports. |
dimension |
dma_id |
dma_id |
The identifier for the Designated Market Area (DMA) where the ad was shown. |
dimension |
dma_name |
dma_name |
The name of the Designated Market Area (DMA) where the ad was shown. |
dimension |
download_button |
download_button |
The number of clicks on a download button in the ad. |
metric |
download_button_rate |
download_button_rate |
The rate at which users click on a download button in the ad. |
metric |
download_detail |
download_detail |
The number of times users viewed the download details for an app. |
metric |
download_detail_rate |
download_detail_rate |
The rate at which users viewed download details, typically as a percentage of clicks or impressions. |
metric |
download_start |
download_start |
The number of times a download initiated after ad interaction. |
metric |
download_start_rate |
download_start_rate |
The rate at which users started a download, typically as a percentage of clicks or impressions. |
metric |
dpa_target_audience_type |
dpa_target_audience_type |
The target audience type for Dynamic Product Ads (DPA). |
metric |
duet_clicks |
duet_clicks |
The number of clicks on the ‘Duet’ button associated with an ad. |
metric |
duration |
duration |
The duration of a video creative in seconds. |
dimension |
dy_like |
dy_like |
The number of likes received by dynamic creative ads. |
metric |
dy_share |
dy_share |
The number of shares received by dynamic creative ads. |
metric |
dynamic_destination |
dynamic_destination |
The dynamic destination URL used for ads, often in dynamic creative optimization. |
dimension |
dynamic_format |
dynamic_format |
The dynamic format used for ad creatives. |
dimension |
end_date |
end_date |
The end date for the reporting period or campaign duration, in YYYY-MM-DD format. |
dimension |
end_timestamp |
end_timestamp |
The end timestamp of the reporting period. |
dimension |
engaged_view |
engaged_view |
The number of engaged views on a video ad. |
metric |
engaged_view_15s |
engaged_view_15s |
The number of times a video has been played at least 15 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad. |
metric |
engaged_view_attribution_window |
engaged_view_attribution_window |
The attribution window for engaged views. |
dimension |
engaged_view_through_conversions |
engaged_view_through_conversions |
Conversions attributed to users who engaged with an ad (e.g., watched a significant portion of a video) but did not click on it. |
metric |
engagement_rate |
engagement_rate |
The percentage of engagements (likes, comments, shares, follows, clicks) an ad receives relative to its impressions. |
metric |
engagements |
engagements |
The total number of engagements with the ad (e.g., likes, comments, shares). |
metric |
engagements_cost |
engagements_cost |
metric |
|
engagements_total |
engagements_total |
The overall amount of engagement on an ad, including likes, comments, shares, follows, and clicks. |
metric |
event_name |
event_name |
The name of a tracked event, such as a conversion event. |
dimension |
event_source_id |
event_source_id |
The unique identifier of the event source (e.g., Pixel ID, App ID). |
dimension |
events |
events |
The number of specific actions or occurrences tracked in relation to the ad. |
metric |
excluded_audience_ids |
excluded_audience_ids |
A list of audience IDs that are excluded from targeting. |
dimension |
excluded_custom_actions |
excluded_custom_actions |
A list of custom actions that are excluded from optimization. |
dimension |
fallback_type |
fallback_type |
The fallback behavior type for ads, typically when a primary action fails. |
dimension |
feed_type |
feed_type |
The type of feed where the ad is displayed. |
dimension |
follows |
follows |
The number of new followers gained due to the ad. |
metric |
form |
form |
The number of form submission events. |
metric |
form_button |
form_button |
The number of times users clicked a form button, attributed to your ads. |
metric |
form_button_rate |
form_button_rate |
The rate at which users clicked a form button, attributed to your ads. |
metric |
form_detail |
form_detail |
The number of times users viewed details of a form. |
metric |
form_detail_rate |
form_detail_rate |
The rate at which users viewed form details, typically as a percentage of clicks or impressions. |
metric |
form_fills |
form_fills |
The number of times a form was successfully filled out by users. |
dimension |
form_rate |
form_rate |
The rate at which forms were submitted, typically as a percentage of clicks or impressions. |
metric |
format |
format |
The general format of the ad creative (e.g., image, video, carousel). |
dimension |
format_type |
format_type |
A more specific type of creative format. |
dimension |
frequency |
frequency |
The average number of times an ad was shown to a unique user. |
metric |
frequency_schedule |
frequency_schedule |
The schedule or cap set for how often an ad is shown to the same user. |
metric |
gender |
gender |
The gender of the targeted audience or users who engaged with the ad. |
dimension |
gross_impressions |
gross_impressions |
The total number of gross impressions for the ad. |
metric |
gross_revenue |
gross_revenue |
The total revenue generated before any deductions. |
metric |
household_income |
household_income |
The household income targeting segment. |
dimension |
identity_authorized_bc_id |
identity_authorized_bc_id |
The Business Center ID authorized to manage identity information. |
dimension |
identity_id |
identity_id |
The unique identifier for the identity (e.g., brand profile) associated with the ad. |
dimension |
identity_type |
identity_type |
The type of identity used for the ad (e.g., advertiser profile, Spark Ads). |
dimension |
image_id |
image_id |
The unique identifier for an image creative used in an ad. |
dimension |
image_ids |
image_ids |
A list of unique identifiers for images used in the creative. |
dimension |
impression_tracking_url |
impression_tracking_url |
A URL used to track ad impressions from a third-party measurement partner. |
dimension |
impressions |
impressions |
The total number of times an ad was shown. |
metric |
in_app_ad_click |
in_app_ad_click |
The number of clicks on an ad displayed within an application. |
metric |
in_app_ad_click_rate |
in_app_ad_click_rate |
The rate at which users clicked on an in-app ad, attributed to your ads. |
metric |
in_app_ad_impr |
in_app_ad_impr |
The number of impressions for an ad displayed within an application. |
metric |
in_app_ad_impr_rate |
in_app_ad_impr_rate |
The rate at which in-app ads were displayed (impressions), attributed to your ads. |
metric |
included_custom_actions |
included_custom_actions |
A list of custom actions that are included for optimization. |
dimension |
industry |
industry |
The industry category of the advertiser or business. |
dimension |
initiate_checkout |
initiate_checkout |
The number of times a user started the checkout process after interacting with an ad. |
metric |
initiate_checkout_rate |
initiate_checkout_rate |
The rate at which users initiated a checkout process, attributed to your ads. |
metric |
interactive_add_on_activity_clicks |
interactive_add_on_activity_clicks |
The number of clicks on interactive add-ons within the ad, such as polls, quizzes, or other engagement features. |
metric |
interactive_add_on_destination_clicks |
interactive_add_on_destination_clicks |
The number of clicks on destinations linked from interactive add-ons within the ad. |
metric |
interactive_add_on_impressions |
interactive_add_on_impressions |
The number of times interactive add-ons within the ad were shown. |
metric |
interactive_add_on_option_a_clicks |
interactive_add_on_option_a_clicks |
The number of clicks on option A of an interactive add-on in the ad. |
metric |
interactive_add_on_option_b_clicks |
interactive_add_on_option_b_clicks |
The number of clicks on option B of an interactive add-on in the ad. |
metric |
interest_category |
interest_category |
The broad category of user interests targeted by the ad group. |
metric |
interest_category_ids |
interest_category_ids |
A list of unique identifiers for interest categories used for audience targeting. |
dimension |
interest_category_name |
interest_category_name |
The name of the interest category targeted by the ad. |
dimension |
interest_category_tier2 |
interest_category_tier2 |
A second-tier category for audience interest targeting. |
metric |
interest_category_tier3 |
interest_category_tier3 |
The third-tier interest category for audience targeting. |
metric |
interest_category_tier4 |
interest_category_tier4 |
The fourth-tier interest category for audience targeting. |
metric |
interest_keyword_ids |
interest_keyword_ids |
A list of interest keyword IDs used for targeting. |
dimension |
inventory_filter_enabled |
inventory_filter_enabled |
Indicates whether inventory filtering is enabled to control where ads are shown. |
dimension |
ios14_quota_type |
ios14_quota_type |
The iOS 14 quota type for app campaigns. |
dimension |
ios14_targeting |
ios14_targeting |
Indicates if iOS 14 specific targeting is applied. |
dimension |
is_aco |
is_aco |
Indicates whether Automatic Creative Optimization (ACO) is enabled for the ad. |
metric |
is_advanced_dedicated_campaign |
is_advanced_dedicated_campaign |
Indicates whether this is an advanced dedicated campaign. |
dimension |
is_new_structure |
is_new_structure |
Indicates if the campaign or ad group uses a new structural setup. |
dimension |
is_search_campaign |
is_search_campaign |
Indicates whether the campaign is a search campaign. |
dimension |
is_smart_creative |
is_smart_creative |
Indicates whether the creative uses Smart Creative features for automated optimization. |
metric |
is_smart_performance_campaign |
is_smart_performance_campaign |
Indicates whether the campaign is a smart performance campaign. |
dimension |
isp_ids |
isp_ids |
A list of Internet Service Provider (ISP) IDs targeted by the ad. |
dimension |
item_duet_status |
item_duet_status |
The duet status of the item (e.g., video) used in the ad creative. |
dimension |
item_group_id |
item_group_id |
The identifier for a group of items within a product catalog. |
dimension |
item_group_ids |
item_group_ids |
A list of item group IDs associated with the ad creative. |
dimension |
item_id |
item_id |
The unique identifier for a specific item within a product catalog. |
dimension |
item_stitch_status |
item_stitch_status |
The stitch status of the item (e.g., video) used in the ad creative. |
dimension |
ix_average_video_play |
ix_average_video_play |
The average duration of video playback. |
metric |
ix_button_click_count |
ix_button_click_count |
The total number of clicks on buttons within an Instant Experience ad. |
metric |
ix_page_duration_avg |
ix_page_duration_avg |
The average time users spent viewing an Instant Experience page. |
metric |
ix_page_view_count |
ix_page_view_count |
The total number of page views within an Instant Experience ad. |
metric |
ix_page_view_count_rate |
ix_page_view_count_rate |
The rate at which Instant Experience pages were viewed, calculated as page views per impression or click. |
metric |
ix_page_viewrate_avg |
ix_page_viewrate_avg |
The average percentage of an Instant Experience that people viewed. |
metric |
ix_product_click_count |
ix_product_click_count |
The total number of clicks on products displayed within an Instant Experience ad. |
metric |
ix_video_views |
ix_video_views |
The number of video views within an Instant Experience ad. |
metric |
ix_video_views_p100 |
ix_video_views_p100 |
The number of interactive video views completed 100%. |
metric |
ix_video_views_p25 |
ix_video_views_p25 |
The number of interactive video views completed 25%. |
metric |
ix_video_views_p50 |
ix_video_views_p50 |
The number of interactive video views completed 50%. |
metric |
ix_video_views_p75 |
ix_video_views_p75 |
The number of interactive video views completed 75%. |
metric |
join_group |
join_group |
The number of times users joined a group or community after interacting with an ad. |
metric |
join_group_rate |
join_group_rate |
The rate at which users joined a group, typically as a percentage of clicks or impressions. |
metric |
landing_page_url |
landing_page_url |
The URL of the webpage users are directed to after clicking on an ad. |
dimension |
landing_page_view_rate |
landing_page_view_rate |
The percentage of users who viewed the landing page after interacting with an ad. |
metric |
language |
language |
The language setting for the ad creative or targeted audience. |
dimension |
languages |
languages |
A list of languages targeted by the ad campaign. |
dimension |
launch_app |
launch_app |
The number of times users launched the app, attributed to your ads. |
metric |
launch_app_rate |
launch_app_rate |
The rate at which users launched the app, attributed to your ads. |
metric |
likes |
likes |
The number of likes on an ad. |
metric |
live_duration |
live_duration |
The total duration of live streams associated with ads. |
dimension |
live_effective_views |
live_effective_views |
The number of times viewers visited your LIVE for more than 10 seconds. Revisits are counted. |
metric |
live_follows |
live_follows |
The number of new followers gained during live stream ads. |
metric |
live_launched_time |
live_launched_time |
The timestamp when a live stream associated with an ad was launched. |
dimension |
live_name |
live_name |
The name or title of the live stream associated with an ad. |
dimension |
live_product_clicks |
live_product_clicks |
The number of times viewers clicked a product and viewed its details page during a LIVE ad. |
metric |
live_status |
live_status |
The current status of a live stream associated with an ad (e.g., live, ended). |
dimension |
live_unique_views |
live_unique_views |
The number of unique viewers who entered your LIVE stream. |
metric |
live_views |
live_views |
The total number of times viewers visited your LIVE stream. Revisits are counted. |
metric |
loan_apply |
loan_apply |
The number of times users applied for a loan. |
metric |
loan_apply_rate |
loan_apply_rate |
The rate at which users applied for a loan, attributed to your ads. |
metric |
loan_credit |
loan_credit |
The number of times users received loan credit. |
metric |
loan_credit_rate |
loan_credit_rate |
The rate at which users received loan credit, typically as a percentage of clicks or impressions. |
metric |
loan_disbursement |
loan_disbursement |
The number of times a loan was disbursed. |
metric |
loan_disbursement_rate |
loan_disbursement_rate |
The rate at which loans were disbursed, typically as a percentage of clicks or impressions. |
metric |
location_ids |
location_ids |
A list of unique identifiers for geographical locations targeted by the ad. |
dimension |
location_target |
location_target |
The geographical locations or areas specified for ad targeting. |
dimension |
login |
login |
The number of times users logged into an application or service. |
metric |
login_rate |
login_rate |
The rate at which users logged in, attributed to your ads. |
metric |
market |
market |
dimension |
|
material_id |
material_id |
The unique identifier for an ad material or asset. |
dimension |
max_delivery_budget |
max_delivery_budget |
The maximum budget allowed for ad delivery. |
metric |
media_channel |
media_channel |
dimension |
|
media_platform_id |
media_platform_id |
dimension |
|
min_android_version |
min_android_version |
dimension |
|
min_ios_version |
min_ios_version |
The minimum iOS version required for app targeting. |
dimension |
mobile_app_id |
mobile_app_id |
The unique identifier of the mobile application. |
dimension |
modify_time |
modify_time |
The last modification timestamp of the ad entity. |
dimension |
music_id |
music_id |
The unique identifier of the music track used in the ad creative. |
dimension |
name |
name |
The name of the campaign, ad group, ad, or creative. |
dimension |
net_cost |
net_cost |
The total advertising cost after any deductions or adjustments. |
metric |
network_types |
network_types |
The network types where the ad can be displayed. |
dimension |
next_day_open |
next_day_open |
The number of times users opened an app the day after installation. |
metric |
next_day_open_rate |
next_day_open_rate |
The rate at which users opened an app the day after installation, typically as a percentage of new installs. |
metric |
next_day_retention |
next_day_retention |
The retention rate of users on the day after installation or engagement. |
dimension |
num_ads |
num_ads |
The number of ads associated with a particular campaign or ad group. |
metric |
objective |
objective |
The marketing objective selected for the campaign, such as Reach, Traffic, or Conversions. |
dimension |
objective_type |
objective_type |
The type of objective set for the campaign or ad group. |
metric |
offline_add_payment_info_event_rate |
offline_add_payment_info_event_rate |
The rate of offline ‘add payment info’ events. |
metric |
offline_add_payment_info_events |
offline_add_payment_info_events |
The number of offline add payment info events attributed to your ads. |
metric |
offline_add_payment_info_events_value |
offline_add_payment_info_events_value |
The total value of offline add payment info events attributed to your ads. |
metric |
offline_add_to_cart_event_rate |
offline_add_to_cart_event_rate |
The rate of offline add-to-cart events, indicating users adding items to their cart outside of online tracking, attributed to your ads. |
metric |
offline_add_to_cart_events |
offline_add_to_cart_events |
The number of offline add to cart events attributed to your ads. |
metric |
offline_add_to_cart_events_value |
offline_add_to_cart_events_value |
The total value of offline add to cart events attributed to your ads. |
metric |
offline_add_to_wishlist_event_rate |
offline_add_to_wishlist_event_rate |
The rate of offline ‘add to wishlist’ events. |
metric |
offline_add_to_wishlist_events |
offline_add_to_wishlist_events |
The number of offline add to wishlist events attributed to your ads. |
metric |
offline_add_to_wishlist_events_value |
offline_add_to_wishlist_events_value |
The total value of offline add to wishlist events attributed to your ads. |
metric |
offline_click_button_event_rate |
offline_click_button_event_rate |
The rate of offline button click events. |
metric |
offline_click_button_events |
offline_click_button_events |
The number of offline click button events attributed to your ads. |
metric |
offline_click_button_events_value |
offline_click_button_events_value |
The total value of offline click button events attributed to your ads. |
metric |
offline_complete_registration_event_rate |
offline_complete_registration_event_rate |
The rate of offline complete registration events. |
metric |
offline_complete_registration_events |
offline_complete_registration_events |
The number of offline complete registration events attributed to your ads. |
metric |
offline_complete_registration_events_value |
offline_complete_registration_events_value |
The total value of offline complete registration events attributed to your ads. |
metric |
offline_contact_event_rate |
offline_contact_event_rate |
The rate of offline contact events. |
metric |
offline_contact_events |
offline_contact_events |
The number of offline contact events attributed to your ads. |
metric |
offline_contact_events_value |
offline_contact_events_value |
The total value of offline contact events attributed to your ads. |
metric |
offline_download_event_rate |
offline_download_event_rate |
The rate of offline download events. |
metric |
offline_download_events |
offline_download_events |
The number of offline download events attributed to your ads. |
metric |
offline_download_events_value |
offline_download_events_value |
The total value of offline download events attributed to your ads. |
metric |
offline_form_event_rate |
offline_form_event_rate |
The rate of offline form submission events. |
metric |
offline_form_events |
offline_form_events |
The number of offline form submission events attributed to your ads. |
metric |
offline_form_events_value |
offline_form_events_value |
The total value of offline form submission events attributed to your ads. |
metric |
offline_initiate_checkout_event_rate |
offline_initiate_checkout_event_rate |
The rate of offline ‘initiate checkout’ events. |
metric |
offline_initiate_checkout_events |
offline_initiate_checkout_events |
The number of offline initiate checkout events attributed to your ads. |
metric |
offline_initiate_checkout_events_value |
offline_initiate_checkout_events_value |
The total value of offline initiate checkout events attributed to your ads. |
metric |
offline_place_order_event_rate |
offline_place_order_event_rate |
The rate of offline ‘place order’ events. |
metric |
offline_place_order_events |
offline_place_order_events |
The number of offline place order events attributed to your ads. |
metric |
offline_place_order_events_value |
offline_place_order_events_value |
The total value of offline place order events attributed to your ads. |
metric |
offline_search_event_rate |
offline_search_event_rate |
The rate of offline search events. |
metric |
offline_search_events |
offline_search_events |
The number of offline search events attributed to your ads. |
metric |
offline_search_events_value |
offline_search_events_value |
The total value of offline search events attributed to your ads. |
metric |
offline_shopping_event_rate |
offline_shopping_event_rate |
The rate of offline shopping events. |
metric |
offline_shopping_events |
offline_shopping_events |
The number of offline shopping events attributed to your ads. |
metric |
offline_shopping_events_roas |
offline_shopping_events_roas |
The Return On Ad Spend (ROAS) generated from offline shopping events. |
metric |
offline_shopping_events_value |
offline_shopping_events_value |
The total value of offline shopping events attributed to your ads. |
metric |
offline_subscribe_event_rate |
offline_subscribe_event_rate |
The rate of offline subscribe events. |
metric |
offline_subscribe_events |
offline_subscribe_events |
The number of offline subscribe events attributed to your ads. |
metric |
offline_subscribe_events_value |
offline_subscribe_events_value |
The total value of offline subscribe events attributed to your ads. |
metric |
offline_total_custom_event_value |
offline_total_custom_event_value |
The total value generated from all offline custom events. |
metric |
offline_view_content_event_rate |
offline_view_content_event_rate |
The rate of offline ‘view content’ events. |
metric |
offline_view_content_events |
offline_view_content_events |
The number of offline view content events attributed to your ads. |
metric |
offline_view_content_events_value |
offline_view_content_events_value |
The total value of offline view content events attributed to your ads. |
metric |
on_web_add_to_wishlist |
on_web_add_to_wishlist |
The number of ‘add to wishlist’ events that occurred on the website, attributed to ads. |
metric |
on_web_add_to_wishlist_per_click |
on_web_add_to_wishlist_per_click |
The number of ‘add to wishlist’ web events per click. |
metric |
on_web_order |
on_web_order |
The number of order completion events that occurred on the website, attributed to ads. |
metric |
on_web_order_rate |
on_web_order_rate |
The rate of orders placed on the website, attributed to your ads. |
metric |
on_web_subscribe |
on_web_subscribe |
The number of subscription events that occurred on the website, attributed to ads. |
metric |
on_web_subscribe_per_click |
on_web_subscribe_per_click |
The number of on-web subscribe events per click on your ads. |
metric |
online_consult |
online_consult |
The number of online consultation events. |
metric |
online_consult_rate |
online_consult_rate |
The rate at which online consultation events occurred, attributed to your ads. |
metric |
onsite_add_billing |
onsite_add_billing |
The number of onsite add billing events. |
metric |
onsite_add_to_wishlist |
onsite_add_to_wishlist |
The number of onsite add to wishlist events. |
metric |
onsite_destination_visit_rate |
onsite_destination_visit_rate |
The rate at which users visited the onsite destination after interacting with an ad. |
metric |
onsite_download_start |
onsite_download_start |
The number of times an onsite download was initiated. |
metric |
onsite_form |
onsite_form |
The number of onsite form submission events. |
metric |
onsite_form_rate |
onsite_form_rate |
The rate of onsite form submission events relative to impressions or clicks. |
metric |
onsite_initiate_checkout_count |
onsite_initiate_checkout_count |
The number of times users initiated a checkout process directly on the platform (onsite). |
metric |
onsite_initiate_checkout_count_rate |
onsite_initiate_checkout_count_rate |
The rate of onsite initiate checkout events relative to impressions or clicks. |
metric |
onsite_on_web_cart |
onsite_on_web_cart |
The number of onsite add to cart events. |
metric |
onsite_on_web_cart_rate |
onsite_on_web_cart_rate |
The rate of onsite add to cart events relative to impressions or clicks. |
metric |
onsite_on_web_detail |
onsite_on_web_detail |
The number of onsite product detail page views. |
metric |
onsite_on_web_detail_rate |
onsite_on_web_detail_rate |
The rate of onsite product detail page views relative to impressions or clicks. |
metric |
onsite_purchase_rate |
onsite_purchase_rate |
The rate of onsite purchase events. |
metric |
onsite_purchases_roas |
onsite_purchases_roas |
Return On Ad Spend (ROAS) specifically from onsite purchases. |
metric |
onsite_shopping |
onsite_shopping |
The number of user shopping behaviors that occur on your website or app. |
metric |
onsite_shopping_rate |
onsite_shopping_rate |
The rate of onsite shopping events. |
metric |
onsite_shopping_roas |
onsite_shopping_roas |
The Return On Ad Spend (ROAS) generated from shopping activities directly on the platform (onsite). |
metric |
onsite_total_add_to_cart |
onsite_total_add_to_cart |
The total number of ‘add to cart’ events on the advertiser’s website. |
metric |
onsite_total_purchase |
onsite_total_purchase |
The total number of purchases completed on the advertiser’s website. |
metric |
onsite_total_purchase_value |
onsite_total_purchase_value |
The total monetary value generated from purchases on the advertiser’s website. |
metric |
onsite_value_per_purchase |
onsite_value_per_purchase |
The average value generated per purchase on the advertiser’s website. |
metric |
operating_systems |
operating_systems |
A list of operating systems (e.g., iOS, Android) targeted by the ad. |
dimension |
operation_status |
operation_status |
The operational status of the entity (e.g., campaign, ad group, ad), such as active, paused, or deleted. |
dimension |
opt_status |
opt_status |
The operation status of the ad group, campaign or ad, indicating whether it is active, paused, or deleted. |
metric |
optimization_event |
optimization_event |
The primary event selected for campaign optimization, aiming to maximize its occurrences. |
dimension |
optimization_goal |
optimization_goal |
The primary goal for ad optimization, influencing bidding and delivery to achieve desired outcomes. |
dimension |
orders |
orders |
The total number of orders placed. |
metric |
owner_bc_id |
owner_bc_id |
The ID of the Business Center that owns the ad account or related entities. |
dimension |
pacing |
pacing |
The strategy for distributing the ad budget over time, such as standard or accelerated delivery. |
dimension |
page_browse_consultation |
page_browse_consultation |
The number of page browse events leading to a consultation, attributed to your ads. |
metric |
page_browse_consultation_rate |
page_browse_consultation_rate |
The rate of page browse events leading to a consultation, attributed to your ads. |
metric |
page_browse_view |
page_browse_view |
The number of page browse events. |
metric |
page_browse_view_rate |
page_browse_view_rate |
The rate of page browse view events, attributed to your ads. |
metric |
page_content_view_events |
page_content_view_events |
The number of page content view events triggered by ad interactions. |
metric |
page_event_search |
page_event_search |
The number of search events that occurred on a webpage, attributed to ads. |
metric |
page_event_search_rate |
page_event_search_rate |
The rate at which users perform a search action on a landing page. |
metric |
page_id |
page_id |
The unique identifier for a business page or profile associated with the ad. |
dimension |
pageview_rate |
pageview_rate |
The rate at which pages were viewed, often expressed as a percentage of impressions. |
metric |
paid_engaged_view |
paid_engaged_view |
The number of times a video ad was played for at least 6 seconds or received at least 1 engagement within one day of a user seeing the ad. |
metric |
paid_engaged_view_15s |
paid_engaged_view_15s |
The number of times a video ad was played for at least 15 seconds or received at least 1 engagement within one day of a user seeing the ad. |
metric |
paid_engagement_engaged_view |
paid_engagement_engaged_view |
The number of engaged views attributed to paid advertising efforts. |
metric |
paid_engagement_engaged_view_15s |
paid_engagement_engaged_view_15s |
The number of 15-second engaged views attributed to paid advertising efforts. |
metric |
pixel_id |
pixel_id |
The unique identifier for the TikTok pixel used to track website events. |
dimension |
placement |
placement |
The specific location or platform where the ad is displayed. |
dimension |
placement_id |
placement_id |
The unique identifier for a specific ad placement. |
dimension |
placement_name |
placement_name |
The name of the ad placement (e.g., TikTok Feed, News Feed App). |
dimension |
placement_type |
placement_type |
The type of placement where the ad is displayed. |
metric |
placements |
placements |
The specific locations or ad networks where the ad is displayed. |
dimension |
platform |
platform |
The operating system or environment where the ad was displayed (e.g., iOS, Android). |
dimension |
platform_buytype |
platform_buytype |
dimension |
|
platform_id |
platform_id |
The unique identifier of the advertising platform. |
dimension |
platform_name |
platform_name |
The name of the advertising platform or channel. |
dimension |
platform_objective |
platform_objective |
dimension |
|
platform_objectivetype |
platform_objectivetype |
dimension |
|
playable_url |
playable_url |
The URL for playable material, specifically supported by interactive Playable Ad types. |
dimension |
postback_window_mode |
postback_window_mode |
dimension |
|
posts |
posts |
metric |
|
product |
product |
dimension |
|
product_click_rate |
product_click_rate |
The rate at which users click on products shown in ads. |
metric |
product_clicks |
product_clicks |
The total number of clicks on products shown in ads. |
metric |
product_details_page_browse |
product_details_page_browse |
The number of times viewers clicked a product and viewed its details page. |
metric |
product_details_page_browse_rate |
product_details_page_browse_rate |
The rate of product details page browse events, attributed to your ads. |
metric |
product_id |
product_id |
The unique identifier of a product advertised. |
dimension |
product_image_url |
product_image_url |
The URL for an image of the product featured in the ad. |
dimension |
product_impressions |
product_impressions |
The total number of times products were displayed in ads. |
metric |
product_name |
product_name |
The name of the product being advertised. |
dimension |
product_set_id |
product_set_id |
The unique identifier for the product set used in dynamic showcase ads. |
dimension |
product_source |
product_source |
The source of the product data, such as a product catalog or store. |
dimension |
product_specific_type |
product_specific_type |
The specific type of product being promoted. |
dimension |
product_status |
product_status |
The current status of the product in the catalog (e.g., active, out of stock). |
dimension |
profile_image |
profile_image |
The URL or ID of the profile image associated with the ad or advertiser. |
metric |
profile_image_url |
profile_image_url |
The URL of the advertiser’s profile image or avatar. |
dimension |
profile_visits |
profile_visits |
The number of profile visits attributed to the ad. |
metric |
profile_visits_rate |
profile_visits_rate |
The rate of profile visits per impression driven by a paid ad, applicable only to Spark Ads. |
metric |
promotion_target_type |
promotion_target_type |
The target type of the promotion (e.g., website, app). |
dimension |
promotion_type |
promotion_type |
The type of promotion used in a campaign, such as for GMV Max campaigns. |
metric |
promotion_website_type |
promotion_website_type |
The type of website used for promotion. |
dimension |
promotional_music_disabled |
promotional_music_disabled |
Indicates whether promotional music is disabled for the ad. |
dimension |
province_id |
province_id |
dimension |
|
province_name |
province_name |
dimension |
|
purchase |
purchase |
The number of purchase events attributed to the ad. |
metric |
purchase_intention_keyword_ids |
purchase_intention_keyword_ids |
A list of keyword IDs related to purchase intention used for targeting. |
dimension |
purchase_rate |
purchase_rate |
The rate at which users make a purchase after interacting with an ad. |
metric |
purchased_impression |
purchased_impression |
The number of ad impressions that were purchased. |
dimension |
purchased_reach |
purchased_reach |
The number of unique users reached through purchased ad placements. |
dimension |
purchases |
purchases |
The number of purchase actions attributed to the ads. |
dimension |
ratings |
ratings |
The number of times users submitted ratings. |
metric |
ratings_rate |
ratings_rate |
The rate at which users provide ratings or reviews. |
metric |
reach |
reach |
The number of unique users who saw the ad. |
metric |
real_time_app_install |
real_time_app_install |
The number of app installs reported in near real-time. |
metric |
real_time_app_install_cost |
real_time_app_install_cost |
The real-time cost associated with app installations, attributed to your ads. |
metric |
real_time_conversion |
real_time_conversion |
The number of times your ad achieved an outcome, based on the objective and settings you selected, with count based on when the conversion actually happened. |
metric |
real_time_conversion_rate |
real_time_conversion_rate |
The percentage of real-time conversions received out of all clicks on your ads, calculated based on when the conversion actually happened. |
metric |
real_time_cost_per_conversion |
real_time_cost_per_conversion |
The average amount of money spent on a real-time conversion (Real-time CPA), calculated based on when the conversion actually happened. |
metric |
real_time_cost_per_result |
real_time_cost_per_result |
The average cost for each real-time result from your ads, calculated based on when the conversion actually happened. |
metric |
real_time_result |
real_time_result |
The number of times your ad achieved an outcome based on the optimization goal selected, with count based on when the conversion actually happened. |
metric |
real_time_result_rate |
real_time_result_rate |
The percentage of real-time results achieved out of all views/clicks on your ads, calculated based on when the conversion actually happened. |
metric |
recency |
recency |
dimension |
|
region |
region |
The geographical region targeted by the ad or where the ad data originates. |
dimension |
registration |
registration |
The number of registration events attributed to the ad. |
metric |
registration_rate |
registration_rate |
The rate at which users complete a registration after interacting with an ad. |
metric |
rejection_reason |
rejection_reason |
The reason why an ad or creative was rejected during the review process. |
dimension |
related_adgroup_ids |
related_adgroup_ids |
A list of identifiers for ad groups that are related to the current entity, for instance, in a split test. |
dimension |
report_id |
report_id |
The unique identifier for a specific report. |
dimension |
result |
result |
The number of times your ad achieved an outcome, based on the optimization goal you selected. |
metric |
result_rate |
result_rate |
The rate at which the campaign achieves its specified result. |
metric |
revenue_events |
revenue_events |
metric |
|
rf_campaign_type |
rf_campaign_type |
The campaign type for Reach and Frequency buying. |
metric |
rf_estimated_cpr |
rf_estimated_cpr |
The estimated Cost Per Result (CPR) for Reach & Frequency campaigns. |
metric |
rf_estimated_frequency |
rf_estimated_frequency |
The estimated average number of times a person will see an ad in a Reach & Frequency campaign. |
metric |
rf_purchased_type |
rf_purchased_type |
The purchased type for Reach and Frequency campaigns. |
dimension |
roas_bid |
roas_bid |
The target Return On Ad Spend (ROAS) bid. |
dimension |
roi |
roi |
The Return On Investment (ROI) from advertising efforts. |
metric |
rta_id |
rta_id |
dimension |
|
rta_product_selection_enabled |
rta_product_selection_enabled |
dimension |
|
sales_lead |
sales_lead |
The number of sales leads generated by the ad campaign. |
metric |
sales_lead_rate |
sales_lead_rate |
The rate at which ads generate sales leads. |
metric |
saved_audience_id |
saved_audience_id |
The unique identifier for a saved audience segment. |
dimension |
schedule_end_time |
schedule_end_time |
The scheduled end date and time for an ad entity (e.g., campaign, ad group). |
dimension |
schedule_infos |
schedule_infos |
Detailed scheduling information for the ad or campaign. |
dimension |
schedule_start_time |
schedule_start_time |
The scheduled start date and time for an ad entity (e.g., campaign, ad group). |
dimension |
schedule_type |
schedule_type |
The type of scheduling applied to an ad entity, such as continuous or specific dates. |
dimension |
scheduled_budget |
scheduled_budget |
The budget allocated for a specific schedule period. |
metric |
search |
search |
The number of search events that are attributed to your ads. |
metric |
search_rate |
search_rate |
The rate at which users perform a search action. |
metric |
search_result_enabled |
search_result_enabled |
Indicates whether the ad is enabled to appear in search results. |
dimension |
search_terms |
search_terms |
The search terms that triggered the ad. |
metric |
secondary_goal_result |
secondary_goal_result |
The number of times your ad achieved an outcome based on the secondary goal selected. |
dimension |
secondary_goal_result_rate |
secondary_goal_result_rate |
The rate at which secondary goal results were achieved, attributed to your ads. |
dimension |
secondary_optimization_event |
secondary_optimization_event |
A secondary event selected for campaign optimization, in addition to the primary optimization event. |
dimension |
secondary_status |
secondary_status |
A secondary status providing more specific information about the state of an ad object. |
dimension |
share_disabled |
share_disabled |
Indicates whether sharing is disabled for the ad creative. |
dimension |
shares |
shares |
The number of times an ad was shared. |
metric |
shop_gross_revenue_by_order_submission |
shop_gross_revenue_by_order_submission |
The gross revenue generated from shop orders submitted through ads. |
dimension |
shopping_ads_deeplink_type |
shopping_ads_deeplink_type |
The deeplink type used for Shopping Ads. |
dimension |
shopping_ads_fallback_type |
shopping_ads_fallback_type |
The fallback type for Shopping Ads when a deeplink fails. |
dimension |
shopping_ads_retargeting_type |
shopping_ads_retargeting_type |
The retargeting type used for Shopping Ads. |
dimension |
shopping_ads_type |
shopping_ads_type |
The type of Shopping Ad. |
dimension |
shopping_ads_video_package_id |
shopping_ads_video_package_id |
The unique identifier for the video package used in Shopping Ads. |
dimension |
show_cnt |
show_cnt |
The total number of impressions (times the ad was shown). |
metric |
showcase_products |
showcase_products |
dimension |
|
skan_achieve_level |
skan_achieve_level |
The number of times the “achieve level” event occurred, as reported via SKAdNetwork. |
metric |
skan_achieve_level_rate |
skan_achieve_level_rate |
The rate at which the “achieve level” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_payment_info |
skan_add_payment_info |
The number of times the “add payment info” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_payment_info_rate |
skan_add_payment_info_rate |
The rate at which the “add payment info” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_to_cart |
skan_add_to_cart |
The number of ‘add to cart’ events reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_add_to_cart_rate |
skan_add_to_cart_rate |
The rate at which the “add to cart” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_to_wishlist |
skan_add_to_wishlist |
The number of times the “add to wishlist” event occurred, as reported via SKAdNetwork. |
metric |
skan_add_to_wishlist_rate |
skan_add_to_wishlist_rate |
The rate at which the “add to wishlist” event occurred, as reported via SKAdNetwork. |
metric |
skan_app_install |
skan_app_install |
The number of app installs reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_app_install_withheld |
skan_app_install_withheld |
Indicates whether the app install information was withheld by SKAdNetwork for privacy reasons. |
metric |
skan_checkout |
skan_checkout |
The number of ‘checkout’ events reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_checkout_rate |
skan_checkout_rate |
The rate at which the “checkout” event occurred, as reported via SKAdNetwork. |
metric |
skan_click_time_cost_per_conversion |
skan_click_time_cost_per_conversion |
The cost per conversion attributed based on click time, specifically for SKAdNetwork (SKAN) campaigns. |
metric |
skan_complete_tutorial |
skan_complete_tutorial |
The number of times the “complete tutorial” event occurred, as reported via SKAdNetwork. |
metric |
skan_complete_tutorial_rate |
skan_complete_tutorial_rate |
The rate at which the “complete tutorial” event occurred, as reported via SKAdNetwork. |
metric |
skan_conversion |
skan_conversion |
The total number of conversion events reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_conversion_rate |
skan_conversion_rate |
The rate of conversions, as reported via SKAdNetwork. |
metric |
skan_cost_per_achieve_level |
skan_cost_per_achieve_level |
The average cost incurred for each “achieve level” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_add_payment_info |
skan_cost_per_add_payment_info |
The average cost incurred for each “add payment info” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_add_to_cart |
skan_cost_per_add_to_cart |
The average cost incurred for each “add to cart” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_add_to_wishlist |
skan_cost_per_add_to_wishlist |
The average cost incurred for each “add to wishlist” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_app_install |
skan_cost_per_app_install |
The average cost incurred for each app installation, as reported via SKAdNetwork. |
metric |
skan_cost_per_checkout |
skan_cost_per_checkout |
The average cost incurred for each “checkout” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_complete_tutorial |
skan_cost_per_complete_tutorial |
The average cost incurred for each “complete tutorial” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_conversion |
skan_cost_per_conversion |
The average cost incurred for each conversion, as reported via SKAdNetwork. |
metric |
skan_cost_per_create_gamerole |
skan_cost_per_create_gamerole |
The SKAdNetwork-attributed cost for each instance of a user creating a game role. |
metric |
skan_cost_per_create_group |
skan_cost_per_create_group |
The SKAdNetwork-attributed cost for each instance of a user creating a group. |
metric |
skan_cost_per_in_app_ad_click |
skan_cost_per_in_app_ad_click |
The average cost incurred for each in-app ad click, as reported via SKAdNetwork. |
metric |
skan_cost_per_in_app_ad_impr |
skan_cost_per_in_app_ad_impr |
The average cost incurred for each in-app ad impression, as reported via SKAdNetwork. |
metric |
skan_cost_per_join_group |
skan_cost_per_join_group |
The SKAdNetwork-attributed cost for each instance of a user joining a group. |
metric |
skan_cost_per_launch_app |
skan_cost_per_launch_app |
The average cost incurred for each app launch event, as reported via SKAdNetwork. |
metric |
skan_cost_per_loan_apply |
skan_cost_per_loan_apply |
The average cost incurred for each loan application event, as reported via SKAdNetwork. |
metric |
skan_cost_per_loan_credit |
skan_cost_per_loan_credit |
The SKAdNetwork-attributed cost for each instance of a user receiving loan credit. |
metric |
skan_cost_per_loan_disbursement |
skan_cost_per_loan_disbursement |
The SKAdNetwork-attributed cost for each loan disbursement. |
metric |
skan_cost_per_login |
skan_cost_per_login |
The average cost incurred for each login event, as reported via SKAdNetwork. |
metric |
skan_cost_per_purchase |
skan_cost_per_purchase |
The average cost incurred for each purchase event, as reported via SKAdNetwork. |
metric |
skan_cost_per_ratings |
skan_cost_per_ratings |
The average cost incurred for each rating event, as reported via SKAdNetwork. |
metric |
skan_cost_per_registration |
skan_cost_per_registration |
The average cost incurred for each registration event, as reported via SKAdNetwork. |
metric |
skan_cost_per_result |
skan_cost_per_result |
The average cost incurred per result (conversion) as reported via SKAdNetwork. |
metric |
skan_cost_per_sales_lead |
skan_cost_per_sales_lead |
The average cost incurred for each sales lead, as reported via SKAdNetwork. |
metric |
skan_cost_per_search |
skan_cost_per_search |
The average cost incurred for each search event, as reported via SKAdNetwork. |
metric |
skan_cost_per_spend_credits |
skan_cost_per_spend_credits |
The average cost incurred for each “spend credits” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_start_trial |
skan_cost_per_start_trial |
The average cost incurred for each “start trial” event, as reported via SKAdNetwork. |
metric |
skan_cost_per_subscribe |
skan_cost_per_subscribe |
The average cost incurred for each subscription event, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_achieve_level |
skan_cost_per_total_achieve_level |
The average cost incurred for all “achieve level” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_add_to_cart |
skan_cost_per_total_add_to_cart |
The average cost incurred for all “add to cart” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_add_to_wishlist |
skan_cost_per_total_add_to_wishlist |
The average cost incurred for all “add to wishlist” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_checkout |
skan_cost_per_total_checkout |
The average cost incurred for all “checkout” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_complete_tutorial |
skan_cost_per_total_complete_tutorial |
The average cost incurred for all “complete tutorial” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_create_gamerole |
skan_cost_per_total_create_gamerole |
The total SKAdNetwork-attributed cost for all instances of users creating game roles. |
metric |
skan_cost_per_total_create_group |
skan_cost_per_total_create_group |
The total SKAdNetwork-attributed cost for all instances of users creating groups. |
metric |
skan_cost_per_total_in_app_ad_click |
skan_cost_per_total_in_app_ad_click |
The average cost incurred for all in-app ad clicks, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_in_app_ad_impr |
skan_cost_per_total_in_app_ad_impr |
The average cost incurred for all in-app ad impressions, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_join_group |
skan_cost_per_total_join_group |
The total SKAdNetwork-attributed cost for all instances of users joining groups. |
metric |
skan_cost_per_total_launch_app |
skan_cost_per_total_launch_app |
The average cost incurred for all app launch events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_loan_apply |
skan_cost_per_total_loan_apply |
The average cost incurred for all loan application events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_loan_credit |
skan_cost_per_total_loan_credit |
The total SKAdNetwork-attributed cost for all instances of users receiving loan credits. |
metric |
skan_cost_per_total_loan_disbursement |
skan_cost_per_total_loan_disbursement |
The total SKAdNetwork-attributed cost for all loan disbursements. |
metric |
skan_cost_per_total_login |
skan_cost_per_total_login |
The average cost incurred for all login events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_purchase |
skan_cost_per_total_purchase |
The average cost incurred for all purchase events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_ratings |
skan_cost_per_total_ratings |
The average cost incurred for all rating events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_registration |
skan_cost_per_total_registration |
The average cost incurred for all registration events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_sales_lead |
skan_cost_per_total_sales_lead |
The average cost incurred for all sales lead events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_search |
skan_cost_per_total_search |
The average cost incurred for all search events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_spend_credits |
skan_cost_per_total_spend_credits |
The cost per spend credit, measured through SKAdNetwork (SKAN). |
metric |
skan_cost_per_total_start_trial |
skan_cost_per_total_start_trial |
The average cost incurred for all “start trial” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_subscribe |
skan_cost_per_total_subscribe |
The average cost incurred for all subscription events, as reported via SKAdNetwork. |
metric |
skan_cost_per_total_unlock_achievement |
skan_cost_per_total_unlock_achievement |
The total SKAdNetwork-attributed cost for all achievements unlocked by users. |
metric |
skan_cost_per_total_view_content |
skan_cost_per_total_view_content |
The average cost incurred for all “view content” events, as reported via SKAdNetwork. |
metric |
skan_cost_per_unlock_achievement |
skan_cost_per_unlock_achievement |
The SKAdNetwork-attributed cost for each achievement unlocked by a user. |
metric |
skan_cost_per_view_content |
skan_cost_per_view_content |
The average cost incurred for each “view content” event, as reported via SKAdNetwork. |
metric |
skan_cost_total_add_payment_info |
skan_cost_total_add_payment_info |
The total cost incurred for all “add payment info” events, as reported via SKAdNetwork. |
metric |
skan_create_gamerole |
skan_create_gamerole |
The number of SKAdNetwork-attributed instances where users created a game role. |
metric |
skan_create_gamerole_rate |
skan_create_gamerole_rate |
The SKAdNetwork-attributed rate at which users created a game role. |
metric |
skan_create_group |
skan_create_group |
The number of SKAdNetwork-attributed instances where users created a group. |
metric |
skan_create_group_rate |
skan_create_group_rate |
The SKAdNetwork-attributed rate at which users created a group. |
metric |
skan_in_app_ad_click |
skan_in_app_ad_click |
The number of in-app ad clicks, as reported via SKAdNetwork. |
metric |
skan_in_app_ad_click_rate |
skan_in_app_ad_click_rate |
The rate of in-app ad clicks, as reported via SKAdNetwork. |
metric |
skan_in_app_ad_impr |
skan_in_app_ad_impr |
The number of in-app ad impressions, as reported via SKAdNetwork. |
metric |
skan_in_app_ad_impr_rate |
skan_in_app_ad_impr_rate |
The rate of in-app ad impressions, as reported via SKAdNetwork. |
metric |
skan_join_group |
skan_join_group |
The number of SKAdNetwork-attributed instances where users joined a group. |
metric |
skan_join_group_rate |
skan_join_group_rate |
The SKAdNetwork-attributed rate at which users joined a group. |
metric |
skan_launch_app |
skan_launch_app |
The number of app launches, as reported via SKAdNetwork. |
metric |
skan_launch_app_rate |
skan_launch_app_rate |
The rate of app launches, as reported via SKAdNetwork. |
metric |
skan_loan_apply |
skan_loan_apply |
The number of loan application events, as reported via SKAdNetwork. |
metric |
skan_loan_apply_rate |
skan_loan_apply_rate |
The rate of loan application events, as reported via SKAdNetwork. |
metric |
skan_loan_credit |
skan_loan_credit |
The number of SKAdNetwork-attributed instances where users received loan credit. |
metric |
skan_loan_credit_rate |
skan_loan_credit_rate |
The SKAdNetwork-attributed rate at which users received loan credit. |
metric |
skan_loan_disbursement |
skan_loan_disbursement |
The number of SKAdNetwork-attributed loan disbursements. |
metric |
skan_loan_disbursement_rate |
skan_loan_disbursement_rate |
The SKAdNetwork-attributed rate at which loans were disbursed. |
metric |
skan_login |
skan_login |
The number of login events, as reported via SKAdNetwork. |
metric |
skan_login_rate |
skan_login_rate |
The rate of login events, as reported via SKAdNetwork. |
metric |
skan_purchase |
skan_purchase |
The number of purchase events, as reported via SKAdNetwork. |
metric |
skan_purchase_rate |
skan_purchase_rate |
The rate of purchase events, as reported via SKAdNetwork. |
metric |
skan_ratings |
skan_ratings |
The number of rating events, as reported via SKAdNetwork. |
metric |
skan_ratings_rate |
skan_ratings_rate |
The rate of rating events, as reported via SKAdNetwork. |
metric |
skan_registration |
skan_registration |
The number of user registration events, as reported via SKAdNetwork. |
metric |
skan_registration_rate |
skan_registration_rate |
The rate of user registration events, as reported via SKAdNetwork. |
metric |
skan_result |
skan_result |
The final conversion value or result reported via SKAdNetwork (SKAN) for iOS app campaigns. |
metric |
skan_result_rate |
skan_result_rate |
The rate of results (conversions), as reported via SKAdNetwork. |
metric |
skan_sales_lead |
skan_sales_lead |
The number of sales lead events, as reported via SKAdNetwork. |
metric |
skan_sales_lead_rate |
skan_sales_lead_rate |
The rate of sales lead events, as reported via SKAdNetwork. |
metric |
skan_search |
skan_search |
The number of search events, as reported via SKAdNetwork. |
metric |
skan_search_rate |
skan_search_rate |
The rate of search events, as reported via SKAdNetwork. |
metric |
skan_spend_credits |
skan_spend_credits |
The number of “spend credits” events, as reported via SKAdNetwork. |
metric |
skan_spend_credits_rate |
skan_spend_credits_rate |
The rate of “spend credits” events, as reported via SKAdNetwork. |
metric |
skan_start_trial |
skan_start_trial |
The number of “start trial” events, as reported via SKAdNetwork. |
metric |
skan_start_trial_rate |
skan_start_trial_rate |
The rate of “start trial” events, as reported via SKAdNetwork. |
metric |
skan_subscribe |
skan_subscribe |
The number of subscription events, as reported via SKAdNetwork. |
metric |
skan_subscribe_rate |
skan_subscribe_rate |
The rate of subscription events, as reported via SKAdNetwork. |
metric |
skan_total_achieve_level |
skan_total_achieve_level |
The total count of “achieve level” events, as reported via SKAdNetwork. |
metric |
skan_total_achieve_level_value |
skan_total_achieve_level_value |
The total value of SKAdNetwork-attributed instances where users achieved a certain level. |
metric |
skan_total_add_payment_info |
skan_total_add_payment_info |
The total count of “add payment info” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_cart |
skan_total_add_to_cart |
The total count of “add to cart” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_cart_value |
skan_total_add_to_cart_value |
The total value associated with “add to cart” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_wishlist |
skan_total_add_to_wishlist |
The total count of “add to wishlist” events, as reported via SKAdNetwork. |
metric |
skan_total_add_to_wishlist_value |
skan_total_add_to_wishlist_value |
The total value associated with “add to wishlist” events, as reported via SKAdNetwork. |
metric |
skan_total_checkout |
skan_total_checkout |
The total count of “checkout” events, as reported via SKAdNetwork. |
metric |
skan_total_checkout_value |
skan_total_checkout_value |
The total value associated with “checkout” events, as reported via SKAdNetwork. |
metric |
skan_total_complete_tutorial |
skan_total_complete_tutorial |
The total count of “complete tutorial” events, as reported via SKAdNetwork. |
metric |
skan_total_complete_tutorial_value |
skan_total_complete_tutorial_value |
The total value of SKAdNetwork-attributed instances where users completed a tutorial. |
metric |
skan_total_create_gamerole |
skan_total_create_gamerole |
The total number of SKAdNetwork-attributed instances where users created a game role. |
metric |
skan_total_create_gamerole_value |
skan_total_create_gamerole_value |
The total value of SKAdNetwork-attributed instances where users created a game role. |
metric |
skan_total_create_group |
skan_total_create_group |
The total number of SKAdNetwork-attributed instances where users created a group. |
metric |
skan_total_create_group_value |
skan_total_create_group_value |
The total value generated from users creating a group, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_click |
skan_total_in_app_ad_click |
The total number of in-app ad clicks, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_click_value |
skan_total_in_app_ad_click_value |
The total value generated from in-app ad clicks, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_impr |
skan_total_in_app_ad_impr |
The total number of in-app ad impressions, attributed via SKAdNetwork. |
metric |
skan_total_in_app_ad_impr_value |
skan_total_in_app_ad_impr_value |
The total value generated from in-app ad impressions, attributed via SKAdNetwork. |
metric |
skan_total_join_group |
skan_total_join_group |
The total number of times users joined a group, attributed via SKAdNetwork. |
metric |
skan_total_join_group_value |
skan_total_join_group_value |
The total value generated from users joining a group, attributed via SKAdNetwork. |
metric |
skan_total_launch_app |
skan_total_launch_app |
The total number of app launches, attributed via SKAdNetwork. |
metric |
skan_total_loan_apply |
skan_total_loan_apply |
The total number of loan applications, attributed via SKAdNetwork. |
metric |
skan_total_loan_credit |
skan_total_loan_credit |
The total number of loan credits, attributed via SKAdNetwork. |
metric |
skan_total_loan_disbursement |
skan_total_loan_disbursement |
The total number of loan disbursements, attributed via SKAdNetwork. |
metric |
skan_total_login |
skan_total_login |
The total number of user logins, attributed via SKAdNetwork. |
metric |
skan_total_purchase |
skan_total_purchase |
The total number of purchases, attributed via SKAdNetwork. |
metric |
skan_total_purchase_value |
skan_total_purchase_value |
The total value generated from purchases, attributed via SKAdNetwork. |
metric |
skan_total_ratings |
skan_total_ratings |
The total number of user ratings, attributed via SKAdNetwork. |
metric |
skan_total_ratings_value |
skan_total_ratings_value |
The total value generated from user ratings, attributed via SKAdNetwork. |
metric |
skan_total_registration |
skan_total_registration |
The total number of user registrations, attributed via SKAdNetwork. |
metric |
skan_total_repetitive_active_pay_roas |
skan_total_repetitive_active_pay_roas |
Return on Ad Spend (ROAS) from repetitive active pay events, specifically for SKAdNetwork (SKAN) attributed campaigns. |
metric |
skan_total_sales_lead |
skan_total_sales_lead |
The total number of sales leads, attributed via SKAdNetwork. |
metric |
skan_total_sales_lead_value |
skan_total_sales_lead_value |
The total value generated from sales leads, attributed via SKAdNetwork. |
metric |
skan_total_search |
skan_total_search |
The total count of search events based on when the events are returned through the SKAdNetwork API. |
metric |
skan_total_spend_credits |
skan_total_spend_credits |
The total number of times users spent credits, attributed via SKAdNetwork. |
metric |
skan_total_spend_credits_value |
skan_total_spend_credits_value |
The total value generated from spending credits, attributed via SKAdNetwork. |
metric |
skan_total_start_trial |
skan_total_start_trial |
The total number of trial starts, attributed via SKAdNetwork. |
metric |
skan_total_subscribe |
skan_total_subscribe |
The total number of subscriptions, attributed via SKAdNetwork. |
metric |
skan_total_subscribe_value |
skan_total_subscribe_value |
The total value generated from subscriptions, attributed via SKAdNetwork. |
metric |
skan_total_unlock_achievement |
skan_total_unlock_achievement |
The total number of times users unlocked an achievement, attributed via SKAdNetwork. |
metric |
skan_total_unlock_achievement_value |
skan_total_unlock_achievement_value |
The total value generated from unlocking achievements, attributed via SKAdNetwork. |
metric |
skan_total_view_content |
skan_total_view_content |
The total number of content views, attributed via SKAdNetwork. |
metric |
skan_total_view_content_value |
skan_total_view_content_value |
The total value generated from content views, attributed via SKAdNetwork. |
metric |
skan_unlock_achievement |
skan_unlock_achievement |
The number of times an achievement was unlocked, attributed via SKAdNetwork. |
metric |
skan_unlock_achievement_rate |
skan_unlock_achievement_rate |
The rate at which achievements were unlocked, attributed via SKAdNetwork. |
metric |
skan_view_content |
skan_view_content |
The number of content views, attributed via SKAdNetwork. |
metric |
skan_view_content_rate |
skan_view_content_rate |
The rate at which content was viewed, attributed via SKAdNetwork. |
metric |
skip_learning_phase |
skip_learning_phase |
Indicates whether the learning phase for the campaign or ad group is skipped. |
dimension |
sku_ids |
sku_ids |
IDs of the Stock Keeping Units (SKUs) associated with products in an ad. |
dimension |
smart_audience_enabled |
smart_audience_enabled |
Indicates whether smart audience features are enabled. |
dimension |
smart_interest_behavior_enabled |
smart_interest_behavior_enabled |
Indicates whether smart interest and behavior targeting is enabled. |
dimension |
smart_target |
smart_target |
Indicates if Smart Targeting is enabled for the campaign or ad group. |
metric |
social_network |
social_network |
The social network platform where the ad is running. |
dimension |
sound_usage_clicks |
sound_usage_clicks |
The number of clicks on the ‘Use this sound’ button within TikTok. |
metric |
source |
source |
The advertising platform or origin where the ad was run. |
dimension |
special_industries |
special_industries |
A list of special industries associated with the advertiser. |
dimension |
spend |
spend |
The total amount of money spent on the ad or campaign. |
metric |
spend_EUR |
spend_EUR |
The total amount of money spent on advertising, reported in Euros (EUR). |
metric |
spend_GBP |
spend_GBP |
The total amount of money spent on advertising, reported in British Pounds (GBP). |
metric |
spend_USD |
spend_USD |
The total amount of money spent on advertising, reported in United States Dollars (USD). |
metric |
spend_credits |
spend_credits |
metric |
|
spend_credits_rate |
spend_credits_rate |
metric |
|
split_test_group_id |
split_test_group_id |
The identifier for a group within a split test. |
dimension |
split_test_status |
split_test_status |
The current status of a split test. |
dimension |
start_date |
start_date |
The start date for the reporting period or campaign duration, in YYYY-MM-DD format. |
dimension |
start_timestamp |
start_timestamp |
The start timestamp of the reporting period. |
dimension |
start_trial |
start_trial |
The number of times a trial was started. |
metric |
start_trial_rate |
start_trial_rate |
The rate at which trials were started. |
metric |
stat_cost |
stat_cost |
The total cost incurred for the reported statistics. |
metric |
stat_time_day |
stat_time_day |
The specific day for which the statistics are reported. |
dimension |
stat_time_hour |
stat_time_hour |
The hour of the day for which the statistical data is reported. |
dimension |
statistic_type |
statistic_type |
The type of statistic or metric being reported. |
dimension |
status |
status |
The current operational status of the ad object (e.g., enabled, paused, deleted). |
dimension |
stitch_clicks |
stitch_clicks |
The number of clicks on the ‘Stitch’ button in Spark Ads. |
metric |
subscribe |
subscribe |
The number of subscription events attributed to the ad. |
metric |
subscribe_rate |
subscribe_rate |
The rate at which users subscribe after interacting with an ad. |
metric |
target |
target |
The target audience or demographic for the ad campaign. |
dimension |
target_roi_budget |
target_roi_budget |
The budget allocated to achieve a specific Return On Investment (ROI) target. |
metric |
targeting_expansion |
targeting_expansion |
The status of targeting expansion for the ad group. |
dimension |
tiktok_comments |
tiktok_comments |
The number of comments received on the video creative within 1 day of a user seeing a paid ad. |
metric |
tiktok_conversions |
tiktok_conversions |
The number of conversions attributed to ads on TikTok. |
metric |
tiktok_cost_usd |
tiktok_cost_usd |
The cost incurred for ads on TikTok, reported in United States Dollars (USD). |
metric |
tiktok_costs |
tiktok_costs |
metric |
|
tiktok_creative_id |
tiktok_creative_id |
The unique identifier for the TikTok ad creative. |
dimension |
tiktok_engagements |
tiktok_engagements |
The total number of user engagements with the ad on TikTok. |
metric |
tiktok_item_id |
tiktok_item_id |
The unique identifier for a TikTok post ID, used specifically for Spark Ads. |
dimension |
tiktok_likes |
tiktok_likes |
The number of likes received on the video creative within 1 day of a user seeing a paid ad. |
metric |
tiktok_link_id |
tiktok_link_id |
dimension |
|
tiktok_page_category |
tiktok_page_category |
dimension |
|
tiktok_reach |
tiktok_reach |
The number of unique users who saw the ad on TikTok. |
metric |
tiktok_shares |
tiktok_shares |
The number of times the video creative was shared on TikTok. |
metric |
tiktok_video_start |
tiktok_video_start |
The number of times the video creative started playing on TikTok. |
metric |
tiktok_vtr_100 |
tiktok_vtr_100 |
Video Through Rate at 100%, meaning the percentage of times the video was played to completion. |
metric |
tiktok_vtr_25 |
tiktok_vtr_25 |
Video Through Rate at 25%, meaning the percentage of times the video was played to 25% of its length. |
metric |
tiktok_vtr_50 |
tiktok_vtr_50 |
Video Through Rate at 50%, meaning the percentage of times the video was played to 50% of its length. |
metric |
tiktok_vtr_75 |
tiktok_vtr_75 |
Video Through Rate at 75%, meaning the percentage of times the video was played to 75% of its length. |
metric |
timezone |
timezone |
The timezone of the advertiser account. |
dimension |
title |
title |
The title or headline of an ad or creative. |
dimension |
total_achieve_level |
total_achieve_level |
The total number of times users achieved a certain level within an app or game, attributed to the ad. |
metric |
total_achieve_level_value |
total_achieve_level_value |
The total value generated from achieve level events. |
metric |
total_active_pay_roas |
total_active_pay_roas |
The Return On Ad Spend (ROAS) from actively paying users. |
metric |
total_ad_impression_events_value |
total_ad_impression_events_value |
The total value attributed to ad impression events. |
metric |
total_ad_impression_roas |
total_ad_impression_roas |
The Return on Ad Spend (ROAS) calculated based on total ad impressions. |
metric |
total_add_billing_value |
total_add_billing_value |
The total value generated from users initiating adding billing information. |
metric |
total_add_payment_info |
total_add_payment_info |
The total number of times payment information was added. |
metric |
total_add_to_wishlist |
total_add_to_wishlist |
The total number of ‘add to wishlist’ events attributed to your ads. |
metric |
total_add_to_wishlist_value |
total_add_to_wishlist_value |
The total monetary value of ‘add to wishlist’ events attributed to your ads. |
metric |
total_app_event_add_to_cart |
total_app_event_add_to_cart |
The total number of ‘add to cart’ events that occurred within your app, attributed to your ads. |
metric |
total_app_event_add_to_cart_value |
total_app_event_add_to_cart_value |
The total monetary value of ‘add to cart’ events that occurred within your app, attributed to your ads. |
metric |
total_button_click_value |
total_button_click_value |
The total value generated from button clicks on a website or app, attributed to the ad. |
metric |
total_checkout |
total_checkout |
The total number of checkout events initiated. |
metric |
total_checkout_value |
total_checkout_value |
The total monetary value of all checkout events. |
metric |
total_complete_payment_rate |
total_complete_payment_rate |
The total rate of complete payment events attributed to ads. |
metric |
total_complete_tutorial |
total_complete_tutorial |
The total number of times users completed a tutorial. |
metric |
total_complete_tutorial_value |
total_complete_tutorial_value |
The total value generated from users completing a tutorial. |
metric |
total_consultation_value |
total_consultation_value |
The total value generated from consultations. |
metric |
total_create_gamerole |
total_create_gamerole |
The total number of times users created a game role. |
metric |
total_create_gamerole_value |
total_create_gamerole_value |
The total value generated from users creating a game role. |
metric |
total_create_group |
total_create_group |
The total number of times a group was created. |
metric |
total_create_group_value |
total_create_group_value |
The total value generated from creating groups. |
metric |
total_download_start_value |
total_download_start_value |
The total value generated from users starting a download. |
metric |
total_form_value |
total_form_value |
The total monetary value generated from form submissions. |
metric |
total_in_app_ad_click |
total_in_app_ad_click |
The total number of clicks on in-app ads. |
metric |
total_in_app_ad_click_value |
total_in_app_ad_click_value |
The total value generated from clicks on in-app ads. |
metric |
total_in_app_ad_impr |
total_in_app_ad_impr |
The total number of in-app ad impressions. |
metric |
total_in_app_ad_impr_value |
total_in_app_ad_impr_value |
The total value generated from in-app ad impressions. |
metric |
total_initiate_checkout_value |
total_initiate_checkout_value |
The total monetary value of all initiate checkout events. |
metric |
total_join_group |
total_join_group |
The total number of times a group was joined. |
metric |
total_join_group_value |
total_join_group_value |
The total value generated from joining groups. |
metric |
total_landing_page_view |
total_landing_page_view |
The total number of landing page views after ad interaction. |
metric |
total_launch_app |
total_launch_app |
The total number of times the app was launched by users. |
metric |
total_loan_apply |
total_loan_apply |
The total number of loan applications. |
metric |
total_loan_credit |
total_loan_credit |
The total number of loan credits. |
metric |
total_loan_disbursement |
total_loan_disbursement |
The total number of loan disbursements. |
metric |
total_login |
total_login |
The total number of user logins. |
metric |
total_next_day_open |
total_next_day_open |
The total number of times the app was opened the day after installation or engagement. |
metric |
total_on_web_add_to_wishlist_value |
total_on_web_add_to_wishlist_value |
The total monetary value of ‘add to wishlist’ events that occurred on the website, attributed to ads. |
metric |
total_on_web_order_value |
total_on_web_order_value |
The total monetary value of order events that occurred on the website, attributed to ads. |
metric |
total_on_web_subscribe_value |
total_on_web_subscribe_value |
The total monetary value of subscription events that occurred on the website, attributed to ads. |
metric |
total_online_consult_value |
total_online_consult_value |
The total value generated from online consultation events. |
metric |
total_onsite_add_billing_value |
total_onsite_add_billing_value |
The total value generated from onsite add billing events. |
metric |
total_onsite_add_to_wishlist_value |
total_onsite_add_to_wishlist_value |
The total value generated from onsite add to wishlist events. |
metric |
total_onsite_form_value |
total_onsite_form_value |
The total value generated from onsite form submission events. |
metric |
total_onsite_initiate_checkout_count_value |
total_onsite_initiate_checkout_count_value |
The total value generated from onsite initiate checkout events. |
metric |
total_onsite_on_web_cart_value |
total_onsite_on_web_cart_value |
The total value generated from onsite add to cart events. |
metric |
total_onsite_shopping_value |
total_onsite_shopping_value |
The total monetary value of all onsite shopping events. |
metric |
total_page_event_search_value |
total_page_event_search_value |
The total monetary value of search events that occurred on a webpage, attributed to ads. |
metric |
total_page_view_content_events_value |
total_page_view_content_events_value |
The total value generated from all page content view events. |
metric |
total_pageview |
total_pageview |
The total number of page views. |
metric |
total_play |
total_play |
The total number of video plays for the ad creative. |
metric |
total_purchase |
total_purchase |
The total number of purchases. |
metric |
total_purchase_roas_day0 |
total_purchase_roas_day0 |
The return on ad spend (ROAS) from purchases made on Day 0 (the day of the ad impression or click). |
metric |
total_purchase_roas_day2 |
total_purchase_roas_day2 |
The return on ad spend (ROAS) from purchases made on Day 2 after the ad impression or click. |
metric |
total_purchase_roas_day6 |
total_purchase_roas_day6 |
Total Return On Ad Spend (ROAS) from purchases, measured on day 6 of the attribution window. |
metric |
total_purchase_value |
total_purchase_value |
The total monetary value of purchases. |
metric |
total_purchase_value_EUR |
total_purchase_value_EUR |
The total monetary value of purchases attributed to ads, reported in Euros (EUR). |
metric |
total_purchase_value_GBP |
total_purchase_value_GBP |
The total monetary value of purchases attributed to ads, reported in British Pounds (GBP). |
metric |
total_purchase_value_USD |
total_purchase_value_USD |
The total monetary value of purchases attributed to ads, reported in United States Dollars (USD). |
metric |
total_purchase_value_day0 |
total_purchase_value_day0 |
The total value of purchases made on Day 0 (the day of the ad impression or click). |
metric |
total_purchase_value_day2 |
total_purchase_value_day2 |
Total value from purchases, measured on day 2 of the attribution window. |
metric |
total_purchase_value_day6 |
total_purchase_value_day6 |
Total value from purchases, measured on day 6 of the attribution window. |
metric |
total_ratings |
total_ratings |
The total number of user ratings. |
metric |
total_ratings_value |
total_ratings_value |
The total value generated from user ratings. |
metric |
total_registration |
total_registration |
The total number of registration events. |
metric |
total_sales_lead |
total_sales_lead |
The total number of sales leads generated. |
metric |
total_sales_lead_value |
total_sales_lead_value |
The total value generated from sales leads. |
metric |
total_search |
total_search |
The total number of search events that are attributed to your ads. |
metric |
total_spend_credits |
total_spend_credits |
The total number of credits spent by users. |
metric |
total_spend_credits_value |
total_spend_credits_value |
The total value generated from users spending credits. |
metric |
total_start_trial |
total_start_trial |
The total number of times users started a trial for a service or product. |
metric |
total_subscribe |
total_subscribe |
The total number of subscription events attributed to ads. |
metric |
total_subscribe_value |
total_subscribe_value |
The total monetary value of subscription events attributed to ads. |
metric |
total_unlock_achievement |
total_unlock_achievement |
The total number of achievements unlocked by users. |
metric |
total_unlock_achievement_value |
total_unlock_achievement_value |
The total value generated from users unlocking achievements. |
metric |
total_user_registration_value |
total_user_registration_value |
The total value generated from user registrations. |
metric |
total_value_per_pageview |
total_value_per_pageview |
The average value returned from each page view event. |
metric |
total_view_content |
total_view_content |
The total number of view content events attributed to your ads. |
metric |
total_view_content_value |
total_view_content_value |
The total monetary value of view content events attributed to your ads. |
metric |
total_web_event_add_to_cart_value |
total_web_event_add_to_cart_value |
The total monetary value of ‘add to cart’ web events. |
metric |
tracking_app_id |
tracking_app_id |
dimension |
|
tracking_pixel_id |
tracking_pixel_id |
The identifier of the tracking pixel used to measure offsite events, such as conversions. |
dimension |
tt_account_name |
tt_account_name |
The name of the TikTok account associated with the ad. |
dimension |
tt_account_profile_image_url |
tt_account_profile_image_url |
The URL of the profile image for the TikTok account associated with the ad. |
dimension |
tt_app_id |
tt_app_id |
The unique identifier for the TikTok application. |
dimension |
tt_app_name |
tt_app_name |
The name of the TikTok application. |
metric |
unique_ad_impression_events |
unique_ad_impression_events |
The number of unique ad impression events. |
metric |
unique_custom_app_events |
unique_custom_app_events |
The number of unique custom in-app events recorded. |
metric |
unlock_achievement |
unlock_achievement |
The number of times users unlocked an achievement. |
metric |
unlock_achievement_rate |
unlock_achievement_rate |
The rate at which users unlock achievements. |
metric |
url_clicks |
url_clicks |
The number of clicks on the ad’s URL. |
metric |
user_registration |
user_registration |
The number of user registration events. |
metric |
user_registration_rate |
user_registration_rate |
The rate at which users complete registration. |
metric |
value_per_add_billing |
value_per_add_billing |
The average value generated per ‘add billing information’ event. |
metric |
value_per_button_click |
value_per_button_click |
The value generated per button click. |
metric |
value_per_checkout |
value_per_checkout |
The average value generated per checkout event. |
metric |
value_per_complete_payment |
value_per_complete_payment |
The monetary value generated for each complete payment. |
metric |
value_per_consultation |
value_per_consultation |
The average value generated per consultation event. |
metric |
value_per_download_start |
value_per_download_start |
The average value generated per download start event. |
metric |
value_per_form |
value_per_form |
The average value generated per form submission event. |
metric |
value_per_initiate_checkout |
value_per_initiate_checkout |
The average value generated per ‘initiate checkout’ event. |
metric |
value_per_offline_form_event |
value_per_offline_form_event |
The average value generated per offline form submission event. |
metric |
value_per_offline_place_order_event |
value_per_offline_place_order_event |
The average value generated per offline place order event. |
metric |
value_per_on_web_add_to_wishlist |
value_per_on_web_add_to_wishlist |
The average value generated per onsite add to wishlist event. |
metric |
value_per_on_web_order |
value_per_on_web_order |
The monetary value generated for each order completed on the website. |
metric |
value_per_online_consult |
value_per_online_consult |
The average value generated per online consultation event. |
metric |
value_per_onsite_form |
value_per_onsite_form |
The average value generated per onsite form submission. |
metric |
value_per_onsite_initiate_checkout_count |
value_per_onsite_initiate_checkout_count |
The average value generated per onsite initiate checkout event. |
metric |
value_per_onsite_on_web_cart |
value_per_onsite_on_web_cart |
The average value generated per onsite add to cart event. |
metric |
value_per_onsite_on_web_detail |
value_per_onsite_on_web_detail |
The average value generated per onsite product detail page view. |
metric |
value_per_onsite_shopping |
value_per_onsite_shopping |
The average value generated per onsite shopping event. |
metric |
value_per_page_event_search |
value_per_page_event_search |
The average value generated per page event search. |
metric |
value_per_total_achieve_level |
value_per_total_achieve_level |
The average value generated per ‘achieve level’ event. |
metric |
value_per_total_add_to_wishlist |
value_per_total_add_to_wishlist |
The average value generated per ‘add to wishlist’ event. |
metric |
value_per_total_app_event_add_to_cart |
value_per_total_app_event_add_to_cart |
The average value generated per ‘add to cart’ event within the app. |
metric |
value_per_total_complete_tutorial |
value_per_total_complete_tutorial |
The average value generated per ‘complete tutorial’ event. |
metric |
value_per_total_create_gamerole |
value_per_total_create_gamerole |
The average value generated per ‘create game role’ event. |
metric |
value_per_total_create_group |
value_per_total_create_group |
The average value generated per ‘create group’ event. |
metric |
value_per_total_in_app_ad_click |
value_per_total_in_app_ad_click |
The average value generated per in-app ad click. |
metric |
value_per_total_in_app_ad_impr |
value_per_total_in_app_ad_impr |
The average value generated per in-app ad impression. |
metric |
value_per_total_join_group |
value_per_total_join_group |
The average value generated per ‘join group’ event. |
metric |
value_per_total_purchase |
value_per_total_purchase |
Total monetary value generated for each purchase attributed to an ad. |
metric |
value_per_total_ratings |
value_per_total_ratings |
The average value generated per rating event. |
metric |
value_per_total_sales_lead |
value_per_total_sales_lead |
The average value generated per sales lead. |
metric |
value_per_total_spend_credits |
value_per_total_spend_credits |
The average value generated per ‘spend credits’ event. |
metric |
value_per_total_subscribe |
value_per_total_subscribe |
The average value generated per subscription event. |
metric |
value_per_total_unlock_achievement |
value_per_total_unlock_achievement |
The average value generated per ‘unlock achievement’ event. |
metric |
value_per_total_view_content |
value_per_total_view_content |
The average value generated per ‘view content’ event. |
metric |
value_per_user_registration |
value_per_user_registration |
The average value generated per user registration. |
metric |
value_per_web_event_add_to_cart |
value_per_web_event_add_to_cart |
The average value generated per ‘add to cart’ web event. |
metric |
video_id |
video_id |
The unique identifier for a video creative used in an ad. |
dimension |
video_play_actions |
video_play_actions |
The total number of times users initiated playing a video ad. |
metric |
video_starts |
video_starts |
The number of times an ad’s video creative began playing. |
metric |
video_views_p100 |
video_views_p100 |
The percentage of video views that reached 100% completion. |
metric |
video_views_p25 |
video_views_p25 |
The percentage of video views that reached 25% completion. |
metric |
video_views_p50 |
video_views_p50 |
The percentage of video views that reached 50% completion. |
metric |
video_views_p75 |
video_views_p75 |
The percentage of video views that reached 75% completion. |
metric |
video_watched_2s |
video_watched_2s |
The number of times a video ad was watched for at least 2 seconds. |
metric |
video_watched_6s |
video_watched_6s |
The number of times a video has been played for at least 6 seconds, or played in full if it is less than 6 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad. |
metric |
video_watched_continuous_2s |
video_watched_continuous_2s |
The number of times a video was continuously watched for at least 2 seconds. |
metric |
view_attribution_window |
view_attribution_window |
The time period after an ad view during which a conversion can be attributed to the ad. |
dimension |
view_completion |
view_completion |
The percentage of video views completed. |
metric |
view_content |
view_content |
The number of times a specific content page or product was viewed after an ad interaction. |
metric |
view_content_rate |
view_content_rate |
The rate at which users view specific content pages. |
metric |
views_cost |
views_cost |
metric |
|
vta_conversion |
vta_conversion |
The number of conversions attributed to a view-through action. |
metric |
vta_purchase |
vta_purchase |
Purchases attributed to a view-through action (user saw the ad but didn’t click, then converted later). |
metric |
vta_registration |
vta_registration |
The number of registration events attributed to view-through actions (VTA), based on information received from your measurement partner. |
metric |
web_event_add_to_cart |
web_event_add_to_cart |
The number of ‘add to cart’ events that occurred on the website, attributed to ads. |
metric |
web_event_add_to_cart_rate |
web_event_add_to_cart_rate |
The rate at which users add items to their cart on a website. |
metric |