> ## 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. # Zähler > Transformieren Sie rohe Nutzungsereignisse in abrechenbare Mengen mit Aggregation und Filterung. Zähler wandeln Rohereignisse in abrechenbare Mengen um. Sie filtern Ereignisse und wenden Aggregationsfunktionen (Count, Sum, Max, Last) an, um die Nutzung pro Kunde zu berechnen. Zählererstellungs-Interface mit Ereignisnamen, Aggregationstyp und Filteroptionen ## API-Ressourcen Erstellen Sie Zähler programmatisch über die API. Rufen Sie alle Zähler in Ihrem Konto ab. Holen Sie Details für einen bestimmten Zähler anhand der ID. Archivieren Sie einen Zähler, um die Nachverfolgung der Nutzung zu stoppen. Stellen Sie einen archivierten Zähler wieder her, um die Nachverfolgung fortzusetzen. ## Einen Zähler erstellen Beschreibender Name (z. B. „API Requests“, „Token Usage“) Exakter Ereignisname, der übereinstimmen muss (Groß-/Kleinschreibung beachten). Beispiele: `api.call`, `image.generated` Wählen Sie aus, wie Ereignisse aggregiert werden: * **Count**: Gesamtanzahl von Ereignissen (API-Aufrufe, Uploads) * **Sum**: Addition numerischer Werte (Tokens, Bytes) * **Max**: Höchster Wert im Zeitraum (Spitzenbenutzer) * **Last**: Aktuellster Wert Metadaten-Schlüssel zur Aggregation (erforderlich für alle Typen außer Count). Beispiele: `tokens`, `bytes`, `duration_ms` Einheitenbezeichnung für Rechnungen. Beispiele: `calls`, `tokens`, `GB`, `hours` Ereignisfilterung Fügen Sie Bedingungen hinzu, um zu filtern, welche Ereignisse gezählt werden: * **UND-Logik**: Alle Bedingungen müssen übereinstimmen * **ODER-Logik**: Jede Bedingung kann übereinstimmen **Vergleichsoperatoren**: gleich, ungleich, größer als, kleiner als, enthält Aktivieren Sie Filter, wählen Sie die Logik, und fügen Sie Bedingungen mit Property-Key, Vergleichsoperator und Wert hinzu. Überprüfen Sie die Konfiguration und klicken Sie auf **Create Meter**. ## Analysen anzeigen Zähleranalytik Ihr Zähler-Dashboard zeigt: * **Übersicht**: Gesamtnutzung und Nutzungsgrafik * **Ereignisse**: Einzelne empfangene Ereignisse * **Kunden**: Nutzung und Gebühren pro Kunde ## Abrechnung in Credits statt Währung Standardmäßig berechnen Meter Kunden pro Einheit in Dollar (oder deiner konfigurierten Währung). Du kannst stattdessen ein Meter so konfigurieren, dass es **vom Credit-Guthaben abzieht** – sodass Nutzung Credits verbraucht statt eine monetäre Gebühr zu erzeugen. Die kreditbasierte Abrechnung benötigt eine [Credit-Berechtigung](/features/credit-based-billing), die demselben Produkt zugeordnet ist. Lege zuerst deinen Credit an und verknüpfe ihn dann mit dem Meter. ### Wann man kreditbasierte Abrechnung verwenden sollte | Szenario | Standard (Währung) | Kreditbasiert | | -------------------------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------- | | Einfache Preis pro Einheit (\$0,01/Call) | ✅ Beste Wahl | Überflüssiger Mehraufwand | | Prepaid-Credit-Pakete (10.000 Tokens kaufen, über Zeit nutzen) | ❌ Nicht darstellbar | ✅ Beste Wahl | | Gebündelte Nutzung mit Abos (Pro-Plan enthält 100K Calls) | Möglich über kostenlosen Schwellenwert | ✅ Besser – Credits rollen über, verfallen, werden im Portal angezeigt | | Produkte mit mehreren Metern, die einen Credit-Pool teilen | ❌ Jeder Meter rechnet separat ab | ✅ Alle Meter ziehen von einem Guthaben ab | ### Konfiguration eines Meters für Credit-Abzug Erstelle zuerst einen Credit unter **Products → Credits**. Definiere die Einheit (z. B. „API Calls“, „Tokens“), die Genauigkeit und Lebenszyklus-Einstellungen (Ablauf, Übertragung, Überziehung). Sieh dir den [Credit-Based Billing guide](/features/credit-based-billing) für detaillierte Anleitungen an. Gehe zu deinem nutzungsbasierten Produkt und öffne den Konfigurationsbereich **Meter**. Klicke auf die **+**-Schaltfläche, um ein Meter anzufügen. Konfiguriere wie gewohnt den Ereignisnamen, den Aggregationstyp und die Messeinheit. Aktiviere **Bill usage in Credits** in der Meter-Konfiguration. Dadurch werden die Credit-Einstellungen sichtbar: Zählerkonfiguration mit aktiviertem Umschalter für die Nutzung von Credits Wähle aus, von welcher Credit-Berechtigung dieses Meter abbuchen soll. Die Anzahl der Nutzungseinheiten, die benötigt werden, um 1 Credit abzuziehen. Beispielsweise: * `1` = jedes Meter-Ereignis zieht 1 Credit ab * `100` = 100 Meter-Ereignisse ziehen 1 Credit ab * `1000` = 1.000 API-Aufrufe verbrauchen 1 Credit Der **kostenlose Schwellenwert** gilt weiterhin – Ereignisse unterhalb dieses Schwellenwerts ziehen keine Credits ab. **Beispiel**: Mit einem kostenlosen Schwellenwert von 1.000 und meter-units-per-credit von 1: * Kunde nutzt 2.500 API-Aufrufe * Die ersten 1.000 sind kostenlos * Die verbleibenden 1.500 ziehen 1.500 Credits vom Guthaben ab ### So funktioniert die Credit-Abrechnung Sobald konfiguriert, läuft die Abzugs-Pipeline automatisch ab: 1. **Ereignisse treffen ein** – Deine Anwendung sendet Nutzungsevents über die [Event Ingestion API](/features/usage-based-billing/event-ingestion) 2. **Meter aggregiert** – Ereignisse werden gemäß deiner Meter-Konfiguration aggregiert (Count, Sum, Max, Last) 3. **Hintergrundprozesse** – Jede Minute holt ein Worker neue Ereignisse seit dem letzten Checkpoint 4. **Credits werden abgezogen** – Aggregierte Nutzung wird mit dem `meter_units_per_credit` Satz in Credits umgerechnet und nach **FIFO-Reihenfolge** abgebucht (älteste Grants zuerst) 5. **Überziehungen werden erfasst** – Wenn das Guthaben null erreicht und Überziehung aktiviert ist, läuft die Nutzung weiter und die Überziehung wird gemäß dem konfigurierten Verhalten behandelt (bei Reset erlassen, auf der nächsten Rechnung berechnet oder als Defizit vorgetragen) ```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 ``` Die Credit-Abrechnung läuft asynchron (etwa jede Minute). Zwischen Ereigniseinspeisung und Guthabenabzug kann es zu kurzen Verzögerungen kommen. Gestalte deine Anwendung so, dass sie diese Verzögerung berücksichtigt – verlasse dich nicht auf Echtzeit-Guthabenkontrollen für einzelne Anfragen. ### Mehrere Meter, ein Credit-Pool Du kannst mehrere Meter desselben Produkts mit derselben **Credit-Berechtigung** verknüpfen. Alle Meter ziehen von einem gemeinsamen Guthaben ab. **Beispiel**: Eine KI-Plattform mit zwei Metern: * `text.generation` – 1 Credit pro 1.000 Tokens * `image.generation` – 10 Credits pro Bild Beide ziehen aus dem gleichen „AI Credits“-Pool. Der Kunde sieht ein einheitliches Guthaben in seinem Portal. Nutze unterschiedliche `meter_units_per_credit` Sätze pro Meter, um relative Kosten auszudrücken. Teure Operationen (Bildgenerierung) verlangen weniger Meter-Einheiten pro Credit als günstige (Textvervollständigung). Sieh dir den vollständigen Verlauf der Credit-Abzüge für einen Kunden an. Prüfe das aktuelle Credit-Guthaben eines Kunden über die API. ## Fehlerbehebung * Der Ereignisname muss exakt übereinstimmen (Groß-/Kleinschreibung) * Überprüfe, dass Meter-Filter Ereignisse nicht ausschließen * Verifiziere, dass Kunden-IDs existieren * Deaktiviere Filter vorübergehend zum Testen * Überprüfe, ob Over Property genau dem Metadaten-Schlüssel entspricht * Verwende Zahlen, keine Strings: `tokens: 150` nicht `"150"` * Füge erforderliche Eigenschaften in allen Ereignissen hinzu * Achte auf exakte Groß-/Kleinschreibung * Verwende die korrekten Operatoren für den Datentyp * Stelle sicher, dass Ereignisse gefilterte Eigenschaften enthalten * Überprüfe den Events-Tab, um die tatsächlich empfangenen Ereignisse zu zählen * Verifiziere den Aggregationstyp (Count vs Sum) * Stelle sicher, dass Werte für Sum/Max numerisch sind ## Nächste Schritte Beginne damit, Nutzungsevents aus deiner Anwendung an deine Meter zu senden. Nutze fertige Meter-Konfigurationen für gängige Anwendungsfälle.