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
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.
Hinweis
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.
Warnung
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 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
valuemitNaN(das liefertparseFloat('€49.90')), einer unendlichen Zahl,nulloder 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
propertieswerden als Strings gespeichert, einDateals ISO-String.null,NaN, eine unendliche Zahl und ein ungültigesDatewerden als leerer String gespeichert, ein Eintrag mitundefinedwird ausgelassen. - Ist
propertiesgleichfalse,''oder0, wie escoupon && { 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.
- 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. 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.
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.
Warnung
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 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.
Hinweis
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 Feldcurrency:goal_valueist 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
