TikTok Ads fields

  • Updated on Sep 11, 2025
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your TikTok Ads data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

274 metrics152 dimensions

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

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
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
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
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
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_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
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_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_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
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
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
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
shares
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
login
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
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
subscribe
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

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