> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metronome.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Métriques non monotones croissantes
La plupart des métriques facturables dans Metronome suivent un usage qui ne fait qu’augmenter dans le temps — par exemple, le nombre total d’appels d’API effectués. Ce sont des métriques **monotones croissantes**. Cependant, certaines métriques peuvent fluctuer à la hausse *et* à la baisse sur une période de facturation — par exemple, le nombre d’appareils connectés ou le stockage utilisé. Ce sont des métriques **non monotones croissantes**, et elles nécessitent quelques considérations spéciales lors de l’utilisation des contrats, engagements, crédits, changements de tarifs et API d’usage de Metronome.
Les métriques non monotones croissantes utilisent généralement le type d’agrégation `latest`, qui capture la valeur la plus récemment déclarée à chaque point dans le temps plutôt que de compter ou de sommer tous les événements.
Cette page couvre les nuances comportementales spécifiques aux métriques non monotones croissantes (par exemple, `latest`). Pour des informations générales sur la création de métriques facturables, voir [Créer des métriques facturables](/fr/guides/implement-metronome/core-concepts/create-billable-metrics#1-identify-usage-components).
## Comment Metronome facture les métriques non monotones croissantes
Lorsque Metronome traite une métrique `latest` à des fins de facturation, il calcule le **changement incrémental** entre les fenêtres de déclaration consécutives plutôt que de facturer sur la valeur absolue. C’est une distinction critique qui affecte la façon dont les charges, engagements, crédits et changements de tarifs sont appliqués.
**Exemple :** vous envoyez les valeurs `latest` suivantes sur quatre jours :
| Jour | Valeur déclarée | Quantité incrémentale facturée |
| ------ | --------------- | ------------------------------ |
| Jour 1 | 7 | 7 |
| Jour 2 | 9 | 2 *(9 − 7)* |
| Jour 3 | 10 | 1 *(10 − 9)* |
| Jour 4 | 5 | −5 *(5 − 10)* |
Metronome calcule le changement incrémental quotidien et l’utilise comme quantité facturable. Lorsque la valeur déclarée **diminue**, la quantité incrémentale est **négative**, ce qui se traduit par un crédit au client pour cette période.
## Couverture des engagements et crédits
Les engagements et crédits ne s’appliquent qu’à **l’usage incrémental qui se situe dans leur plage de dates d’effet** — pas à la valeur absolue déclarée.
### Exemple
Supposons que vous ayez une métrique `latest` et envoyez les valeurs suivantes :
* **Jour 1 :** valeur déclarée = **7**
* **Jour 2 :** valeur déclarée = **9**
Vous créez un contrat avec un engagement qui couvre **uniquement à partir du Jour 2**.
Même si la valeur absolue au Jour 2 est 9, l’engagement ne couvre que la **quantité incrémentale** de **2** (le changement de 7 à 9). L’usage du Jour 1 (quantité de 7) n’est pas couvert par l’engagement car il se situe en dehors de la plage d’effet de l’engagement.
| Période | Valeur déclarée | Quantité incrémentale | Couvert par l’engagement ? |
| ------- | --------------- | --------------------- | -------------------------- |
| Jour 1 | 7 | 7 | Non |
| Jour 2 | 9 | 2 | Oui |
Ce comportement garantit que les engagements et crédits sont appliqués proportionnellement à l’usage qui s’est réellement produit pendant leur période d’effet.
La même logique s’applique aux **crédits**. Dans la facture ci-dessous, le crédit de 100 \$ libellé « Free credit » ne couvre que la quantité incrémentale qui tombe dans sa plage de dates d’effet (à partir du 17 mars).
**Exemple de facture avec couverture de crédit :**
| Nom | Engagement ou crédit appliqué | Date d’effet | Quantité | Prix unitaire | Total |
| -------------- | ----------------------------- | ----------------- | -------- | ----------------------- | ------------- |
| Latest Product | – | 1 mars – 17 mars | 40 | 3,00 \$ | 120,00 \$ |
| Latest Product | Free credit | 17 mars – 1 avril | 25 | 4,00 \$ | 100,00 \$ |
| Latest Product | – | 17 mars – 1 avril | 55 | 4,00 \$ | 220,00 \$ |
| | | | | Crédit gratuit consommé | −100,00 \$ |
| | | | | **Total dû** | **340,00 \$** |
Dans cet exemple, le crédit gratuit couvre 25 des 80 unités incrémentales accumulées pendant la période du 17 mars au 1 avril. Les 55 unités restantes sont facturées au tarif standard.
## Changements de tarifs
Lorsqu’un changement de tarif prend effet en milieu de période, Metronome applique chaque tarif uniquement à **l’usage incrémental qui s’est produit pendant la fenêtre d’effet de ce tarif**. Cela interagit avec les métriques non monotones croissantes de deux façons importantes selon que la valeur a augmenté ou diminué.
### Scénario 1 : la valeur augmente (l’incrément est positif)
* **Jour 1 :** valeur déclarée = **7** (tarif = 3,00 \$/unité)
* **Jour 2 :** valeur déclarée = **9** (le tarif passe à 4,00 \$/unité)
La quantité incrémentale au Jour 2 est **2**. Seule cette quantité de 2 est facturée au nouveau tarif de 4,00 $. La quantité de 7 du Jour 1 reste à 3,00 $.
| Période | Quantité | Tarif | Charge |
| ------- | -------- | --------- | ------------ |
| Jour 1 | 7 | 3,00 \$ | 21,00 \$ |
| Jour 2 | 2 | 4,00 \$ | 8,00 \$ |
| | | **Total** | **29,00 \$** |
### Scénario 2 : la valeur diminue (l’incrément est négatif)
Lorsque la valeur déclarée chute après un changement de tarif, la **quantité incrémentale négative** est tarifée au **nouveau tarif**, ce qui se traduit par un crédit à ce tarif.
* **1 mars – 17 mars :** la valeur déclarée atteint **40** (tarif = 3,00 \$/unité)
* **17 mars – 1 avril :** la valeur déclarée chute de **10** (le tarif passe à 4,00 \$/unité)
**Exemple de facture avec changement de tarif et quantité négative :**
| Nom | Date d’effet | Quantité | Prix unitaire | Total |
| -------------- | ----------------- | -------- | ------------- | ------------ |
| Latest Product | 1 mars – 17 mars | 40 | 3,00 \$ | 120,00 \$ |
| Latest Product | 17 mars – 1 avril | −10 | 4,00 \$ | −40,00 \$ |
| | | | **Total dû** | **80,00 \$** |
Dans ce cas, le client est facturé 120,00 $pour la première période à 3,00$/unité, puis crédité de 40,00 $pour la diminution de 10 unités au nouveau tarif de 4,00$, ce qui donne un total net de **80,00 \$**.
Parce que les quantités incrémentales négatives sont tarifées au **tarif actuellement en vigueur** (et non au tarif d’origine), une augmentation de tarif combinée à une diminution d’usage peut entraîner un crédit par unité plus important que la charge d’origine. Assurez-vous que le moment du changement de tarif tient compte de ce comportement.
## Crédits combinés à des changements de tarifs et des baisses d’usage
Lorsqu’un crédit est présent en plus d’un changement de tarif et d’une diminution d’usage, l’interaction entre ces facteurs peut produire des **totaux de facture négatifs**. Cela se produit parce que Metronome évalue chaque ligne de charge indépendamment et applique les crédits au fur et à mesure qu’il rencontre des charges positives — il ne **regarde pas en avant** pour tenir compte des charges négatives qui apparaissent plus tard sur la facture.
### Exemple
En utilisant le même scénario que ci-dessus — un changement de tarif de 3,00 $à 4,00$ le 17 mars, avec un usage passant à 40 puis chutant de 10 — ajoutez maintenant un **crédit gratuit de 100,00 \$** qui couvre toute la période de facturation.
Metronome traite les charges dans l’ordre chronologique :
1. **1 mars – 17 mars :** 40 unités × 3,00 $= 120,00$. Le crédit de 100,00 $est appliqué ici, couvrant 33,33 unités. Les 6,67 unités restantes sont facturées à 3,00$.
2. **17 mars – 1 avril :** −10 unités × 4,00 $= −40,00$. Cette charge négative est traitée telle quelle — le crédit a déjà été consommé.
**Exemple de facture avec crédit, changement de tarif et quantité négative :**
| Nom | Engagement ou crédit appliqué | Date d’effet | Quantité | Prix unitaire | Total |
| -------------- | ----------------------------- | ----------------- | -------- | ----------------------- | ------------- |
| Latest Product | Free credit | 1 mars – 17 mars | 33,33 | 3,00 \$ | 100,00 \$ |
| Latest Product | – | 1 mars – 17 mars | 6,67 | 3,00 \$ | 20,00 \$ |
| Latest Product | – | 17 mars – 1 avril | −10 | 4,00 \$ | −40,00 \$ |
| | | | | Sous-total | 80,00 \$ |
| | | | | Crédit gratuit consommé | −100,00 \$ |
| | | | | **Total dû** | **−20,00 \$** |
Le sous-total des charges est de 80,00 $(le même que dans le scénario sans crédit). Cependant, le crédit complet de 100,00$ a été consommé contre la première tranche de charges positives. Le résultat est un **total dû négatif de −20,00 \$**.
**Metronome ne regarde pas en avant lors de l’application des crédits.** Les crédits sont déduits des postes de charge positifs au fur et à mesure qu’ils sont rencontrés. Le système ne précalcule pas le total net de la facture et ne limite pas le crédit en conséquence. Cela signifie que lorsque des charges positives au début d’une période sont suivies de charges négatives plus tard (en raison d’une diminution d’usage), un crédit peut être entièrement consommé même si le total net de la facture aurait été inférieur au montant du crédit. Cela peut entraîner des totaux de facture négatifs.
Gardez cela à l’esprit lors de la configuration des crédits pour des produits qui utilisent des métriques non monotones croissantes, en particulier en combinaison avec des changements de tarifs en milieu de période.
Lors de l’utilisation de métriques non monotones croissantes, nous recommandons de configurer les engagements et crédits pour couvrir **toute la période de facturation** plutôt qu’une plage de dates partielle. Cela garantit que les crédits sont appliqués de manière holistique sur tous les postes, y compris les charges incrémentales négatives provenant des baisses d’usage, et évite les totaux de facture négatifs inattendus causés par des crédits entièrement consommés contre des charges positives précoces avant que les charges négatives ultérieures ne soient traitées.
## Ventilations de factures
Lorsque vous appelez le [point de terminaison de ventilations de factures](/fr/api-reference/invoices/list-invoice-breakdowns), Metronome renvoie la **quantité incrémentale et son coût associé pour chaque fenêtre de temps** — pas la valeur absolue déclarée. Cela inclut les quantités négatives en cas de baisse d’usage.
### Exemple
Vous envoyez les valeurs `latest` suivantes :
| Jour | Valeur déclarée |
| ------ | --------------- |
| Jour 1 | 7 |
| Jour 2 | 9 |
| Jour 3 | 10 |
| Jour 4 | 5 |
Le point de terminaison des ventilations de factures renvoie :
| Jour | Quantité | Coût |
| ------ | -------- | ------------------ |
| Jour 1 | 7 | 7 × prix unitaire |
| Jour 2 | 2 | 2 × prix unitaire |
| Jour 3 | 1 | 1 × prix unitaire |
| Jour 4 | −5 | −5 × prix unitaire |
La colonne **Quantité** reflète le changement incrémental, et le **Coût** est calculé en fonction de cette quantité incrémentale. Les quantités négatives produisent des coûts négatifs (crédits).
Cette ventilation vous donne une vue granulaire, jour par jour, de la façon dont la valeur de la métrique a changé et de la façon dont chaque changement a été tarifé.
## Points de terminaison d’usage
Contrairement aux ventilations de factures, les [points de terminaison d’usage](/fr/api-reference/usage/get-usage-data-with-paginated-groupings) renvoient la **dernière valeur absolue déclarée par fenêtre de temps** — et non le changement incrémental. La valeur que vous voyez dépend de la granularité demandée.
### Exemple
Vous envoyez les valeurs `latest` suivantes :
| Jour | Valeur déclarée |
| ------ | --------------- |
| Jour 1 | 7 |
| Jour 2 | 8 |
| Jour 3 | 9 |
**Avec une ventilation quotidienne**, le point de terminaison d’usage renvoie :
| Jour | Valeur |
| ------ | ------ |
| Jour 1 | 7 |
| Jour 2 | 8 |
| Jour 3 | 9 |
**Sans ventilation** (période complète), le point de terminaison d’usage renvoie :
| Période | Valeur |
| --------------- | ------ |
| Jour 1 – Jour 3 | 9 |
La valeur renvoyée sans ventilation est la **dernière valeur déclarée** sur l’ensemble de la fenêtre interrogée.
**Distinction clé :** les ventilations de factures montrent les **quantités incrémentales** (le changement entre fenêtres), tandis que les points de terminaison d’usage montrent la **dernière valeur absolue** dans chaque fenêtre. Gardez cette différence à l’esprit lors de la réconciliation des données entre les deux.
## Résumé
| Comportement | À quoi s’attendre |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Quantité de facturation | Changement incrémental entre les fenêtres de déclaration — peut être négatif |
| Engagements et crédits | Appliqués uniquement à l’usage incrémental dans la plage de dates d’effet de l’engagement/crédit |
| Changements de tarifs | Chaque tarif s’applique à la quantité incrémentale pendant sa fenêtre d’effet ; les incréments négatifs sont tarifés au tarif actuel |
| Crédits + changements de tarifs + baisses | Les crédits sont consommés contre les charges positives au fur et à mesure ; ils ne regardent pas en avant. Cela peut entraîner des totaux de facture négatifs. |
| Ventilations de factures | Renvoie les quantités incrémentales et les coûts par fenêtre de temps, y compris les valeurs négatives |
| Points de terminaison d’usage | Renvoie la dernière valeur absolue par fenêtre de temps (non incrémentale) |