Standardmäßig ist die Web-Analyse anonym: Sie zählt Besuche, ohne zu wissen, wer sie gemacht hat. Sobald Sie einen Besucher identifizieren, erscheinen seine Besuche in seiner Kontakt-Zeitleiste, und Segmente können sein Verhalten nutzen.
Da /track ein öffentlicher Endpunkt ist, beweist eine Adresse allein nichts. Die Identifizierung ist daher immer signiert.
identify()
Rufen Sie identify auf, sobald Sie wissen, wer der Besucher ist, mit der Adresse und einer auf Ihrem Server berechneten Signatur.
NotifuseAnalytics.identify('alice@example.com', '<hmac from your server>')
Beide Argumente sind Pflicht: Ohne sie lehnt identify den Aufruf ab, statt still zu scheitern. Abgelehnt werden auch eine Adresse mit mehr als 255 Zeichen und eine Signatur mit mehr als 64 Byte. Eine falsch signierte Adresse scheitert dagegen still: Der Server verwirft die Identität und erfasst den Besuch anonym.
Die Signatur berechnen
Die Signatur ist ein hexadezimal codierter HMAC-SHA256 über den String wa_identify:, gefolgt von der E-Mail-Adresse, mit dem geheimen Schlüssel Ihres Arbeitsbereichs als Schlüssel.
import { createHmac } from 'crypto'
function webIdentifyHmac(email, workspaceSecretKey) {
return createHmac('sha256', workspaceSecretKey)
.update('wa_identify:' + email)
.digest('hex')
}func webIdentifyHMAC(email, workspaceSecretKey string) string {
mac := hmac.New(sha256.New, []byte(workspaceSecretKey))
mac.Write([]byte("wa_identify:" + email))
return hex.EncodeToString(mac.Sum(nil))
}Signieren Sie die Adresse genau so, wie Sie sie an identify übergeben. Die Signatur wird geprüft, bevor die Adresse normalisiert wird, daher muss Alice@Example.com als Alice@Example.com signiert werden.
Warnung
Berechnen Sie die Signatur nie im Browser. Sie existiert, weil jeder an den Tracking-Endpunkt senden kann. Ein geheimer Schlüssel, der mit der Seite ausgeliefert wird, macht sie völlig wirkungslos.
Das Präfix wa_identify: hält diese Signatur von der Signatur in Ihren Abmeldelinks getrennt. Eine aus einer weitergeleiteten E-Mail kopierte Signatur kann daher keinen Besucher identifizieren, und eine von Ihrer Seite kopierte kann niemandes Abonnements ändern.
clearIdentity() sorgt dafür, dass spätere Beats die Identität nicht mehr mitsenden. Bereits Erfasstes wird dadurch nicht anonymisiert.
Identifizierung über E-Mail-Links
Notifuse kann den Links getrackter E-Mails eine signierte Identität hinzufügen. Ein Empfänger, der auf einen solchen Link klickt, wird dann beim Aufruf der Seite erkannt, ohne dass Ihre Website Code dafür braucht.
Diese Funktion ist standardmäßig aus. Aktivieren Sie E-Mail-Empfänger erkennen unter Einstellungen → Web-Analyse.
Hinweis
Anders als bei identify(), das Ihr Server mit Ihrem eigenen Geheimnis aufruft, erzeugt Notifuse diesen Nachweis für jeden Empfänger jedes getrackten Versands. Deshalb hat er eine eigene Einstellung und wird nicht zusammen mit der Web-Analyse aktiviert.
Die Identität ist ein verschlüsselter Parameter nf_id, der 7 Tage nach seiner Erzeugung abläuft. Er wird nur Links hinzugefügt, deren Host in Ihren erlaubten Domains steht, sodass Links zu Drittanbietern in derselben E-Mail ihn nie tragen. Der Tracker liest ihn beim Aufruf der Seite und entfernt ihn aus der URL.
Ein Versand trägt ihn nie, wenn für die Benachrichtigung das Tracking ausdrücklich deaktiviert ist oder (bei der Transaktions-API) wenn die Nachricht CC- oder BCC-Empfänger hat. Die Identität ginge sonst an jemanden, der nicht der Kontakt ist.
Warnung
Das Ausschalten des Klick-Trackings entfernt die Identität nicht. Ohne Weiterleitung, in die er eingebettet werden kann, wird der Parameter direkt in Ihren eigenen Link geschrieben. Um ihn zu unterdrücken, muss das Tracking für die Benachrichtigung deaktiviert oder die Identifizierung über E-Mail-Links ausgeschaltet sein.
Das Ausschalten der Einstellung verhindert nur, dass neue Nachweise erzeugt werden. Ein nf_id, der bereits im Browser eines Besuchers liegt, identifiziert ihn weiter, bis er abläuft, also bis zu 7 Tage später.
Was die Identifizierung erfasst
Sobald ein Besucher identifiziert ist, werden dieser Besuch und alles, was darin bereits erfasst wurde, dem Kontakt zugeordnet:
- In den Analysezeilen: die Adresse des Kontakts. Contact Email wird so zu einer Dimension und Identified Contacts zu einer Kennzahl.
- In der Kontakt-Zeitleiste: ein Eintrag pro aufgerufener Seite und einer, der den Besuch zusammenfasst, dazu alle Ziele als benutzerdefinierte Ereignisse.
Ist die Adresse noch kein Kontakt, wird einer angelegt, mit der Sprache und der Zeitzone, die der Besuch gemeldet hat, und dem aus der IP des Besuchers ermittelten Land, wenn die Standortbestimmung aktiv ist. Ein Wert, den Notifuse nicht speichern kann, etwa eine nicht unterstützte Sprache oder eine unbekannte Zeitzone, wird weggelassen. Ein bestehender Kontakt wird durch einen Besuch nie geändert, und ein so angelegter Kontakt tritt keiner Liste bei.
Im Kontaktblatt
Der Tab Web-Besuche im Blatt eines Kontakts listet seine identifizierten Besuche, die neuesten zuerst: wann, wie lange, wie viele Seiten, woher er kam und mit welchem Gerät. Klappen Sie einen Besuch auf, um seinen Verlauf Seite für Seite zu sehen, mit den unterwegs erreichten Zielen. Über der Liste fasst eine Übersicht den ersten identifizierten Besuch, die erreichten Ziele und die meistbesuchten Seiten zusammen. In Web-Analytics öffnen öffnet das Dashboard, gefiltert auf den Kontakt.
Der Tab ist nur für Mitglieder sichtbar, die die Web-Analyse lesen dürfen, und nur, solange die Web-Analyse aktiviert ist.
Segmente
Das Surfverhalten steht als Aktivitätsbedingungen in einem Segment zur Verfügung:
| Bedingung | Filtert nach |
|---|---|
| Webseite anzeigen | Pfad, Verweildauer auf der Seite, Scrolltiefe, Seitennummer im Besuch, Einstiegsart |
| Website besuchen | Einstiegsseite, Ausstiegsseite, aufgerufene Seiten, Besuchsdauer, Scrolltiefe, erreichte Ziele, Zielwert, Referrer-Domain, UTM-Quelle / -Medium / -Kampagne, Kanal, Kanalgruppe, Gerät, Browser, Betriebssystem, Land |
„Hat /pricing in den letzten 30 Tagen mindestens zweimal aufgerufen“ oder „kam über eine Newsletter-Kampagne und hat mindestens ein Ziel erreicht“ sind damit gewöhnliche Segmentbedingungen. Wie Bedingungen kombiniert werden, steht unter Kontakte.
Hinweis
Navigation löst nie eine Automatisierung aus. Seitenaufrufe und Besuche werden erfasst und sind segmentierbar, aber nur Ziele erreichen Automatisierungen, über den Auslöser custom_event unter dem normalisierten Namen des Ziels. Ziele haben einen angegebenen Typ und sind daher auch über die Bedingung Custom Events Goal erreichbar; siehe Ziele.
Datenschutz
- Es wird kein Cookie gesetzt, und keine Kennung folgt einem Besucher von Website zu Website.
- IP-Adressen dienen zur Standortbestimmung und werden nie gespeichert.
- Ein anonymer Besuch bleibt anonym. Nichts verknüpft ihn nachträglich mit einem Kontakt, der in einer späteren Sitzung identifiziert wurde.
- Das Löschen eines Kontakts entfernt seine Adresse überall, wo sie gespeichert war: in den Analysezeilen, in seinen Zeitleisteneinträgen und in den benutzerdefinierten Ereignissen aus seinen Web-Zielen. Der Traffic bleibt anonym erhalten, sodass sich historische Summen nicht ändern.
Warnung
Ein Besucher, dessen Browser noch einen Nachweis enthält, wird bei seinem nächsten Besuch erneut identifiziert (und erneut als Kontakt angelegt), auch nachdem Sie ihn gelöscht haben. Um das dauerhaft zu verhindern, rufen Sie identify() für diese Adresse nicht mehr auf und schalten Sie die Identifizierung über E-Mail-Links aus, wenn der Nachweis aus einem Link stammt. Ein nf_id, der vor dem Ausschalten der Einstellung erzeugt wurde, funktioniert weiter, bis er abläuft.
Hinweise
- Für die Identifizierung gilt ein Ratenlimit pro Adresse und pro Quell-IP. Für das Anlegen eines neuen Kontakts durch eine Identifizierung gilt zusätzlich ein Ratenlimit pro Arbeitsbereich.
- Wird eine Grenze überschritten, geht bei diesem Beat die Identität verloren, nie der Besuch.
- Jeder Projektionsdurchlauf schreibt höchstens 100 Seitenaufrufe pro Besuch und behält die neuesten. Ein langer Besuch, der über mehrere Durchläufe projiziert wird, kann mehr als 100 Einträge für Seitenaufrufe in der Zeitleiste hinterlassen.
- Ziele, die älter als 24 Stunden sind, werden keiner Zeitleiste hinzugefügt. Ein nachträglich übertragener Offline-Besuch löst also keine Automatisierungen einen Tag zu spät aus.
- API-Referenz
