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

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_orders
  • Beneficio 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_profit
  • Ventas 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_value
  • Reembolsos

    Número total de artículos devueltos durante el período seleccionado.

    shopify:refunds
  • Total de pedidos

    El número total de pedidos realizados a través de todos los canales de venta.

    shopify:total_orders
  • Tasa 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_rate
  • Ticket 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_ticket
  • Descuentos

    Valor total de los descuentos concedidos durante el período analizado. Esta métrica incluye todos los canales de ventas.

    shopify:discounts
  • Ventas 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_sales
  • Tasa 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_through
  • Promedio de unidades pedidas

    Promedio de unidades pedidas durante el período de análisis.

    shopify:average_units_sold
  • Pedidos cancelados

    Número total de pedidos cancelados durante el período seleccionado.

    shopify:canceled_orders
  • Pedidos entregados

    Número total de pedidos entregados durante el período seleccionado.

    shopify:delivered_orders
  • Beneficio neto

    Beneficio total obtenido de los productos durante el período analizado. Se calcula restando el costo de las ventas netas.

    shopify:net_profit
  • Ventas netas

    Ventas totales menos el valor de los descuentos y devoluciones. Incluye todos los canales de venta.

    shopify:net_sales
  • Ventas 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_sales
  • Valor 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_value
  • Valor 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_value
  • Clientes Nuevos

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

    shopify:new_customers
  • Clientes Recurrentes

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

    shopify:recurring_customers
  • Total 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_channel
  • Pedidos a lo largo del tiempo

    Número de pedidos realizados durante el período analizado.

    shopify:orders_over_time
  • Procesamiento 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_time
  • Ventas 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_time
  • Total 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_products
  • Beneficio 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_product
  • Beneficio 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_variant
  • Ventas por Referente de Tráfico

    Ventas totales de cada fuente de tráfico durante el período analizado.

    shopify:sales_by_referrer
  • Ventas 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_source
  • Resumen de pedidos

    Resumen de los pedidos del período analizado

    shopify:orders_summary
  • Resumen 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.