Metrics

Métriques Shopify via l'API

Votre client connecte son compte Shopify et votre produit interroge 33 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.

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"
      ]
    }
  ]
}
Exemple : « Commandes traitées » en octobre, comparé à septembre.

Plus d'exemples d'appels Shopify

Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).

Graphique

Ventes par canal

Ventes totales pour la période associées à chaque canal de vente actif.

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"
      ]
    }
  ]
}

Tableau

Produits les plus vendus

Résumé des performances de vente pour chaque produit pendant la période analysée. Comprend les commandes passées sur tous les canaux de vente.

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"
      ]
    }
  ]
}

Chiffre

Bénéfice brut total

Le bénéfice total obtenu des produits pendant la période analysée. Il est calculé en soustrayant le coût des ventes nettes.

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"
      ]
    }
  ]
}

Chiffres

21 métriques

  • Commandes traitées

    Le nombre cumulatif de commandes traitées et marquées comme traitées pendant la période d'analyse.

    shopify:processed_orders
  • Bénéfice brut total

    Le bénéfice total obtenu des produits pendant la période analysée. Il est calculé en soustrayant le coût des ventes nettes.

    shopify:gross_profit
  • Ventes Totales

    Les ventes totales équivalent aux ventes brutes plus les frais d'expédition, taxes, droits de douane et frais, moins la valeur des remises et retours. Cela inclut tous les canaux de vente.

    shopify:total_sales_value
  • Remboursements

    Nombre total d'articles retournés pendant la période sélectionnée.

    shopify:refunds
  • Total des commandes

    Le nombre total de commandes passées sur tous les canaux de vente.

    shopify:total_orders
  • Taux de Clients Récurrents

    Le pourcentage de personnes ayant passé plus d'une commande dans la boutique. Le taux est calculé en divisant le nombre de clients récurrents par le nombre total de clients ayant passé une commande pendant la période sélectionnée.

    shopify:recurring_customers_rate
  • Ticket Moyen

    La valeur moyenne de toutes les commandes (hors cartes cadeaux) divisée par le nombre total de commandes comprenant au moins un produit autre qu'une carte cadeau. La valeur de la commande exclut les ajustements post-commande tels que les modifications, échanges ou retours, ainsi que les droits de douane, autres taxes, frais de port et remises.

    shopify:average_ticket
  • Remises

    Valeur totale des remises accordées pendant la période analysée. Cette métrique inclut tous les canaux de vente.

    shopify:discounts
  • Ventes Brutes

    Valeur de tous les articles achetés avant l'ajout de taxes ou d'autres ajustements, tels que les droits, l'expédition, les réductions ou les retours. Cette métrique inclut tous les canaux de vente.

    shopify:gross_sales
  • Taux de rotation des stocks

    Valeur de tous les articles achetés avant l'ajout de taxes ou d'autres ajustements, tels que les droits, l'expédition, les réductions ou les retours. Cette métrique inclut tous les canaux de vente.

    shopify:sell_through
  • Moyenne des unités commandées

    Nombre moyen d'unités commandées pendant la période d'analyse.

    shopify:average_units_sold
  • Commandes annulées

    Nombre total de commandes annulées pendant la période sélectionnée.

    shopify:canceled_orders
  • Commandes livrées

    Nombre total de commandes livrées pendant la période sélectionnée.

    shopify:delivered_orders
  • Bénéfice net

    Bénéfice total obtenu des produits pendant la période analysée. Il est calculé en soustrayant le coût des ventes nettes.

    shopify:net_profit
  • Ventes nettes

    Total des ventes moins la valeur des remises et des retours. Cela inclut tous les canaux de vente.

    shopify:net_sales
  • Ventes payées

    Ventes nettes ne prenant en compte que les commandes dont le paiement est confirmé. Les commandes au paiement en attente ou expiré, comme un Pix ou un boleto non payé, ne sont comptées qu'une fois payées.

    shopify:paid_sales
  • Valeur des remboursements

    Valeur totale des remboursements accordés pendant la période analysée. Cette métrique inclut tous les canaux de vente.

    shopify:refunds_value
  • Valeur de l'Expédition

    Valeur totale des frais de livraison pendant la période analysée. Cette métrique inclut tous les canaux de vente.

    shopify:shipping_value
  • Nouveaux clients

    Le nombre de clients ayant effectué leur premier achat pendant la période analysée.

    shopify:new_customers
  • Clients récurrents

    Le nombre de clients ayant déjà effectué des achats précédents et étant revenus pour acheter pendant la période analysée.

    shopify:recurring_customers
  • Total des Ventes des Nouveaux Clients

    Total des ventes du premier achat des nouveaux clients pendant la période analysée. Les ventes totales sont égales aux ventes brutes plus le fret, les impôts, les droits d'importation et les frais, moins le montant des remises et des retours. Inclut tous les canaux de vente.

    shopify:new_customers_total_sales

Graphiques

5 métriques

  • Ventes par canal

    Ventes totales pour la période associées à chaque canal de vente actif.

    shopify:sales_per_channel
  • Commandes au fil du temps

    Nombre de commandes effectuées pendant la période analysée.

    shopify:orders_over_time
  • Traitement des commandes dans le temps

    Le nombre cumulatif de commandes traitées et marquées comme traitées sur la période analysée.

    shopify:orders_processing_over_time
  • Ventes totales au fil du temps

    Ventes totales sur la période sélectionnée. Cela équivaut aux ventes brutes plus les frais d'expédition, les taxes, les droits de douane et les frais, moins la valeur des remises et des retours. Comprend tous les canaux de vente.

    shopify:sales_over_time
  • Total des ventes par heure

    Valeur totale des ventes par heure. Les données sont calculées en ajoutant les ventes brutes plus les frais de port, taxes, droits d'importation et frais, moins la valeur des remises et retours. La valeur inclut tous les canaux de vente.

    shopify:sales_per_hour

Tableaux

7 métriques

  • Produits les plus vendus

    Résumé des performances de vente pour chaque produit pendant la période analysée. Comprend les commandes passées sur tous les canaux de vente.

    shopify:best_selling_products
  • Bénéfice par produit

    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
  • Bénéfice par variante de produit

    Résumé de la performance du bénéfice brut par variante de produit pour la période sélectionnée. Seuls les produits dont le coût a été enregistré au moment de la vente sont répertoriés.

    shopify:profit_by_product_variant
  • Ventes par Référent de Trafic

    Ventes totales de chaque source de trafic pendant la période analysée.

    shopify:sales_by_referrer
  • Ventes par Réseau Social d'Origine

    Ventes totales résultant de sessions de boutique virtuelle provenant de sources de référence de réseaux sociaux, telles que Facebook et Instagram. Cette mesure est uniquement valable pour le canal de vente de la Boutique Virtuelle.

    shopify:sales_by_source
  • Résumé des commandes

    Résumé des commandes de la période analysée

    shopify:orders_summary
  • Résumé des Ventes

    Résumé des performances des ventes pour la période sur la durée analysée.

    shopify:sales_summary

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.