TikTok Ads metrics and dimensions

373 metrics152 dimensions

Search fields

ACCOUNT

advertiser_name

Field label	Advertiser name
Description	Name of the advertiser account
Field type	dimension
Data type	string.text.value

advertiser_id

Field label	Advertiser ID
Description	ID of the advertiser account
Field type	dimension
Data type	string.text.value

advertiser_status

Field label	Advertiser status
Field type	dimension
Data type	string.text.value

advertiser_company

Field label	Company
Description	Advertiser company name
Field type	dimension
Data type	string.text.value

advertiser_balance

Field label	Advertiser balance
Description	Available balance on the account
Field type	dimension
Data type	float.currency.value

advertiser_currency

Field label	Currency
Description	Currency of the advertiser account
Field type	dimension
Data type	string.currency.code

advertiser_timezone

Field label	Time zone
Description	Time zone of the ad account
Field type	dimension
Data type	string.time.timezone

advertiser_address

Field label	Advertiser address
Description	Advertiser company address
Field type	dimension
Data type	string.text.value

advertiser_country

Field label	Advertiser country
Description	Advertiser company country
Field type	dimension
Data type	string.geo.country

advertiser_license_number

Field label	Advertiser license number
Description	Advertiser company license number
Field type	dimension
Data type	string.text.value

advertiser_email

Field label	Advertiser contact email
Field type	dimension
Data type	string.text.email

advertiser_phone_number

Field label	Advertiser contact phone number
Description	Fixed phone number, desensitised data
Field type	dimension
Data type	string.text.phone

advertiser_cellphone_number

Field label	Advertiser cellphone number
Description	Contact mobile number, desensitised data
Field type	dimension
Data type	string.text.phone

advertiser_account_type

Field label	Advertiser account type
Description	Type of the ad account, values include: RESERVATION, AUCTION
Field type	dimension
Data type	string.text.value

cost_cash

Field label	Cost (cash)
Description	The estimated amount of money you've spent on your campaign, ad group, or ad during its schedule charged by cash
Field type	metric
Data type	float.currency.value

cost_voucher

Field label	Cost (voucher)
Description	The estimated amount of money you've spent on your campaign, ad group, or ad during its schedule charged by voucher
Field type	metric
Data type	float.currency.value

ad_name

Field label	Ad name
Description	Name of the ad
Field type	dimension
Data type	string.text.value

ad_text

Field label	Ad text
Description	Text of the ad
Field type	dimension
Data type	string.text.value

ad_id

Field label	Ad ID
Description	ID of the ad
Field type	dimension
Data type	string.text.value

ad_status

Field label	Ad status
Description	The status of the ad
Field type	dimension
Data type	string.text.value

ad_opt_status

Field label	Ad operation status
Description	Operation status, values include: DISABLE, ENABLE
Field type	dimension
Data type	string.text.value

post_id

Field label	Post ID
Description	ID of the post associated with the ad
Field type	dimension
Data type	string.text.value

post_url

Field label	Post URL
Description	Link to the post associated with the ad
Field type	dimension
Data type	string.text.url

profile_image

Field label	Profile image URL
Description	Avatar URL
Field type	dimension
Data type	string.text.value

landing_page_url

Field label	Landing page URL
Field type	dimension
Data type	string.text.url

utm_source

Field label	utm_source parameter value
Description	utm_source parameter value from the destination URL, can be used to join with Google Analytics data
Field type	dimension
Data type	string.text.value

utm_medium

Field label	utm_medium parameter value
Description	utm_medium parameter value from the destination URL, can be used to join with Google Analytics data
Field type	dimension
Data type	string.text.value

utm_campaign

Field label	utm_campaign parameter value
Description	utm_campaign parameter value from the destination URL, can be used to join with Google Analytics data
Field type	dimension
Data type	string.text.value

utm_term

Field label	utm_term parameter value
Description	utm_term parameter value from the destination URL, can be used to join with Google Analytics data
Field type	dimension
Data type	string.text.value

utm_content

Field label	utm_content parameter value
Description	utm_content parameter value from the destination URL, can be used to join with Google Analytics data
Field type	dimension
Data type	string.text.value

display_name

Field label	Display name
Description	The display name of the landing page or pure exposure ad
Field type	dimension
Data type	string.text.value

call_to_action

Field label	Call-to-action
Description	The call-to-action (CTA) text
Field type	dimension
Data type	string.text.value

playable_url

Field label	Playable URL
Description	Playable material URL. Note this field is only supported by the interactive Playable Ad type
Field type	dimension
Data type	string.text.url

video_id

Field label	Video ID
Description	ID of ad video
Field type	dimension
Data type	string.text.value

image_mode

Field label	Image mode
Description	Material type
Field type	dimension
Data type	string.text.value

ad_product_specific_type

Field label	Ad product specific type
Description	Different dimensions to choose products, values include: ALL, PRODUCT_SET, CUSTOMIZED_PRODUCTS
Field type	dimension
Data type	string.text.value

ad_catalog_id

Field label	Ad catalog ID
Description	The catalog you choose for your ads
Field type	dimension
Data type	string.text.value

ad_product_set_id

Field label	Ad product set ID
Description	The ID of the product set
Field type	dimension
Data type	string.text.value

ad_sku_ids

Field label	Ad SKU IDs
Description	IDs of the SKUs
Field type	dimension
Data type	string.text.value

ad_dynamic_format

Field label	Ad dynamic format
Description	Values include: UNSET, DYNAMIC_CREATIVE (smart creative)
Field type	dimension
Data type	string.text.value

ad_vertical_video_strategy

Field label	Ad vertical video strategy
Description	Values include: UNSET, CUSTOM (single video), TPL_VIDEO (catalog videos), LIVE_STREAM
Field type	dimension
Data type	string.text.value

ad_dynamic_destination

Field label	Ad dynamic destination
Description	Values include: UNSET, DLP (Dynamic Landing Page)
Field type	dimension
Data type	string.text.value

ad_identity_type

Field label	Ad identity type
Description	Identity type for the ad. May include CUSTOMIZED_USER, AUTH_CODE, TT_USER, BC_AUTH_TT values
Field type	dimension
Data type	string.text.value

AD GROUP

ad_group_name

Field label	Ad group name
Description	Name of the ad group
Field type	dimension
Data type	string.text.value

ad_group_id

Field label	Ad group ID
Description	ID of the ad group
Field type	dimension
Data type	string.text.value

ad_group_status

Field label	Ad group status
Field type	dimension
Data type	string.text.value

ad_group_opt_status

Field label	Ad group operation status
Description	Operation status, values include: DISABLE, ENABLE
Field type	dimension
Data type	string.text.value

optimize_goal

Field label	Optimization goal
Description	The optimization goal for the ad group, see possible values at https://ads.tiktok.com/marketing_api/docs?id=100641
Field type	dimension
Data type	string.text.value

cpv_video_duration

Field label	CPV video duration
Description	Optimized video playback duration, values include: SIX_SECONDS (video playback 6 seconds) and TWO_SECONDS (video playback 2 seconds)
Field type	dimension
Data type	string.text.value

pacing

Field label	Pacing
Description	Speed of ad delivery, values include PACING_MODE_SMOOTH (Standard pace, budgets are allocated within the scheduled ad time) and PACING_MODE_FAST (Fast paced, consumes budget and produces results as fast as possible)
Field type	dimension
Data type	string.text.value

billing_event

Field label	Bid method
Description	Billing event for the ad group, eg. CPC, CPM or CPV
Field type	dimension
Data type	string.text.value

bid_type

Field label	Bidding strategy
Description	Values include BID_TYPE_CUSTOM (Manual bidding), BID_TYPE_MAX_CONVERSION (Maximum conversion bidding), BID_TYPE_NO_BID (Disable bid control, spending your budget fully and getting the maximum possible results)
Field type	dimension
Data type	string.text.value

deep_bid_type

Field label	Deep bid type
Description	Values include DEFAULT (No deep event bid), MIN (Double bid operation Method: Tiktok Ads platform will bid to keep your average cost around your target, including installation and target costs), PACING (Automatic optimization operation method: Tiktok Ads platform will bid to keep your average installation cost around your target goal, while aiming to get you the maximum number of target events.)
Field type	dimension
Data type	string.text.value

bid

Field label	Bid
Description	CPC, CPM bidding, oCPM learning bidding
Field type	dimension
Data type	float.currency.value

conversion_bid

Field label	Conversion bid
Description	oCPM conversion bid
Field type	dimension
Data type	float.currency.value

statistic_type

Field label	Conversion bid statistic type
Description	Conversion bid statistic type, either EVERYTIME (Each Purchase) or NONE (Unique Purchase)
Field type	dimension
Data type	string.text.value

deep_cpabid

Field label	Deep CPA bid
Description	Deep bid
Field type	dimension
Data type	float.currency.value

placement_type

Field label	Placement type
Description	Possible values for placement type are PLACEMENT_TYPE_AUTOMATIC (automatic placement), PLACEMENT_TYPE_NORMAL (manual placement)
Field type	dimension
Data type	string.text.value

adgroup_placement

Field label	AG Placement
Description	Placement location. If placement_type of the adgroup is PLACEMENT_TYPE_AUTOMATIC (automatic placement), placement will be returned as None
Field type	dimension
Data type	string.text.value

is_comment_disable

Field label	Are comments disabled
Description	Whether to allow comments on your ads on TikTok, Vigo, Helo. Optional values: FALSE (allow), TRUE (restrict)
Field type	dimension
Data type	bool

schedule_type

Field label	Schedule type
Description	Ad schedule type values include: SCHEDULE_FROM_NOW, SCHEDULE_START_END
Field type	dimension
Data type	string.text.value

schedule_start_time

Field label	Schedule start time
Description	Ad delivery start time (UTC)
Field type	dimension
Data type	string.time.datetime

schedule_end_time

Field label	Schedule end time
Description	Ad delivery end time (UTC)
Field type	dimension
Data type	string.time.datetime

ad_group_budget

Field label	Ad group budget
Description	Budget of the ad group
Field type	dimension
Data type	float.currency.value

ad_group_budget_mode

Field label	Ad group budget mode
Description	Budget mode of the ad group
Field type	dimension
Data type	string.text.value

ad_group_shopping_ads_type

Field label	Ad group shopping ads type
Description	Shopping ads type. Values include: UNSET, VIDEO (Video shopping ads), LIVE (Live shopping ads), CATALOG_LISTING_ADS
Field type	dimension
Data type	string.text.value

ad_group_product_source

Field label	Ad group product source
Description	Values include: UNSET, CATALOG (Catalog), STORE (TikTok Shop or TikTok Storefront (third-party store))
Field type	dimension
Data type	string.text.value

ad_group_split_test_group_id

Field label	Ad group split test group ID
Description	Split test group ID. Returned if the ad group is part of a split test
Field type	dimension
Data type	string.text.value

ad_group_split_test_status

Field label	Ad group split test status
Description	Split test status. Returned if the ad group is part of a split test
Field type	dimension
Data type	string.text.value

ATTRIBUTION

vta_conversion

Field label	VTA conversions
Description	The percentage of app install events you received out of all the clicks of your ads
Field type	metric
Data type	int.number.value

vta_registration

Field label	VTA registrations
Description	The number of registration event that attribute to impression, based on information received from your measurement partner
Field type	metric
Data type	int.number.value

vta_purchase

Field label	VTA purchases
Description	The number of in-app payment event that attribute to impression, based on information received from your measurement partner
Field type	metric
Data type	int.number.value

cta_conversion

Field label	CTA conversions
Description	The number of in-app app install event that occurred on your mobile app and are attributed to the amount of clicks
Field type	metric
Data type	int.number.value

cta_registration

Field label	CTA registrations
Description	The number of in-app registration event that attribute to click, based on information received from your measurement partner
Field type	metric
Data type	int.number.value

cta_purchase

Field label	CTA purchases
Description	The number of in-app payment event that attribute to click, based on information received from your measurement partner
Field type	metric
Data type	int.number.value

AUDIENCE

gender

Field label	Gender
Field type	dimension
Data type	string.person.gender

age

Field label	Age
Field type	dimension
Data type	string.person.age

dma_id

Field label	DMA ID
Field type	dimension
Data type	int.number.value

dma_name

Field label	DMA name
Field type	dimension
Data type	string.geo.metro

province_id

Field label	Province ID
Field type	dimension
Data type	int.number.value

province_name

Field label	Province name
Field type	dimension
Data type	string.geo.region

country_code

Field label	Country code
Field type	dimension
Data type	string.geo.country.twolettercode

country_name

Field label	Country
Field type	dimension
Data type	string.geo.country

language

Field label	Language
Field type	dimension
Data type	string.language.locale

connection_type

Field label	Connection type
Field type	dimension
Data type	string.text.value

platform

Field label	Device platform
Description	Reports the OS platform that received impressions of your ads (iOS, Android, etc.)
Field type	dimension
Data type	string.text.value

placement

Field label	Placement
Description	Reports the apps that were served impressions of your ads
Field type	dimension
Data type	string.text.value

interest_category_name

Field label	Interest category
Field type	dimension
Data type	string.text.value

BASIC

impressions

Field label	Impressions
Description	The number of times your ads were on screen
Field type	metric
Data type	int.number.value

clicks

Field label	Clicks
Description	Number of clicks from your ads to a specified destination
Field type	metric
Data type	int.number.value

ctr

Field label	CTR
Description	The percentage of times people saw your ad and performed a click
Field type	metric
Data type	float.number.ratio

cost

Field label	Cost
Description	The estimated total amount of money you've spent on your campaign, ad group or ad in the currency of the advertising account
Field type	metric
Data type	float.currency.value

cost_eur

Field label	Cost (EUR)
Description	The estimated total amount of money you've spent on your campaign, ad group or ad converted to euros
Field type	metric
Data type	float.currency.value
Services	Currency conversion

cost_gbp

Field label	Cost (GBP)
Description	The estimated total amount of money you've spent on your campaign, ad group or ad converted to British pounds
Field type	metric
Data type	float.currency.value
Services	Currency conversion

cost_usd

Field label	Cost (USD)
Description	The estimated total amount of money you've spent on your campaign, ad group or ad converted to US dollars
Field type	metric
Data type	float.currency.value
Services	Currency conversion

cpc

Field label	CPC
Description	The average amount of money you've spent on a click
Field type	metric
Data type	float.currency.value

cpm

Field label	CPM
Description	The average amount of money you've spent per 1,000 impressions
Field type	metric
Data type	float.currency.value

BUSINESS CENTER

advertiser_owner_business_center_id

Field label	Business center ID
Description	ID of a Business Center that the ad account belongs to
Field type	dimension
Data type	string.text.value

business_center_name

Field label	Business center name
Description	Business Center name
Field type	dimension
Data type	string.text.value

business_center_company_name

Field label	Business center company name
Description	Business Center company name
Field type	dimension
Data type	string.text.value

business_center_currency

Field label	Business center currency
Description	Business Center currency
Field type	dimension
Data type	string.currency.code

business_center_timezone

Field label	Business center timezone
Description	Business Center timezone
Field type	dimension
Data type	string.time.timezone

business_center_registration_country_code

Field label	Business center registration country code
Description	Business Center registration country code
Field type	dimension
Data type	string.geo.country.twolettercode

business_center_registration_country

Field label	Business center registration country
Description	Business Center registration country
Field type	dimension
Data type	string.geo.country

business_center_type

Field label	Business center type
Description	Business Center type, values include: NORMAL, DIRECT, AGENCY, SELF_SERVICE, SELF_SERVICE_AGENCY
Field type	dimension
Data type	string.text.value

business_center_status

Field label	Business center status
Description	Business Center status, values include: REVIEWING, DENY, ENABLE, PUNISH
Field type	dimension
Data type	string.text.value

CAMPAIGN

campaign_name

Field label	Campaign name
Description	Name of the campaign
Field type	dimension
Data type	string.text.value

campaign_id

Field label	Campaign ID
Description	ID of the campaign
Field type	dimension
Data type	string.text.value

campaign_type

Field label	Campaign type
Description	Type of the campaign
Field type	dimension
Data type	string.text.value

campaign_budget

Field label	Campaign budget
Description	Budget of the campaign
Field type	dimension
Data type	float.currency.value

campaign_budget_mode

Field label	Campaign budget mode
Description	Budget of the campaign
Field type	dimension
Data type	string.text.value

campaign_status

Field label	Campaign status
Description	The status of the campaign
Field type	dimension
Data type	string.text.value

campaign_operation_status

Field label	Campaign operation status
Description	Operation status, values include: DISABLE, ENABLE, DELETE
Field type	dimension
Data type	string.text.value

campaign_objective_type

Field label	Campaign objective type
Field type	dimension
Data type	string.text.value

campaign_rf_campaign_type

Field label	Campaign RF type
Description	When objective type is specified as RF_REACH, this field shows whether the campaign has been set as a TikTok Pulse campaign. Values: STANDARD (Reach & Frequency campaign), PULSE (TikTok Pulse campaign)
Field type	dimension
Data type	string.text.value

campaign_creation_date

Field label	Campaign creation date
Field type	dimension
Data type	string.time.date

campaign_modify_date

Field label	Campaign modify date
Field type	dimension
Data type	string.time.date

CONVERSION

external_action

Field label	Conversion event
Description	Name of the shallow external action conversion event
Field type	dimension
Data type	string.text.value

deep_external_action

Field label	Deep conversion event
Description	Name of the deep external action conversion event
Field type	dimension
Data type	string.text.value

pixel_id

Field label	Pixel ID
Description	ID of the conversion pixel
Field type	dimension
Data type	string.text.value

results

Field label	Results
Description	The number of times your ad achieved an outcome, based on the optimization goal you selected. One campaign may have a number of different optimization goals. Calculated based on the time each ad impression occurred
Field type	metric
Data type	int.number.value

result_rate

Field label	Result rate
Description	The percentage of results you achieved out of all of the views/clicks on your ads. Calculated based on the time each ad impression occurred
Field type	metric
Data type	float.number.ratio

cost_per_result

Field label	Cost per result
Description	The average cost for each result from your ads. Calculated based on the time each ad impression occurred
Field type	metric
Data type	float.currency.value

real_time_results

Field label	Real-time results
Description	The number of times your ad achieved an outcome, based on the optimization goal you selected. One campaign may have a number of different optimization goals. Count is based on when the conversion actually happened
Field type	metric
Data type	int.number.value

real_time_result_rate

Field label	Real-time result rate
Description	The percentage of real-time results you achieved out of all of the views/clicks on your ads. Calculated based on when the conversion actually happened
Field type	metric
Data type	float.number.ratio

real_time_cost_per_result

Field label	Cost per real-time result
Description	The average cost for each real-time result from your ads. Calculated based on when the conversion actually happened
Field type	metric
Data type	float.currency.value

conversions

Field label	Conversions
Description	The number of times your ad achieved an outcome, based on the secondary goal you selected. One campaign may have a number of different secondary goals. Calculated based on the time each ad impression occurred
Field type	metric
Data type	int.number.value

conversion_rate

Field label	Conversion rate
Description	The percentage of results you received out of all the clicks of your ads. Calculated based on the time each ad impression occurred
Field type	metric
Data type	float.number.ratio

cost_per_conversion

Field label	Cost per conversion
Description	The average amount of money you've spent on a conversion (CPA). Calculated based on the time each ad impression occurred
Field type	metric
Data type	float.currency.value

real_time_conversions

Field label	Real-time conversions
Description	The number of times your ad achieved an outcome, based on the objective and settings you selected. Count is based on when the conversion actually happened
Field type	metric
Data type	int.number.value

real_time_conversion_rate

Field label	Real-time conversion rate
Description	The percentage of real-time conversions you received out of all the clicks of your ads. Calculated based on when the conversion actually happened
Field type	metric
Data type	float.number.ratio

cost_per_real_time_conversion

Field label	Cost per real-time conversion
Description	The average amount of money you've spent on a real-time conversion (Real-time CPA). Calculated based on when the conversion actually happened
Field type	metric
Data type	float.currency.value

secondary_goal_result

Field label	Secondary goal result
Description	The number of times your ad achieved an outcome, based on the secondary goal you selected. As one campaign may have a number of different secondary goals, this statistic is not supported for campaigns. Please go to ad groups or ads to view. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

cost_per_secondary_goal_result

Field label	Cost per secondary goal result
Description	The average cost for each secondary goal result from your adverts. As one campaign may have a number of different secondary goals, this statistic is not supported for campaigns. Please go to ad groups or ads to view. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	float.currency.value

skan_results

Field label	Results (SKAN)
Description	The number of times your ad achieved an outcome, based on the optimization goal you selected. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_result_rate

Field label	Result rate (SKAN)
Description	The percentage of results you achieved out of all of the views/clicks on your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.ratio

skan_cost_per_result

Field label	Cost per result (SKAN)
Description	The average cost for each result from your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_conversions

Field label	Conversions (SKAN)
Description	The number of times your ad achieved an outcome, based on the secondary goal you selected. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_conversion_rate

Field label	Conversion rate (SKAN)
Description	The percentage of results you received out of all the clicks of your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.ratio

skan_cost_per_conversion

Field label	Cost per conversion (SKAN)
Description	The average amount of money you've spent on a conversion (CPA). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

CREATIVE

video_thumbnail

Field label	Video thumbnail
Description	Thumbnail image for video creative
Field type	dimension
Data type	string.text.formula
Destinations	Google Sheets

video_thumbnail_url

Field label	Video thumbnail URL
Description	Thumbnail URL for video creative
Field type	dimension
Data type	string.text.url

creative_format

Field label	Creative format
Description	Creative format for ad media
Field type	dimension
Data type	string.text.value

DATASOURCE

dataSourceName

Field label	Data source
Description	The name of the source for this data, as listed on supermetrics.com/docs
Field type	dimension
Data type	string.text.value
Destinations	API, Data warehouse

system_metadata.data_source_logins

Field label	Data source logins
Description	The data source login accounts that were used to authenticate against the data source
Field type	dimension
Data type	string.text.json

system_metadata.data_source_login_owners

Field label	Data source login owners
Description	The Supermetrics users that created the data source login connections
Field type	dimension
Data type	string.text.json

DEPRECATED

keywords

Field label	Keywords
Description	An array of keywords to describe the app/website.
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2021-06-17

download_detail

Field label	Details page browse events (app download)
Description	The number of details page browse (app download) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

download_button

Field label	Button clicks (app download)
Description	The number of button click (app download) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

consultation

Field label	Consultation events
Description	The number of consultation events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

total_consultation_value

Field label	Total consultation value
Description	The total value returned from consultation events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

button_click_consultation

Field label	Button clicks (consultation)
Description	The number of button click (consultation) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

total_button_click_consultation_value

Field label	Total button click (consultation) value
Description	The total value returned from button click (consultation) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

page_browse_consultation

Field label	Details page browse events (consultation)
Description	The number of details page browse (consultation) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

total_page_browse_consultation_value

Field label	Total details page browse (consultation) value
Description	The total value returned from button click (consultation) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

total_form_button_value

Field label	Total button clicks (form) value
Description	The total value returned from button click (form) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

form_button

Field label	Button clicks (form)
Description	The number of button click (form) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

total_form_detail_value

Field label	Total details page browse (form) value
Description	The total value returned from details page browse (form) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

form_detail

Field label	Details page browse events (form)
Description	The number of details page browse (form) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

total_download_detail_value

Field label	Total details page browse (app download) value
Description	The total value returned from details page browse (app download) events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2023-02-02

ENGAGEMENT

profile_visits

Field label	Profile visits
Description	The number of profile visits the ad drove during the campaign
Field type	metric
Data type	int.number.value

likes

Field label	Paid likes
Description	The total amount of likes the ad received during the campaign
Field type	metric
Data type	int.number.value

comments

Field label	Paid comments
Description	The number of comments the ad received during the campaign
Field type	metric
Data type	int.number.value

Field label	Paid shares
Description	The number of shares the ad received during the campaign
Field type	metric
Data type	int.number.value

follows

Field label	Paid follows
Description	The number of new followers that were gained within 1 day of a user seeing a paid ad
Field type	metric
Data type	int.number.value

engagements

Field label	Clicks (All)
Description	The sum of all clickable interactions on your ads, including clicks led to advertiser-specified destinations and non-destination clicks from social actions and interactive experiences
Field type	metric
Data type	int.number.value

clicks_on_music_disc

Field label	Music clicks
Description	The number of clicks on the official music in your Spark Ads during the campaign
Field type	metric
Data type	int.number.value

duet_clicks

Field label	Duet clicks
Description	The number of clicks on the "Duet" button
Field type	metric
Data type	int.number.value

stitch_clicks

Field label	Stitch clicks
Description	The number of clicks on the "Stitch" button
Field type	metric
Data type	int.number.value

GMV MAX ADS

roi_protection_compensation_status

Field label	ROI protection compensation status
Description	The ROI protection compensation status of the campaign
Field type	dimension
Data type	string.text.value

gmv_max_ads_spend

Field label	GMV Max Ads spend
Description	The estimated total amount you've spent on your ads during its schedule
Field type	metric
Data type	float.currency.value

gmv_max_ads_billed_cost

Field label	GMV Max Ads billed cost
Description	The amount spent, excluding ad credit/coupons used
Field type	metric
Data type	float.currency.value

IN APP EVENT

real_time_app_install

Field label	Real-time app installs
Description	The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is based on when the conversion actually happened.)
Field type	metric
Data type	int.number.value

app_install

Field label	App installs
Description	The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

registration

Field label	Unique registrations
Description	The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

purchase

Field label	Unique purchases
Description	The number of unique purchases event occurred in your app that were recorded by your measurement partner. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

app_event_add_to_cart

Field label	Unique adds to cart
Description	The number of unique times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

checkout

Field label	Unique checkouts
Description	The number of unique times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

view_content

Field label	Unique content views
Description	The number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

next_day_open

Field label	Unique day 2 retentions
Description	The number of unique day 2 retentions in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

add_payment_info

Field label	Unique payment info additions
Description	The number of unique times a user added payment info in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

add_to_wishlist

Field label	Unique adds to wishlist
Description	The number of unique times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

launch_app

Field label	Unique app launches
Description	The number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

complete_tutorial

Field label	Unique tutorial completions
Description	The number of unique times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

create_group

Field label	Unique group creations
Description	The number of unique times a user created a group in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

join_group

Field label	Unique group joins
Description	The number of unique times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

create_gamerole

Field label	Unique role creations
Description	The number of unique times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

spend_credits

Field label	Unique credit spends
Description	The number of unique times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

achieve_level

Field label	Unique level achievements
Description	The number of unique times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

unlock_achievement

Field label	Unique achievement unlocks
Description	The number of unique times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

in_app_ad_click

Field label	Unique in-app ad clicks
Description	The number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

in_app_ad_impr

Field label	Unique in-app ad impressions
Description	The number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

loan_apply

Field label	Unique loan applications
Description	The number of unique times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

loan_credit

Field label	Unique loan approvals
Description	The number of unique times a user was approved a loan in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

loan_disbursement

Field label	Unique loan disbursements
Description	The number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

Field label	Unique logins
Description	The number of unique logins in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

Field label	Unique searches
Description	The number of unique searches in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

start_trial

Field label	Unique trial stats
Description	The number of unique times a user started a trial in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

Field label	Unique subscribes
Description	The number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)
Field type	metric
Data type	int.number.value

total_registration

Field label	Registrations events
Description	Registration (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_purchase

Field label	Purchase events
Description	Purchase (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_purchase_value

Field label	Total purchase value
Description	Total Purchase Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_app_event_add_to_cart

Field label	Add to cart events
Description	Add to Cart (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_app_event_add_to_cart_value

Field label	Total add to cart value
Description	Total Add to Cart Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

cost_per_total_app_event_add_to_cart

Field label	Cost per add to cart (in app)
Description	Cost per Add to Cart (The total count is based on when you were billed.)
Field type	metric
Data type	float.currency.value

total_checkout

Field label	Checkout events
Description	Checkout (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_checkout_value

Field label	Total checkout value
Description	Total Checkout Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_view_content

Field label	View content events
Description	View Content (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_view_content_value

Field label	Total view content value
Description	Total View Content Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_next_day_open

Field label	Day 2 retention events
Description	Day 2 Retention (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_add_payment_info

Field label	Add payment info events
Description	Add Payment Info (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_add_to_wishlist

Field label	Add to wishlist events
Description	Add to Wishlist (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_add_to_wishlist_value

Field label	Total add to wishlist value
Description	Total Add to Wishlist Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_launch_app

Field label	Launch app events
Description	Launch App (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_complete_tutorial

Field label	Complete tutorial events
Description	Complete Tutorial (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_complete_tutorial_value

Field label	Total complete tutorial value
Description	Total Complete Tutorial Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_create_group

Field label	Create group events
Description	Create Group (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_create_group_value

Field label	Total create group value
Description	Total Create Group Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_join_group

Field label	Join group events
Description	Join Group (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_join_group_value

Field label	Total join group value
Description	Total Join Group Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_create_gamerole

Field label	Create role events
Description	Create Role (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_create_gamerole_value

Field label	Total create role value
Description	Total Create Role Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_spend_credits

Field label	Spend credit events
Description	Spend Credit (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_spend_credits_value

Field label	Total spend credit value
Description	Total Spend Credit Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_achieve_level

Field label	Achieve level events
Description	Achieve Level (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_achieve_level_value

Field label	Total achieve level value
Description	Total Achieve Level Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_unlock_achievement

Field label	Unlock achievement events
Description	Unlock Achievement (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_unlock_achievement_value

Field label	Total unlock achievement value
Description	Total Unlock Achievement Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_in_app_ad_click

Field label	In-app ad clicks
Description	In App Ad Click (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_in_app_ad_click_value

Field label	Total in app ad click value
Description	Total In App Ad Click Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_in_app_ad_impr

Field label	In-app ad impressions
Description	In-app ad impressions (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_in_app_ad_impr_value

Field label	Total in-app ad impression value
Description	Total in-app ad impression value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_loan_apply

Field label	Loan apply events
Description	Loan Apply (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_loan_credit

Field label	Loan approval events
Description	Loan Approval (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_loan_disbursement

Field label	Loan disbursement events
Description	Loan Disbursement (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_login

Field label	Login events
Description	Login (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_search

Field label	Search events
Description	Search (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_start_trial

Field label	Start trial events
Description	Start Trial (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_subscribe

Field label	Subscribe events
Description	Subscribe (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_subscribe_value

Field label	Total subscribe value
Description	Total Subscribe Value (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

sales_lead

Field label	Unique generate lead
Description	The number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

total_sales_lead

Field label	Total generate lead
Description	Generate lead (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_sales_lead_value

Field label	Total generate lead value
Description	Total generate lead value (The total count is based on when you were billed.)
Field type	metric
Data type	float.currency.value

ratings

Field label	Unique rate
Description	The number of unique ratings in your mobile app that were recorded as app events and attributed to your ads
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

total_ratings

Field label	Total rate
Description	Rate (Total No.) (The total count is based on when you were billed.)
Field type	metric
Data type	int.number.value

total_ratings_value

Field label	Total rate value
Description	Total rate value (The total count is based on when you were billed.)
Field type	metric
Data type	float.currency.value

IN APP EVENT (SKAN)

skan_app_install

Field label	App Installs (SKAN)
Description	The number of times your mobile app was installed that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_registration

Field label	Unique registrations (SKAN)
Description	The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_registration

Field label	Registration events (SKAN)
Description	Registration (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_purchase

Field label	Unique purchases (SKAN)
Description	The number of unique purchases event occurred in your app that were recorded by your measurement partner. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_purchase

Field label	Purchase events (SKAN)
Description	Purchase (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_purchase_value

Field label	Total purchase value (SKAN)
Description	Total Purchase Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_add_to_cart

Field label	Unique adds to cart (SKAN)
Description	The number of unique times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_add_to_cart

Field label	Add to cart events (SKAN)
Description	Add to Cart (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_cost_per_total_add_to_cart

Field label	Cost per add to cart (SKAN)
Description	The average cost for each add to cart event that is attributed to your ads. The total count is based on when the events are returned through the SKAdNetwork API
Field type	metric
Data type	float.currency.value

skan_total_add_to_cart_value

Field label	Total add to cart value (SKAN)
Description	Total Add to Cart Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_checkout

Field label	Unique checkouts (SKAN)
Description	The number of unique times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_checkout

Field label	Checkout events (SKAN)
Description	Checkout (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_checkout_value

Field label	Total checkout value (SKAN)
Description	Total Checkout Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_view_content

Field label	Unique view content (SKAN)
Description	The number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_view_content

Field label	View content events (SKAN)
Description	View Content (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_view_content_value

Field label	Total view content value (SKAN)
Description	Total View Content Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_add_payment_info

Field label	Unique add payment info (SKAN)
Description	The number of unique times a user added payment info in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_add_payment_info

Field label	Add payment info events (SKAN)
Description	Add Payment Info (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_add_to_wishlist

Field label	Unique add to wishlist (SKAN)
Description	The number of unique times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_add_to_wishlist

Field label	Add to wishlist events (SKAN)
Description	Add to Wishlist (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_add_to_wishlist_value

Field label	Total add to wishlist value (SKAN)
Description	Total Add to Wishlist Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_launch_app

Field label	Unique launch app (SKAN)
Description	The number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_launch_app

Field label	Launch app events (SKAN)
Description	Launch App (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_complete_tutorial

Field label	Unique complete tutorial (SKAN)
Description	The number of unique times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_complete_tutorial

Field label	Complete tutorial events (SKAN)
Description	Complete Tutorial (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_complete_tutorial_value

Field label	Total complete tutorial value (SKAN)
Description	Total Complete Tutorial Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_create_group

Field label	Unique create group (SKAN)
Description	The number of unique times a user created a group in your mobile game app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_create_group

Field label	Create group events (SKAN)
Description	Create Group (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_create_group_value

Field label	Total create group value (SKAN)
Description	Total Create Group Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_join_group

Field label	Unique join group (SKAN)
Description	The number of unique times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_join_group

Field label	Join group events (SKAN)
Description	Join Group (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_join_group_value

Field label	Total join group value (SKAN)
Description	Total Join Group Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_create_gamerole

Field label	Unique create role (SKAN)
Description	The number of unique times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_create_gamerole

Field label	Create role events (SKAN)
Description	Create Role (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_create_gamerole_value

Field label	Total create role value (SKAN)
Description	Total Create Role Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_spend_credits

Field label	Unique spend credit (SKAN)
Description	The number of unique times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_spend_credits

Field label	Spend credit events (SKAN)
Description	Spend Credit (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_spend_credits_value

Field label	Total spend credit value (SKAN)
Description	Total Spend Credit Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_achieve_level

Field label	Unique achieve level (SKAN)
Description	The number of unique times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_achieve_level

Field label	Achieve level events (SKAN)
Description	Achieve Level (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_achieve_level_value

Field label	Total achieve level value (SKAN)
Description	Total Achieve Level Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_unlock_achievement

Field label	Unique unlock achievement (SKAN)
Description	The number of unique times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_unlock_achievement

Field label	Unlock achievement events (SKAN)
Description	Unlock Achievement (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_unlock_achievement_value

Field label	Total unlock achievement value (SKAN)
Description	Total Unlock Achievement Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_sales_lead

Field label	Unique generate lead (SKAN)
Description	The number of unique leads generated through your mobile app and are attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_sales_lead

Field label	Total generate lead events (SKAN)
Description	Generate Lead (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_sales_lead_value

Field label	Total generate lead value (SKAN)
Description	Total Generate Lead Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_in_app_ad_click

Field label	Unique in app ad click (SKAN)
Description	The number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_in_app_ad_click

Field label	In app ad click events (SKAN)
Description	In App Ad Click (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_in_app_ad_click_value

Field label	Total an app ad click value (SKAN)
Description	Total In App Ad Click Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_in_app_ad_impr

Field label	Unique in app ad impressions (SKAN)
Description	The number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_in_app_ad_impr

Field label	In app ad impressions events (SKAN)
Description	In-app ad impressions (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_in_app_ad_impr_value

Field label	Total in app ad impressions value (SKAN)
Description	Total in-app ad impression value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_loan_apply

Field label	Unique loan apply (SKAN)
Description	The number of unique times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_loan_apply

Field label	Loan apply event (SKAN)
Description	Loan Apply (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_loan_credit

Field label	Unique loan approval (SKAN)
Description	The number of unique times a user was approved a loan in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_loan_credit

Field label	Loan approval events (SKAN)
Description	Loan Approval (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_loan_disbursement

Field label	Unique loan disbursement (SKAN)
Description	The number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_loan_disbursement

Field label	Loan disbursement events (SKAN)
Description	Loan Disbursement (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_login

Field label	Unique logins (SKAN)
Description	The number of unique logins in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_login

Field label	Login events (SKAN)
Description	Login (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_ratings

Field label	Unique ratings (SKAN)
Description	The number of unique ratings in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_ratings

Field label	Rate events (SKAN)
Description	Rates (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_ratings_value

Field label	Total rate value (SKAN)
Description	Total rate value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

skan_search

Field label	Unique search (SKAN)
Description	The number of unique searches in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_search

Field label	Search events (SKAN)
Description	Search (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_start_trial

Field label	Unique start trial (SKAN)
Description	The number of unique times a user started a trial in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_start_trial

Field label	Start trial events (SKAN)
Description	Start Trial (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_subscribe

Field label	Unique subscribe (SKAN)
Description	The number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_subscribe

Field label	Subscribe events (SKAN)
Description	Subscribe (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	int.number.value

skan_total_subscribe_value

Field label	Total subscribe value (SKAN)
Description	Total Subscribe Value. SKAN metrics will only display values for iOS14 dedicated campaigns
Field type	metric
Data type	float.number.value

OFFLINE EVENT

offline_total_crm_events

Field label	CRM events
Description	Number of CRM events attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_crm_event

Field label	Cost per CRM event
Description	Average cost per CRM event. Calculated by Cost / CRM Events
Field type	metric
Data type	float.currency.value

offline_crm_event_rate

Field label	CRM event rate
Description	Percentage of CRM events out of all click events. Calculated by CRM events / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_crm_event

Field label	Value per CRM event
Description	Average value returned from each CRM event
Field type	metric
Data type	float.currency.value

offline_crm_event_value

Field label	CRM event value
Description	Total value returned from all CRM events
Field type	metric
Data type	float.currency.value

offline_purchase_events

Field label	Purchases (offline)
Description	The number of offline purchase actions attributed to your ad
Field type	metric
Data type	int.number.value

cost_per_offline_purchase

Field label	Cost per purchase (offline)
Description	The average cost per offline purchase action attributed to your ads. Calculated by Cost / Purchases (offline)
Field type	metric
Data type	float.currency.value

offline_purchase_rate

Field label	Unique purchase rate (offline)
Description	The percentage of offline purchase actions from all clicks attributed to your ads. Calculated by Purchases (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_purchase

Field label	Value per purchase (offline)
Description	The average value per offline purchase action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_purchase_value

Field label	Purchase value (offline)
Description	The total value of offline purchase actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_purchase_roas

Field label	Purchase ROAS (offline)
Description	The return on ad spend (ROAS) from offline purchase actions
Field type	metric
Data type	float.number.value

offline_contact_events

Field label	Contacts (offline)
Description	The number of offline contact actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_contact

Field label	Cost per contact (offline)
Description	The average cost per offline contact action attributed to your ads. Calculated by Cost / Contacts (offline)
Field type	metric
Data type	float.currency.value

offline_contact_rate

Field label	Unique contact rate (offline)
Description	The percentage of offline contact actions from all clicks attributed to your ads. Calculated by Contacts (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_contact

Field label	Value per contact (offline)
Description	The average value per offline contact action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_contact_value

Field label	Contact value (offline)
Description	The total value of offline contact actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_subscribe_events

Field label	Subscriptions (offline)
Description	The number of offline subscribe actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_subscribe

Field label	Cost per subscription (offline)
Description	The average cost per offline subscribe action attributed to your ads. Calculated by Cost / Subscriptions (offline)
Field type	metric
Data type	float.currency.value

offline_subscribe_rate

Field label	Unique subscription rate (offline)
Description	The percentage of offline subscribe actions from all clicks attributed to your ads. Calculated by Subscriptions (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_subscribe

Field label	Value per subscription (offline)
Description	The average value per offline subscribe action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_subscribe_value

Field label	Subscription value (offline)
Description	The total value of offline subscribe actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_form_submission_events

Field label	Form submissions (offline)
Description	The number of offline lead actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_form_submitted

Field label	Cost per form submitted (offline)
Description	The average cost per offline lead action attributed to your ads. Calculated by Forms submissions (offline)
Field type	metric
Data type	float.currency.value

offline_form_submission_rate

Field label	Unique form submission rate (offline)
Description	The percentage of offline lead actions from all clicks attributed to your ads. Calculated by Form submissions (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_form_submission

Field label	Value per form submitted (offline)
Description	The average value per offline lead attributed to your ads
Field type	metric
Data type	float.currency.value

offline_form_submission_value

Field label	Form submission value (offline)
Description	The total value of offline lead actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_add_payment_info_events

Field label	Payment info adds (offline)
Description	The number of offline add payment info actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_payment_info_added

Field label	Cost per payment info add (offline)
Description	The average cost per offline add payment info action attributed to your ads. Calculated by Cost / Payment info adds (offline)
Field type	metric
Data type	float.currency.value

offline_add_payment_info_rate

Field label	Unique payment info add rate (offline)
Description	The percentage of offline add payment info actions from all clicks attributed to your ads. Calculated by Payment info adds (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_add_payment_info

Field label	Value per payment info add (offline)
Description	The average value per offline add payment info action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_add_payment_info_value

Field label	Payment info add value (offline)
Description	The total value of offline add payment info actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_add_to_cart_events

Field label	Adds to cart (offline)
Description	The number of offline add to cart actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_add_to_cart

Field label	Cost per add to cart (offline)
Description	The average cost per offline add to cart action attributed to your ads. Calculated by Cost / Adds to cart (offline)
Field type	metric
Data type	float.currency.value

offline_add_to_cart_rate

Field label	Unique add to cart rate (offline)
Description	The percentage of offline add to cart actions from all clicks attributed to your ads. Calculated by Adds to cart (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_add_to_cart

Field label	Value per add to cart (offline)
Description	The average value per offline add to cart action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_add_to_cart_value

Field label	Add to cart value (offline)
Description	The total value of offline add to cart actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_add_to_wishlist_events

Field label	Adds to wishlist (offline)
Description	The number of offline add to wishlist actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_add_to_wishlist

Field label	Cost per add to wishlist (offline)
Description	The average cost per offline add to wishlist action attributed to your ads. Calculated by Cost / Adds to wishlist (offline)
Field type	metric
Data type	float.currency.value

offline_add_to_wishlist_rate

Field label	Unique add to wishlist rate (offline)
Description	The percentage of offline add to wishlist actions from all clicks attributed to your ads. Calculated by Adds to wishlist (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_add_to_wishlist

Field label	Value per add to wishlist (offline)
Description	The average value per offline add to wishlist action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_add_to_wishlist_value

Field label	Add to wishlist value (offline)
Description	The total value of offline add to wishlist actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_click_button_events

Field label	Button clicks (offline)
Description	The number of offline click button actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_button_click

Field label	Cost per button click (offline)
Description	The average cost per offline click button action attributed to your ads. Calculated by Cost / Button clicks (offline)
Field type	metric
Data type	float.currency.value

offline_click_button_rate

Field label	Unique button click rate (offline)
Description	The percentage of offline click button actions from all clicks attributed to your ads. Calculated by Button clicks (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_click_button

Field label	Value per button click (offline)
Description	The average value per offline click button action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_click_button_value

Field label	Button click value (offline)
Description	The total value of offline click button actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_complete_registration_events

Field label	Registrations (offline)
Description	The number of offline complete registration actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_registration

Field label	Cost per registration (offline)
Description	The average cost per offline complete registration action attributed to your ads. Calculated by Cost / Registrations (offline)
Field type	metric
Data type	float.currency.value

offline_complete_registration_rate

Field label	Unique registration rate (offline)
Description	The percentage of offline complete registration actions from all clicks attributed to your ads. Calculated by Registrations (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_registration

Field label	Value per registration (offline)
Description	The average value per offline complete registration action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_registration_value

Field label	Registration value (offline)
Description	The total value of offline complete registration actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_download_events

Field label	Downloads (offline)
Description	The number of offline download actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_download

Field label	Cost per download (offline)
Description	The average cost per offline download action attributed to your ads. Calculated by Cost / Downloads (offline)
Field type	metric
Data type	float.currency.value

offline_download_rate

Field label	Unique download rate (offline)
Description	The percentage of offline download actions from all clicks attributed to your ads. Calculated by Downloads (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_download

Field label	Value per download (offline)
Description	The average value per offline download action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_download_value

Field label	Download value (offline)
Description	The total value of offline download actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_initiate_checkout_events

Field label	Checkouts initiated (offline)
Description	The number of offline initiate checkout actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_checkout_initiated

Field label	Cost per checkout initiated (offline)
Description	The average cost per offline initiate checkout action attributed to your ads. Calculated by Cost / Checkouts initated (offline)
Field type	metric
Data type	float.currency.value

offline_initiate_checkout_rate

Field label	Unique checkout initiation rate (offline)
Description	The percentage of offline initiate checkout actions from all clicks attributed to your ads. Calculated by Checkouts initiated (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_initiate_checkout

Field label	Value per checkout initiated (offline)
Description	The average value per offline initiate checkout action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_initiate_checkout_value

Field label	Checkout initiation value (offline)
Description	The total value of offline initiate checkout actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_place_order_events

Field label	Orders placed (offline)
Description	The number of offline place order actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_order_placed

Field label	Cost per order placed (offline)
Description	The average cost per offline place order action attributed to your ads. Calculated by Cost / Orders placed (offline)
Field type	metric
Data type	float.currency.value

offline_place_order_rate

Field label	Unique orders placed rate (offline)
Description	The percentage of offline place order actions from all clicks attributed to your ads. Calculated by Orders placed (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_placed_order

Field label	Value per order placed (offline)
Description	The average value per offline place order action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_place_order_value

Field label	Orders placed value (offline)
Description	The total value of offline place order actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_search_events

Field label	Searches (offline)
Description	The number of offline search actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_search

Field label	Cost per search (offline)
Description	The average cost per offline search action attributed to your ads. Calculated by Cost / Searches (offline)
Field type	metric
Data type	float.currency.value

offline_search_rate

Field label	Unique search rate (offline)
Description	The percentage of offline search actions from all clicks attributed to your ads. Calculated by Searches (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_search

Field label	Value per search (offline)
Description	The average value per offline search action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_search_value

Field label	Search value (offline)
Description	The total value of offline search actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_view_content_events

Field label	Content views (offline)
Description	The number of offline view content actions attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_content_view

Field label	Cost per content view (offline)
Description	The average cost per offline view content action attributed to your ads. Calculated by Cost / Content views (offline)
Field type	metric
Data type	float.currency.value

offline_view_content_rate

Field label	Unique content view rate (offline)
Description	The percentage of offline view content actions from all clicks attributed to your ads. Calculated by calc - Content views (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_content_view

Field label	Value per content view (offline)
Description	The average value per offline view content action attributed to your ads
Field type	metric
Data type	float.currency.value

offline_view_content_value

Field label	Content view value (offline)
Description	The total value of offline view content actions attributed to your ads
Field type	metric
Data type	float.currency.value

offline_preferred_leads

Field label	Preferred leads (offline)
Description	Number of preferred leads events attributed to your TikTok ads
Field type	metric
Data type	int.number.value

cost_per_offline_perferred_lead

Field label	Cost per preferred leads (offline)
Description	Average cost per preferred lead event attributed to your TikTok ads. Calculated by Cost / Perferred leads (offline)
Field type	metric
Data type	float.currency.value

offline_preferred_lead_rate

Field label	Preferred leads rate (offline)
Description	Percentage of preferred leads events out of all click events attributed to your TikTok ads. Calculated by Perferred leads (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_total_find_location

Field label	Total find location (offline)
Description	The number of offline find location events attributed to your TikTok ads
Field type	metric
Data type	int.number.value

cost_per_offline_find_location

Field label	Cost per find location (offline)
Description	The average cost of each offline find location event attributed to your TikTok ads. Calculated by Cost / Total find location (offline)
Field type	metric
Data type	float.currency.value

offline_find_location_rate

Field label	Find location rate (offline)
Description	The percentage of offline find location events out of all click events attributed to your TikTok ads. Calculated by Total find location (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_find_location

Field label	Value per find location (offline)
Description	The average value returned offline from each find location event attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

offline_total_find_location_value

Field label	Total find location value (offline)
Description	The total value returned from all offline find location events attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

offline_total_schedule

Field label	Total schedule (offline)
Description	The number of offline schedule events attributed to your TikTok ads
Field type	metric
Data type	int.number.value

cost_per_offline_schedule

Field label	Cost per schedule (offline)
Description	The average cost of each offline schedule event attributed to your TikTok ads. Calculated by Cost / Total schedule (offline)
Field type	metric
Data type	float.currency.value

offline_schedule_rate

Field label	Schedule rate (offline)
Description	The percentage of offline schedule events out of all click events attributed to your TikTok ads. Calculated by Total schedule (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_schedule

Field label	Value per schedule (offline)
Description	The average value returned from each offline schedule event attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

offline_total_schedule_value

Field label	Total schedule value (offline)
Description	The total value returned from all offline schedule events attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

offline_total_customize_product

Field label	Total customize product (offline)
Description	The number of offline customize product events attributed to your TikTok ads
Field type	metric
Data type	int.number.value

cost_per_offline_customized_product

Field label	Cost per customize product (offline)
Description	The average cost of each offline customize product event attributed to your TikTok ads. Calculated by Cost / Total customized product (offline)
Field type	metric
Data type	float.currency.value

offline_customize_product_rate

Field label	Customize product rate (offline)
Description	The percentage of offline customize product events out of all click events attributed to your TikTok ads. Calculated by Total customized products (offline) / Clicks
Field type	metric
Data type	float.number.ratio

offline_value_per_customized_product

Field label	Value per customize product (offline)
Description	The average value returned from each offline customize product event attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

offline_total_customize_product_value

Field label	Total customize product value (offline)
Description	The total value returned from all offline customize product events attributed to your TikTok ad
Field type	metric
Data type	float.currency.value

offline_total_custom_events

Field label	Custom events (offline)
Description	Number of custom offline events attributed to your ads
Field type	metric
Data type	int.number.value

cost_per_offline_custom_event

Field label	Cost per custom event (offline)
Description	Average cost per custom offline event attributed to your ads. Calculated by Cost / Custom events (offline)
Field type	metric
Data type	float.currency.value

offline_custom_event_rate

Field label	Custom event rate (offline)
Description	Percentage of custom offline events from all clicks attributed to your ads. Calculated by Custom events (offline) / Click
Field type	metric
Data type	float.number.ratio

offline_value_per_custom_event

Field label	Value per custom event (offline)
Description	Average value per custom offline event attributed to your ads
Field type	metric
Data type	float.currency.value

offline_total_custom_event_value

Field label	Custom event value (offline)
Description	Total value of custom offline events attributed to your ads
Field type	metric
Data type	float.currency.value

ONSITE EVENT

onsite_shopping_roas

Field label	Complete payment ROAS (onsite)
Description	The total return on ad spend (ROAS) from complete payment events that are attributed to your ads on TikTok Store
Field type	metric
Data type	float.number.ratio
Aggregation	Non-aggregatable metric

onsite_shopping

Field label	Complete payment (onsite)
Description	The number of complete payment events on TikTok Store
Field type	metric
Data type	int.number.value

cost_per_onsite_shopping

Field label	Cost per complete payment (onsite)
Description	The average cost of each 'Complete Payment' event attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

total_onsite_shopping_value

Field label	Total complete payment value (onsite)
Description	The total value returned from 'Complete Payment' events attributed to your TikTok ads
Field type	metric
Data type	int.number.value

onsite_initiate_checkout

Field label	Initiate checkout (onsite)
Description	The number of initiate checkout events on TikTok Store
Field type	metric
Data type	int.number.value

onsite_on_web_detail

Field label	Product details page view (onsite)
Description	The number of product details page view events on TikTok Store
Field type	metric
Data type	int.number.value

onsite_add_to_wishlist

Field label	Add to wishlist (onsite)
Description	The number of add to wishlist events on TikTok Store
Field type	metric
Data type	int.number.value

onsite_add_billing

Field label	Add billing (onsite)
Description	The number of add billing events on TikTok Store
Field type	metric
Data type	int.number.value

onsite_on_web_cart

Field label	Add to cart (onsite)
Description	The number of add to cart events on TikTok Store
Field type	metric
Data type	int.number.value

cost_per_onsite_on_web_cart

Field label	Cost per add to cart (onsite)
Description	The average cost of each 'Add to Cart' event attributed to your TikTok ads
Field type	metric
Data type	float.currency.value

total_onsite_on_web_cart_value

Field label	Total add to cart value (onsite)
Description	The total value returned from 'Add to Cart' events attributed to your TikTok ads
Field type	metric
Data type	int.number.value

onsite_form

Field label	Form submission (onsite)
Description	The number of form submission events on Leads Generation page
Field type	metric
Data type	int.number.value

onsite_download_start

Field label	App store click (onsite)
Description	The number of app store click events on App Profile Page
Field type	metric
Data type	int.number.value

onsite_total_page_views

Field label	Total page views (onsite)
Description	The number of page view events on Instant Experience pages (App Profile Page, Collection Ads, TikTok Instant Page, Leads Generatio Ads)
Field type	metric
Data type	int.number.value

onsite_total_product_clicks

Field label	Call-to-Action button clicks (onsite)
Description	The number of call-to-action button click events on Instant Experience pages (App Profile Page, Collection Ads, TikTok Instant Page, Leads Generatio Ads)
Field type	metric
Data type	int.number.value

onsite_button_clicks

Field label	Total product clicks (onsite)
Description	The number of product click events on Instant Experience pages (App Profile Page, Collection Ads, TikTok Instant Page, Leads Generation Ads)
Field type	metric
Data type	int.number.value

PAGE EVENT

complete_payment_roas

Field label	Complete payment ROAS
Description	The total return on ad spend (ROAS) from complete payment events that are attributed to your ads
Field type	metric
Data type	float.currency.value
Aggregation	Non-aggregatable metric

complete_payment

Field label	Complete payment events
Description	The number of complete payment events
Field type	metric
Data type	int.number.value

total_complete_payment_rate

Field label	Total complete payment value
Description	The total value returned from complete payment events
Field type	metric
Data type	float.currency.value

total_landing_page_view

Field label	Total landing page view
Description	The number of landing page view events from your ads
Field type	metric
Data type	int.number.value

cost_per_landing_page_view

Field label	Cost per landing page view
Description	The average cost of each landing page view event
Field type	metric
Data type	float.currency.value

landing_page_view_rate

Field label	Landing page view rate
Description	The percentage of click events that are landing page view events
Field type	metric
Data type	float.number.percentage

cost_per_web_event_add_to_cart

Field label	Cost per add to cart
Description	The average cost of each add to cart event
Field type	metric
Data type	float.currency.value

page_browse_view

Field label	Page browse events
Description	The number of page browse events
Field type	metric
Data type	int.number.value

button_click

Field label	Button click events
Description	The number of button click events
Field type	metric
Data type	int.number.value

total_button_click_value

Field label	Total button click value
Description	The total value returned from button click events
Field type	metric
Data type	int.number.value

online_consult

Field label	Online consultation events
Description	The number of online consultation events
Field type	metric
Data type	int.number.value

total_online_consult_value

Field label	Total online consultation value
Description	The total value returned from online consultation events
Field type	metric
Data type	int.number.value

user_registration

Field label	User registrations
Description	The number of user registration events
Field type	metric
Data type	int.number.value

total_user_registration_value

Field label	Total user registration value
Description	The total value returned from user registration events
Field type	metric
Data type	int.number.value

page_content_view_events

Field label	Total page view content
Description	The number of product details page view events
Field type	metric
Data type	int.number.value

total_page_view_content_events_value

Field label	Total page view content value
Description	The total value returned from all view content events
Field type	metric
Data type	float.currency.value

cost_per_page_content_view_event

Field label	Cost per page view content
Description	The average cost of each product details page view event
Field type	metric
Data type	float.currency.value

product_details_page_browse

Field label	Product details page browse events
Description	The number of product details page browse events
Field type	metric
Data type	int.number.value

total_product_details_page_browse_value

Field label	Total product details page browse value
Description	The total value returned from product details page browse events
Field type	metric
Data type	int.number.value

web_event_add_to_cart

Field label	Add to cart events
Description	The number of add to cart events
Field type	metric
Data type	int.number.value

total_web_event_add_to_cart_value

Field label	Total add to cart value
Description	The total value returned from add to cart events
Field type	metric
Data type	int.number.value

on_web_order

Field label	Place an order events
Description	The number of place an order events
Field type	metric
Data type	int.number.value

total_on_web_order_value

Field label	Total place an order value
Description	The total value returned from place an order events
Field type	metric
Data type	int.number.value

form

Field label	Form submissions
Description	The number of form submission events
Field type	metric
Data type	int.number.value

total_form_value

Field label	Total form submission value
Description	The total value returned from form submission events
Field type	metric
Data type	int.number.value

download_start

Field label	Download button clicks
Description	The number of download button click events
Field type	metric
Data type	int.number.value

total_download_start_value

Field label	Total download button click value
Description	The total value returned from download button click events
Field type	metric
Data type	int.number.value

initiate_checkout

Field label	Checkout initiations
Description	The number of initiate checkout events
Field type	metric
Data type	int.number.value

total_initiate_checkout_value

Field label	Total initiate checkout value
Description	The total value returned from initiate checkout events
Field type	metric
Data type	int.number.value

add_billing

Field label	Add billing
Description	The number of add billing events
Field type	metric
Data type	int.number.value

total_add_billing_value

Field label	Total add billing value
Description	The total value returned from add billing events
Field type	metric
Data type	int.number.value

page_event_search

Field label	Search events
Description	The number of search events
Field type	metric
Data type	int.number.value

total_page_event_search_value

Field label	Total search value
Description	The total value returned from search events
Field type	metric
Data type	int.number.value

on_web_subscribe

Field label	Total subscribe
Description	The number of subscribe events that are attributed to your ads
Field type	metric
Data type	int.number.value

total_on_web_subscribe_value

Field label	Total subscribe value
Description	The total value returned from all subscribe events
Field type	metric
Data type	float.currency.value

cost_per_on_web_subscribe

Field label	Cost per subscribe
Description	The average cost of each subscribe event
Field type	metric
Data type	float.currency.value

on_web_subscribe_per_click

Field label	Subscribe rate (%)
Description	The percentage of subscribe events out of all click events
Field type	metric
Data type	float.number.percentage

value_per_on_web_subscribe

Field label	Value per subscribe
Description	The average value returned from each subscribe event
Field type	metric
Data type	float.currency.value

PROMOTED APP

tt_app_id

Field label	TikTok app ID
Description	TikTok App ID, the App ID you used when creating an Ad Group. Supported in Ad Group and Ad level. Returned if the promotion type of one Ad Group is App
Field type	dimension
Data type	string.text.value

tt_app_name

Field label	TikTok app name
Description	The name of your TikTok App. Supported in Ad Group and Ad level. Returned if the promotion type of one Ad Group is App
Field type	dimension
Data type	string.text.value

mobile_app_id

Field label	Mobile app ID
Description	Mobile App ID. Supported in Ad Group and Ad level. Returned if the promotion type of one Ad Group is App
Field type	dimension
Data type	string.text.value

app_name

Field label	Promoted app name
Description	The name of the promoted app
Field type	dimension
Data type	string.text.value

app_id

Field label	Promoted app ID
Description	The application ID of the promoted app
Field type	dimension
Data type	string.text.value

app_type

Field label	Promoted app type
Description	The type of the promoted app
Field type	dimension
Data type	string.text.value

app_download_url

Field label	Promoted app download URL
Description	The download URL of the promoted app
Field type	dimension
Data type	string.text.url

app_package

Field label	Promoted app package
Description	The package name of the promoted app
Field type	dimension
Data type	string.text.value

QUERY

system_metadata.query_date_range_start

Field label	Start date
Description	The start date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_date_range_end

Field label	End date
Description	The end date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_timezone

Field label	Timezone
Description	The timezone that is supplied to the query
Field type	dimension
Data type	string.time.timezone

system_metadata.query_filters

Field label	Filters
Description	All filters used in the query
Field type	dimension
Data type	string.text.json

system_metadata.query_date_start

Field label	Start
Description	When the query was started
Field type	dimension
Data type	string.time.datetime

system_metadata.query_date_end

Field label	End
Description	When the query completed
Field type	dimension
Data type	string.time.datetime

system_metadata.query_duration

Field label	Duration
Description	The duration in seconds of the query
Field type	dimension
Data type	int.duration.seconds

system_metadata.query_accounts

Field label	Accounts
Description	A list of accounts of which the data was pulled from
Field type	dimension
Data type	string.text.json

REACH

reach

Field label	Reach
Description	The number of unique users who saw your ads at least once. This metric is estimated
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

frequency

Field label	Frequency
Description	The average number times each unique user saw your ads. Calculated as impressions divided by reach. This metric is estimated
Field type	metric
Data type	float.number.value
Aggregation	Non-aggregatable metric

cost_per_1000_reached

Field label	Cost per 1,000 people reached
Description	The average cost to reach 1,000 unique users. This metric is estimated
Field type	metric
Data type	float.currency.value

TARGETING

audience_type

Field label	Audience type
Description	Audience type values: CUSTOM_AUDIENCE (Customize your audience), EXCLUDE_INTERACT_USERS (Exclude audience who have interacted with your App), INCLUDE_INTERACT_USERS (Include audience who have interacted with your App), INCLUDE_SPECIFIC_EVENTS (Include audience who satisfy specific audience_rule), EXCLUDE_SPECIFIC_EVENTS (Exclude audience who satisfy specific audience_rule)
Field type	dimension
Data type	string.text.value

audience_rule

Field label	Audience rule
Description	Audience targeting inclusion and exclusion rules
Field type	dimension
Data type	string.text.value

target_age

Field label	Age targeting
Description	List of targeted age groups
Field type	dimension
Data type	string.text.value

target_gender

Field label	Gender targeting
Description	Targeted gender
Field type	dimension
Data type	string.text.value

target_languages

Field label	Language targeting
Description	List of targeted languages
Field type	dimension
Data type	string.text.value

target_operation_system

Field label	Operating system targeting
Description	List of targeted operating systems
Field type	dimension
Data type	string.text.value

target_connection_type

Field label	Connection type targeting
Description	List of targeted connection types
Field type	dimension
Data type	string.text.value

target_device_price

Field label	Device price targeting
Description	Targeted device price in USD, for example: [0,300] represents price range is from $0 to $300
Field type	dimension
Data type	string.text.value

target_android_osv

Field label	Minimum Android version
Description	Targeted audience minimum Android version
Field type	dimension
Data type	string.text.value

target_ios_osv

Field label	Minimum iOS version
Description	Targeted audience minimum iOS version
Field type	dimension
Data type	string.text.value

TIME

today

Field label	Today
Description	Today's date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date
Destinations	API, Data warehouse

year

Field label	Year
Description	Year, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeek

Field label	Year of week (Sun-Sat)
Description	Year of week for US-style Sunday-Saturday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeekIso

Field label	Year of week (Mon-Sun)
Description	Year of week for ISO standard Monday-Sunday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearMonth

Field label	Year & month
Description	Year and month, e.g. 2017\|06
Field type	dimension
Data type	string.time.yearmonth

month

Field label	Month
Description	Month, e.g. 6
Field type	dimension
Data type	string.time.month

yearWeek

Field label	Year & week (Sun-Sat)
Description	Year and week for US-style Sunday-Saturday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweek

yearWeekIso

Field label	Year & week (Mon-Sun)
Description	Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweekiso

week

Field label	Week (Sun-Sat)
Description	US week number, e.g. 51
Field type	dimension
Data type	string.time.week

weekIso

Field label	Week (Mon-Sun)
Description	ISO week number, e.g. 51
Field type	dimension
Data type	string.time.weekiso

dayOfMonth

Field label	Day of month
Description	Day of month, e.g. 2
Field type	dimension
Data type	string.time.dayofmonth

dayOfWeekName

Field label	Day of week (Sun-Sat)
Description	Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday
Field type	dimension
Data type	string.time.dayofweek

dayOfWeekNameIso

Field label	Day of week (Mon-Sun)
Description	Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday
Field type	dimension
Data type	string.time.dayofweekiso

date

Field label	Date
Description	Date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date

hour

Field label	Hour
Description	Hour in a 24-hour clock, e.g. 18
Field type	dimension
Data type	string.time.hour

VIDEO

video_play_actions

Field label	Video views
Description	The number of times your video starts to play. Replays will not be counted
Field type	metric
Data type	int.number.value

video_watched_2s

Field label	2-second video views
Description	The number of times your video played for at least 2 seconds. Replays will not be counted
Field type	metric
Data type	int.number.value

video_watched_6s

Field label	6-second video views
Description	The number of times your video played for at least 6 seconds, or completely played. Replays will not be counted
Field type	metric
Data type	int.number.value

average_video_play

Field label	Avg watch time per video view
Description	The average time your video was played per single video view, including any time spent replaying the video
Field type	metric
Data type	float.number.value

average_video_play_per_user

Field label	Avg watch time per person
Description	The average time your video was played per person, including any time spent replaying the video. This metric is estimated
Field type	metric
Data type	float.number.value

video_views_p25

Field label	Video views at 25%
Description	The number of times your video was played at 25% of its length. Replays will not be counted
Field type	metric
Data type	int.number.value

video_views_p50

Field label	Video views at 50%
Description	The number of times your video was played at 50% of its length. Replays will not be counted
Field type	metric
Data type	int.number.value

video_views_p75

Field label	Video views at 75%
Description	The number of times your video was played at 75% of its length. Replays will not be counted
Field type	metric
Data type	int.number.value

video_views_p100

Field label	Video views at 100%
Description	The number of times your video was played at 100% of its length. Replays will not be counted
Field type	metric
Data type	int.number.value

engaged_view

Field label	6-second video views (focused view)
Description	The number of times your video has been played at least 6 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad. Engagements to be measured: Likes, shares, follows, profile visits, clicks, hashtag clicks, music clicks, anchor clicks, and interactive add-ons activity clicks
Field type	metric
Data type	int.number.value

engaged_view_15s

Field label	15-second video views (focused view)
Description	The number of times your video has been played at least 15 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad
Field type	metric
Data type	int.number.value