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

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:sales
  • Revenu

    La somme des paiements effectués par vos clients (hors commandes annulées) pendant la période analysée.

    nuvem_shop:revenue
  • Coupons valides

    Le nombre de coupons actifs pendant la période analysée.

    nuvem_shop:coupons
  • 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.

    nuvem_shop:recurring_customers
  • Nouveaux clients

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

    nuvem_shop:new_customers
  • Produits vendus

    Le nombre total d'articles vendus pendant la période analysée.

    nuvem_shop:sold_products
  • Ticket 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_ticket
  • Paniers convertis en ventes

    Le nombre de fois que les utilisateurs ont cliqué sur 'Finaliser la commande' au moment du paiement.

    nuvem_shop:all_sales
  • Paniers 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_checkouts
  • Modes 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_methods
  • Modes 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_methods
  • Donné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_filled
  • Adresses 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_time
  • Produits vendus au fil du temps

    Quantité d'articles vendus pendant la période analysée.

    nuvem_shop:products_over_time
  • Clients 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_time
  • Revenus 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_installments
  • Performance des coupons

    Ce tableau montre le résumé de la performance des coupons.

    nuvem_shop:coupon_performance
  • Performance par état

    Ce tableau montre un résumé de la performance par état pendant la période analysée.

    nuvem_shop:province_performance
  • Performance 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_performance
  • Performance 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_performance
  • Performance des méthodes de paiement

    Ce tableau montre la performance de chacun des modes de paiement disponibles.

    nuvem_shop:payment_method_performance
  • Performance des moyens de paiement

    Ce tableau montre la performance de chacun des systèmes de paiement disponibles.

    nuvem_shop:payment_system_performance
  • Performance des produits

    Résumé de la performance des ventes de produits pendant la période analysée.

    nuvem_shop:product_performance
  • Sources 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.