Metrics

Métricas de Nuvemshop con la API

Tu cliente conecta su cuenta de Nuvemshop y tu producto consulta 26 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": "nuvem_shop:sales",
      "component": "number_v1",
      "metrics": [
        "sales_count"
      ],
      "dimensions": [
        "orders"
      ]
    }
  ]
}
Ejemplo: "Ventas" en octubre, comparado con septiembre.

Más ejemplos de llamadas a Nuvemshop

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

Este gráfico ilustra la cantidad de ventas realizadas durante el período seleccionado.

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": "nuvem_shop:orders_over_time",
      "component": "chart_v1",
      "metrics": [
        "sales_count"
      ],
      "dimensions": [
        "orders"
      ]
    }
  ]
}

Tabla

Cantidad de Cuotas

Esta tabla muestra el número de pedidos y los ingresos por número de cuotas.

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": "nuvem_shop:number_of_installments",
      "component": "datatable_v1",
      "metrics": [
        "sales_count",
        "revenue_value"
      ],
      "dimensions": [
        "installments"
      ]
    }
  ]
}

Número

Ingresos

La suma de los pagos realizados por sus clientes (sin incluir pedidos cancelados) durante el 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": "nuvem_shop:revenue",
      "component": "number_v1",
      "metrics": [
        "revenue_value"
      ],
      "dimensions": [
        "orders"
      ]
    }
  ]
}

Números

13 métricas

  • Ventas

    El número total de ventas con pago confirmado en el período seleccionado.

    nuvem_shop:sales
  • Ingresos

    La suma de los pagos realizados por sus clientes (sin incluir pedidos cancelados) durante el período analizado.

    nuvem_shop:revenue
  • Cupones válidos

    El número de cupones activos en el período analizado.

    nuvem_shop:coupons
  • Clientes Recurrentes

    El número de clientes que ya habían realizado compras anteriores y regresaron para comprar durante el período analizado.

    nuvem_shop:recurring_customers
  • Clientes Nuevos

    El número de clientes que hicieron su primera compra durante el período analizado.

    nuvem_shop:new_customers
  • Productos Vendidos

    El número total de artículos vendidos durante el período analizado.

    nuvem_shop:sold_products
  • Ticket Promedio

    El ticket medio se calcula dividiendo los ingresos totales por el número de ventas realizadas en el período seleccionado. Esta métrica proporciona una visión sobre el valor medio gastado por transacción.

    nuvem_shop:average_ticket
  • Carritos convertidos en ventas

    El número de veces que los usuarios hicieron clic en 'Finalizar Pedido' en el checkout.

    nuvem_shop:all_sales
  • Carritos que pueden convertirse en ventas

    El número de veces que se abandonó el checkout después de completar la dirección de entrega y avanzar a la segunda etapa del proceso de compra. Esta métrica puede devolver datos diferentes para un mismo período, ya que Nuvemshop guarda los datos de carritos abandonados por hasta 30 días. Después de este plazo, ya no es posible verificar los datos de esos carritos.

    nuvem_shop:abandoned_checkouts
  • Medios de pago seleccionados

    El número total de veces que un método de pago fue seleccionado en la finalización de la compra. Esta métrica puede devolver datos diferentes para un mismo período, ya que Nuvemshop guarda los datos de carritos abandonados por hasta 30 días. Después de este plazo, ya no es posible verificar los datos de esos carritos.

    nuvem_shop:selected_payment_methods
  • Medios de envío seleccionados

    El número total de veces que un cliente seleccionó un método de envío durante la finalización de la compra. Esta métrica puede devolver datos diferentes para un mismo período, ya que Nuvemshop guarda los datos de carritos abandonados por hasta 30 días. Después de este plazo, ya no es posible verificar los datos de esos carritos.

    nuvem_shop:selected_shipping_methods
  • Datos personales completos

    El número total de veces que los usuarios completaron el campo de correo electrónico en la finalización de la compra. Esta métrica puede devolver datos diferentes para un mismo período, ya que Nuvemshop guarda los datos de carritos abandonados por hasta 30 días. Después de este plazo, ya no es posible verificar los datos de esos carritos.

    nuvem_shop:personal_data_filled
  • Direcciones completas

    El número total de veces que los usuarios completaron la dirección de entrega en la finalización de la compra. Esta métrica puede devolver datos diferentes para un mismo período, ya que Nuvemshop guarda los datos de carritos abandonados por hasta 30 días. Después de este plazo, ya no es posible verificar los datos de esos carritos.

    nuvem_shop:shipping_address_filled

Gráficos

4 métricas

  • Pedidos a lo largo del tiempo

    Este gráfico ilustra la cantidad de ventas realizadas durante el período seleccionado.

    nuvem_shop:orders_over_time
  • Productos vendidos a lo largo del tiempo

    Cantidad de artículos vendidos durante el período analizado.

    nuvem_shop:products_over_time
  • Clientes a lo largo del tiempo

    Este gráfico muestra la evolución del número de Nuevos Clientes y Clientes Recurrentes durante el período seleccionado. Se muestran los días en que hubo clientes nuevos y clientes recurrentes.

    nuvem_shop:new_returning_customers_over_time
  • Ingresos y ticket medio a lo largo del tiempo

    Este gráfico muestra la evolución de los Ingresos Totales y del Ticket Medio durante el período analizado.

    nuvem_shop:revenue_averageTicket_over_time

Tablas

9 métricas

  • Cantidad de Cuotas

    Esta tabla muestra el número de pedidos y los ingresos por número de cuotas.

    nuvem_shop:number_of_installments
  • Desempeño de los Cupones

    Esta tabla muestra el resumen del rendimiento de los cupones.

    nuvem_shop:coupon_performance
  • Desempeño por estado

    Esta tabla muestra un resumen del rendimiento por estado durante el período analizado.

    nuvem_shop:province_performance
  • Desempeño por envío

    Esta tabla muestra el valor de las ventas y los ingresos agrupados por configuración de envío.

    nuvem_shop:shipping_performance
  • Desempeño por medios de envío

    Esta tabla muestra el rendimiento de los métodos de envío durante el período analizado.

    nuvem_shop:shipping_method_performance
  • Desempeño de los métodos de pago

    Esta tabla muestra el rendimiento de cada uno de los métodos de pago disponibles.

    nuvem_shop:payment_method_performance
  • Desempeño de los medios de pago

    Esta tabla muestra el rendimiento de cada uno de los sistemas de pago disponibles.

    nuvem_shop:payment_system_performance
  • Desempeño de los Productos

    Resumen del rendimiento de ventas de productos durante el período analizado.

    nuvem_shop:product_performance
  • Fuentes de tráfico UTM

    Esta tabla muestra los ingresos y el valor de las ventas, agrupados por información sobre el origen de los visitantes que compraron en su tienda.

    nuvem_shop:traffic_source_performance

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.