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"
      ]
    }
  ]
}
Ejemplo: "Pedidos" en octubre, comparado con septiembre.

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:orders
  • Pedidos entregados

    Pedidos realizados en el período analizado que fueron entregados al cliente o completados.

    tiktok_shop:delivered_orders
  • Pedidos cancelados

    Pedidos cuyo cancelamiento fue completado en el período analizado, independientemente de cuándo fueron realizados.

    tiktok_shop:cancelled_orders
  • Artículos vendidos

    Unidades vendidas en los pedidos realizados en el período analizado.

    tiktok_shop:items_sold
  • Clientes

    Número de clientes distintos que realizaron pedidos en el período analizado.

    tiktok_shop:customers
  • Ventas brutas

    Precio de los productos antes de los descuentos en los pedidos realizados en el período analizado.

    tiktok_shop:gross_sales
  • Descuento del vendedor

    Descuentos cubiertos por la tienda en los pedidos realizados en el período analizado.

    tiktok_shop:seller_discount
  • Descuento 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_discount
  • Ventas netas

    Ventas brutas menos los descuentos cubiertos por la tienda y los reembolsos completados en el período analizado.

    tiktok_shop:net_sales
  • Envío

    Valores de envío pagados por los clientes en los pedidos realizados en el período analizado.

    tiktok_shop:shipping
  • Impuestos

    Impuestos cobrados en los pedidos realizados en el período analizado.

    tiktok_shop:taxes
  • Ventas 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_sales
  • Valor 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_value
  • Artículos por pedido

    Artículos vendidos divididos por el número de pedidos realizados en el período analizado.

    tiktok_shop:items_per_order
  • Valor de las cancelaciones

    Valor reembolsado a los clientes por las cancelaciones completadas en el período analizado.

    tiktok_shop:cancelled_amount
  • Reembolsos

    Solicitudes de devolución y reembolso completadas con reembolso en el período analizado, independientemente de cuándo se realizó el pedido.

    tiktok_shop:refunds
  • Artículos reembolsados

    Unidades reembolsadas por las devoluciones concluidas en el período analizado.

    tiktok_shop:refunded_items
  • Valor de los reembolsos

    Valor reembolsado a los clientes por las devoluciones completadas en el período analizado.

    tiktok_shop:refunded_amount
  • Tasa de cancelación

    Pedidos cuyo cancelamiento fue concluido en el período analizado divididos por los pedidos realizados en él.

    tiktok_shop:cancellation_rate
  • Tasa de reembolso

    Devoluciones concluidas con reembolso en el período analizado divididas por los pedidos realizados en él.

    tiktok_shop:refund_rate
  • Flete 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_shipping
  • Descuento 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_time
  • Ventas a lo largo del tiempo

    Total de ventas de los pedidos realizados en cada día del período analizado.

    tiktok_shop:sales_over_time
  • Pedidos 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_status
  • Cancelaciones 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_initiator
  • Devoluciones 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_summary
  • Cancelaciones y reembolsos por día

    Cancelaciones y reembolsos completados en cada día del período analizado.

    tiktok_shop:cancellations_and_refunds_by_day
  • Ventas 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_method
  • Productos 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_products
  • Ventas 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_variant
  • Cancelaciones por motivo

    Cancelaciones completadas en el período analizado agrupadas por el motivo informado.

    tiktok_shop:cancellations_by_reason
  • Devoluciones 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.