Metrics
Métricas de TikTok Shop con la API
Tu cliente conecta su cuenta de TikTok Shop y tu producto consulta 34 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok_shop:orders",
"component": "number_v1",
"metrics": [
"orders"
]
}
]
}Más ejemplos de llamadas a TikTok Shop
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Pedidos a lo largo del tiempo
Pedidos realizados en cada día del período analizado.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok_shop:orders_over_time",
"component": "chart_v1",
"metrics": [
"orders"
],
"dimensions": [
"date"
]
}
]
}Tabla
Resumen de ventas
Ventas de los pedidos realizados en cada día del período analizado, netas de los reembolsos concluidos ese día.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok_shop:sales_summary",
"component": "datatable_v1",
"metrics": [
"orders",
"items_sold",
"gross_sales",
"seller_discount",
"platform_discount",
"net_sales",
"shipping",
"taxes",
"total_sales"
],
"dimensions": [
"date"
]
}
]
}Número
Pedidos entregados
Pedidos realizados en el período analizado que fueron entregados al cliente o completados.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok_shop:delivered_orders",
"component": "number_v1",
"metrics": [
"delivered_orders"
]
}
]
}Números
22 métricas
Pedidos
Número de pedidos realizados en el período analizado, excluyendo pedidos no pagados, pedidos cancelados y pedidos de muestra enviados a creadores.
tiktok_shop:ordersPedidos entregados
Pedidos realizados en el período analizado que fueron entregados al cliente o completados.
tiktok_shop:delivered_ordersPedidos cancelados
Pedidos cuyo cancelamiento fue completado en el período analizado, independientemente de cuándo fueron realizados.
tiktok_shop:cancelled_ordersArtículos vendidos
Unidades vendidas en los pedidos realizados en el período analizado.
tiktok_shop:items_soldClientes
Número de clientes distintos que realizaron pedidos en el período analizado.
tiktok_shop:customersVentas brutas
Precio de los productos antes de los descuentos en los pedidos realizados en el período analizado.
tiktok_shop:gross_salesDescuento del vendedor
Descuentos cubiertos por la tienda en los pedidos realizados en el período analizado.
tiktok_shop:seller_discountDescuento de la plataforma
Descuentos cubiertos por TikTok Shop en los pedidos realizados en el período analizado. Como son pagados por la plataforma, no se deducen de las ventas de la tienda.
tiktok_shop:platform_discountVentas netas
Ventas brutas menos los descuentos cubiertos por la tienda y los reembolsos completados en el período analizado.
tiktok_shop:net_salesEnvío
Valores de envío pagados por los clientes en los pedidos realizados en el período analizado.
tiktok_shop:shippingImpuestos
Impuestos cobrados en los pedidos realizados en el período analizado.
tiktok_shop:taxesVentas Totales
Ventas netas más el envío y los impuestos cobrados en los pedidos realizados en el período analizado. Los pedidos cancelados nunca entran en las ventas, por lo que las cancelaciones no se deducen.
tiktok_shop:total_salesValor medio del pedido
Valor de los productos de los pedidos realizados en el período analizado, antes de descuentos y reembolsos, dividido por el número de pedidos.
tiktok_shop:average_order_valueArtículos por pedido
Artículos vendidos divididos por el número de pedidos realizados en el período analizado.
tiktok_shop:items_per_orderValor de las cancelaciones
Valor reembolsado a los clientes por las cancelaciones completadas en el período analizado.
tiktok_shop:cancelled_amountReembolsos
Solicitudes de devolución y reembolso completadas con reembolso en el período analizado, independientemente de cuándo se realizó el pedido.
tiktok_shop:refundsArtículos reembolsados
Unidades reembolsadas por las devoluciones concluidas en el período analizado.
tiktok_shop:refunded_itemsValor de los reembolsos
Valor reembolsado a los clientes por las devoluciones completadas en el período analizado.
tiktok_shop:refunded_amountTasa de cancelación
Pedidos cuyo cancelamiento fue concluido en el período analizado divididos por los pedidos realizados en él.
tiktok_shop:cancellation_rateTasa de reembolso
Devoluciones concluidas con reembolso en el período analizado divididas por los pedidos realizados en él.
tiktok_shop:refund_rateFlete medio
Valores de envío pagados por los clientes divididos por el número de pedidos realizados en el período analizado.
tiktok_shop:average_shippingDescuento medio
Descuentos financiados por la tienda divididos por el número de pedidos realizados en el período analizado.
tiktok_shop:average_discount
Gráficos
5 métricas
Pedidos a lo largo del tiempo
Pedidos realizados en cada día del período analizado.
tiktok_shop:orders_over_timeVentas a lo largo del tiempo
Total de ventas de los pedidos realizados en cada día del período analizado.
tiktok_shop:sales_over_timePedidos por situación
Distribución de los pedidos realizados en el período analizado por la situación actual, incluyendo pedidos no pagados y cancelados.
tiktok_shop:orders_by_statusCancelaciones por solicitante
Distribución de las cancelaciones completadas en el período analizado por quién las solicitó: el cliente, la tienda, los operadores de TikTok Shop o el sistema.
tiktok_shop:cancellations_by_initiatorDevoluciones por tipo
Distribución de las devoluciones completadas en el período analizado por la solución dada: solo reembolso, devolución y reembolso, sustitución o cambio.
tiktok_shop:returns_by_type
Tablas
7 métricas
Resumen de ventas
Ventas de los pedidos realizados en cada día del período analizado, netas de los reembolsos concluidos ese día.
tiktok_shop:sales_summaryCancelaciones y reembolsos por día
Cancelaciones y reembolsos completados en cada día del período analizado.
tiktok_shop:cancellations_and_refunds_by_dayVentas por forma de pago
Pedidos realizados en el período analizado agrupados por la forma de pago elegida por el cliente.
tiktok_shop:sales_by_payment_methodProductos más vendidos
Productos vendidos en el período analizado; las ventas netas deducen los reembolsos de esos artículos completados en el período. Situación, variaciones y stock reflejan el catálogo en el momento del informe, no el período.
tiktok_shop:best_selling_productsVentas por variante
Variantes de producto vendidas en el período analizado; las ventas netas deducen los reembolsos de esos artículos completados en el período. Precio y stock reflejan el catálogo en el momento del informe, no el período.
tiktok_shop:sales_by_variantCancelaciones por motivo
Cancelaciones completadas en el período analizado agrupadas por el motivo informado.
tiktok_shop:cancellations_by_reasonDevoluciones por motivo
Devoluciones concluidas en el período analizado agrupadas por el motivo informado por el cliente.
tiktok_shop:returns_by_reason
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
