Documentation Index

Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

Kwai Ads metrics and dimensions

  • Updated on Mar 5, 2026
  • Published on Aug 5, 2025
Prev Next

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

75 metrics40 dimensions

25% VIDEO PLAY

video_plays_25
Field label Video plays at 25%
Description Number of video plays at 25%
Field type metric
Data type int.number.value
cost_per_video_plays_25
Field label Cost per 1,000 video plays at 25%
Description Cost per 1,000 video plays at 25%. Calculated as Cost / Video plays at 25% * 1000
Field type metric
Data type float.currency.value
video_plays_25_rate
Field label Video plays at 25% rate
Description Video plays at 25% rate. Calculated as Video plays at 25% / Impressions
Field type metric
Data type float.number.ratio

3-SECOND VIDEO PLAY

video_plays_3s
Field label 3-second video play
Description Number of video plays until 3 seconds
Field type metric
Data type int.number.value
cost_per_3s_play
Field label Cost per 1,000 3-second video play
Description Cost per 1,000 3-second video play. Calculated as Cost / 3-second video play * 1000
Field type metric
Data type float.currency.value
video_play_3s_rate
Field label 3-second video play rate
Description 3-second video play rate. Calculated as 3-second video play / Impressions
Field type metric
Data type float.number.ratio

5-SECOND VIDEO PLAY

video_plays_5s
Field label 5-second video play
Description Number of video plays until 5 seconds
Field type metric
Data type int.number.value
cost_per_5s_play
Field label Cost per 1,000 5-second video play
Description Cost per 1,000 5-second video play. Calculated as Cost / Video plays 5s * 1000
Field type metric
Data type float.currency.value
video_play_5s_rate
Field label 5-second video play rate
Description 5-second video play rate. Calculated as 5-second video play / Impressions
Field type metric
Data type float.number.ratio

50% VIDEO PLAY

video_plays_50
Field label Video plays at 50%
Description Number of video plays at 50%
Field type metric
Data type int.number.value
cost_per_video_plays_50
Field label Cost per 1,000 video plays at 50%
Description Cost per 1,000 video play at 50%. Calculated as Cost / Video plays at 50% * 1000
Field type metric
Data type float.currency.value
video_plays_50_rate
Field label Video plays at 50% rate
Description Video plays at 50% rate. Calculated as Video plays at 50% / Impressions
Field type metric
Data type float.number.ratio

75% VIDEO PLAY

video_plays_75
Field label Video plays at 75%
Description Number of video plays at 75%
Field type metric
Data type int.number.value
cost_per_video_plays_75
Field label Cost per 1,000 video plays at 75%
Description Cost per 1,000 video plays at 75%. Calculated as Cost / Video plays at 75% * 1000
Field type metric
Data type float.currency.value
video_plays_75_rate
Field label Video plays at 75% rate
Description Video plays at 75% rate. Calculated as Video plays at 75% / Impressions
Field type metric
Data type float.number.ratio

ACCOUNT

account_name
Field label Account name
Description The name of the account
Field type dimension
Data type string.text.value
account_id
Field label Account ID
Description The ID of the account
Field type dimension
Data type string.text.value
account_currency
Field label Account currency
Description The currency of the account
Field type dimension
Data type string.currency.code

AD

ad_name
Field label Ad name
Description The name of the ad
Field type dimension
Data type string.text.value
ad_id
Field label Ad ID
Description The ID of the ad
Field type dimension
Data type string.text.value
video_id
Field label Video ID
Description ID of the ad video
Field type dimension
Data type string.text.value

AD SET

ad_set_name
Field label Ad set name
Description The name of the ad set
Field type dimension
Data type string.text.value
ad_set_id
Field label Ad set ID
Description The ID of the ad set
Field type dimension
Data type string.text.value
app_name
Field label App name
Description The name of the app
Field type dimension
Data type string.text.value
app_id
Field label App ID
Description The ID of the app
Field type dimension
Data type string.text.value

BASIC

impressions
Field label Impressions
Description Number of impressions
Field type metric
Data type int.number.value
clicks
Field label Clicks
Description Number of clicks
Field type metric
Data type int.number.value
ctr
Field label CTR
Description Click-through rate. Calculated as Clicks / Impressions
Field type metric
Data type float.number.ratio
cost
Field label Cost
Description The total amount of cost (in USD)
Field type metric
Data type float.currency.value
cost_eur
Field label Cost (EUR)
Description The total amount of cost (converted to EUR)
Field type metric
Data type float.currency.value
Services Currency conversion
cost_gbp
Field label Cost (GBP)
Description The total amount of cost (converted to GBP)
Field type metric
Data type float.currency.value
Services Currency conversion
cpm
Field label CPM
Description Cost per 1000 impressions. Calculated as Cost / Impressions * 1000
Field type metric
Data type float.currency.value
cpc
Field label CPC
Description Cost per click. Calculated as Cost / Clicks
Field type metric
Data type float.currency.value
cpa
Field label CPA (Conv.)
Description The cost per conversion/acquisition. Calculated as Cost / Conversions (Conv.)
Field type metric
Data type float.currency.value
conversions
Field label Conversion (Conv.)
Description The total number of conversions attributed to your ads, based on the selected conversion goal
Field type metric
Data type int.number.value
conversion_rate
Field label CVR (Conv.)
Description The rate of conversions to clicks. Calculated as Conversions (Conv.) / Clicks
Field type metric
Data type float.number.ratio

CAMPAIGN

campaign_name
Field label Campaign name
Description The name of the campaign
Field type dimension
Data type string.text.value
campaign_id
Field label Campaign ID
Description The ID of the campaign
Field type dimension
Data type string.text.value

CONVERSION EVENT (CONV.)

registration
Field label Registration (Conv.)
Description The total number of registration events attributed to your ads
Field type metric
Data type int.number.value
cost_per_registration
Field label Cost per registration (Conv.)
Description The cost of each registration event. Calculated as Cost / Registration (Conv.)
Field type metric
Data type float.currency.value
registration_rate
Field label Registration rate (Conv.)
Description The percentage of registration events you received out of all the clicks of your ads. Calculated as Registration (Conv.) / Clicks
Field type metric
Data type float.number.ratio
add_to_cart
Field label Add to cart (Conv.)
Description The number of add to cart events attributed to your ads
Field type metric
Data type int.number.value
cost_per_add_to_cart
Field label Cost per add to cart (Conv.)
Description The cost of each add to cart event. Calculated as Cost / Add to cart (Conv.)
Field type metric
Data type int.number.value
add_to_cart_rate
Field label Add to cart rate (Conv.)
Description The percentage of add to cart events you received out of all the clicks of your ads. Calculated as Add to cart (Conv.) / Clicks
Field type metric
Data type float.number.ratio
activation
Field label Activation (Conv.)
Description The number of activation events attributed to your ads
Field type metric
Data type int.number.value
cost_per_activation
Field label Cost per activation (Conv.)
Description The cost of each activation event. Calculated as Cost / Activation (Conv.)
Field type metric
Data type float.currency.value
activation_rate
Field label Activation rate (Conv.)
Description The percentage of activation events you received out of all the clicks of your ads. Calculated as Activation (Conv.) / Clicks
Field type metric
Data type float.number.ratio
content_view
Field label Content view (Conv.)
Description The number of content view events attributed to your ads
Field type metric
Data type int.number.value
cost_per_content_view
Field label Cost per content view (Conv.)
Description The cost of each content view event. Calculated as Cost / Content view (Conv.)
Field type metric
Data type float.currency.value
content_view_rate
Field label Content view rate (Conv.)
Description The percentage of content view events you received out of all the clicks of your ads. Calculated as Content view (Conv.) / Clicks
Field type metric
Data type float.number.ratio
unique_purchase
Field label Unique purchase (Conv.)
Description The number of unique purchase events attributed to your ads
Field type metric
Data type int.number.value
cost_per_unique_purchase
Field label Cost per unique purchase (Conv.)
Description The cost of each unique purchase event. Calculated as Cost / Unique purchase (Conv.)
Field type metric
Data type float.currency.value
unique_purchase_rate
Field label Unique purchase rate (Conv.)
Description The percentage of unique purchase events you received out of all the clicks of your ads. Calculated as Unique purchase (Conv.) / Clicks
Field type metric
Data type float.number.ratio
total_purchase
Field label Total purchase (Conv.)
Description The number of total purchase events attributed to your ads
Field type metric
Data type int.number.value
cost_per_total_purchase
Field label Cost per total purchase (Conv.)
Description The cost of each total purchase event. Calculated as Cost / Total purchase (Conv.)
Field type metric
Data type float.currency.value
total_purchase_rate
Field label Total purchase rate (Conv.)
Description The percentage of total purchase events you received out of all the clicks of your ads. Calculated as Total purchase (Conv.) / Clicks
Field type metric
Data type float.number.ratio
total_day_one_retention
Field label Total day 1 retention (Conv.)
Description The number of total day 1 retention attributed activations by your ads
Field type metric
Data type int.number.value
total_day_one_retention_rate
Field label Total day 1 retention rate (Conv.)
Description The percentage of total day 1 retention events you received out of all the activations generated by your ads. Calculated as Total day 1 retention (Conv.) / Clicks
Field type metric
Data type float.number.ratio
total_day_one_retention_platform_attribution
Field label Total day 1 retention (platform attribution) (Conv.)
Description The number of total day 1 retention (platform attribution) attributed activations by your ads
Field type metric
Data type int.number.value
total_day_one_retention_platform_attribution_rate
Field label Total day 1 retention (platform attribution) rate (Conv.)
Description The percentage of total day 1 retention (platform attribution) events you received out of all the activations generated by your ads. Calculated as Total day 1 retention (platform attribution) (Conv.) / Clicks
Field type metric
Data type float.number.ratio
unique_content_view
Field label Unique content view (Conv.)
Description The number of unique content view events attributed to your ads
Field type metric
Data type int.number.value
unique_content_view_rate
Field label Unique content view rate (Conv.)
Description The percentage of unique content view events you received out of all the clicks of your ads. Calculated as Unique content view (Conv.) / Clicks
Field type metric
Data type float.number.ratio
unique_in_app_ad_view
Field label Unique in-app ad view (Conv.)
Description The number of unique in-app ad view attributed to your ads
Field type metric
Data type int.number.value
cost_per_unique_in_app_ad_view
Field label Cost per unique in-app ad view (Conv.)
Description The cost of each unique in-app ad view. Calculated as Cost / Unique in-app ad view (Conv.)
Field type metric
Data type float.currency.value
unique_in_app_ad_view_rate
Field label Unique in-app ad view rate (Conv.)
Description The percentage of unique in-app ad view events you received out of all the clicks of your ads. Calculated as Unique in-app ad view (Conv.) / Clicks
Field type metric
Data type float.number.ratio
in_app_ad_view
Field label In-app ad view (Conv.)
Description The number of in-app ad view events attributed to your ads
Field type metric
Data type int.number.value
cost_per_in_app_ad_view
Field label Cost per in-app ad view (Conv.)
Description The cost of each in-app ad view event. Calculated as Cost / In-app ad view (Conv.)
Field type metric
Data type float.currency.value
in_app_ad_view_rate
Field label In-app ad view rate (Conv.)
Description The percentage of in-app ad view events you received out of all the clicks of your ads. Calculated as In-app ad view (Conv.) / Clicks
Field type metric
Data type float.number.ratio
in_app_ad_click
Field label In-app ad click (Conv.)
Description The number of in-app ad click events attributed to your ads
Field type metric
Data type int.number.value
cost_per_in_app_ad_click
Field label Cost per in-app ad click (Conv.)
Description The cost of each in-app ad click event. Calculated as Cost / In-app ad click (Conv.)
Field type metric
Data type float.currency.value
in_app_ad_click_rate
Field label In-app ad click rate (Conv.)
Description The percentage of in-app ad click events you received out of all the clicks of your ads. Calculated as In-app ad click (Conv.) / Clicks
Field type metric
Data type float.number.ratio
unique_key_in_app_event
Field label Unique key in-app event (Conv.)
Description The number of unique key in-app events attributed to your ads
Field type metric
Data type int.number.value
cost_per_unique_key_in_app_event
Field label Cost per unique key in-app event (Conv.)
Description Cost per unique key in-app event conversion. Calculated as Cost / Unique key in-app event (Conv.)
Field type metric
Data type float.currency.value
unique_key_in_app_event_rate
Field label Unique key in-app event rate (Conv.)
Description The percentage of key in-app events you received out of all the clicks of your ads. Calculated as Unique key in-app event (Conv.) / Clicks
Field type metric
Data type float.number.ratio
key_in_app_event
Field label Key in-app event (Conv.)
Description The number of key in-app events attributed to your ads
Field type metric
Data type int.number.value
cost_per_key_in_app_event
Field label Cost per key in-app event (Conv.)
Description Cost per key in-app event conversion. Calculated as Cost / Key in-app event (Conv.)
Field type metric
Data type float.currency.value
key_in_app_event_rate
Field label Key in-app event rate (Conv.)
Description The percentage of key in-app events you received out of all the clicks of your ads. Calculated as Key in-app event (Conv.) / Clicks
Field type metric
Data type float.number.ratio
app_launch
Field label App launch (Conv.)
Description The number of app launch events attributed to your ads
Field type metric
Data type int.number.value
cost_per_app_launch
Field label Cost per app launch (Conv.)
Description The cost of each app launch event. Calculated as Cost / App launch (Conv.)
Field type metric
Data type float.currency.value
app_launch_rate
Field label App launch rate (Conv.)
Description The percentage of app launch events you received out of all the clicks of your ads. Calculated as App launch (Conv.) / Clicks
Field type metric
Data type float.number.ratio
unique_app_launch
Field label Unique app launch (Conv.)
Description The number of unique app launch events attributed to your ads
Field type metric
Data type int.number.value
cost_per_unique_app_launch
Field label Cost per unique app launch (Conv.)
Description The cost of each unique app launch event. Calculated as Cost / Unique app launch (Conv.)
Field type metric
Data type float.currency.value
unique_app_launch_rate
Field label Unique app launch rate (Conv.)
Description The percentage of unique app launch events you received out of all the clicks of your ads. Calculated as Unique app launch (Conv.) / Clicks
Field type metric
Data type float.number.ratio

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

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
system_metadata.query_excluded_accounts
Field label Excluded invalid accounts
Description A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting
Field type dimension
Data type string.text.json

TARGETING

country_code
Field label Country code
Description The country code
Field type dimension
Data type string.text.value
operating_system
Field label Operating system
Description Operating system (0=Unknown system, 1=iOS, 2=Android)
Field type dimension
Data type string.text.value

THRUPLAY

through_plays
Field label Through plays
Description For video 15 seconds or shorter, the number of times the video was played at 97%. For longer videos, the number of video plays to at least 15 unique seconds
Field type metric
Data type int.number.value
cost_per_through_plays
Field label Cost per 1,000 through plays
Description Cost Per 1,000 video through play
Field type metric
Data type float.currency.value
through_play_rate
Field label Through play rate
Description Video through play rate. Calculated as Through plays / Impressions
Field type metric
Data type float.number.ratio

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
Field type dimension
Data type string.time.year
year_of_week
Field label Year of week (Sun-Sat)
Field type dimension
Data type string.time.year
year_of_week_iso
Field label Year of week (Mon-Sun)
Field type dimension
Data type string.time.year
year_month
Field label Year & month
Field type dimension
Data type string.time.yearmonth
month
Field label Month
Field type dimension
Data type string.time.month
year_week_iso
Field label Year & week (Mon-Sun)
Field type dimension
Data type string.time.yearweekiso
week
Field label Week (Sun-Sat)
Field type dimension
Data type string.time.week
week_iso
Field label Week (Mon-Sun)
Field type dimension
Data type string.time.weekiso
day_of_month
Field label Day of month
Field type dimension
Data type string.time.dayofmonth
day_of_week_name
Field label Day of week (Sun-Sat)
Field type dimension
Data type string.time.dayofweek
day_of_week_name_iso
Field label Day of week (Mon-Sun)
Field type dimension
Data type string.time.dayofweekiso
date
Field label Date
Field type dimension
Data type string.time.date
atom
Field label Datetime
Field type dimension
Data type string.time.datetime

VIDEO PLAY

video_completions
Field label Video completions
Description Number of video played to its completion
Field type metric
Data type int.number.value

© Supermetrics 2025