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"
]
}
]
}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:salesIngresos
La suma de los pagos realizados por sus clientes (sin incluir pedidos cancelados) durante el período analizado.
nuvem_shop:revenueCupones válidos
El número de cupones activos en el período analizado.
nuvem_shop:couponsClientes 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_customersClientes Nuevos
El número de clientes que hicieron su primera compra durante el período analizado.
nuvem_shop:new_customersProductos Vendidos
El número total de artículos vendidos durante el período analizado.
nuvem_shop:sold_productsTicket 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_ticketCarritos convertidos en ventas
El número de veces que los usuarios hicieron clic en 'Finalizar Pedido' en el checkout.
nuvem_shop:all_salesCarritos 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_checkoutsMedios 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_methodsMedios 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_methodsDatos 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_filledDirecciones 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_timeProductos vendidos a lo largo del tiempo
Cantidad de artículos vendidos durante el período analizado.
nuvem_shop:products_over_timeClientes 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_timeIngresos 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_installmentsDesempeño de los Cupones
Esta tabla muestra el resumen del rendimiento de los cupones.
nuvem_shop:coupon_performanceDesempeño por estado
Esta tabla muestra un resumen del rendimiento por estado durante el período analizado.
nuvem_shop:province_performanceDesempeñ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_performanceDesempeñ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_performanceDesempeñ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_performanceDesempeño de los medios de pago
Esta tabla muestra el rendimiento de cada uno de los sistemas de pago disponibles.
nuvem_shop:payment_system_performanceDesempeño de los Productos
Resumen del rendimiento de ventas de productos durante el período analizado.
nuvem_shop:product_performanceFuentes 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.
