> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ziele

> Erfassen Sie Konversionen auf Ihrer Website und nutzen Sie sie in Segmenten und Automatisierungen.

![Bereich Ziele mit einer Karte pro Ziel, die Anzahl, Konversionsrate, Gesamtwert und Medianwert im Vergleich zum vorherigen Zeitraum zeigt](https://www.notifuse.com/docs/assets/screenshots/web_analytics/goals.png)

Ein Ziel ist etwas, das sich zu zählen lohnt: eine Registrierung, ein Kauf, eine Demo-Anfrage. Ihre Website meldet es, und die Web-Analyse erfasst es zu dem Besuch, der es ausgelöst hat.

## Ein Ziel erfassen

```javascript
NotifuseAnalytics.trackGoal({ action: 'purchase', type: 'purchase', value: 49.9 })
```

| Feld         | Pflicht | Hinweise                                                                                                                        |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `action`     | Ja      | Der Name des Ziels, bis zu 100 Byte (100 ASCII-Zeichen, weniger bei Text mit Akzenten oder nicht lateinischen Zeichen).         |
| `type`       | Ja      | Die Art der Konversion: `purchase`, `subscription`, `lead`, `signup`, `booking`, `trial` oder `other`.                          |
| `value`      | Nein    | Eine nicht negative Zahl: Umsatz oder was immer Sie aufsummieren.                                                               |
| `properties` | Nein    | Bis zu 50 eigene Werte, 1024 Byte pro Wert und insgesamt 8 KB einschließlich der Schlüssel. Sie werden als Strings gespeichert. |

`type` ist Pflicht, weil nur Ihre Website weiß, ob eine Konversion ein Verkauf oder
ein Lead ist, und die zielbasierten Segmentbedingungen danach filtern. `trackGoal` lehnt ab,
wenn `type` fehlt oder keiner dieser Werte in Kleinbuchstaben ist. Fangen Sie den Fehler also ab,
wenn Sie vor einer Weiterleitung auf `trackGoal` warten. Verwenden Sie `other`, wenn keiner
der anderen Werte passt.

Der aktuelle Seitenpfad und seine Position im Besuch werden automatisch angehängt, sodass ein Ziel immer weiß, wo es erreicht wurde.

> [!NOTE]
>
> Ziele werden sofort gesendet, ohne auf den nächsten Heartbeat zu warten. So kommt auch eine Konversion auf einer Seite an, die der Besucher gleich verlässt.

> [!WARNING]
>
> Ein negativer `value` macht das ganze Ziel ungültig: Verworfen wird das Ziel samt Name, nicht nur die Zahl. Die API für [benutzerdefinierte Ereignisse](https://www.notifuse.com/de/docs/features/custom-events.md) verhält sich hier anders: Sie akzeptiert negative Werte bewusst, für Erstattungen und Rückbuchungen.

Sie müssen Ziele nirgends vorab anlegen. Der Tab Ziele listet alle Namen, die Ihre Website gesendet hat, nach Konversionen sortiert, und zeigt bis zu 30 Ziele mit den meisten Konversionen für den Zeitraum und die angewendeten Filter.

### Werte aus einem Tag-Manager oder einfachem JavaScript

Ein Snippet oder ein Tag-Manager übergibt oft Werte, die von der Seite gelesen wurden. `trackGoal` wandelt daher die gängigen Typen für Sie um:

- Ein `value`, der als String in JSON-Zahlenschreibweise übergeben wird, etwa `'49.90'` oder `'120'`, wird als Zahl gespeichert. `'49,90'`, `'1,299.00'`, `'€49.90'` und `'.5'` gehören nicht dazu, und ein solches Ziel wird wie unten beschrieben ausgelassen.
- Ein `value` mit `NaN` (das liefert `parseFloat('€49.90')`), einer unendlichen Zahl, `null` oder einem leeren String erfasst das Ziel ohne Wert und ohne Warnung. Der Tab Ziele und die Berichte zählen ein solches Ziel bei Durchschnitts- und Medianwerten als 0.
- Zahlen und Booleans in `properties` werden als Strings gespeichert, ein `Date` als ISO-String. `null`, `NaN`, eine unendliche Zahl und ein ungültiges `Date` werden als leerer String gespeichert, ein Eintrag mit `undefined` wird ausgelassen.
- Ist `properties` gleich `false`, `''` oder `0`, wie es `coupon && { coupon }` ohne Gutschein ergibt, wird das Ziel ohne Eigenschaften erfasst.

Ein Ziel, dessen Daten sich trotzdem nicht erfassen lassen, wird mit einer Warnung in der Browserkonsole ausgelassen. Der Aufruf wird dennoch aufgelöst, sodass eine Seite, die vor der Weiterleitung auf `trackGoal` wartet, trotzdem weiterleitet. Das betrifft eine fehlende, leere oder nicht als String übergebene `action` oder eine mit mehr als 100 Byte, einen `value`, der keine Zahl ist oder außerhalb von 0 bis 1e12 liegt, sowie `properties`, die ein Array, ein nicht leerer String, `true` oder eine andere Zahl als `0` und `NaN` sind, ein Objekt oder ein Array enthalten oder die obigen Grenzen überschreiten. Der Rest des Besuchs wird weiter erfasst.

Eine `Map`, `FormData` oder `URLSearchParams` hat keine eigenen Felder. Ein Ziel, das eines davon als `properties` erhält, wird daher ohne Eigenschaften und ohne Warnung erfasst. Übergeben Sie stattdessen `Object.fromEntries(…)` davon und lassen Sie Dateifelder weg, deren Wert ein Objekt ist.

## Was ein Ziel liefert

Das Auge auf der Karte eines Ziels öffnet sein Dashboard in voller Breite. Jede Zahl darauf zählt nur Konversionen dieses Ziels.

![Ziel-Dashboard für add_to_cart: Schaltflächen für vorheriges und nächstes Ziel, der verglichene Zeitraum, die Leiste mit Anzahl, Konv.-Rate, Gesamtwert und Medianwert, ein Tagesdiagramm mit Anmerkungen, eine Heatmap nach Tag und Stunde sowie die Karten Top-Quellen, Top-Kampagnen und Geräte](https://www.notifuse.com/docs/assets/screenshots/web_analytics/goal_dashboard.png)

- **Die Leiste** führt zurück zu den Zielen, wechselt mit den Pfeilen oder mit **K** und **J** zum vorherigen oder nächsten Ziel des Rasters und zeigt den Zeitraum sowie den Vergleichszeitraum. Beide legen Sie im Tab Ziele fest.
- **Gefiltert nach** listet die angewendeten Filter, die sich einzeln entfernen lassen. Es sind die Filter des gesamten Bereichs Web-Analyse: Ein Klick auf eine Zeile oder ein Land im Dashboard fügt dort ebenfalls einen hinzu.
- **Die KPI-Leiste** zeigt Anzahl, Konv.-Rate, Gesamtwert und Medianwert im Vergleich zum Vergleichszeitraum. Ein Klick auf Anzahl, Gesamtwert oder Medianwert stellt den Wert im Diagramm dar.
- **Konv.-Rate** ist die Zahl der Konversionen des Ziels geteilt durch die Sitzungen des Zeitraums, wie auf der Karte des Ziels. Sie zählt Zielereignisse, nicht konvertierende Sitzungen. Ein Ziel, das in einer Sitzung zweimal erreicht wird, zählt also doppelt, und die Rate kann 100 % übersteigen. Ihr Tooltip weist darauf hin, dass sie den gesamten Traffic einschließt, egal weshalb der Besucher kam.
- **Das Diagramm** folgt der Granularität, die Sie darin wählen, und trägt Ihre [Anmerkungen](https://www.notifuse.com/de/docs/web-analytics/annotations.md). Daneben steht eine Heatmap des Ziels nach Tag und Stunde.
- **Die Karten** schlüsseln die Konversionen und ihren Wert auf: Top-Quellen (Referrer, Kanäle, Kanalgruppen), Top-Kampagnen (Kampagnen, Quellen, Medien, ohne Konversionen ohne Kampagne), Geräte (Geräte, Browser, Betriebssysteme), Länder (Karte und Liste), Landingpages (Landingpages und Zielseiten) und eine Karte für Ihre benutzerdefinierten Dimensionen, die einen Namen haben.

In den Berichten liefern Ziele die Kennzahlen Goals, Total Goal Value, Avg Goal Value, Median Goal Value und Converting Sessions sowie die Dimensionen Goal Name, Goal Path und Goal Value. Auf Sitzungsebene können Sie Kanäle mit Sessions with Goals und Goal Value nach Konversionen statt nach Traffic vergleichen.

Bei einem **identifizierten** Besucher wird ein Ziel außerdem zu einem benutzerdefinierten Ereignis in seiner Kontakt-Zeitleiste und ist damit in Segmenten und Automatisierungen nutzbar. Siehe [Besucher identifizieren](https://www.notifuse.com/de/docs/web-analytics/identifying-visitors.md).

## Zielnamen in der Kontakt-Zeitleiste

Ein Ziel, das in eine Kontakt-Zeitleiste gelangt, wird zuerst normalisiert: in Kleinbuchstaben umgewandelt, alles außerhalb von ASCII `a–z`, `0–9`, `.` und `/` zu einem einzelnen `_` zusammengefasst, `_` am Anfang und Ende entfernt und das Ergebnis nach 100 Zeichen abgeschnitten. Aus `Trial Started` wird so `trial_started`, und auf diesen Namen prüft eine Automatisierung oder ein Segment.

> [!WARNING]
>
> Die erlaubten Zeichen sind reines ASCII. Buchstaben mit Akzenten und nicht lateinische Buchstaben werden daher entfernt, nicht transkribiert: `Café` kommt als `caf` an. Ein Name ganz ohne ASCII-Buchstaben oder -Ziffern, etwa `購入`, wird zu nichts normalisiert und erreicht die Zeitleiste nie. Das Ziel wird trotzdem erfasst und ausgewertet; nur die Kopie in der Zeitleiste entfällt. Verwenden Sie ASCII-Zielnamen, wenn Sie darauf segmentieren oder automatisieren.
>
> Diese Regel ist auch enger als die Namensregel für Ereignisse, die über die API für [benutzerdefinierte Ereignisse](https://www.notifuse.com/de/docs/features/custom-events.md) gesendet werden und Bindestriche erlaubt: `black-friday` wird als Web-Ziel zu `black_friday`.

## Web-Ziele in Segmenten nutzen

Ein Web-Ziel trägt dieselben drei Angaben wie ein über die API erstelltes
benutzerdefiniertes Ereignis: einen Namen, einen Wert und einen Typ.

- Die Bedingung **Custom Events Goal** trifft auf Web-Ziele zu, mit einem bestimmten Typ oder
  mit **All types**, und zählt, summiert und mittelt ihren Wert.
- Eine **Automatisierung** kann durch ein benutzerdefiniertes Ereignis mit dem normalisierten Namen des Ziels ausgelöst werden.

> [!NOTE]
>
> Den Typ gibt Ihre Website an, Notifuse prüft ihn nicht, und dieselbe Seite
> legt auch Namen und Wert des Ziels fest. Lesen Sie Umsatzauswertungen mit diesem Wissen, so
> wie bei Ereignissen, die über die API gesendet werden.

## Grenzen

- Pro Schreib-Batch werden bis zu 100 Ziele einer Sitzung in die Kontakt-Zeitleiste übertragen. Weitere Ziele im selben Batch fehlen dauerhaft in der Zeitleiste. Der Zähler beginnt bei jedem Batch neu, sodass ein langer Besuch mit vielen Konversionen insgesamt mehr als 100 Einträge in der Zeitleiste haben kann. Der Besuch selbst wird weiter erfasst; die Grenze betrifft nur die Kopie in der Zeitleiste.
- Ein Ziel, das älter als 24 Stunden ist, wird nicht in eine Zeitleiste übertragen. Ein Besucher, dessen Browser einen Tag offline war, kommt mit vollständigem Besuch zurück, ohne einen Tag zu spät Automatisierungen nach dem Muster „Sie haben gerade …“ auszulösen.
- Ein Ziel mit einem Wert über 1e12, einem Namen über 100 Byte, Eigenschaften mit mehr als 50 Schlüsseln, mehr als 1024 Byte in einem Wert oder mehr als 8 KB insgesamt samt Schlüsseln, einer Eigenschaft mit einem Objekt oder Array oder einem NUL-Zeichen (`\u0000`) im Namen oder in den Eigenschaften wird verworfen: nur das Ziel, nie der Rest des Besuchs.

## Hinweise

- Ziele anonymer Besucher werden ganz normal erfasst und ausgewertet. Nur die Kopie in der Zeitleiste braucht eine Identität.
- Übertragene Ereignisse tragen neben Ihren eigenen Eigenschaften den Kontext des Besuchs als Eigenschaften (Sitzungs-ID, Pfad, Landing-Pfad, UTM-Quelle / -Medium / -Kampagne, Gerät und Land). Diese Schlüssel setzt Notifuse, und sie überschreiben gleichnamige Eigenschaften.
- Eine Währung, eine Bestellnummer oder alles andere, was die Konversion mitbringt, gehört in `properties`, die gesendet und gespeichert werden. Es gibt kein eigenes Feld `currency`: `goal_value` ist eine einfache Zahl. Wenn Sie mehrere Währungen erfassen, gruppieren Sie Ihre Berichte daher nach der Währungseigenschaft, statt Werte über Währungen hinweg zu summieren.
- [API-Referenz](https://www.notifuse.com/docs/api-reference.md)
