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"
]
}
]
}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_ordersBé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_profitVentes 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_valueRemboursements
Nombre total d'articles retournés pendant la période sélectionnée.
shopify:refundsTotal des commandes
Le nombre total de commandes passées sur tous les canaux de vente.
shopify:total_ordersTaux 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_rateTicket 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_ticketRemises
Valeur totale des remises accordées pendant la période analysée. Cette métrique inclut tous les canaux de vente.
shopify:discountsVentes 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_salesTaux 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_throughMoyenne des unités commandées
Nombre moyen d'unités commandées pendant la période d'analyse.
shopify:average_units_soldCommandes annulées
Nombre total de commandes annulées pendant la période sélectionnée.
shopify:canceled_ordersCommandes livrées
Nombre total de commandes livrées pendant la période sélectionnée.
shopify:delivered_ordersBé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_profitVentes nettes
Total des ventes moins la valeur des remises et des retours. Cela inclut tous les canaux de vente.
shopify:net_salesVentes 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_salesValeur 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_valueValeur 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_valueNouveaux clients
Le nombre de clients ayant effectué leur premier achat pendant la période analysée.
shopify:new_customersClients 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_customersTotal 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_channelCommandes au fil du temps
Nombre de commandes effectuées pendant la période analysée.
shopify:orders_over_timeTraitement 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_timeVentes 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_timeTotal 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_productsBé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_productBé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_variantVentes par Référent de Trafic
Ventes totales de chaque source de trafic pendant la période analysée.
shopify:sales_by_referrerVentes 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_sourceRésumé des commandes
Résumé des commandes de la période analysée
shopify:orders_summaryRé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.
