> ## Documentation Index > Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # Compteurs > Transformez les événements d'utilisation bruts en quantités facturables grâce à l'agrégation et au filtrage. Les compteurs convertissent les événements bruts en quantités facturables. Ils filtrent les événements et appliquent des fonctions d’agrégation (Count, Sum, Max, Last) pour calculer l’usage par client. Interface de création de compteur montrant le nom de l'événement, le type d'agrégation et les options de filtrage ## Ressources API Créez des compteurs via l’API. Récupérez tous les compteurs de votre compte. Obtenez les détails d’un compteur spécifique par son ID. Archivez un compteur pour arrêter le suivi d’usage. Restaurez un compteur archivé pour reprendre le suivi. ## Création d'un compteur Nom descriptif (par ex. "API Requests", "Token Usage") Nom exact de l’événement à faire correspondre (sensible à la casse). Exemples: `api.call`, `image.generated` Choisissez comment les événements sont agrégés : * **Count**: Nombre total d’événements (appels d’API, téléchargements) * **Sum**: Additionne des valeurs numériques (tokens, octets) * **Max**: Valeur la plus élevée sur la période (pic d’utilisateurs) * **Last**: Valeur la plus récente Clé de métadonnées à agréger (requis pour tous les types sauf Count). Exemples: `tokens`, `bytes`, `duration_ms` Libellé d’unité pour les factures. Exemples: `calls`, `tokens`, `GB`, `hours` Filtrage d'événements Ajoutez des conditions pour filtrer les événements comptés : * **Logique ET** : Toutes les conditions doivent correspondre * **Logique OU** : Toute condition peut correspondre **Comparateurs** : égal, différent, supérieur à, inférieur à, contient Enable filtering, choose logic, add conditions with property key, comparator, and value. Vérifiez la configuration et cliquez sur **Create Meter**. ## Visualisation des analyses Analytique de compteur Votre tableau de bord des compteurs montre : * **Aperçu** : Utilisation totale et graphique d'utilisation * **Événements** : Événements individuels reçus * **Clients** : Utilisation et frais par client ## Facturation en crédits plutôt qu'en devise Par défaut, les compteurs facturent les clients à l’unité en dollars (ou dans la devise que vous avez configurée). Vous pouvez plutôt configurer un compteur pour **déduire d’un solde de crédits** : l’utilisation consomme des crédits plutôt que de générer une charge monétaire. La déduction basée sur les crédits nécessite un [Droit de crédit](/features/credit-based-billing) attaché au même produit. Créez d’abord votre crédit, puis associez-le au compteur. ### Quand utiliser la déduction basée sur les crédits | Scénario | Standard (devise) | Par crédits | | ------------------------------------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------ | | Tarification simple par unité (0,01 \$/appel) | ✅ Mieux adapté | Surcharge inutile | | Packs de crédits prépayés (achetez 10 000 jetons, utilisez-les au fil du temps) | ❌ Impossible à exprimer | ✅ Mieux adapté | | Utilisation groupée avec des abonnements (le plan Pro inclut 100 000 appels) | Possible via un seuil gratuit | ✅ Préférable - les crédits se reportent, expirent, s’affichent dans le portail | | Produits multi-compteurs partageant une réserve de crédits | ❌ Chaque compteur facture séparément | ✅ Tous les compteurs déduisent d’un même solde | ### Configurer un compteur pour déduire des crédits Commencez par créer un crédit dans **Produits → Crédits**. Définissez l’unité (par exemple, « Appels API », « Jetons »), la précision et les paramètres de cycle de vie (expiration, report, dépassement). Consultez le [guide de facturation basée sur les crédits](/features/credit-based-billing) pour des instructions détaillées. Accédez à votre produit basé sur l’utilisation et ouvrez la section de configuration du **compteur**. Cliquez sur le bouton **+** pour joindre un compteur. Configurez comme d’habitude le nom de l’événement, le type d’agrégation et l’unité de mesure. Activez **Facturer l’utilisation en crédits** dans la configuration du compteur. Cela affiche les paramètres de crédit : Configuration du compteur avec la facturation de l'utilisation en bascule des crédits activée Sélectionnez le droit de crédit dont ce compteur doit déduire. Le nombre d’unités d’utilisation requis pour déduire 1 crédit. Par exemple : * `1` = chaque événement de compteur déduit 1 crédit * `100` = 100 événements de compteur déduisent 1 crédit * `1000` = 1 000 appels API consomment 1 crédit Le **seuil gratuit** s’applique toujours : les événements en dessous de ce seuil ne déduisent pas de crédits. **Exemple** : avec un seuil gratuit de 1 000 et 1 unité de compteur par crédit : * Le client utilise 2 500 appels API * Les 1 000 premiers sont gratuits * Les 1 500 restants déduisent 1 500 crédits de leur solde ### Comment fonctionne la déduction de crédits Une fois configuré, le flux de déduction s’exécute automatiquement : 1. **Les événements arrivent** - Votre application envoie les événements d’utilisation via l’[API d’ingestion d’événements](/features/usage-based-billing/event-ingestion) 2. **Le compteur agrège** - Les événements sont agrégés selon la configuration du compteur (Count, Sum, Max, Last) 3. **Les workers d’arrière-plan traitent** - Toutes les minutes, un worker récupère les nouveaux événements depuis le dernier point de contrôle 4. **Les crédits sont déduits** - L’utilisation agrégée est convertie en crédits en utilisant le taux `meter_units_per_credit` et déduite selon l’**ordre FIFO** (les droits les plus anciens sont consommés en premier) 5. **Le dépassement est suivi** - Si le solde atteint zéro et que le dépassement est activé, l’utilisation continue et le dépassement est géré selon le comportement configuré (réinitialisé, facturé sur la prochaine facture, ou reporté comme déficit) ```mermaid theme={null} flowchart LR A[Usage Event] --> B[Meter Aggregation] B --> C{Credits Available?} C -->|Yes| D[Deduct from Balance] C -->|No| E{Overage Enabled?} E -->|Yes| F[Track Overage] E -->|No| G[Block Usage] D --> H[Update Ledger] F --> H ``` La déduction des crédits s’exécute de manière asynchrone (toutes les \~1 minute). Un léger délai peut exister entre l’ingestion de l’événement et la déduction du solde. Concevez votre application pour gérer ce délai : ne comptez pas sur des vérifications de solde en temps réel pour contrôler l’accès sur des requêtes individuelles. ### Plusieurs compteurs, une seule réserve de crédits Vous pouvez lier plusieurs compteurs d’un même produit au **même droit de crédit**. Tous les compteurs déduisent d’un solde partagé unique. **Exemple** : une plateforme IA avec deux compteurs : * `text.generation` - 1 crédit pour 1 000 jetons * `image.generation` - 10 crédits par image Les deux déduisent de la même réserve « Crédits IA ». Le client voit un solde unifié dans son portail. Utilisez des taux `meter_units_per_credit` différents selon les compteurs pour exprimer des coûts relatifs. Les opérations coûteuses (génération d’images) consomment moins d’unités de compteur par crédit que les opérations bon marché (complétion de texte). Affichez l’historique complet de déduction de crédits d’un client. Vérifiez le solde de crédits actuel d’un client via l’API. ## Dépannage * Le nom de l’événement doit correspondre exactement (sensible à la casse) * Vérifiez que les filtres du compteur n’excluent pas d’événements * Assurez-vous que les identifiants de client existent * Désactivez temporairement les filtres pour tester * Vérifiez que la propriété Over correspond exactement à la clé des métadonnées * Utilisez des nombres, pas des chaînes : `tokens: 150` et non `"150"` * Incluez les propriétés requises dans tous les événements * Respectez la casse * Utilisez les opérateurs adaptés au type de données * Assurez-vous que les événements contiennent les propriétés filtrées * Consultez l’onglet Événements pour comptabiliser les événements réellement reçus * Vérifiez le type d’agrégation (Count vs Sum) * Assurez-vous que les valeurs sont numériques pour Sum/Max ## Prochaines étapes Commencez à envoyer des événements d’utilisation depuis votre application vers vos compteurs. Utilisez des configurations de compteurs prêtes à l’emploi pour des cas d’usage courants.