Reference
Dimensions & Metrics
Every dimension and metric AskYourAds.app can pull, per platform. Use this when you're not sure what to ask, or when the chat couldn't match a term you used.
Loading…
Show
click to toggle
95 of 95 fields
| Name | Description | Type | Additive | Synonyms |
|---|---|---|---|---|
| ad_id | ad_id | Dimension | — | — |
| ad_name | ad_name | Dimension | — | ad, ads, ad name, ad names, ads names, creative, creatives |
| ad_status | ad_status | Dimension | — | ads statuses, ad statuses, ad state, ads states, ad states |
| ad_text | ad_text | Dimension | — | ad copy, ads copies, ad copies, creative text, creative texts, creatives texts |
| adgroup_id | adgroup_id | Dimension | — | — |
| adgroup_name | adgroup_name | Dimension | — | ad group, ad groups, ads groups, adgroup, adgroups, ad set, ad sets, ads sets, adset, adsets, ad group name, ads groups names, ad group names |
| adgroup_status | adgroup_status | Dimension | — | ads groups status, ad group status, ads groups statuses, ad group statuses, adsets status, adset status, adset statuses, adsets statuses |
| advertiser_id | advertiser_id | Dimension | — | advertiser, advertisers, account, accounts |
| age | age (TikTok Ads, AUDIENCE@AUCTION_CAMPAIGN@DAILY). Audience age bracket breakdown. Values: AGE_13_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45_54, AGE_55_PLUS. Only valid in AUDIENCE reports. | Dimension | — | age bracket, age brackets, ages brackets, age group, age groups, ages groups |
| campaign_id | campaign_id | Dimension | — | — |
| campaign_name | campaign_name | Dimension | — | campaign, campaigns, campaign name, campaigns names, campaign names |
| campaign_status | campaign_status | Dimension | — | campaigns statuses, campaign statuses, campaign state, campaigns states, campaign states |
| country_code | country_code (TikTok Ads, BASIC_BY_COUNTRY@AUCTION_AD@DAILY). ISO-3166 country code of the user. Only valid in AUDIENCE reports / *_by_country streams. | Dimension | — | country, countries, geo, geos, location, locations, market, markets |
| dpa_target_audience_type | dpa_target_audience_type | Dimension | — | — |
| event_name | event_name | Dimension | — | event, events, conversion event, conversion events, conversions events, key event, key events |
| event_source | event_source | Dimension | — | — |
| gender | gender (TikTok Ads, AUDIENCE@AUCTION_CAMPAIGN@DAILY). Audience gender breakdown. Values: MALE, FEMALE, UNKNOWN. Only valid in AUDIENCE reports. | Dimension | — | sex, genders |
| mobile_app_id | mobile_app_id (TikTok Ads, BASIC@AUCTION_AD@DAILY). Mobile app store id (App Store / Play Store). | Dimension | — | — |
| placement_type | placement_type (TikTok Ads, BASIC@AUCTION_AD@DAILY). Where the ad ran — TikTok, Pangle, etc. | Dimension | — | placement, placements, placement position, placement positions, placements positions |
| platform | platform (TikTok Ads, AUDIENCE_BY_PLATFORM@AUCTION_CAMPAIGN@DAILY). Platform breakdown — IOS, ANDROID, WEB. Only valid in AUDIENCE reports. | Dimension | — | platforms, device, devices, device type, device types, devices types, device platform, devices platforms, device platforms, os, operating system, operating systems |
| promotion_type | promotion_type | Dimension | — | objective, objectives, campaign objective, campaigns objectives, campaign objectives, promotion goal, promotion goals |
| province_id | province_id (TikTok Ads, AUDIENCE_BY_PROVINCE@AUCTION_AD@DAILY). Sub-national province / state id. Only valid in *_by_province streams. | Dimension | — | province, provinces, region, regions, state, states |
| stat_time_day | stat_time_day (TikTok Ads, BASIC@AUCTION_AD@DAILY). Daily timestamp. Date dimension. | Dimension | — | date, dates, day, days |
| stat_time_hour | stat_time_hour (TikTok Ads, BASIC@AUCTION_AD@HOURLY). Hourly timestamp. Hour dimension. | Dimension | — | hour, hours, time, times |
| tt_app_id | tt_app_id (TikTok Ads, BASIC@AUCTION_AD@DAILY). TikTok app id (in-app placement). | Dimension | — | — |
| tt_app_name | tt_app_name | Dimension | — | tiktok app, tiktok apps |
| average_video_play | average_video_play (TikTok Ads, BASIC@AUCTION_AD@DAILY). Average video play time per impression. | Metric |
No
duration_avg
|
avg video play, avg video plays, avg videos plays, average video plays, average videos plays |
| average_video_play_per_user | average_video_play_per_user (TikTok Ads, BASIC@AUCTION_AD@DAILY). Average video play time per unique user. | Metric |
No
duration_avg
|
avg video play per user, avg video plays per user, video play per user, video plays per user |
| cash_spend | cash_spend | Metric | Yes | cash cost, non-voucher spend |
| clicks | clicks (TikTok Ads, BASIC@AUCTION_AD@DAILY). Total clicks on the ad. | Metric | Yes | click, tap, taps, click count, clicks count |
| complete_payment | complete_payment (TikTok Ads, BASIC@AUCTION_AD@DAILY). Completed purchase events. Also called: purchases, sales. | Metric | Yes | completed purchase, completed purchases, completed payment, completed payments, checkout, checkouts |
| conversion | conversion | Metric | Yes | conversions, total conversion, total conversions |
| conversion_rate | conversion_rate (TikTok Ads, BASIC@AUCTION_AD@DAILY). Conversions ÷ clicks. Recompute from summed numerator/denominator across rows. | Metric |
No
ratio
|
cvr, conversion percentage, conversions percentages, conversion percentages, conversion ratio, conversions ratios, conversion ratios |
| cost_per_1000_reached | cost_per_1000_reached (TikTok Ads, BASIC@AUCTION_AD@DAILY). Cost per 1000 unique people reached. | Metric |
No
ratio
|
cost per thousand reach, cpr, cost per 1000 users |
| cost_per_app_install | cost_per_app_install | Metric |
No
ratio
|
cpi, cost per install, cost per installs |
| cost_per_conversion | cost_per_conversion (TikTok Ads, BASIC@AUCTION_AD@DAILY). CPA — cost per conversion / cost per acquisition. | Metric |
No
ratio
|
cpa, cost per acquisition, cost / conv., cost per conv |
| cost_per_purchase | cost_per_purchase | Metric |
No
ratio
|
cost per purchase, cost per purchases |
| cost_per_registration | cost_per_registration | Metric |
No
ratio
|
cost per registration, cost per registrations, cost per signup, cost per signups, cost per sign-up, cost per sign-ups |
| cost_per_result | cost_per_result (TikTok Ads, BASIC@AUCTION_AD@DAILY). Cost per result (the optimization event of the campaign). | Metric |
No
ratio
|
cost per result, cost per results |
| cost_per_sales_lead | cost_per_sales_lead | Metric |
No
ratio
|
cost per lead, cost per leads, cpl |
| cost_per_secondary_goal_result | cost_per_secondary_goal_result | Metric |
No
ratio
|
— |
| cost_per_total_app_event_add_to_cart | cost_per_total_app_event_add_to_cart | Metric |
No
ratio
|
cost per add to cart, cost per atc, cpc add to cart |
| cost_per_total_sales_lead | cost_per_total_sales_lead | Metric |
No
ratio
|
cost per total lead, cost per total leads, cost per lead total |
| cpc | cpc (TikTok Ads, BASIC@AUCTION_AD@DAILY). Cost per click. Average cost paid per ad click. | Metric |
No
ratio
|
cost per click, cost per clicks, average cpc, avg cpc |
| cpm | cpm (TikTok Ads, BASIC@AUCTION_AD@DAILY). Cost per mille (per thousand impressions). | Metric |
No
ratio
|
cost per mille, cost per thousand impressions, cost per thousand impression |
| cta_conversion | cta_conversion | Metric | Yes | click-through conversion, click-through conversions, click-through attribution conversion, click-through attribution conversions |
| cta_purchase | cta_purchase | Metric | Yes | click-through purchase, click-through purchases, click-through attribution purchase, click-through attribution purchases |
| ctr | ctr (TikTok Ads, BASIC@AUCTION_AD@DAILY). Click-through rate. Clicks ÷ impressions. | Metric |
No
ratio
|
click-through rate, click-through rates, click through rate, click through rates, clicks through rates, clickthrough rate, clickthrough rates |
| engaged_view | engaged_view | Metric | Yes | engaged views |
| engaged_view_15s | engaged_view_15s | Metric | Yes | 15 second engaged view, 15 second engaged views, 15s engaged view, 15s engaged views |
| engaged_view_through_conversions | engaged_view_through_conversions | Metric | Yes | evtc, engaged view through conversion, engaged views through conversions, engaged view through conversions |
| engagements | engagements | Metric | Yes | engagement, interaction, interactions, total engagement, total engagements |
| frequency | frequency (TikTok Ads, BASIC@AUCTION_AD@DAILY). Average impressions per unique user. impressions ÷ reach. | Metric |
No
ratio
|
freq, average frequency, avg frequency, frequencies |
| gross_impressions | gross_impressions | Metric | Yes | gross impression, gross impressions, raw impression, raw impressions |
| impressions | impressions (TikTok Ads, BASIC@AUCTION_AD@DAILY). Total times the ad was shown. | Metric | Yes | impression, ad impression, ad impressions, ads impressions, show, shows |
| onsite_shopping | onsite_shopping | Metric | Yes | onsite shopping event, onsite shopping events |
| paid_engaged_view | paid_engaged_view | Metric | Yes | paid engaged views |
| paid_engaged_view_15s | paid_engaged_view_15s | Metric | Yes | — |
| paid_engagement_engaged_view | paid_engagement_engaged_view | Metric | Yes | — |
| paid_engagement_engaged_view_15s | paid_engagement_engaged_view_15s | Metric | Yes | — |
| profile_visits_rate | profile_visits_rate | Metric |
No
ratio
|
profile visit rate, profile visit rates, profile visits rates, profile visits percentage |
| purchase | purchase (TikTok Ads, BASIC@AUCTION_AD@DAILY). Pixel purchase event. Synonym for complete_payment on Web Pixel. | Metric | Yes | purchases, pixel purchase, pixel purchases, purchase event, purchase events, purchases events |
| purchase_rate | purchase_rate | Metric |
No
ratio
|
purchase percentage, purchase ratio, purchase ratios, purchases ratios |
| reach | reach (TikTok Ads, BASIC@AUCTION_AD@DAILY). Unique users reached. Deduplicated count, not additive across days. | Metric |
No
dedup_count
|
unique user, unique users, unique reach, people reached |
| real_time_conversion | real_time_conversion | Metric | Yes | — |
| real_time_conversion_rate | real_time_conversion_rate | Metric |
No
ratio
|
— |
| real_time_cost_per_conversion | real_time_cost_per_conversion | Metric |
No
ratio
|
— |
| real_time_cost_per_result | real_time_cost_per_result | Metric |
No
ratio
|
— |
| real_time_result | real_time_result | Metric | Yes | — |
| real_time_result_rate | real_time_result_rate | Metric |
No
ratio
|
— |
| registration | registration | Metric | Yes | registrations, signup, signups, sign-up, sign-ups |
| registration_rate | registration_rate | Metric |
No
ratio
|
signup rate, signups rates, signup rates, sign-up rate, sign-up rates, registration percentage |
| result | result | Metric | Yes | results |
| result_rate | result_rate | Metric |
No
ratio
|
result percentage, result ratio, results ratios, result ratios |
| sales_lead | sales_lead | Metric | Yes | lead, leads, sales leads |
| sales_lead_rate | sales_lead_rate | Metric |
No
ratio
|
lead rate, lead rates, leads rates |
| secondary_goal_result | secondary_goal_result | Metric | Yes | — |
| secondary_goal_result_rate | secondary_goal_result_rate | Metric |
No
ratio
|
— |
| spend | spend (TikTok Ads, BASIC@AUCTION_AD@DAILY). Also called: cost, ad spend, total spend. | Metric | Yes | cost, ad spend, ad cost, money spent, amount spent |
| total_app_event_add_to_cart | total_app_event_add_to_cart | Metric | Yes | add to cart, atc, add-to-cart event, add-to-cart events |
| total_complete_payment_rate | total_complete_payment_rate (TikTok Ads, BASIC@AUCTION_AD@DAILY). Purchase rate — purchases ÷ clicks. | Metric |
No
ratio
|
purchase completion rate, purchases completions rates, purchase completion rates, payment completion rate, payment completions rates, payment completion rates |
| total_onsite_shopping_value | total_onsite_shopping_value | Metric | Yes | onsite shopping value, onsite shopping values, onsite revenue |
| total_pageview | total_pageview | Metric | Yes | pageview, pageviews, page view, page views, pages views, total pageviews |
| total_purchase_value | total_purchase_value | Metric | Yes | purchase value, purchases values, purchase values, revenue, purchase revenue |
| value_per_complete_payment | value_per_complete_payment (TikTok Ads, BASIC@AUCTION_AD@DAILY). Average order value (AOV). | Metric |
No
ratio
|
average purchase value, average purchases values, average purchase values, avg order value, avg orders values, avg order values, aov |
| video_play_actions | video_play_actions (TikTok Ads, BASIC@AUCTION_AD@DAILY). Total video plays. Also called: video views, video plays. | Metric | Yes | video view, video views, videos views, video play, videos plays, video plays, total video view, total videos views, total video views, total video play, total videos plays, total video plays |
| video_views_p100 | video_views_p100 (TikTok Ads, BASIC@AUCTION_AD@DAILY). Video views to 100% completion. Also called: completed views. | Metric | Yes | video completion, video completions, videos completions, completed video view, completed video views, completed videos views, video view to 100%, video views to 100%, video 100% |
| video_views_p25 | video_views_p25 (TikTok Ads, BASIC@AUCTION_AD@DAILY). Video views to 25% completion. | Metric | Yes | video view to 25%, video views to 25%, video 25%, video first quartile |
| video_views_p50 | video_views_p50 (TikTok Ads, BASIC@AUCTION_AD@DAILY). Video views to 50% completion. | Metric | Yes | video view to 50%, video views to 50%, video 50%, video midpoint, video second quartile |
| video_views_p75 | video_views_p75 (TikTok Ads, BASIC@AUCTION_AD@DAILY). Video views to 75% completion. | Metric | Yes | video view to 75%, video views to 75%, video 75%, video third quartile |
| video_watched_2s | video_watched_2s (TikTok Ads, BASIC@AUCTION_AD@DAILY). Number of times the video was played for at least 2 seconds. Also called: 2-second video plays, 2s views, video views 2s. | Metric | Yes | 2 second video view, 2 second videos views, 2 second video views, 2-second video view, 2-second videos views, 2-second video views, 2s video view, 2s video views, 2s videos views, 2 second video play, 2 second videos plays, 2 second video plays, 2-second video plays, 2s video plays |
| video_watched_6s | video_watched_6s (TikTok Ads, BASIC@AUCTION_AD@DAILY). Number of times the video was played for at least 6 seconds. Also called: 6-second video plays, 6s views, video views 6s. | Metric | Yes | 6 second video view, 6 second video views, 6 second videos views, 6-second video view, 6-second videos views, 6-second video views, 6s video view, 6s video views, 6s videos views, 6 second video play, 6 second video plays, 6 second videos plays, 6-second video plays, 6s video plays |
| voucher_spend | voucher_spend | Metric | Yes | voucher cost, credit spend |
| vta_conversion | vta_conversion | Metric | Yes | view-through conversion, view-through conversions, vtc, view through conversion, view through conversions, views through conversions |
| vta_purchase | vta_purchase | Metric | Yes | view-through purchase, view-through purchases, view through purchase, view through purchases, views through purchases |