TikTok Shop has rapidly become one of the most important social commerce platforms, combining short-form video content with native shopping experiences. Whether you're managing your shop through TikTok Seller Center, pulling data via the Shop API, or analyzing performance for affiliate partnerships, understanding every available dimension and metric is essential for growing your social commerce business.

This guide covers every dimension and metric available in TikTok Shop as of 2026. We've organized them by category — products, orders, creators, traffic, LIVE shopping, refunds, and customers — with API field references and practical context on when each metric matters for shop optimization.

What Are Dimensions vs Metrics in TikTok Shop?

In TikTok Shop's analytics model, dimensions are descriptive attributes that categorize your data — like product name, order status, creator username, or shipping method. They define the rows and filters in your reports.

Metrics are the quantitative measurements — GMV, orders, units sold, conversion rate, average order value. They tell you what happened and how your shop performed.

TikTok Shop Seller Center provides built-in analytics dashboards covering shop performance, product analytics, LIVE analytics, and creator performance. The TikTok Shop API offers programmatic access to the same data points for custom reporting and integration with external analytics tools.

Shop and Product Dimensions

Product dimensions describe the items listed in your TikTok Shop. These fields identify each product, its categorization, pricing, inventory status, and listing quality. They form the foundation of all merchandising and product performance analysis.

DimensionAPI FieldDescription
Product IDproduct_idUnique identifier for the product listing
Product Nameproduct_nameDisplay title of the product as shown to shoppers
SKU IDsku_idUnique identifier for the specific product variation (size, color, etc.)
SKU Namesku_nameVariation label displayed to the customer (e.g., "Black / Large")
Categorycategory_nameProduct category from TikTok Shop's taxonomy (e.g., Beauty, Fashion, Electronics)
Subcategorysubcategory_nameSecond-level category for finer product classification
Product Statusproduct_statusListing state: live, draft, suspended, deleted, or under review
PricepriceCurrent selling price of the product or SKU
Original Priceoriginal_priceOriginal price before any discounts or promotions
Stock Quantitystock_quantityAvailable inventory units for the SKU
Warehousewarehouse_idFulfillment warehouse assigned to the product
Shipping Templateshipping_template_idShipping configuration (rates, delivery time, regions) applied to the product
Product Ratingproduct_ratingAverage customer rating (1-5 stars) based on verified purchase reviews
Review Countreview_countTotal number of customer reviews for the product
Brandbrand_nameBrand name associated with the product (if brand registered)
Created Datecreate_timeTimestamp when the product listing was first created

Order Dimensions

Order dimensions describe the transactions completed through your TikTok Shop. These fields track every order from placement through fulfillment, including payment details, shipping information, and the traffic source that drove the purchase.

DimensionAPI FieldDescription
Order IDorder_idUnique identifier for the order
Order Statusorder_statusCurrent state: unpaid, awaiting shipment, shipped, delivered, completed, cancelled
Payment Statuspayment_statusPayment state: pending, paid, refunded, or partially refunded
Payment Methodpayment_methodHow the customer paid: credit card, debit card, PayPal, or other methods
Order Datecreate_timeTimestamp when the order was placed
Shipping Methodshipping_typeDelivery method: standard, express, or economy shipping
Tracking Numbertracking_numberCarrier tracking number for the shipment
Shipping Providershipping_providerCarrier name: USPS, UPS, FedEx, DHL, or regional carriers
Buyer Countrybuyer_countryCustomer's shipping country
Buyer Regionbuyer_regionState or province of the shipping address
Traffic Sourcetraffic_sourceHow the buyer found the product: organic video, LIVE, paid ad, search, showcase, or direct
Affiliate Orderis_affiliate_orderWhether the order was driven by an affiliate creator (boolean)
LIVE Orderis_live_orderWhether the order was placed during a LIVE shopping session (boolean)
Promotion Appliedpromotion_typeType of promotion on the order: flash deal, bundle deal, free shipping, or coupon

Creator and Affiliate Dimensions

Creator dimensions describe the TikTok content creators who promote and sell your products through the affiliate program, direct partnerships, or their own LIVE shopping sessions. These fields are essential for evaluating creator ROI and optimizing your affiliate strategy.

DimensionAPI FieldDescription
Creator Usernamecreator_usernameTikTok handle of the creator promoting your products
Creator IDcreator_idUnique identifier for the creator on TikTok Shop
Follower Countfollower_countCreator's total follower count at the time of reporting
Creator Categorycreator_categoryContent niche: beauty, fashion, food, tech, lifestyle, fitness, etc.
Collaboration Typecollaboration_typePartnership model: open affiliate, targeted affiliate, direct partnership, or shop creator
Commission Ratecommission_ratePercentage of each sale paid to the creator as commission
Sample Sentsample_statusWhether a product sample was sent to the creator for review
Creator Tiercreator_tierClassification based on follower count and engagement: mega, macro, mid-tier, micro, nano
Content Formatcontent_formatType of content the creator produces: short video, LIVE stream, or both
Partnership Start Datepartnership_start_dateWhen the creator-seller partnership began

Core Metrics: GMV, Orders, and AOV

These fundamental metrics measure your shop's overall transaction performance. GMV is TikTok Shop's primary revenue metric — understanding the difference between gross and net revenue is critical for accurate financial analysis.

MetricAPI FieldDescriptionFormula / Notes
GMV (Gross Merchandise Value)gmvTotal value of all confirmed orders before deductionsSum of all order totals including product prices and shipping
Net Revenuenet_revenueRevenue after subtracting refunds, platform fees, and commissionsGMV - Refunds - Platform Fee - Affiliate Commission - Shipping Subsidies
Total Orderstotal_ordersNumber of confirmed orders in the periodExcludes cancelled and refunded orders in some report views
Units Soldunits_soldTotal quantity of product units soldSum of all item quantities across confirmed orders
Average Order Value (AOV)aovAverage revenue per orderGMV ÷ Total Orders
Platform Feeplatform_feeTikTok Shop's commission on each transactionPercentage of GMV retained by TikTok (varies by category and seller tier)
Shipping Costshipping_costTotal shipping charges across all ordersIncludes seller-subsidized and buyer-paid shipping
Promotion Discountpromotion_discountTotal discount amount from all promotions appliedIncludes seller coupons, flash deals, and bundle discounts

Traffic Metrics

Traffic metrics track how shoppers discover and navigate through your TikTok Shop. Understanding the full purchase funnel — from initial discovery through checkout completion — is essential for identifying where potential customers drop off and where to focus optimization efforts.

MetricAPI FieldDescriptionFormula / Notes
Shop Page Visitsshop_visitsTotal visits to your TikTok Shop storefront pageIncludes visits from all traffic sources
Product Detail Page Viewsproduct_viewsTimes individual product detail pages were viewedKey top-of-funnel metric for product interest
Add to Cart Countadd_to_cartTimes products were added to shopping cartsStrong purchase intent signal
Add to Cart Rateadd_to_cart_ratePercentage of product views that resulted in an add-to-cart(Add to Cart ÷ Product Views) × 100
Checkout Initiationscheckout_initiationsTimes customers started the checkout processCounts each checkout start, not completions
Checkout Completion Ratecheckout_completion_ratePercentage of checkout initiations that resulted in a completed order(Completed Orders ÷ Checkout Initiations) × 100
Overall Conversion Rateconversion_ratePercentage of product views that converted to orders(Orders ÷ Product Views) × 100
Cart Abandonment Ratecart_abandonment_ratePercentage of add-to-cart events that did not convert to orders1 - (Orders ÷ Add to Cart) × 100
Traffic Source Breakdowntraffic_sourceDimension: organic video, LIVE shopping, paid ads, search, showcase, or directAvailable as a breakdown for all traffic and conversion metrics
Search Impressionssearch_impressionsTimes your products appeared in TikTok Shop search resultsMeasures product discoverability through the search channel
Search Click-Through Ratesearch_ctrPercentage of search impressions that resulted in a product page view(Search Clicks ÷ Search Impressions) × 100

Creator Metrics

Creator metrics measure the performance of individual creators who promote your products through the TikTok Shop affiliate program. These metrics help you evaluate which partnerships deliver the best ROI and inform decisions about commission rates, sample distribution, and creator recruitment.

MetricAPI FieldDescriptionFormula / Notes
Affiliate GMVaffiliate_gmvGMV generated through affiliate creator contentTotal order value from affiliate-attributed sales
Affiliate Ordersaffiliate_ordersNumber of orders attributed to affiliate creatorsOrders where the traffic source is a creator's content
Commission Paidcommission_paidTotal commission paid to affiliate creatorsSum of commission amounts across all affiliate orders
Creator Videos Postedcreator_videosNumber of videos featuring your products posted by a creatorCounts all published videos with your product links
Creator Video Viewscreator_video_viewsTotal views on creator videos featuring your productsAggregate views across all affiliate videos for your products
Creator Video Engagementcreator_engagementTotal engagement (likes, comments, shares) on creator affiliate contentHigher engagement typically correlates with better conversion rates
Creator Conversion Ratecreator_conversion_ratePercentage of creator content views that resulted in a purchase(Affiliate Orders ÷ Creator Video Views) × 100
Creator ROAScreator_roasReturn on affiliate spend for a specific creatorAffiliate GMV ÷ Commission Paid
Average Order Value (Creator)creator_aovAverage order value from a specific creator's affiliate salesCreator Affiliate GMV ÷ Creator Affiliate Orders
Creator Showcase Clicksshowcase_clicksClicks on products in a creator's profile showcase sectionThe showcase is the product shelf on a creator's TikTok profile

LIVE Shopping Metrics

LIVE shopping metrics measure the performance of real-time selling sessions on TikTok. LIVE commerce is one of TikTok Shop's most powerful selling channels, often delivering higher conversion rates than organic or paid video. These metrics help you optimize everything from scheduling and duration to product presentation and audience engagement.

MetricAPI FieldDescriptionFormula / Notes
Peak Concurrent Viewerspeak_viewersMaximum number of simultaneous viewers during the LIVE sessionIndicates the peak audience size reached during the stream
Total Unique Viewersunique_viewersDeduplicated count of users who watched any portion of the LIVEEach user counted once regardless of how many times they joined
Average Watch Timeavg_watch_timeAverage duration each viewer spent watching the LIVE sessionMeasured in seconds — longer watch times indicate stronger engagement
LIVE Durationlive_durationTotal length of the LIVE sessionMeasured in minutes from start to end of stream
Items Clickeditems_clickedNumber of times product cards were clicked during the LIVEEach click on a product pin or shopping bag counts once
Orders During LIVElive_ordersOrders placed by viewers during the LIVE sessionOrders placed within the LIVE session timeframe
LIVE GMVlive_gmvTotal order value from purchases made during the LIVEGMV attributed specifically to the LIVE shopping session
LIVE Conversion Ratelive_conversion_ratePercentage of LIVE viewers who made a purchase(Live Orders ÷ Unique Viewers) × 100
New Followers from LIVEnew_followersNew followers gained during the LIVE sessionUsers who followed your shop during the stream
LIVE Commentslive_commentsTotal comments posted during the LIVE sessionIndicator of audience engagement and interaction level
LIVE Likeslive_likesTotal likes received during the LIVE sessionEach tap of the like button counts as one like
LIVE Shareslive_sharesTimes the LIVE stream was shared to other usersShares expand reach beyond current viewers
GPM (GMV per Mille)gpmGMV generated per 1,000 viewers(LIVE GMV ÷ Unique Viewers) × 1,000

Refund and Return Metrics

Refund metrics track the post-purchase experience and financial impact of returns. High return rates affect both your profitability and your shop's quality score on TikTok, which in turn affects product visibility and algorithmic promotion.

MetricAPI FieldDescriptionFormula / Notes
Total Refund Amountrefund_amountTotal monetary value of all refunds issuedIncludes full and partial refunds
Refund Countrefund_countNumber of orders with refunds processedEach order with any refund activity counts once
Refund Raterefund_ratePercentage of orders that received a refund(Refund Count ÷ Total Orders) × 100
Return Ratereturn_ratePercentage of units sold that were returned(Units Returned ÷ Units Sold) × 100
Refund Reasonrefund_reasonDimension: quality issue, wrong item, not as described, shipping damage, change of mindCategorized reasons help identify root causes of returns
Average Refund Processing Timeavg_refund_timeAverage days from refund request to resolutionImpacts customer satisfaction and shop quality score
Dispute Ratedispute_ratePercentage of orders resulting in a buyer disputeHigh dispute rates may trigger TikTok Shop penalties
Product Return Rateproduct_return_rateReturn rate for a specific productIdentifies products with quality or description accuracy issues

Customer Metrics

Customer metrics track the behavior and value of your TikTok Shop buyers. These metrics help you understand your customer base composition, repeat purchase patterns, and the lifetime value of shoppers acquired through different channels.

MetricAPI FieldDescriptionFormula / Notes
New Customersnew_customersBuyers placing their first order from your shopNo prior orders in your TikTok Shop history
Returning Customersreturning_customersBuyers who have ordered from your shop beforeAt least one prior completed order exists
Repeat Purchase Raterepeat_purchase_ratePercentage of customers who make a second purchase(Returning Customers ÷ Total Customers) × 100
Customer Lifetime Valuecustomer_ltvAverage cumulative spend per customer across all ordersTotal GMV ÷ Total Unique Customers
Average Orders per Customeravg_orders_per_customerAverage number of orders per unique customerTotal Orders ÷ Total Unique Customers
Shop Followersshop_followersTotal number of users following your TikTok ShopFollowers receive notifications about new products and promotions
New Followersnew_followers_countNew shop followers gained in the periodNet new followers — not accounting for unfollows
Customer Rating Scorecustomer_satisfaction_scoreAverage satisfaction rating from post-purchase surveysScale varies — typically 1-5 stars

How to Use TikTok Shop Metrics for Store Optimization

With the breadth of metrics available, knowing which to prioritize depends on your current growth stage and objectives. Here's a practical framework for selecting the right TikTok Shop metrics for different goals.

For revenue growth

Monitor GMV, total orders, AOV, and net revenue as your primary dashboard. Break down GMV by traffic source to understand which channels drive the most value — organic video, LIVE, affiliates, or paid ads. Focus on increasing AOV through bundle deals, minimum-order promotions, and cross-selling within your product catalog.

For affiliate program optimization

Track affiliate GMV, creator conversion rate, and creator ROAS (GMV divided by commission paid) by individual creator. Identify your top-performing affiliates by both volume and efficiency. Test different commission rates to find the sweet spot that attracts quality creators while maintaining healthy margins. Monitor creator videos posted to ensure partnership activity remains consistent.

For LIVE shopping performance

Focus on LIVE GMV, LIVE conversion rate, peak concurrent viewers, and GPM (GMV per mille). GPM normalizes LIVE revenue by audience size, making it the best metric for comparing sessions of different scales. Track average watch time to gauge content quality — longer sessions indicate viewers are staying engaged. Schedule LIVE sessions when your audience is most active and test different product presentation sequences.

For reducing returns

Monitor refund rate overall and product return rate at the item level. Break down returns by refund reason to identify patterns — if "not as described" is the top reason, improve product photos and descriptions. If "quality issue" dominates, investigate your supply chain. Keep your overall refund rate below 5% to maintain a strong shop quality score.

Common Mistakes When Analyzing TikTok Shop Data

Even experienced social commerce sellers make these mistakes when working with TikTok Shop metrics. Avoiding them will improve your analysis accuracy and help you make better optimization decisions.

1. Treating GMV as actual revenue

GMV is gross transaction value — not what you actually receive. After subtracting refunds, platform fees (typically 2-8%), affiliate commissions, shipping subsidies, and promotion costs, your net revenue can be 20-40% lower than GMV. Always calculate and track net revenue for profitability analysis.

2. Ignoring traffic source attribution

Not all TikTok Shop traffic converts equally. Organic video traffic might have a 2% conversion rate while LIVE shopping converts at 8%. If you don't segment metrics by traffic source, you'll miss where your actual revenue comes from and where to invest more effort.

3. Evaluating creators only by GMV volume

A creator generating $10,000 in GMV at a 20% commission rate costs you $2,000. Another generating $5,000 at 5% commission costs $250. The second creator has 4x better ROAS despite lower volume. Always evaluate affiliate partnerships using creator ROAS alongside absolute GMV to optimize your commission spend efficiently.

4. Not monitoring shop quality score impacts

TikTok Shop uses a quality score that affects your product visibility and eligibility for promotions. High refund rates, slow shipping, and negative reviews all lower your score. Monitoring refund rate, average refund processing time, and customer satisfaction score isn't just about customer experience — it directly affects your algorithmic reach.

5. Comparing LIVE sessions without normalizing for audience size

A LIVE session with 10,000 viewers and $5,000 GMV looks less impressive than one with 50,000 viewers and $8,000 GMV — until you calculate GPM. The smaller session generated $500 per thousand viewers versus $160. Use GPM to compare LIVE effectiveness independent of audience size, and use total GMV for measuring absolute revenue impact.

6. Overlooking product-level metrics in favor of shop-level aggregates

Shop-level averages can mask individual product problems. A healthy 3% overall conversion rate might hide one product converting at 8% and another at 0.5%. Regularly review product-level conversion rates, return rates, and revenue per product to identify both your stars and your problem listings that need optimization or removal.