Metrics
Métricas de Shopify con la API
Tu cliente conecta su cuenta de Shopify y tu producto consulta 33 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": "shopify:processed_orders",
"component": "number_v1",
"metrics": [
"fulfilledOrdersTotal"
],
"dimensions": [
"orders_date"
]
}
]
}Más ejemplos de llamadas a Shopify
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
Ventas por canal
Ventas totales del período asociadas a cada canal de ventas activo.
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": "shopify:sales_per_channel",
"component": "chart_v1",
"metrics": [
"totalSales"
],
"dimensions": [
"orders_channel"
]
}
]
}Tabla
Productos más vendidos
Resumen del rendimiento de ventas de cada producto durante el período analizado. Incluye pedidos realizados a través de todos los canales de venta.
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": "shopify:best_selling_products",
"component": "datatable_v1",
"metrics": [
"vendor",
"productType",
"currentQuantity",
"grossSales",
"liquidSales",
"discount",
"refund",
"tax",
"totalSales"
],
"dimensions": [
"orders_products"
]
}
]
}Número
Beneficio bruto total
El beneficio total obtenido de los productos durante el período analizado. Se calcula restando el costo a las ventas netas.
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": "shopify:gross_profit",
"component": "number_v1",
"metrics": [
"grossProfitTotal"
],
"dimensions": [
"orders_products"
]
}
]
}Números
21 métricas
Pedidos procesados
El número acumulativo de pedidos procesados y marcados como procesados durante el período de análisis.
shopify:processed_ordersBeneficio bruto total
El beneficio total obtenido de los productos durante el período analizado. Se calcula restando el costo a las ventas netas.
shopify:gross_profitVentas Totales
Las ventas totales equivalen a las ventas brutas más envío, impuestos, aranceles de importación y tasas, menos el valor de los descuentos y devoluciones. Incluye todos los canales de ventas.
shopify:total_sales_valueReembolsos
Número total de artículos devueltos durante el período seleccionado.
shopify:refundsTotal de pedidos
El número total de pedidos realizados a través de todos los canales de venta.
shopify:total_ordersTasa de Clientes Recurrentes
El porcentaje de personas que han realizado más de un pedido en la tienda. La tasa se calcula dividiendo el número de clientes recurrentes por el número total de clientes que han realizado un pedido en el período seleccionado.
shopify:recurring_customers_rateTicket Promedio
El valor promedio de todos los pedidos (excluyendo tarjetas de regalo) dividido por el número total de pedidos con al menos un producto que no sea tarjeta de regalo. El valor del pedido excluye ajustes posteriores al pedido como ediciones, intercambios o devoluciones, así como derechos de importación, otros impuestos, envío y descuentos.
shopify:average_ticketDescuentos
Valor total de los descuentos concedidos durante el período analizado. Esta métrica incluye todos los canales de ventas.
shopify:discountsVentas Brutas
Valor de todos los artículos comprados antes de la adición de impuestos u otros ajustes, como derechos, envío, descuentos o devoluciones. Esta métrica incluye todos los canales de ventas.
shopify:gross_salesTasa de sell-through
Valor de todos los artículos comprados antes de la adición de impuestos u otros ajustes, como derechos, envío, descuentos o devoluciones. Esta métrica incluye todos los canales de ventas.
shopify:sell_throughPromedio de unidades pedidas
Promedio de unidades pedidas durante el período de análisis.
shopify:average_units_soldPedidos cancelados
Número total de pedidos cancelados durante el período seleccionado.
shopify:canceled_ordersPedidos entregados
Número total de pedidos entregados durante el período seleccionado.
shopify:delivered_ordersBeneficio neto
Beneficio total obtenido de los productos durante el período analizado. Se calcula restando el costo de las ventas netas.
shopify:net_profitVentas netas
Ventas totales menos el valor de los descuentos y devoluciones. Incluye todos los canales de venta.
shopify:net_salesVentas pagadas
Ventas netas considerando solo los pedidos con pago confirmado. Los pedidos con pago pendiente o vencido, como Pix o boleto no pagados, quedan fuera hasta que se paguen.
shopify:paid_salesValor de los reembolsos
Valor total de los reembolsos otorgados durante el período analizado. Esta métrica incluye todos los canales de venta.
shopify:refunds_valueValor del Envío
Valor total de los costos de envío durante el período analizado. Esta métrica incluye todos los canales de venta.
shopify:shipping_valueClientes Nuevos
El número de clientes que hicieron su primera compra durante el período analizado.
shopify:new_customersClientes Recurrentes
El número de clientes que ya habían realizado compras anteriores y regresaron para comprar durante el período analizado.
shopify:recurring_customersTotal de Ventas de Clientes Nuevos
Total de ventas de la primera compra de los clientes nuevos en el período analizado. Las ventas totales son iguales a las ventas brutas más flete, impuestos, tributos de importación y tasas, menos el valor de descuentos y devoluciones. Incluye todos los canales de ventas.
shopify:new_customers_total_sales
Gráficos
5 métricas
Ventas por canal
Ventas totales del período asociadas a cada canal de ventas activo.
shopify:sales_per_channelPedidos a lo largo del tiempo
Número de pedidos realizados durante el período analizado.
shopify:orders_over_timeProcesamiento de pedidos a lo largo del tiempo
El número acumulativo de pedidos procesados y marcados como procesados durante el período analizado.
shopify:orders_processing_over_timeVentas totales a lo largo del tiempo
Ventas totales durante el período seleccionado. Se iguala a las ventas brutas más envío, impuestos, aranceles de importación y tasas, menos el valor de los descuentos y devoluciones. Incluye todos los canales de ventas.
shopify:sales_over_timeTotal de ventas por hora
Valor total de las ventas por hora. Los datos se calculan sumando las ventas brutas más envío, impuestos, aranceles de importación y tasas, menos el valor de descuentos y devoluciones. El valor incluye todos los canales de ventas.
shopify:sales_per_hour
Tablas
7 métricas
Productos más vendidos
Resumen del rendimiento de ventas de cada producto durante el período analizado. Incluye pedidos realizados a través de todos los canales de venta.
shopify:best_selling_productsBeneficio por producto
Summary of gross profit performance by product for the selected period. Only products whose cost was recorded at the time of sale are listed.The number of sales.
shopify:profit_by_productBeneficio por variante de producto
Resumen del rendimiento del beneficio bruto por variante de producto para el período seleccionado. Solo se enumeran los productos cuyo coste se registró en el momento de la venta.
shopify:profit_by_product_variantVentas por Referente de Tráfico
Ventas totales de cada fuente de tráfico durante el período analizado.
shopify:sales_by_referrerVentas por Red Social de Origen
Ventas totales resultantes de sesiones de tienda virtual que provienen de fuentes de referencia de redes sociales, como Facebook e Instagram. Esta métrica solo es válida para el canal de ventas de Tienda Virtual.
shopify:sales_by_sourceResumen de pedidos
Resumen de los pedidos del período analizado
shopify:orders_summaryResumen de Ventas
Resumen del rendimiento de las ventas para el período durante el marco de tiempo analizado.
shopify:sales_summary
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
