Dokumentation

Allgemein

Unter Allgemein stehen die beiden Entscheidungen, die für das ganze Projekt gelten – wie es heißt und wo sein Tag beginnt – und ganz unten die Schaltfläche, die es löscht.

• Projektname: wie das Projekt in der Auswahl oben in der App und in Ihren Einladungen heißt. An Ihren Daten ändert eine Umbenennung nichts.
• Zeitzone: die folgenreichste Einstellung auf dieser Seite. Sie entscheidet, wann Ihr Tag beginnt und endet. Wählen Sie die Zone, in der die meisten Ihrer Besucher sind, nicht die, in der Sie zufällig sitzen.

Jede Tageszahl im Produkt wird an dieser Grenze geschnitten, und alle an derselben: Events pro Tag, jeder Punkt in jedem Tagesdiagramm, Feature-Statistiken, Funnel-Ergebnisse und die Besuche hinter den Flows. Fragen Sie auf einem Projekt mit der Zeitzone New York den 10. März ab, bekommen Sie den New Yorker Tag – genau den Tag, unter dem diese Zahlen von Anfang an abgelegt wurden.

Sie entscheidet außerdem, wann die Identität eines Besuchers erneuert wird. Eine Session gilt einen Tag und beginnt um Mitternacht in dieser Zone von vorn. Die falsche Zone zerschneidet Personen deshalb in zwei Hälften: Ein Projekt voller amerikanischer Besucher, das auf UTC steht, beginnt jeden Tag um 19 Uhr Ortszeit für alle neu, und wer sich einen Abend lang umsieht, wird als zwei Personen gezählt. Genau das soll diese Einstellung verhindern.

Eine Änderung gilt nur für künftige Tage. Bereits erfasste Tage behalten die Grenzen, mit denen sie erfasst wurden, und nichts wird neu berechnet – die detaillierten Besuchsdaten, die die Frage ein zweites Mal beantworten könnten, werden gelöscht, sobald ein Tag zusammengerechnet ist. Rechnen Sie also mit einem Sprung in jedem Diagramm, das über den Umstellungstag läuft, und damit, dass dieser Tag selbst zum Teil alte und zum Teil neue Grenze enthält. Der Sprung ist die Umstellung, nicht Ihr Verkehr.

• Projekt löschen: entfernt das Projekt und alles darin – Events, Funnels, Dashboards, Schlüssel – und lässt sich nicht rückgängig machen. Sie müssen vorher den Projektnamen eintippen. Nur der Eigentümer sieht das.

Tracker

Die Seite Tracker bestimmt, was das Skript auf Ihrer Website erfasst und wie oft es das Erfasste sendet. Das Skript liest diese Einstellungen beim Laden einer Seite, eine Änderung greift also beim nächsten Seitenaufruf – bei Ihnen muss nichts neu ausgeliefert werden.

Was Sie hier einstellen, gilt für jede Seite, die den Schlüssel dieses Projekts verwendet. Eine einzelne Seite kann jede dieser Einstellungen für sich überschreiben, indem ihr Skript-Tag denselben Namen als data--Attribut trägt. Deshalb gibt es beides: Die Einstellung hier ändern Sie, ohne Ihre Website anzufassen; das Attribut ist die Ausnahme für eine einzelne Website oder Seite – etwa eine besonders laute Seite, die anders abgetastet wird, oder eine Testumgebung, die an eine andere Adresse sendet. Scheint eine Änderung hier nichts zu bewirken, suchen Sie im Skript-Tag der betreffenden Seite nach einem Attribut desselben Namens: Es hat Vorrang. Die Tracker-Referenz listet alle auf.

• Sende-Intervall: wie lange das Skript wartet, bevor es das Gesammelte sendet, in Millisekunden. Kürzer heißt, dass Events früher in Ihren Berichten auftauchen, dafür stellt der Browser mehr Anfragen.
• Max. Warteschlangengröße: wie viele Events sich ansammeln dürfen, bevor das Skript sie sendet, ohne das Intervall abzuwarten.
• DOM-Suchtiefe: wie weit das Skript nach außen schaut, wenn jemand etwas Kleines innerhalb eines Buttons anklickt – das Symbol darin etwa –, um den Button selbst zu finden. Drei Ebenen passen für die meisten Seiten; erhöhen Sie den Wert, wenn Ihre Bedienelemente tief verschachtelt sind.
• Max. Textlänge: wie viel vom sichtbaren Text eines Elements aufbewahrt wird, in Zeichen. Längere Beschriftungen werden hier abgeschnitten.
• Abtastrate: welcher Anteil der Seitenaufrufe überhaupt erfasst wird, von 0 % bis 100 %. Die Entscheidung fällt einmal pro Seitenaufruf, nicht einmal pro Besucher. Das Skript würfelt beim Start und speichert nichts im Browser; dieselbe Person kann also auf einer Seite erfasst werden und auf der nächsten nicht. Bei 10 % bekommen Sie ungefähr ein Zehntel aller Seitenaufrufe. Das ist nicht ein Zehntel Ihrer Besucher, dafür aber lückenlos verfolgt – Besucherzahlen wie Funnel-Ergebnisse dünnen deshalb entsprechend aus.
• Auto-Capture: zwei Schalter, einer für Seitenaufrufe und einer namens Interaktionen. Interaktionen umfasst Klicks und abgeschickte Formulare zusammen: Ist er aus, wird eine Formularübermittlung nur aufgezeichnet, wenn das Formular selbst ein data-track-Attribut trägt. Schalten Sie beide aus, wird nichts aufgezeichnet, außer Sie fordern es aus Ihrem eigenen Code an.
• Klickziel-Elemente: die Liste der CSS-Selektoren, die bestimmt, was als anklickbar gilt. Sie beginnt mit Links, Buttons und Absenden-Buttons und dazu einem Dutzend ARIA-Rollen – [role=button], [role=link], [role=menuitem], [role=option], [role=tab], [role=switch] und ähnliche. Dieser letzte Teil ist der Grund, warum Klicks auf Menüs, Reiter und Auswahllisten, die aus schlichten div-Elementen gebaut sind – so bauen die meisten Komponentenbibliotheken sie –, ohne Ihr Zutun erfasst werden.

Datenschutz & Sicherheit

Auf der Seite Datenschutz & Sicherheit legen Sie fest, was niemals erfasst werden darf und wer Ihnen überhaupt etwas senden darf.

• PII-URL-Parameter: Namen von URL-Parametern, deren Wert durch :redacted ersetzt wird, bevor das Event den Browser verlässt. email, token, key, password und secret stehen von Anfang an auf der Liste. Ein Eintrag trifft überall innerhalb eines Parameternamens, und Groß- und Kleinschreibung spielt keine Rolle – email erfasst also auch user_email, und key erfasst auch monkey. Halten Sie die Einträge so genau, dass sie nur treffen, was Sie meinen.
• Ausgeschlossene URLs: Seiten, auf denen überhaupt nichts erfasst wird. Ein Muster darf * für „hier steht irgendetwas“ verwenden, /admin/* deckt also jede Seite in Ihrem Verwaltungsbereich ab.
• Erlaubte Domains: die Websites, die mit Ihrem Schlüssel Events senden dürfen. Lassen Sie die Liste leer, darf es jede Website; füllen Sie sie aus, ist ein von Ihrer Seite abgeschriebener Schlüssel anderswo wertlos.

API-Schlüssel

Auf der Seite API-Schlüssel erstellen Sie die Schlüssel, die Ihr Tracker und Ihr eigener Code verwenden, und widerrufen einen, der abhandengekommen ist. Es gibt zwei Arten:

• Öffentlich: darf nur Events hereinschicken. Dieser gehört in das Script-Tag auf Ihrer Seite, wo ihn jeder sehen kann – das ist ungefährlich, denn lesen kann er nichts.
• Geheim: voller Zugriff auf die Daten Ihres Projekts. Behalten Sie ihn auf Ihrem eigenen Server und legen Sie ihn niemals in etwas, das ein Browser herunterlädt. Das Anlegen neuer geheimer Schlüssel ist derzeit deaktiviert – sofern Ihr Projekt nicht schon einen hat, arbeiten Sie also mit einem öffentlichen Schlüssel.

Den vollständigen Wert eines Schlüssels sehen Sie genau einmal, beim Erstellen – kopieren Sie ihn dann. Danach sind nur noch die ersten Zeichen sichtbar, dazu der Zeitpunkt der letzten Verwendung. Daran erkennen Sie vor dem Widerrufen, ob ein Schlüssel noch im Einsatz oder längst vergessen ist.

Mitglieder

Die Seite Mitglieder bestimmt, wer in dieses Projekt hineinkommt. Eigentümer und Admins laden Personen per E-Mail ein und geben jeder eine von zwei Rollen:

• Admin: darf Einstellungen ändern, API-Schlüssel verwalten und Personen einladen oder entfernen.
• Mitglied: sieht das Projekt und seine Einstellungen und ändert nichts.

Eine Rolle lässt sich direkt in der Tabelle ändern, und wer entfernt wird, ist sofort draußen. Das Projekt umbenennen, seine Zeitzone ändern, es löschen und Trait-Schlüssel löschen bleibt trotzdem beim Eigentümer.

Eine vollständige Übersicht der Rollen und Berechtigungen finden Sie unter Mitglieder & Rollen.

Trait-Schlüssel

Die Seite Trait-Schlüssel listet die Traits auf, die Ihr Tracker gesendet hat. So sehen Sie, was Sie benutzen, und räumen auf, was Sie nicht mehr benutzen.

Ein Trait-Schlüssel ist ein vollständiger Trait, genau so, wie Ihr Tracker ihn gesendet hat. plan:pro und plan:free sind zwei davon und nicht einer mit zwei Werten: Nichts trennt einen Trait am Doppelpunkt. Das lohnt sich zu wissen, bevor Sie sich Traits ausdenken – zwei Werte derselben Idee kosten zwei Plätze.

Sie legen hier nie einen an. Kommt zum ersten Mal ein Trait an, den das Projekt noch nicht kennt, wird er für Sie eingetragen und das Datum vermerkt; das zeigt die Spalte Zuerst gesehen. Damit ist diese Seite auch ein guter Ort, um Tippfehler zu bemerken: Steht ein plann:pro neben plan:pro, sendet irgendetwas in Ihrem Code das falsche Wort – und hat einen Platz belegt.

Wie viele Traits ein Projekt halten darf, hängt von Ihrem Plan ab; die Zahl steht auf der Seite Pläne & Limits. Sind alle Plätze belegt, wird ein neuer Trait einfach nicht eingetragen. Events, die ihn tragen, werden weiterhin erfasst – nur eben ohne diesen Trait, er taucht dann also auch nicht im Trait-Filter auf.

Einen Trait zu löschen gibt einen Platz frei und lässt alles Erfasste unangetastet: An Ihren bisherigen Zahlen ändert sich nichts. Sendet Ihr Tracker den Trait erneut, wird er wieder eingetragen und belegt den Platz erneut – löschen Sie also die, die Sie wirklich nicht mehr senden. Löschen darf nur der Projekteigentümer.

Abrechnung

Abonnement und Zahlungsdaten stehen auf der Abrechnungsseite, die zu Ihrem Konto gehört und nicht zu einem einzelnen Projekt. Was in welchem Plan enthalten ist, steht unter Pläne & Limits; ums Wechseln, Kündigen und Bezahlen geht es unter Abrechnung.

Konto

Die Seite Konto betrifft Sie und nicht ein einzelnes Projekt. Was Sie hier ändern, begleitet Sie deshalb in jedes Projekt, zu dem Sie gehören.

• Ihre Angaben: der Name und die E-Mail-Adresse, die Ihr Team sieht, und ob diese Adresse bestätigt ist. Ist sie es nicht, finden Sie hier eine Schaltfläche, die die Bestätigungsmail erneut verschickt.
• E-Mail-Benachrichtigungen: zwei Schalter – einer für die wöchentliche Zusammenfassung Ihrer Projekte, einer für Produkt- und Marketing-E-Mails. Sie werden beim Umlegen gespeichert.
• Überall abmelden: beendet jede angemeldete Sitzung auf jedem Gerät, auch die, in der Sie gerade sind. Dazu greifen Sie, wenn Sie sich an einem Gerät angemeldet haben, über das Sie nicht mehr verfügen.
• Konto schließen: löscht Ihr Konto endgültig. Sie müssen DELETE eintippen und danach ein zweites Mal bestätigen. Gehört Ihnen ein Projekt, in dem noch andere Personen sind, wird das Schließen abgelehnt und diese Projekte werden aufgeführt – damit niemand in einem Projekt ohne Eigentümer zurückbleibt.