Metrics
Métriques Nuvemshop via l'API
Votre client connecte son compte Nuvemshop et votre produit interroge 26 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": "nuvem_shop:sales",
"component": "number_v1",
"metrics": [
"sales_count"
],
"dimensions": [
"orders"
]
}
]
}Plus d'exemples d'appels Nuvemshop
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
Commandes au fil du temps
Ce graphique illustre la quantité de ventes réalisées pendant la période sélectionnée.
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"
]
}
]
}Tableau
Quantité de paiements échelonnés
Ce tableau montre le nombre de commandes et la recette par nombre de paiements échelonnés.
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"
]
}
]
}Chiffre
Revenu
La somme des paiements effectués par vos clients (hors commandes annulées) pendant la période analysée.
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"
]
}
]
}Chiffres
13 métriques
Soldes
Le nombre total de ventes avec paiement confirmé pour la période sélectionnée.
nuvem_shop:salesRevenu
La somme des paiements effectués par vos clients (hors commandes annulées) pendant la période analysée.
nuvem_shop:revenueCoupons valides
Le nombre de coupons actifs pendant la période analysée.
nuvem_shop:couponsClients 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.
nuvem_shop:recurring_customersNouveaux clients
Le nombre de clients ayant effectué leur premier achat pendant la période analysée.
nuvem_shop:new_customersProduits vendus
Le nombre total d'articles vendus pendant la période analysée.
nuvem_shop:sold_productsTicket Moyen
Le ticket moyen est calculé en divisant la recette totale par le nombre de ventes réalisées pendant la période sélectionnée. Cette métrique fournit une vue sur la valeur moyenne dépensée par transaction.
nuvem_shop:average_ticketPaniers convertis en ventes
Le nombre de fois que les utilisateurs ont cliqué sur 'Finaliser la commande' au moment du paiement.
nuvem_shop:all_salesPaniers susceptibles de devenir des ventes
Le nombre de fois que le paiement a été abandonné après le remplissage de l'adresse de livraison et le passage à la deuxième étape du processus d'achat. Cette métrique peut retourner des données différentes pour une même période, car Nuvemshop conserve les données des chariots abandonnés pendant jusqu'à 30 jours. Après cette période, il n'est plus possible de vérifier les données de ces chariots.
nuvem_shop:abandoned_checkoutsModes de paiement sélectionnés
Le nombre total de fois qu'un mode de paiement a été sélectionné lors de la finalisation de l'achat. Cette métrique peut retourner des données différentes pour une même période, car Nuvemshop conserve les données des chariots abandonnés pendant jusqu'à 30 jours. Après cette période, il n'est plus possible de vérifier les données de ces chariots.
nuvem_shop:selected_payment_methodsModes d'expédition sélectionnés
Le nombre total de fois qu'un client a sélectionné un mode d'expédition lors de la finalisation de l'achat. Cette métrique peut retourner des données différentes pour une même période, car Nuvemshop conserve les données des chariots abandonnés pendant jusqu'à 30 jours. Après cette période, il n'est plus possible de vérifier les données de ces chariots.
nuvem_shop:selected_shipping_methodsDonnées personnelles complètes
Le nombre total de fois que les utilisateurs ont rempli le champ e-mail lors de la finalisation de l'achat. Cette métrique peut retourner des données différentes pour une même période, car Nuvemshop conserve les données des chariots abandonnés pendant jusqu'à 30 jours. Après cette période, il n'est plus possible de vérifier les données de ces chariots.
nuvem_shop:personal_data_filledAdresses complètes
Le nombre total de fois que les utilisateurs ont rempli l'adresse de livraison lors de la finalisation de l'achat. Cette métrique peut retourner des données différentes pour une même période, car Nuvemshop conserve les données des chariots abandonnés pendant jusqu'à 30 jours. Après cette période, il n'est plus possible de vérifier les données de ces chariots.
nuvem_shop:shipping_address_filled
Graphiques
4 métriques
Commandes au fil du temps
Ce graphique illustre la quantité de ventes réalisées pendant la période sélectionnée.
nuvem_shop:orders_over_timeProduits vendus au fil du temps
Quantité d'articles vendus pendant la période analysée.
nuvem_shop:products_over_timeClients au fil du temps
Ce graphique affiche l'évolution du nombre de Nouveaux Clients et de Clients Récurrents pendant la période sélectionnée. Il affiche les jours où il y a eu des clients nouveaux et des clients récurrents.
nuvem_shop:new_returning_customers_over_timeRevenus et ticket moyen au fil du temps
Ce graphique montre l'évolution de la Recette Totale et du Ticket Moyen pendant la période analysée.
nuvem_shop:revenue_averageTicket_over_time
Tableaux
9 métriques
Quantité de paiements échelonnés
Ce tableau montre le nombre de commandes et la recette par nombre de paiements échelonnés.
nuvem_shop:number_of_installmentsPerformance des coupons
Ce tableau montre le résumé de la performance des coupons.
nuvem_shop:coupon_performancePerformance par état
Ce tableau montre un résumé de la performance par état pendant la période analysée.
nuvem_shop:province_performancePerformance par frais d'expédition
Ce tableau montre la valeur des ventes et la recette regroupées par configuration d'expédition.
nuvem_shop:shipping_performancePerformance par moyens d'expédition
Ce tableau montre la performance des modes d'expédition pendant la période analysée.
nuvem_shop:shipping_method_performancePerformance des méthodes de paiement
Ce tableau montre la performance de chacun des modes de paiement disponibles.
nuvem_shop:payment_method_performancePerformance des moyens de paiement
Ce tableau montre la performance de chacun des systèmes de paiement disponibles.
nuvem_shop:payment_system_performancePerformance des produits
Résumé de la performance des ventes de produits pendant la période analysée.
nuvem_shop:product_performanceSources de trafic UTM
Ce tableau montre la recette et la valeur des ventes, regroupées par informations sur l'origine des visiteurs ayant acheté dans votre boutique.
nuvem_shop:traffic_source_performance
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
