Understanding the full landscape of TikTok Ads dimensions and metrics is essential for anyone running paid campaigns on the platform. Whether you're building custom dashboards, pulling data through the TikTok Marketing API, or simply trying to make sense of TikTok Ads Manager reports, knowing exactly what data is available — and what each field means — is the foundation of effective campaign optimization.
This guide provides a complete reference of every dimension and metric available in TikTok Ads as of 2026. We've organized them by category, included the API field names for developers and analysts, and added practical context on when and how to use each one. We also cover TikTok-specific features like Spark Ads metrics, TikTok Shop tracking, and interactive addon measurement.
What Are TikTok Ads Dimensions vs Metrics?
Before diving into the full reference, it's important to understand the difference between dimensions and metrics — two concepts that are often confused but serve fundamentally different purposes in advertising data.
Dimensions are descriptive attributes that define what you're looking at. They are the labels, categories, and identifiers that let you organize and filter your data. Examples include campaign name, ad group ID, targeting age range, placement, and country. Dimensions answer the question: "How do I want to slice this data?"
Metrics are quantitative measurements that tell you how things performed. They are the numbers: impressions, clicks, spend, conversions, CTR, CPC. Metrics answer the question: "What happened with my ads?"
Audience breakdowns are a special type of dimension that you can apply across any metric to segment performance. For example, you can break down your conversion metrics by age group, country, operating system, or device model to identify which segments drive the best results.
How Is TikTok Ads Data Structured?
TikTok Ads data follows a strict three-level hierarchy: Advertiser Account > Campaign > Ad Group > Ad. Each level inherits configuration from above and adds its own settings. Campaigns define the objective and budget type. Ad groups control targeting, placements, schedule, optimization, and bidding. Ads contain the creative content and tracking links. Metrics can be queried at any level — ad-level metrics roll up to ad group, campaign, and account totals.
The TikTok Marketing API returns dimensions as object fields and metrics through the Reporting API endpoint (/report/integrated/get/). Most metrics are available at all levels, while some dimensions are level-specific (e.g., targeting parameters only exist at the ad group level). The API organizes metrics into categories: basic metrics, video metrics, engagement metrics, conversion metrics, in-app event metrics, page event metrics, and interactive addon metrics.
Campaign-Level Dimensions
Campaign-level dimensions define the top-level structure of your advertising. These fields identify the campaign and its core configuration — objective, budget strategy, and status. Use these dimensions to organize reporting by campaign and understand the strategic setup behind your results.
| Dimension | API Field | Description |
|---|---|---|
| Campaign ID | campaign_id | Unique identifier for the campaign |
| Campaign Name | campaign_name | The name of the campaign as set by the advertiser |
| Objective Type | objective_type | Campaign goal: REACH, TRAFFIC, VIDEO_VIEWS, LEAD_GENERATION, COMMUNITY_INTERACTION, APP_PROMOTION, WEB_CONVERSIONS, PRODUCT_SALES, SHOP_PURCHASES |
| Campaign Budget | budget | Campaign-level budget amount in account currency (when Campaign Budget Optimization is enabled) |
| Budget Mode | budget_mode | How budget is allocated: BUDGET_MODE_DAY (daily) or BUDGET_MODE_TOTAL (lifetime) |
| Campaign Status | operation_status | Operational status: ENABLE, DISABLE, or DELETE |
| Secondary Status | secondary_status | Detailed delivery status: CAMPAIGN_STATUS_ENABLE, CAMPAIGN_STATUS_DISABLE, CAMPAIGN_STATUS_DELETE, CAMPAIGN_STATUS_BUDGET_EXCEED, etc. |
| Campaign Type | campaign_type | Indicates regular campaigns vs. Smart+ (automated) campaigns |
| Split Test Variable | split_test_variable | A/B test variable when the campaign is part of a split test: TARGETING, BIDDING_OPTIMIZATION, CREATIVE |
| App Promotion Type | app_promotion_type | For app campaigns: APP_INSTALL, APP_RETARGETING, APP_PRE_REGISTRATION |
| Special Industry | special_industries | Compliance declaration for regulated industries: HOUSING, EMPLOYMENT, CREDIT |
| Create Time | create_time | Timestamp when the campaign was first created (UTC) |
| Modify Time | modify_time | Timestamp of the last modification to the campaign (UTC) |
Ad Group-Level Dimensions
Ad group dimensions control who sees your ads, where they appear, when they run, and how they're optimized. This is the most configuration-heavy level in the TikTok Ads hierarchy, covering targeting, placement, scheduling, bidding, and optimization settings. In TikTok's structure, ad groups are equivalent to Meta's ad sets.
| Dimension | API Field | Description |
|---|---|---|
| Ad Group ID | adgroup_id | Unique identifier for the ad group |
| Ad Group Name | adgroup_name | Name of the ad group as defined by the advertiser |
| Placement Type | placement_type | PLACEMENT_TYPE_AUTOMATIC (recommended) or PLACEMENT_TYPE_NORMAL (manual selection) |
| Placements | placements | Selected placements: PLACEMENT_TIKTOK, PLACEMENT_PANGLE, PLACEMENT_GLOBAL_APP_BUNDLE |
| Target Age | age_groups | Targeted age ranges: AGE_13_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45_54, AGE_55_100 |
| Target Gender | gender | Gender targeting: GENDER_MALE, GENDER_FEMALE, or GENDER_UNLIMITED (all) |
| Interest Categories | interest_category_ids | TikTok interest-based targeting categories (e.g., Beauty, Fashion, Gaming, Food) |
| Interest Keywords | interest_keyword_ids | Keyword-based interest targeting for more granular audience definition |
| Target Locations | location_ids | Geographic targeting by country, region, state, DMA, or city IDs |
| Languages | languages | Language targeting by ISO language codes |
| Operating System | operating_systems | Device OS targeting: ANDROID, IOS, or both |
| Device Model | device_model_ids | Specific device model targeting (e.g., iPhone 15, Samsung Galaxy S24) |
| Network Types | network_types | Connection targeting: WIFI, 2G, 3G, 4G, 5G |
| Optimization Goal | optimization_goal | What TikTok optimizes delivery for: CLICK, CONVERT, INSTALL, REACH, VIDEO_VIEW, LEAD, ENGAGEMENT, SHOP_PURCHASE |
| Bid Strategy | bid_type | Bidding approach: BID_TYPE_NO_BID (lowest cost), BID_TYPE_CUSTOM (cost cap/bid cap) |
| Bid Amount | bid_price | Bid cap or target cost amount in account currency |
| Billing Event | billing_event | When you get charged: CPC, CPM, CPV, OCPM (optimized CPM) |
| Deep Bid Type | deep_bid_type | Secondary optimization for multi-event strategies: VO_MIN_ROAS (value optimization), DEEP_BID_DEFAULT (deep conversion) |
| Daily Budget | budget | Ad group-level budget amount in account currency |
| Budget Mode | budget_mode | BUDGET_MODE_DAY (daily) or BUDGET_MODE_TOTAL (lifetime) |
| Schedule Start | schedule_start_time | When the ad group begins delivering (UTC timestamp) |
| Schedule End | schedule_end_time | When the ad group stops delivering (UTC timestamp, null for continuous delivery) |
| Dayparting | dayparting | Hour-by-hour schedule defining when ads can deliver (48 half-hour slots per day) |
| Pixel ID | pixel_id | TikTok Pixel associated with the ad group for conversion tracking |
| Optimization Event | conversion_id | Specific pixel event optimized for: CompletePayment, AddToCart, ViewContent, etc. |
| App ID | app_id | Application ID for app promotion campaigns |
| Custom Audience | audience_ids | Custom audiences used for targeting (website visitors, app users, customer files) |
| Excluded Audience | excluded_audience_ids | Custom audiences excluded from targeting |
| Audience Type | audience_type | CUSTOM_AUDIENCE (include), EXCLUDED_AUDIENCE (exclude), or LOOKALIKE_AUDIENCE |
| Ad Group Status | operation_status | Operational status: ENABLE, DISABLE, or DELETE |
| Secondary Status | secondary_status | Detailed status: ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_BUDGET_EXCEED, ADGROUP_STATUS_AUDIT, ADGROUP_STATUS_REAUDIT, etc. |
Ad-Level Dimensions
Ad-level dimensions describe the individual ad unit — its identity, creative content, format, and configuration. These are critical for creative analysis, identifying which ad variations drive performance, and managing the creative lifecycle across your TikTok campaigns.
| Dimension | API Field | Description |
|---|---|---|
| Ad ID | ad_id | Unique identifier for the ad |
| Ad Name | ad_name | Name of the ad as set by the advertiser |
| Ad Format | ad_format | Creative format: SINGLE_VIDEO, SINGLE_IMAGE, CAROUSEL, COLLECTION, PLAYABLE, LIVE |
| Creative Type | creative_type | Whether using custom creative or dynamic creative optimization (DCO) |
| Identity Type | identity_type | Ad identity source: CUSTOMIZED_USER (custom), AUTH_CODE (Spark Ads via auth code), TT_USER (Spark Ads via TikTok account) |
| Landing Page URL | landing_page_url | Destination URL the ad links to on your website |
| Call to Action | call_to_action | CTA button text: SHOP_NOW, LEARN_MORE, SIGN_UP, DOWNLOAD, BOOK_NOW, CONTACT_US, APPLY_NOW, GET_QUOTE, SUBSCRIBE, ORDER_NOW |
| Display Name | display_name | Brand name displayed on the ad (for non-Spark Ads) |
| Profile Image | profile_image_url | Profile image URL displayed alongside the ad |
| Video ID | video_id | TikTok-assigned video asset identifier |
| Image IDs | image_ids | Image asset identifiers for image or carousel ads |
| Music ID | music_id | Commercial music library track ID used in the ad creative |
| Ad Text | ad_text | Primary text copy displayed with the ad creative |
| App Name | app_name | Application name displayed for app promotion ads |
| Tracking URL | click_tracking_url | Third-party click tracking URL for attribution partners |
| Impression Tracking URL | impression_tracking_url | Third-party impression tracking URL for verification |
| Deeplink | deeplink | App deep link URL for directing users to specific in-app content |
| Ad Status | operation_status | Operational status: ENABLE, DISABLE, or DELETE |
| Secondary Status | secondary_status | Detailed status: AD_STATUS_DELIVERY_OK, AD_STATUS_AUDIT, AD_STATUS_AUDIT_DENY, AD_STATUS_REAUDIT, AD_STATUS_BALANCE_EXCEED |
| Create Time | create_time | When the ad was first created (UTC) |
| Modify Time | modify_time | When the ad was last modified (UTC) |
Core Performance Metrics
These are the fundamental metrics that measure how your ads are delivered and interacted with. Every TikTok advertiser should understand these — they form the basis of all campaign analysis and optimization decisions. The TikTok Reporting API categorizes these as "basic" metrics.
| Metric | API Field | Description | Formula / Notes |
|---|---|---|---|
| Impressions | impressions | Number of times your ads were displayed on screen | Counts each time the ad is shown, including repeats to the same person |
| Reach | reach | Number of unique users who saw your ad at least once | Estimated metric. Cannot be summed across time periods — use the longest period |
| Frequency | frequency | Average number of times each person saw your ad | Impressions ÷ Reach |
| Amount Spent | spend | Estimated total money spent in account currency | Reported in the advertiser's account currency |
| Clicks | clicks | Total clicks on the ad including CTA, profile image, display name, and ad content | Broader than landing page clicks — includes all interactive elements |
| Landing Page Clicks | real_time_app_install_cost | Clicks that redirect users to your designated landing page | Use this for measuring actual traffic intent, not total clicks |
| CTR | ctr | Click-through rate based on total clicks | (Clicks ÷ Impressions) × 100 |
| CPC | cpc | Average cost per click | Spend ÷ Clicks |
| CPM | cpm | Cost per 1,000 impressions | (Spend ÷ Impressions) × 1,000 |
| Cost Per 1,000 Reach | cost_per_1000_reached | Cost per 1,000 unique users reached | (Spend ÷ Reach) × 1,000 |
| Results | result | Number of times your ad achieved an outcome based on the optimization goal | Maps to the ad group optimization goal (clicks, conversions, installs, views, etc.) |
| Cost Per Result | cost_per_result | Average cost per optimization goal outcome | Spend ÷ Results |
| Result Rate | result_rate | Percentage of impressions that resulted in an optimization goal outcome | (Results ÷ Impressions) × 100 |
| Real-Time Spend | real_time_cost | Spend data updated in near-real-time (vs. standard delayed reporting) | More current but may differ slightly from finalized spend |
Conversion Metrics
Conversion metrics measure the business outcomes driven by your TikTok ads — purchases, registrations, add-to-cart events, and other valuable actions. These are sourced from the TikTok Pixel, Events API, TikTok Shop, and app SDK events. TikTok organizes these into website events (page events), app events (in-app events), and shop events.
| Metric | API Field | Description | Formula / Notes |
|---|---|---|---|
| Conversions | conversion | Total conversion events from the pixel event selected as optimization goal | Aggregates all attributed events matching the ad group's optimization event |
| Conversion Rate | conversion_rate | Percentage of clicks that resulted in a conversion | (Conversions ÷ Clicks) × 100 |
| Cost Per Conversion | cost_per_conversion | Average cost per conversion event | Spend ÷ Conversions |
| Total Complete Payment | total_complete_payment | Number of completed purchase/payment events across all sources | Includes website pixel, Events API, and TikTok Shop purchases |
| Total Complete Payment Rate | total_complete_payment_rate | Rate of clicks resulting in completed payments | (Complete Payments ÷ Clicks) × 100 |
| Cost Per Complete Payment | cost_per_total_complete_payment | Average cost per completed purchase | Spend ÷ Total Complete Payments |
| Value Per Complete Payment | value_per_total_complete_payment | Average revenue per completed purchase | Total Purchase Value ÷ Total Complete Payments |
| Total Add to Cart | total_add_to_cart | Number of add-to-cart events across all sources | Tracked via pixel AddToCart event or TikTok Shop cart actions |
| Cost Per Add to Cart | cost_per_total_add_to_cart | Average cost per add-to-cart event | Spend ÷ Total Add to Cart |
| Total Initiate Checkout | total_initiate_checkout | Number of checkout initiation events across all sources | Tracked via pixel InitiateCheckout event |
| Cost Per Initiate Checkout | cost_per_total_initiate_checkout | Average cost per checkout initiation | Spend ÷ Total Initiate Checkout |
| Total Registration | total_registration | Number of registration/signup completion events | Tracked via pixel CompleteRegistration event |
| Cost Per Registration | cost_per_total_registration | Average cost per registration | Spend ÷ Total Registration |
| Total App Install | total_app_install | Number of mobile app installations attributed to ads | From app SDK events and mobile measurement partners (MMPs) |
| Cost Per App Install | cost_per_total_app_install | Average cost per app installation | Spend ÷ Total App Install |
| Total View Content | total_view_content | Number of content view events (product pages, landing pages) | Tracked via pixel ViewContent event |
| Total Add Payment Info | total_add_payment_info | Number of times users added payment information | Tracked via pixel AddPaymentInfo event |
| Total Add to Wishlist | total_add_to_wishlist | Number of times items were added to wishlists | Tracked via pixel AddToWishlist event |
| Total Search | total_search | Number of search events on your website | Tracked via pixel Search event |
| Total Subscribe | total_subscribe | Number of subscription events | Tracked via pixel Subscribe event |
| Total Form Submission | total_form_submission | Number of form submission events (lead gen, contact forms) | Tracked via pixel SubmitForm event or TikTok native lead forms |
| Value Per Conversion | value_per_conversion | Average value attributed to each conversion event | Total Conversion Value ÷ Conversions |
| ROAS | complete_payment_roas | Return on ad spend based on complete payment value | Total Complete Payment Value ÷ Spend |
Video & Engagement Metrics
Video metrics are central to TikTok advertising since virtually every ad on the platform is video-based. These metrics measure how users engage with your video content — from initial views through completion rates and social interactions. TikTok provides more granular video thresholds than most other platforms.
Video View Metrics
| Metric | API Field | Description |
|---|---|---|
| Video Views (2s) | video_play_actions | Times your video was played for at least 2 seconds or completed (whichever first), with 50%+ in view |
| Video Views (6s Focused) | video_watched_6s | Times your video was played for at least 6 focused seconds (TikTok's equivalent of Meta's ThruPlay) |
| Video Views (Full) | video_views_p100 | Times your video was played to 100% completion |
| Video Watched at 25% | video_views_p25 | Times your video was played through 25% of its length |
| Video Watched at 50% | video_views_p50 | Times your video was played through 50% of its length |
| Video Watched at 75% | video_views_p75 | Times your video was played through 75% of its length |
| Average Watch Time | average_video_play | Average time (in seconds) each person spent watching the video per impression |
| Average Watch Time Per View | average_video_play_per_user | Average watch time per unique video view, factoring in replays |
| Video Watched % | video_watched_rate | Average percentage of the video that was watched per impression |
| Cost Per 2s Video View | cost_per_video_play | Average cost per 2-second video view |
| Cost Per 6s Focused View | cost_per_video_watched_6s | Average cost per 6-second focused video view |
| Cost Per Full View | cost_per_video_views_p100 | Average cost per completed video view |
Engagement Metrics
| Metric | API Field | Description |
|---|---|---|
| Paid Likes | likes | Number of likes on your ad directly attributed to paid delivery |
| Paid Comments | comments | Number of comments on your ad attributed to paid delivery |
| Paid Shares | shares | Number of times your ad was shared attributed to paid delivery |
| Paid Follows | follows | New followers gained directly from ad interaction |
| Profile Visits | profile_visits | Number of times users visited your TikTok profile after seeing the ad |
| Engagement Rate | engagement_rate | Rate of total paid engagement interactions relative to impressions |
| Cost Per Like | cost_per_like | Average cost per paid like on your ad |
| Cost Per Comment | cost_per_comment | Average cost per paid comment on your ad |
| Cost Per Share | cost_per_share | Average cost per paid share of your ad |
| Cost Per Follow | cost_per_follow | Average cost per new follower from ad interaction |
| Cost Per Profile Visit | cost_per_profile_visit | Average cost per profile visit attributed to ads |
| Clicks on Music Disc | clicks_on_music_disc | Number of clicks on the music disc icon in your ad |
| Anchor Clicks | anchor_clicks | Clicks on interactive anchor components attached to the ad |
| Anchor CTR | anchor_click_rate | Click-through rate on interactive anchor components |
In-App Event Metrics
In-app event metrics track actions users take within your mobile app after interacting with your TikTok ads. These are sourced from the TikTok SDK, mobile measurement partners (MMPs like AppsFlyer, Adjust, or Branch), or server-to-server integrations. Essential for app promotion campaigns and measuring post-install behavior.
| Metric | API Field | Description |
|---|---|---|
| Real-Time App Install | real_time_app_install | App installations reported in near-real-time (before MMP deduplication) |
| Real-Time App Install Cost | real_time_app_install_cost | Cost per app install based on real-time data |
| App Event Optimization | app_event_optimization | In-app events matching the optimization event configured in the ad group |
| Cost Per App Event | cost_per_app_event_optimization | Average cost per in-app optimization event |
| In-App Purchase | in_app_purchase | Number of in-app purchases made post-install |
| In-App Purchase Value | in_app_purchase_value | Total revenue from in-app purchases attributed to ads |
| In-App Add to Cart | in_app_add_to_cart | Number of add-to-cart actions within the app |
| In-App Checkout | in_app_checkout | Number of checkout initiations within the app |
| In-App Registration | in_app_registration | Number of registration completions within the app |
| Deep Link Clicks | deep_link_clicks | Clicks that opened the app via deep link rather than app store |
| Download Start | download_start | Number of times app download began from the ad click |
| App Retention (Day 2) | retention_d2 | Users who opened the app on day 2 after install |
| App Retention (Day 7) | retention_d7 | Users who opened the app on day 7 after install |
| Lifetime Value (LTV) | app_ltv | Estimated lifetime revenue per user from app events |
Audience Breakdowns
Audience breakdowns are segmentation dimensions that let you split any metric by specific criteria. They answer questions like "Which age group converts best?", "Which operating system has the lowest CPC?", or "Which country drives the most revenue?" Apply these breakdowns in the TikTok Reporting API using thedimensions parameter alongside your metrics.
Age Breakdown
| Value | API Field | Description |
|---|---|---|
| AGE_13_17 | age | Users aged 13 to 17 (limited targeting in most markets) |
| AGE_18_24 | age | Users aged 18 to 24 — TikTok's largest demographic cohort |
| AGE_25_34 | age | Users aged 25 to 34 — fast-growing segment on TikTok |
| AGE_35_44 | age | Users aged 35 to 44 |
| AGE_45_54 | age | Users aged 45 to 54 |
| AGE_55_100 | age | Users aged 55 and older |
Gender Breakdown
| Value | API Field | Description |
|---|---|---|
| MALE | gender | Male users |
| FEMALE | gender | Female users |
| UNKNOWN | gender | Users who have not specified their gender |
Country / Region Breakdown
| Breakdown | API Field | Description |
|---|---|---|
| Country Code | country_code | Country by ISO 3166-1 alpha-2 code (US, GB, FR, JP, BR, etc.) |
| Province / State | province_id | State or province-level geographic breakdown |
| DMA | dma_id | Designated Market Area (US only) |
Language Breakdown
| Breakdown | API Field | Description |
|---|---|---|
| Language | language | User device language setting (en, es, fr, de, ja, ko, pt, etc.) |
Operating System Breakdown
| Value | API Field | Description |
|---|---|---|
| ANDROID | platform | Users on Android devices |
| IOS | platform | Users on iOS devices (iPhone, iPad) |
| OTHER | platform | Users on other platforms (rare, may include web) |
Device Model Breakdown
| Breakdown | API Field | Description |
|---|---|---|
| Device Brand | device_brand_id | Device manufacturer: Apple, Samsung, Xiaomi, Huawei, Oppo, etc. |
| Device Model | device_model_id | Specific device model for detailed hardware-level analysis |
| OS Version | os_version | Operating system version (e.g., iOS 18.1, Android 15) |
Placement / Position Breakdown
| Breakdown | API Field | Description |
|---|---|---|
| Placement | placement | Where the ad was shown: TikTok, Pangle, Global App Bundle |
| TikTok Position | ad_position | Position within TikTok: In-Feed, TopView, Search Results, Profile Feed, Following Feed |
Interest Category Breakdown
| Breakdown | API Field | Description |
|---|---|---|
| Interest Category | interest_category | TikTok interest taxonomy: Beauty & Personal Care, Fashion, Food & Beverage, Gaming, Travel, Tech & Electronics, Fitness, Education, etc. |
| Interest Category (L2) | interest_category_l2 | Second-level interest subcategory for more granular analysis |
TikTok-Specific Dimensions
TikTok offers several unique advertising features that generate dimensions and metrics not found on other platforms. Understanding these is critical for leveraging what makes TikTok advertising distinct — authentic creator content, in-app shopping, and interactive ad experiences.
Spark Ads vs Regular Ads
Spark Ads let you boost existing organic TikTok posts (your own or a creator's) as paid ads. This changes how engagement metrics are attributed and reported. Theidentity_type dimension at the ad level tells you whether an ad is a Spark Ad (AUTH_CODE or TT_USER) or a regular custom ad (CUSTOMIZED_USER).
| Dimension / Metric | API Field | Description |
|---|---|---|
| Identity Type | identity_type | CUSTOMIZED_USER (regular ad), AUTH_CODE (Spark via code), TT_USER (Spark via account link) |
| Identity ID | identity_id | TikTok account ID used as the ad identity for Spark Ads |
| TikTok Item ID | tiktok_item_id | The original organic post ID used in the Spark Ad |
| Paid Likes | likes | Likes attributed to paid delivery (excludes organic likes on the same post) |
| Paid Comments | comments | Comments attributed to paid delivery (excludes organic comments) |
| Paid Shares | shares | Shares attributed to paid delivery (excludes organic shares) |
| Paid Follows | follows | New followers from paid ad interaction (excludes organic follows) |
Key difference: For Spark Ads, all engagement (likes, comments, shares) accumulates on the original organic post, boosting its organic reach even after the ad campaign ends. Regular custom ads create a standalone ad unit where engagement disappears when the ad stops running.
TikTok Shop Metrics
TikTok Shop integrates e-commerce directly into the TikTok experience, allowing users to browse and purchase products without leaving the app. These metrics track the shopping journey from product views to completed orders.
| Metric | API Field | Description |
|---|---|---|
| Product Clicks | product_clicks | Clicks on product cards or links within TikTok Shop ads |
| Product Details Page Browse | product_details_page_browse | Views of the product detail page within TikTok Shop |
| Add to Cart (Shop) | shop_add_to_cart | Products added to TikTok Shop cart from ad interactions |
| Initiate Checkout (Shop) | initiate_checkout | Checkout processes started within TikTok Shop |
| Shop Complete Payment | shop_complete_payment | Orders completed and paid for within TikTok Shop |
| GMV (Gross Merchandise Value) | total_sales | Total revenue from TikTok Shop orders attributed to ads |
| Shop ROAS | shop_roas | Return on ad spend from TikTok Shop purchases: GMV ÷ Spend |
| Units Sold | units_sold | Total number of product units sold via TikTok Shop |
| Average Order Value | average_order_value | Average revenue per TikTok Shop order |
| Live Viewers | live_viewers | Unique viewers of a TikTok LIVE shopping session (for LIVE Shopping Ads) |
| Live Duration | live_duration | Total duration of the TikTok LIVE shopping session in seconds |
Interactive Addon Metrics
TikTok interactive addons are overlay elements you can attach to ads to boost engagement — polls, countdown stickers, display cards, gift code stickers, and more. These metrics measure how users interact with these addon components.
| Metric | API Field | Description |
|---|---|---|
| Interactive Addon Impressions | interactive_addon_impression | Number of times the interactive addon was displayed |
| Interactive Addon Clicks | interactive_addon_destination_clicks | Clicks on interactive addons that directed users to a destination |
| Poll Votes | poll_vote | Total votes submitted on poll sticker addons |
| Poll Vote Rate | poll_vote_rate | Percentage of addon impressions that resulted in a poll vote |
| Countdown Sticker Clicks | countdown_sticker_clicks | Clicks on countdown timer sticker addons |
| Gift Code Sticker Claims | gift_code_sticker_claims | Number of gift/promo codes claimed from sticker addons |
| Display Card Clicks | display_card_clicks | Clicks on display card addon overlays |
| Sticker Addon CTR | sticker_addon_ctr | Click-through rate across all interactive sticker addons |
How to Use TikTok Metrics for Optimization
Having access to 200+ metrics is powerful, but knowing which ones matter for your specific campaign goals is what separates effective analysts from data-overwhelmed marketers. Here's a practical framework for selecting the right metrics by campaign type.
For reach and awareness campaigns
Focus on reach, frequency, CPM, cost per 1,000 reached, and video views (2s). Monitor frequency to prevent ad fatigue — on TikTok, creative fatigue happens faster than other platforms due to the high-frequency consumption pattern. Generally keep frequency below 3-4 for cold audiences and refresh creatives every 7-14 days.
For traffic campaigns
Prioritize landing page clicks (not total clicks), CTR, CPC, and your website analytics bounce rate. The gap between total clicks and landing page clicks reveals how many users clicked your profile or display name instead of your destination — if this gap exceeds 40%, your CTA and landing page URL may need to be more prominent.
For conversion campaigns
Track complete payment ROAS, cost per complete payment, total add to cart, total initiate checkout, and conversion rate. Use the conversion funnel metrics (view content → add to cart → initiate checkout → complete payment) to identify where drop-offs occur. Break down by country_code and platform (OS) to see which markets and devices drive the most value.
For video view campaigns
Use hook rate (2-second views ÷ impressions) to test opening hooks. Track 6-second focused views for genuine engagement — this is TikTok's quality-view threshold. Analyze the video completion percentages (25%, 50%, 75%, 100%) to identify exact drop-off points. If your 50% rate is dramatically lower than your 25% rate, the middle section of your creative needs work.
For app install campaigns
Monitor real-time app installs alongside total app installs for pacing. Track cost per app install, day-2 and day-7 retention, and in-app purchase value for quality signals. Use deep link clicks to measure re-engagement campaign effectiveness. Compare real-time cost per install vs. finalized cost to catch delivery issues early.
For TikTok Shop campaigns
Focus on GMV (total sales), shop ROAS, cost per shop complete payment, units sold, and average order value. Use product detail page browse and shop add to cart as leading indicators. For LIVE Shopping Ads, track live viewers and live duration alongside purchase metrics to optimize your live commerce strategy.
Common Mistakes When Analyzing TikTok Ads Data
Even experienced digital marketers make these mistakes when working with TikTok Ads metrics. Avoiding them will save you from flawed analyses and bad optimization decisions.
1. Using total clicks instead of landing page clicks
Total clicks includes every interaction — profile visits, display name clicks, CTA clicks, and ad body clicks — not just clicks to your website. When measuring traffic intent, always use landing page clicks. On TikTok, the difference can be 2-4x because users frequently click on profiles to explore creator content before visiting a landing page.
2. Comparing 2-second views to 6-second focused views
A 2-second video view simply requires 2 seconds of watch time with the ad in view. A 6-second focused view requires sustained, intentional viewing. They measure fundamentally different levels of engagement — the 2-second view is closer to an impression qualifier while the 6-second view indicates genuine interest. Comparing them directly or using them interchangeably leads to misleading conclusions.
3. Ignoring Spark Ads organic spillover
Spark Ads generate both paid and organic engagement on the underlying post. Thelikes, comments, shares, and follows metrics in the TikTok Ads API only report paid engagement. The organic engagement that accumulates on the same post (often substantial) is only visible in TikTok's creator analytics. Evaluating Spark Ads purely on paid metrics undervalues their total impact by 30-60%.
4. Summing reach across time periods
Just like on Meta, TikTok's reach metric is deduplicated — the same person seeing your ad in January and February counts as 1 for the year but 1 in each month. Summing monthly reach numbers overcounts your actual unique audience. Always query reach for the full period you want to measure.
5. Averaging ROAS across ad groups
ROAS is a ratio. Averaging ROAS across ad groups gives mathematically incorrect results because it ignores the relative spend of each ad group. Instead, sum the total conversion value and total spend across all ad groups, then calculate ROAS from the totals: Total Conversion Value ÷ Total Spend.
6. Not accounting for TikTok's attribution differences
TikTok's default attribution window is 7-day click and 1-day view, but this can vary by optimization goal and campaign type. Smart+ campaigns may use different attribution models than manual campaigns. Always check the attribution_setting at the ad group level before comparing performance across campaigns. A campaign showing higher ROAS might simply have a wider attribution window rather than better performance.
