# Stückkosten

Eine Geschäftskennzahl ist eine Größe, die dein Unternehmen jeden Tag zählt, etwa aktive Kunden, Bestellungen oder API-Anfragen. Ein gespeicherter Kostenbericht, der eine nennt, zeigt neben seinen Kosten die Kosten pro Einheit der Kennzahl auf einer zweiten Achse: die Kosten jedes Tages, jeder Woche, jedes Monats oder Quartals geteilt durch den Betrag der Kennzahl in diesem Abschnitt.

## Bevor du beginnst

- Geschäftskennzahlen anlegen, umbenennen, befüllen und löschen erfordert die Teamrolle Owner oder Editor in einem Workspace, den dein Team bearbeiten kann. Jede Teamrolle kann sie lesen. Siehe [Zugriffsmodell](/de/concepts/access-model).
- Stückkosten brauchen einen gespeicherten Bericht; siehe [Berichte speichern und verwalten](/de/cost-reports/manage).

## Geschäftskennzahl anlegen

<Stepper>

1. Öffne **Geschäftskennzahlen** unter Berichte und wähle **Neue Kennzahl**.
2. Gib in **Geschäftskennzahl anlegen** einen **Name** und eine **Einheit** ein, was eine Einheit zählt, im Singular, etwa Kunde.
3. Gib optional **Label-Spalten** ein, bis zu fünf durch Kommas getrennt, etwa Region oder Tarif. Jeder Wert kann dann mit ihnen gekennzeichnet werden.
4. Wähle **Kennzahl anlegen**.

</Stepper>

:::note
Die Label-Spalten einer Kennzahl stehen fest, sobald sie existiert, weil jeder gespeicherte Wert über sie geführt wird. **Geschäftskennzahl bearbeiten** benennt nur die Kennzahl oder ihre Einheit um.
:::

## Werte aus CSV hochladen

<Stepper>

1. Wähle auf **Geschäftskennzahlen** das Upload-Symbol in der Zeile der Kennzahl, „Werte für“ gefolgt von ihrem Namen.
2. Wähle in **Werte hochladen** eine **CSV-Datei** und dann **Hochladen**.

</Stepper>

Die Datei hat eine Kopfzeile mit einer Spalte `date` (`YYYY-MM-DD`), einer Spalte `amount` (eine Zahl, null oder mehr) und beliebigen Label-Spalten der Kennzahl, in beliebiger Reihenfolge. Jede Zeile ist ein Tag für eine Kombination von Labels; eine Label-Spalte, die eine Zeile leer lässt, ist ohne Label.

```csv
date,amount,region
2026-09-01,120,eu
2026-09-01,80,us
2026-09-02,125,eu
```

Eine Zusammenfassung wie „3 neu, 0 ersetzt, 0 unverändert“ sagt, was der Upload getan hat. Jede Zeile ersetzt den Wert, den die Kennzahl für ihren Tag und ihre Labels schon hat; dieselbe Datei noch einmal hochzuladen ändert also nichts.

## Werte über die Public API senden

`POST /v1/business-metrics/{metricId}/values` nimmt bis zu 10.000 Werte pro Anfrage, jeder ein `date`, ein `amount` als Dezimalzeichenkette und optional `labels` nach Spalte, und speichert sie ebenso: Jeder ersetzt den Wert seines Tages und seiner Labels. `GET /v1/business-metrics/{metricId}/values` liest sie nach Tag zurück. Siehe die [API-Referenz](/api) und [Terraform](/de/developers/terraform) für die Ressource `costfluent_business_metric`.

## Kosten pro Einheit darstellen

<Stepper>

1. Öffne einen gespeicherten Bericht und wähle **Bearbeiten**.
2. Wähle unter **Stückkosten** die Kennzahl, angezeigt als ihr Name und „(pro“ ihre Einheit. **Keine** zeigt nur die Kosten.
3. Wähle **Änderungen speichern**.

</Stepper>

Das Diagramm des Berichts zeichnet dann eine Linie „Kosten pro“, benannt mit der Einheit der Kennzahl, auf einer eigenen Achse rechts, und eine Karte „Durchschnittliche Kosten pro“ zeigt die Kosten des Zeitraums geteilt durch den Betrag der Kennzahl, nur über die Abschnitte, die beides haben.

## Wie es sich verhält

- Stückkosten erfordern die Messgröße **Kosten** und die Granularität Täglich, Wöchentlich, Monatlich oder Quartalsweise. Jede andere Wahl wird mit „Stückkosten erfordern das Maß Kosten und ein Tages-, Wochen-, Monats- oder Quartalsintervall.“ abgelehnt.
- Eine Woche läuft von Montag bis Sonntag, und eine Woche, ein Monat oder ein Quartal summiert die Tagesbeträge der Kennzahl innerhalb des Berichtszeitraums.
- Ein Abschnitt ohne Betrag der Kennzahl oder mit einem Betrag von null hat keine Kosten pro Einheit: Die Linie bricht dort ab, statt auf null zu fallen.
- Alle Labels werden summiert: Die Stückkosten teilen durch den gesamten Betrag der Kennzahl im Abschnitt.
- Ein Bericht, dessen Kosten bei ausgeschalteter Umrechnung in mehr als einer Währung vorliegen, hat keine Stückkosten; siehe [Kostenbeträge](/de/concepts/cost-amounts).
- Ein Upload gilt ganz oder gar nicht: Eine Zeile mit einem Datum, das nicht `YYYY-MM-DD` ist, einem Betrag, der keine Zahl oder kleiner als null ist, einer Label-Spalte, die die Kennzahl nicht hat, einem Label, das eine Tabellenkalkulation als Formel lesen würde, oder einem Tag mit Labels, die schon in einer früheren Zeile stehen, weist die Datei zurück und nennt die ersten fehlerhaften Zeilen. Eine Datei hat höchstens 100.000 Zeilen und 9 MB; teile eine größere nach Datum auf.
- Eine Kennzahl zu löschen löscht ihre Werte, und ein Bericht mit ihren Stückkosten zeigt wieder nur die Kosten.
- Ein Dashboard-Widget zeigt die Stückkosten eines Berichts wie der Bericht. Ein Freigabelink zeigt nur die Kosten des Berichts.

## Verwandte Seiten

- [Berichte speichern und verwalten](/de/cost-reports/manage)
- [Kostendaten erkunden](/de/cost-reports/explore)
- [Kostenbeträge](/de/concepts/cost-amounts)
