TikTok Shop Metrics and Breakdowns
This page provides a comprehensive reference of all supported metrics and breakdowns available for TikTok Shop data extraction through Adzviser.
Data is sourced from the TikTok Shop Orders API. Product- and SKU-level fields expand each order into its individual items; order-level amounts such as shipping, tax and order totals are still counted once per order, so combining the two levels never inflates your totals.
Dates and times are reported in UTC.
Metrics
Counts
| Field Name | Description |
|---|---|
| Orders | Number of distinct orders |
| Items sold | Number of line items across all orders |
Items subtotal
| Field Name | Description |
|---|---|
| Items subtotal (before discounts) | Product price before any discount |
| Items subtotal (seller discount) | Discount funded by the seller |
| Items subtotal (TikTok Shop discount) | Discount funded by TikTok Shop |
| Items subtotal (after discounts) | Product price after seller and platform discounts |
Shipping
| Field Name | Description |
|---|---|
| Shipping fee (before discounts) | Original shipping fee before any discount |
| Shipping fee (seller discount) | Shipping discount funded by the seller |
| Shipping fee (TikTok Shop discount) | Shipping discount funded by TikTok Shop |
| Shipping fee (co-funded discount) | Shipping discount co-funded by seller and TikTok Shop |
| Shipping fee (after discounts) | Shipping fee charged to the buyer after discounts |
| Shipping insurance fee | Fee charged for shipping insurance |
Taxes & fees
| Field Name | Description |
|---|---|
| Tax | Total tax on the order |
| Tax (product) | Tax charged on the products |
| Tax (shipping fee) | Tax charged on the shipping fee |
| Retail delivery fee | Government-mandated retail delivery fee |
| Buyer service fee | Service fee charged to the buyer |
| Handling fee | Order handling fee |
| Small order fee | Surcharge applied to small orders |
| Item insurance fee | Fee charged for item insurance |
Total
| Field Name | Description |
|---|---|
| Total amount | Total amount the buyer paid for the order |
Line-item level
| Field Name | Description |
|---|---|
| Item sale price | Selling price of the line item |
| Item original price | Price of the line item before discounts |
| Item seller discount | Seller-funded discount on the line item |
| Item TikTok Shop discount | TikTok Shop-funded discount on the line item |
Breakdowns
Buyer
| Field Name | Description |
|---|---|
| Buyer message | Message left by the buyer at checkout |
| Buyer user ID | Unique identifier of the buyer |
| Buyer email | Buyer's email address |
Order
| Field Name | Description |
|---|---|
| Order ID | Unique order identifier |
| Order status | Current status of the order |
| Order currency | Currency the order was placed in |
| Order tracking number | Shipment tracking number |
| Order shipping type | Shipping type (e.g. platform or seller shipping) |
| Order delivery type | Delivery type for the order |
| Order delivery option name | Name of the chosen delivery option |
| Order delivery option ID | Identifier of the chosen delivery option |
| Order fulfillment type | How the order is fulfilled |
| Order is on hold | Whether the order is on hold |
| Order is replacement | Whether the order is a replacement |
| Order is sample | Whether the order is a sample |
| Order is cash on delivery | Whether the order is cash on delivery |
| Order cancel reason | Reason the order was cancelled |
| Order cancellation initiator | Who initiated the cancellation |
| Order payment method name | Payment method used for the order |
| Order warehouse ID | Identifier of the fulfilling warehouse |
| Order shipping provider | Shipping provider for the order |
Recipient / Shipping
| Field Name | Description |
|---|---|
| Recipient name | Full name of the recipient |
| Recipient first name | Recipient's first name |
| Recipient last name | Recipient's last name |
| Recipient phone number | Recipient's phone number |
| Recipient full address | Recipient's complete address |
| Recipient address line 1 | First line of the recipient's address |
| Recipient address line 2 | Second line of the recipient's address |
| Recipient address line 3 | Third line of the recipient's address |
| Recipient address line 4 | Fourth line of the recipient's address |
| Recipient postal code | Recipient's postal code |
| Recipient region code | Recipient's region code |
Seller / Shop
| Field Name | Description |
|---|---|
| Seller note | Internal note added by the seller |
| Shop ID | Unique identifier of the shop |
| Shop region | Region the shop operates in |
| Shop seller type | Type of seller account |
Product / SKU (line-item level)
| Field Name | Description |
|---|---|
| Product ID | Unique identifier of the product |
| Product name | Name of the product |
| SKU ID | Unique identifier of the SKU |
| SKU name | Name of the SKU variant |
| Seller SKU | Seller-defined SKU code |
| Item display status | Display status of the line item |
| Item currency | Currency of the line item |
| Item tracking number | Tracking number for the line item |
| Item shipping provider name | Shipping provider handling the line item |
| Item package ID | Identifier of the package containing the item |
| Item package status | Status of the item's package |
| Item cancel reason | Reason the line item was cancelled |
Timestamps
| Field Name | Description |
|---|---|
| Order created date | Date the order was created |
| Order created datetime | Date and time the order was created |
| Order updated date | Date the order was last updated |
| Order updated datetime | Date and time the order was last updated |
| Order paid date | Date the order was paid |
| Order paid datetime | Date and time the order was paid |
| Order canceled date | Date the order was cancelled |
| Order canceled datetime | Date and time the order was cancelled |
| Order delivered date | Date the order was delivered |
| Order delivered datetime | Date and time the order was delivered |
| Order shipped date | Date the order was shipped (ready to ship) |
| Order shipped datetime | Date and time the order was shipped (ready to ship) |