WeChat: Most-used fields

The table below gives information about most-used fields that you can import from WeChat. 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
account_corporation_name	account_corporation_name	The official corporate name of the advertiser account owner.	dimension
account_daily_budget	account_daily_budget	The daily budget limit set for the advertiser account.	dimension
account_id	account_id	Unique identifier for the advertiser account.	dimension
account_wechat_account_name	account_wechat_account_name	The name of the WeChat Official Account linked to the advertiser. This identifies the specific official account whose data is being reported.	dimension
activated_cost	activated_cost	The total cost incurred for all activations related to the advertisement.	dimension
activated_count	activated_count	The total number of activations attributed to the advertisement.	dimension
activated_rate	activated_rate	The rate of successful activations from impressions or clicks.	dimension
ad_adcreative	ad_adcreative	Details of the ad creative, including content and media.	dimension
ad_adcreative_id	ad_adcreative_id	Unique identifier for the ad creative.	dimension
ad_audit_spec	ad_audit_spec	Specifications related to the audit status and details of the ad.	dimension
ad_click_tracking_url	ad_click_tracking_url	The URL used to track clicks on the ad.	dimension
ad_configured_status	ad_configured_status	The configured status of the ad, indicating whether it is enabled, paused, or otherwise configured.	dimension
ad_created_time	ad_created_time	The timestamp when the ad was created.	dimension
ad_feeds_interaction_enabled	ad_feeds_interaction_enabled	This field indicates whether interactive features, such as likes, comments, or shares, are enabled for ads displayed within user feeds, like WeChat Moments. Enabling this feature allows users to engage directly with the ad content.	dimension
ad_id	ad_id	Unique identifier for the ad.	dimension
ad_impression_tracking_url	ad_impression_tracking_url	The URL used to track impressions of the ad.	dimension
ad_is_deleted	ad_is_deleted	Indicates whether the ad has been marked as deleted.	dimension
ad_is_dynamic_creative	ad_is_dynamic_creative	Indicates whether the ad uses dynamic creative optimization.	dimension
ad_last_modified_time	ad_last_modified_time	The timestamp when the ad was last modified.	dimension
ad_name	ad_name	The name of the ad.	dimension
ad_reject_message	ad_reject_message	The message detailing the reason for an ad’s rejection during the audit process.	dimension
ad_system_status	ad_system_status	The system status of the ad, reflecting its current operational state within the advertising platform.	dimension
add_wishlist_count	add_wishlist_count	The number of times users added an item to their wishlist after interacting with the advertisement.	dimension
adgroup_additional_user_action_sets	adgroup_additional_user_action_sets	Additional user action sets associated with the ad group for conversion tracking.	dimension
adgroup_begin_date	adgroup_begin_date	The start date for the ad group’s campaign.	dimension
adgroup_bid_amount	adgroup_bid_amount	The bid amount set for the ad group.	dimension
adgroup_billing_event	adgroup_billing_event	The billing event for the ad group, such as impression-based (CPM) or click-based (CPC).	dimension
adgroup_cold_start_audience	adgroup_cold_start_audience	A specific audience used for cold start optimization of the ad group.	dimension
adgroup_configured_status	adgroup_configured_status	The configured status of the ad group, indicating whether it is enabled, paused, or otherwise configured.	dimension
adgroup_created_time	adgroup_created_time	The timestamp when the ad group was created.	dimension
adgroup_daily_budget	adgroup_daily_budget	The daily budget limit set for the ad group.	dimension
adgroup_deep_conversion_spec	adgroup_deep_conversion_spec	Specifications for deep conversion tracking within the ad group.	dimension
adgroup_dynamic_creative_id_set	adgroup_dynamic_creative_id_set	A set of dynamic creative IDs used within the ad group.	dimension
adgroup_end_date	adgroup_end_date	The end date for the ad group’s campaign.	dimension
adgroup_expand_enabled	adgroup_expand_enabled	Indicates whether audience expansion is enabled for the ad group.	dimension
adgroup_expand_targeting	adgroup_expand_targeting	Settings for expanding the target audience beyond the initial selection for the ad group.	dimension
adgroup_id	adgroup_id	Unique identifier for the ad group.	dimension
adgroup_is_deleted	adgroup_is_deleted	Indicates whether the ad group has been marked as deleted.	dimension
adgroup_last_modified_time	adgroup_last_modified_time	The timestamp when the ad group was last modified.	dimension
adgroup_name	adgroup_name	The name of the ad group.	dimension
adgroup_optimization_goal	adgroup_optimization_goal	The optimization goal set for the ad group, such as impressions, clicks, or conversions.	dimension
adgroup_poi_list	adgroup_poi_list	A list of Points of Interest (POI) targeted by the ad group.	dimension
adgroup_promoted_object_type	adgroup_promoted_object_type	The type of object being promoted by the ad group, consistent with the campaign’s promoted object type.	dimension
adgroup_scene_spec	adgroup_scene_spec	Specifications for ad scenes or placements where the ad group will be displayed.	dimension
adgroup_site_set	adgroup_site_set	The set of sites or placements where the ad group will run, such as WeChat Moments or Mobile Union.	dimension
adgroup_system_status	adgroup_system_status	The system status of the ad group, reflecting its current operational state within the advertising platform.	dimension
adgroup_targeting_id	adgroup_targeting_id	The ID of the targeting settings applied to the ad group.	dimension
adgroup_user_action_sets	adgroup_user_action_sets	User action sets associated with the ad group for conversion tracking.	dimension
app_add_to_cart_count	app_add_to_cart_count	The total number of times users added items to their shopping cart within an application after engaging with the ad.	dimension
app_apply_uv	app_apply_uv	The number of unique visitors who applied for something within an application after interacting with the ad.	dimension
app_checkout_amount	app_checkout_amount	The total monetary amount of checkouts completed within an application, attributed to the ad.	dimension
app_checkout_count	app_checkout_count	The total number of checkout events completed within an application, attributed to the ad.	dimension
app_credit_uv	app_credit_uv	The number of unique visitors who applied for credit or a loan within an application after interacting with the ad.	dimension
app_pre_credit_uv	app_pre_credit_uv	The number of unique visitors who initiated a pre-qualification process for credit or a loan within an application after interacting with the ad.	dimension
app_register_cost	app_register_cost	The total cost incurred for user registrations within an application, attributed to the ad.	dimension
app_register_count	app_register_count	The total number of user registrations within an application, attributed to the ad.	dimension
app_withdraw_uv	app_withdraw_uv	The number of unique visitors who initiated a withdrawal process within an application after interacting with the ad.	dimension
campaign_budget_reach_date	campaign_budget_reach_date	The date when the campaign’s daily budget was most recently reached. If the daily budget has not been reached, this field will be empty.	dimension
campaign_configured_status	campaign_configured_status	The configured status of the campaign, indicating whether it is enabled, paused, or otherwise configured.	dimension
campaign_created_time	campaign_created_time	The timestamp when the campaign was created.	dimension
campaign_daily_budget	campaign_daily_budget	The daily budget limit set for the campaign.	dimension
campaign_id	campaign_id	Unique identifier for the campaign.	dimension
campaign_is_deleted	campaign_is_deleted	Indicates whether the campaign has been marked as deleted.	dimension
campaign_last_modified_time	campaign_last_modified_time	The timestamp when the campaign was last modified.	dimension
campaign_name	campaign_name	The name of the campaign.	dimension
campaign_promoted_object_type	campaign_promoted_object_type	The type of object being promoted by the campaign, such as an app, e-commerce product, or official account.	dimension
campaign_speed_mode	campaign_speed_mode	The delivery speed mode for the campaign, which can be either standard or fast.	dimension
campaign_type	campaign_type	The type of advertising campaign, such as WeChat Moments ads.	dimension
click_detail_count	click_detail_count	The total number of clicks on detailed elements of the advertisement.	dimension
click_head_count	click_head_count	The total number of clicks on the advertiser’s profile picture or avatar within an ad.	dimension
click_image_count	click_image_count	The total number of clicks on images within the advertisement.	dimension
click_nick_count	click_nick_count	The total number of clicks on the advertiser’s nickname or name displayed with an ad.	dimension
click_poi_count	click_poi_count	The total number of clicks on a Point of Interest (POI) related to the advertisement.	dimension
click_user_count	click_user_count	The total number of unique users who clicked on the advertisement.	dimension
comment_count	comment_count	The total number of comments received on the advertised content.	metric
comment_user_count	comment_user_count	The total number of unique users who commented on the advertised content.	dimension
compensation_amount	compensation_amount	A monetary amount calculated by the platform as compensation for ad campaigns that significantly deviate from the target cost within a specified cost guarantee period.	dimension
conversions_cost	conversions_cost	The cost incurred per conversion.	dimension
conversions_count	conversions_count	The total number of conversions recorded for an ad.	dimension
conversions_rate	conversions_rate	The rate of conversions from clicks or impressions.	dimension
cost	cost	The total cost incurred for the ad or campaign.	metric
coupon_get_cost	coupon_get_cost	The total cost associated with users acquiring coupons after interacting with the ad.	dimension
coupon_get_rate	coupon_get_rate	The rate at which users acquired coupons after interacting with the ad, expressed as a percentage.	dimension
coupon_use_count	coupon_use_count	The total number of times coupons obtained through the advertisement were used.	dimension
cpc	cpc	The average cost per click (CPC).	metric
ctr	ctr	The click-through rate (CTR).	metric
date	date	The date for which the report data is generated.	dimension
deep_conversions_cost	deep_conversions_cost	The cost incurred for deep conversions.	dimension
deep_conversions_count	deep_conversions_count	The total number of deep conversions recorded for an ad. Deep conversions are advanced conversion events beyond initial actions.	dimension
deep_conversions_rate	deep_conversions_rate	The rate of deep conversions from clicks or impressions.	dimension
download_cost	download_cost	The cost incurred for app downloads.	dimension
download_count	download_count	The number of app downloads recorded.	dimension
first_day_order_amount	first_day_order_amount	The total monetary amount of orders placed on the first day after a user’s initial interaction with the ad.	dimension
first_day_order_count	first_day_order_count	The total number of orders placed on the first day after a user’s initial interaction with the ad.	dimension
first_pay_cost	first_pay_cost	The cost associated with a user’s first payment or transaction after engaging with the advertisement.	dimension
first_pay_count	first_pay_count	The number of first payments or transactions made by users after engaging with the advertisement.	dimension
forward_count	forward_count	The total number of times the advertised content was shared or forwarded.	dimension
forward_user_count	forward_user_count	The total number of unique users who shared or forwarded the advertised content.	dimension
image_click_user_count	image_click_user_count	The number of unique users who clicked on an image within the advertisement.	dimension
install_cost	install_cost	The total cost incurred for application installations attributed to the advertisement.	dimension
install_count	install_count	The total number of application installations attributed to the advertisement.	dimension
install_rate	install_rate	The rate at which users installed an application after interacting with the ad, expressed as a percentage.	dimension
key_page_uv	key_page_uv	The number of unique visitors to a designated key page or landing page associated with the advertisement.	dimension
leads_cost	leads_cost	The cost incurred for generating leads.	dimension
leads_purchase_cost	leads_purchase_cost	The cost incurred for purchases made by leads generated through the advertisement.	dimension
leads_purchase_rate	leads_purchase_rate	The rate at which generated leads completed a purchase, expressed as a percentage.	dimension
leads_purchase_uv	leads_purchase_uv	The number of unique visitors who became leads and subsequently made a purchase.	dimension
leads_rate	leads_rate	The rate at which leads are generated.	dimension
leads_user_count	leads_user_count	The number of unique users who became leads.	dimension
leads_user_rate	leads_user_rate	The rate of unique users becoming leads.	dimension
link_click_user_count	link_click_user_count	The number of unique users who clicked on a link within the advertisement.	dimension
nickname_click_user_count	nickname_click_user_count	The number of unique users who clicked on the advertiser’s nickname or name displayed with an ad.	dimension
no_interest_count	no_interest_count	The number of times users explicitly indicated disinterest or chose to hide an ad, serving as feedback for ad relevance.	dimension
official_account_apply_amount	official_account_apply_amount	The total monetary amount of applications submitted through the WeChat Official Account, attributed to the ad.	dimension
official_account_apply_cost	official_account_apply_cost	The cost incurred for applications submitted through the WeChat Official Account, attributed to the ad.	dimension
official_account_apply_count	official_account_apply_count	The total number of applications submitted through the WeChat Official Account, attributed to the ad.	dimension
official_account_apply_rate	official_account_apply_rate	The rate at which users submitted applications through the WeChat Official Account after engaging with the ad.	dimension
official_account_apply_roi	official_account_apply_roi	The return on investment for applications submitted through the WeChat Official Account, attributed to the ad.	dimension
official_account_apply_user_count	official_account_apply_user_count	The number of unique users who submitted applications through the WeChat Official Account after interacting with the ad.	dimension
official_account_consult_count	official_account_consult_count	The total number of consultation requests initiated through the WeChat Official Account.	dimension
official_account_credit_apply_user_count	official_account_credit_apply_user_count	The number of unique users who applied for credit or a loan through the WeChat Official Account after interacting with the ad.	dimension
official_account_credit_user_count	official_account_credit_user_count	The number of unique users who engaged with credit-related services through the WeChat Official Account.	dimension
official_account_first_day_order_amount	official_account_first_day_order_amount	The total monetary amount of orders placed through the WeChat Official Account on the first day after a user’s initial interaction with the ad.	dimension
official_account_first_day_order_count	official_account_first_day_order_count	The total number of orders placed through the WeChat Official Account on the first day after a user’s initial interaction with the ad.	dimension
official_account_follow_cost	official_account_follow_cost	The cost incurred for new followers gained by the WeChat Official Account, attributed to the ad.	dimension
official_account_follow_count	official_account_follow_count	The total number of new followers gained by the WeChat Official Account, attributed to the ad.	dimension
official_account_follow_rate	official_account_follow_rate	The rate at which users followed the WeChat Official Account after engaging with the ad, expressed as a percentage.	dimension
official_account_order_amount	official_account_order_amount	The total monetary amount of orders placed through the WeChat Official Account, attributed to the ad.	dimension
official_account_order_cost	official_account_order_cost	The cost incurred for orders placed through the WeChat Official Account, attributed to the ad.	dimension
official_account_order_count	official_account_order_count	The total number of orders placed through the WeChat Official Account, attributed to the ad.	dimension
official_account_order_rate	official_account_order_rate	The rate at which orders were placed through the WeChat Official Account after engaging with the ad.	dimension
official_account_order_roi	official_account_order_roi	The return on investment for orders placed through the WeChat Official Account, attributed to the ad.	dimension
official_account_order_user_count	official_account_order_user_count	The number of unique users who placed orders through the WeChat Official Account after interacting with the ad.	dimension
official_account_reader_count	official_account_reader_count	The total number of readers or unique views for content on the WeChat Official Account.	dimension
official_account_register_amount	official_account_register_amount	The total monetary amount generated from user registrations through the WeChat Official Account, attributed to the ad.	dimension
official_account_register_cost	official_account_register_cost	The cost incurred for user registrations through the WeChat Official Account, attributed to the ad.	dimension
official_account_register_rate	official_account_register_rate	The rate at which users registered through the WeChat Official Account after engaging with the ad.	dimension
official_account_register_roi	official_account_register_roi	The return on investment for user registrations through the WeChat Official Account, attributed to the ad.	dimension
official_account_register_user_count	official_account_register_user_count	The number of unique users who registered through the WeChat Official Account after interacting with the ad.	dimension
order_amount	order_amount	The total monetary amount of orders placed, attributed to the advertisement.	dimension
order_count	order_count	The total number of orders placed, attributed to the advertisement.	dimension
order_rate	order_rate	The rate at which orders were placed after engaging with the advertisement, expressed as a percentage.	dimension
order_roi	order_roi	The return on investment for orders placed, attributed to the advertisement.	dimension
order_unit_price	order_unit_price	The average unit price of items in orders placed, attributed to the advertisement.	dimension
own_page_coupon_get_count	own_page_coupon_get_count	The number of times users acquired coupons from an advertiser’s own page after interacting with the ad.	dimension
page_consult_user_count	page_consult_user_count	The number of unique users who initiated a consultation from a page related to the advertisement.	dimension
page_reservation_count	page_reservation_count	The total number of reservations made from a page related to the advertisement.	dimension
phone_call_uv	phone_call_uv	The number of unique visitors who initiated a phone call after interacting with the advertisement.	dimension
platform_coupon_get_count	platform_coupon_get_count	The total number of coupons acquired by users from the platform after interacting with the ad.	dimension
platform_key_page_avg_view_per_user	platform_key_page_avg_view_per_user	The average number of views per user on key pages within the platform, related to the advertisement.	dimension
platform_key_page_view_duration	platform_key_page_view_duration	The total duration of views on key pages within the platform, related to the advertisement.	dimension
platform_key_page_view_user_count	platform_key_page_view_user_count	The number of unique users who viewed key pages within the platform, related to the advertisement.	dimension
platform_page_view_count	platform_page_view_count	The total number of page views within the platform, attributed to the advertisement.	dimension
platform_page_view_rate	platform_page_view_rate	The rate at which pages within the platform were viewed after engagement with the advertisement.	dimension
poi_click_user_count	poi_click_user_count	The number of unique users who clicked on a Point of Interest (POI) related to the advertisement.	dimension
portrait_click_user_count	portrait_click_user_count	The number of unique users who clicked on the advertiser’s profile picture or avatar within an ad.	dimension
potential_customer_phone_uv	potential_customer_phone_uv	The number of unique visitors identified as potential customers who initiated a phone call after interacting with the advertisement.	dimension
praise_count	praise_count	The total number of likes or praise received for the advertised content.	metric
praise_user_count	praise_user_count	The total number of unique users who liked or praised the advertised content.	dimension
retention_cost	retention_cost	The cost incurred to retain users or customers after their initial interaction with the advertisement.	dimension
retention_count	retention_count	The number of users or customers retained after their initial interaction with the advertisement.	dimension
scan_follow_count	scan_follow_count	The number of times users followed an account by scanning a QR code, attributed to the advertisement.	dimension
sign_in_count	sign_in_count	The total number of user sign-ins or logins attributed to the advertisement.	dimension
thousand_display_price	thousand_display_price	The cost per thousand impressions (CPM).	dimension
valid_click_count	valid_click_count	The number of valid clicks on an ad.	dimension
valid_leads_cost	valid_leads_cost	The cost incurred for valid leads.	dimension
valid_leads_rate	valid_leads_rate	The conversion rate of valid leads.	dimension
valid_leads_uv	valid_leads_uv	Unique visitors who became valid leads.	dimension
valid_page_consult_user_count	valid_page_consult_user_count	The number of unique users who initiated a valid consultation from a page related to the advertisement.	dimension
valid_phone_uv	valid_phone_uv	The number of unique visitors who initiated a valid phone call after interacting with the advertisement.	dimension
valuable_click_cost	valuable_click_cost	The cost incurred for valuable clicks on the advertisement, defined as clicks leading to desired actions.	dimension
valuable_click_count	valuable_click_count	The total number of valuable clicks on the advertisement, defined as clicks leading to desired actions.	dimension
valuable_click_rate	valuable_click_rate	The rate of valuable clicks on the advertisement, expressed as a percentage.	dimension
video_click_user_count	video_click_user_count	The number of unique users who clicked on a video within the advertisement.	dimension
video_inner_play_count	video_inner_play_count	The total number of times videos were played within the ad’s native environment.	dimension
video_inner_play_user_count	video_inner_play_user_count	The number of unique users who played videos within the ad’s native environment.	dimension
video_outer_play_count	video_outer_play_count	The total number of times videos were played in an external environment after interacting with the ad.	dimension
video_outer_play_user_count	video_outer_play_user_count	The number of unique users who played videos in an external environment after interacting with the ad.	dimension
video_play_count	video_play_count	The total number of times a video associated with the advertisement was played.	dimension
view_commodity_page_uv	view_commodity_page_uv	The number of unique visitors who viewed a commodity or product page after interacting with the advertisement.	dimension
view_count	view_count	The total number of views or impressions for an ad.	metric
view_user_count	view_user_count	The total number of unique users who viewed the advertisement or associated content.	dimension
web_apply_uv	web_apply_uv	The number of unique visitors who applied for something on a website after interacting with the ad.	dimension
web_credit_uv	web_credit_uv	The number of unique visitors who engaged with credit-related services on a website after interacting with the ad.	dimension
web_order_cost	web_order_cost	The total cost incurred for orders placed on a website, attributed to the advertisement.	dimension
web_register_uv	web_register_uv	The number of unique visitors who registered on a website after interacting with the ad.	dimension
wechat_account_id	wechat_account_id	Unique identifier for the WeChat account linked to the advertiser.	dimension
wechat_agency_id	wechat_agency_id	The ID of the WeChat agency associated with the account.	dimension
wechat_app_register_uv	wechat_app_register_uv	The number of unique visitors who registered within a WeChat application after interacting with the ad.	dimension
wechat_minigame_arpu	wechat_minigame_arpu	The Average Revenue Per User (ARPU) for WeChat Mini Games, attributed to the advertisement.	dimension
wechat_minigame_checkout_amount	wechat_minigame_checkout_amount	The total monetary amount of checkouts completed within WeChat Mini Games, attributed to the ad.	dimension
wechat_minigame_checkout_count	wechat_minigame_checkout_count	The total number of checkout events completed within WeChat Mini Games, attributed to the ad.	dimension
wechat_minigame_register_cost	wechat_minigame_register_cost	The total cost incurred for user registrations within WeChat Mini Games, attributed to the ad.	dimension
wechat_minigame_register_rate	wechat_minigame_register_rate	The rate at which users registered within WeChat Mini Games after engaging with the ad.	dimension
wechat_minigame_retention_count	wechat_minigame_retention_count	The total number of retained users within WeChat Mini Games after their initial interaction with the advertisement.	dimension