Dokumentation

Was eine Session ist

Eine Session ist alles, was ein Besucher uns zwischen Mitternacht und Mitternacht sendet, gemessen in der Zeitzone Ihres Projekts. Alles auf dieser Seite spielt sich innerhalb dieses einen Tages ab: Nach Mitternacht beginnt derselbe Besucher eine neue Session, die sich nicht mehr mit der vorherigen verbinden lässt. Innerhalb des Tages hält die Identität über Seitenaufrufe, Neuladen und Browser-Tabs hinweg – wer fünf Seiten liest, ist eine Session und nicht fünf. Ermittelt wird die Identität auf unseren Servern aus der Anfrage selbst: Der Tracker sendet keine Kennung, und weder Cookies noch localStorage oder sessionStorage sind beteiligt.

Eine Session ist nicht dasselbe wie ein Besuch. Ein Besuch ist alles, was jemand am Stück macht: Er endet nach 30 Minuten ohne Aktivität und in jedem Fall um Mitternacht. Wer morgens und abends auf Ihrer Website ist, hat zwei Besuche innerhalb einer Session gemacht. Flows zählen Besuche; die Besucherzahlen überall sonst zählen Sessions.

Was eine Session zusammenhält

• Bewegung innerhalb einer Single-Page-App: Die Session ändert sich nicht. Navigation in der App ist derselbe Besucher am selben Tag.
• Eine neue Seite laden: ebenfalls dieselbe Session. Eine Website aus ganz gewöhnlichen einzelnen Seiten ist hier nicht im Nachteil – wer zwanzig Seiten lädt, ist eine Session und nicht zwanzig.

Um Mitternacht in der Zeitzone Ihres Projekts endet jede Session, und eine neue beginnt. Die beiden lassen sich danach nicht mehr miteinander verbinden, weder von uns noch von jemand anderem. Diese Zeitzone wählen Sie selbst: siehe Einstellungen → Allgemein.

Wozu Sessions dienen

Jedes Event trägt seine Session als Identität des Besuchers für diesen Tag mit sich. Erst dadurch kann das Produkt:

• die Handlungen einer Person zusammenfassen, statt jeden Klick als Fremden zu behandeln
• berichten, wie viele Leute da waren, und nicht nur, wie viele Klicks es gab – die Zahl „Eindeutige Sessions“ auf der Übersicht und in Ihren Berichten
• jemandem durch die Schritte eines Funnels folgen und von einer Seite zur nächsten in Flows

Weil eine Session einen Tag lang gilt, steckt ein Besucher, der jeden Tag wiederkam, in einer Wochensumme siebenmal. Das ist Absicht und der Preis dafür, niemanden über Tage hinweg zu verfolgen.

Session-Traits

Sie können einer Session Traits anhängen und anschließend jeden Bericht nur für die Besucher mit einem dieser Traits lesen. Ein Trait ist ein schlichtes Wort und kein Schlüssel-Wert-Paar: plan:pro liest sich für Menschen angenehm, aber nichts im Produkt trennt es am Doppelpunkt. Es wird als Ganzes gespeichert und verglichen. Setzen Sie Traits am Script-Tag über data-traits, das eine kommagetrennte Liste erwartet, oder aus Ihrem Code über window.tracker.setTraits(), das ein Array erwartet:

<!-- Via script tag -->
<script
  src="https://api.privatrak.com/tracker.js"
  data-api-key="your-public-key"
  data-traits="plan:pro,role:admin"
  defer
></script>

// Programmatically
window.tracker.setTraits(['plan:pro', 'role:admin']);

Traits hängen an ganzen Paketen von Events. Alles, was nach dem Setzen erfasst wird, trägt sie also mit. Im Browser wird nichts aufbewahrt, deshalb beginnt jeder Seitenaufruf ohne Traits, bis Ihr Script-Tag oder Ihr Code sie erneut setzt.

setTraits() ersetzt die ganze Liste, statt sie zu ergänzen. Ein zweiter Aufruf mit einem einzelnen Trait entfernt die zuvor gesetzten. Übergeben Sie deshalb immer alle Traits, die die Session tragen soll.

Traits werden angehängt, wenn ein Paket gesendet wird, und nicht im Moment des einzelnen Events. Gesendet wird etwa alle fünf Sekunden oder sobald zehn Events aufgelaufen sind. Ein Aufruf von setTraits() erfasst deshalb auch die Events, die noch auf den Versand warten.

Jeder verschiedene Trait, den Ihr Tracker sendet, belegt einen Platz in Ihrem Projekt, und Ihr Plan bestimmt, wie viele Plätze es gibt. Welche Traits in Gebrauch sind und wie Sie einen Platz wieder freigeben, sehen Sie unter Einstellungen → Trait-Schlüssel.

Was eine Session Ihnen sagen kann und was nicht

• Nichts reicht über den Tag hinaus: Es gibt keine Möglichkeit zu erkennen, dass der heutige Besucher der von gestern ist. Wiederkehrende Kunden, wochenlange Entscheidungswege und Kundenwert über die Zeit liegen außerhalb dessen, was hier geht – mit Absicht.
• Tabs und Neuladen kosten nichts: mehrere Tabs gleichzeitig, ein Neuladen oder den Browser schließen und eine Stunde später zurückkommen – all das bleibt dieselbe Session, solange es derselbe Tag ist.
• Zwei Personen können zu einer werden: Besucher, die sich einen Internetanschluss teilen und dieselbe Browser-Version benutzen, sehen für uns identisch aus und teilen sich eine Session. Bei privatem Verkehr ist das selten, hinter einem Firmennetz nicht.
• Eine Person kann zu zweien werden: Wer mitten im Besuch vom WLAN ins Mobilfunknetz wechselt, beginnt eine neue Session, weil die Identität aus der Verbindung ermittelt wird, über die jemand ankommt.

Wie die Identität ermittelt wird

Das ist der einzige Absatz, in dem es um Kryptografie geht. Kommt ein Event an, nimmt der Server die IP-Adresse des Besuchers, die User-Agent-Kennung seines Browsers und die ID Ihres Projekts und schickt sie durch eine Einwegfunktion mit Schlüssel – einen HMAC –, deren geheimer Schlüssel um Mitternacht in der Zeitzone Ihres Projekts ausgetauscht wird. „Einweg“ heißt: Aus dem Ergebnis lässt sich keine IP-Adresse zurückgewinnen. IP und User-Agent dienen nur dieser Berechnung und werden danach verworfen, nie gespeichert und nie protokolliert. Weil der Schlüssel täglich wechselt, ergibt derselbe Besucher morgen einen völlig anderen Wert; zwei Tage lassen sich deshalb auch von uns nicht zusammenfügen. Es ist derselbe Ansatz, den Plausible Analytics verwendet und den die französische Datenschutzbehörde als zulässig bewertet hat. Das ganze Bild steht in der Datenschutz-Dokumentation.