Dokumentation
Erfahren Sie, wie Sie das Tracking-Tool verwenden
Erste Schritte
Fünf Schritte vom leeren Konto bis zum ersten erfassten Besuch – sie zu erledigen dauert ungefähr so lange, wie sie zu lesen. Haben Sie Konto und Projekt schon, erledigt die Seite Einrichtung die letzten drei mit Ihrem eigenen Schlüssel bereits eingesetzt: Folgen Sie ihr dort und lesen Sie hier nach, warum das so ist.
Videoreihe ansehenAcht kurze Videos zum gesamten Produkt, auf YouTube.Wird in einem neuen Tab geöffnet1. Konto anlegen
Registrieren Sie sich mit E-Mail-Adresse und Passwort oder mit Google. Bei einer E-Mail-Adresse schicken wir Ihnen einen Link, mit dem Sie bestätigen, dass die Adresse Ihnen gehört; er gilt einen Tag lang. Klicken Sie ihn, bevor Sie bei Schritt 3 ankommen: Solange die Adresse nicht bestätigt ist, lässt sich kein Schlüssel erstellen. Liegt die Mail nicht im Posteingang, sehen Sie im Spam-Ordner nach – und oben in Ihrem Dashboard gibt es eine Schaltfläche, die sie erneut verschickt. Wer sich mit Google anmeldet, hat die Adresse damit schon bestätigt und muss nichts anklicken.
2. Projekt anlegen
Ein Projekt ist eine Website oder App: eigene Schlüssel, eigene Einstellungen, eigene Zahlen. Gleich nach der Registrierung stehen zwei Dinge zur Wahl. Eine geführte Tour öffnet ein Demo-Projekt, das bereits mit erfundenen Daten gefüllt ist – der schnellste Weg zu sehen, was das Dashboard kann, bevor es eigene Daten gibt; es steht neben Ihren echten Projekten, statt sich mit ihnen zu vermischen. Erstes Projekt anlegen ist hier der richtige Weg. Dabei werden vier kurze Fragen gestellt – wie es heißen soll, welche Interaktionen von selbst erfasst werden, welche Domains Daten schicken dürfen und ein paar Datenschutzeinstellungen – und jede Antwort lässt sich später unter Einstellungen ändern.
Die eine Antwort, über die es sich nachzudenken lohnt, ist die Zeitzone; sie ist aus Ihrem Browser vorbelegt. Sie legt fest, wo für dieses Projekt ein Tag beginnt und endet, und damit, auf welchen Tag jede Zahl fällt. Eine spätere Änderung wirkt nur auf Tage, die noch nicht stattgefunden haben – deshalb ist es billiger, sie gleich richtig zu setzen. Die Einzelheiten stehen unter Einstellungen.
3. Öffentlichen API-Schlüssel erstellen
Der öffentliche Schlüssel ist der, der auf Ihre Website gehört, wo ihn jeder lesen kann. Das ist ungefährlich: Er darf Events hereinschicken und nichts lesen. Erstellen Sie einen auf der Seite Einrichtung oder wählen Sie einen vorhandenen aus der Liste.
4. Skript in Ihre Seiten einbauen
Setzen Sie das hier in den <head> jeder Seite, die Sie erfassen wollen, und tragen Sie statt des Beispiels Ihren eigenen Schlüssel ein. Lassen Sie defer stehen: Damit baut der Browser die Seite erst fertig, und genau das sorgt dafür, dass track() aus Ihrem eigenen Code sofort funktioniert.
<script
src="https://api.privatrak.com/tracker.js"
data-api-key="your-public-key"
defer
></script>5. Prüfen, ob es ankommt
Rufen Sie Ihre Website einmal selbst auf, damit ein Seitenaufruf entsteht, öffnen Sie dann die Seite Events und drücken Sie über der Tabelle auf Aktualisieren. Ihr Besuch sollte binnen weniger Sekunden in der obersten Zeile stehen. Erscheint nichts, öffnen Sie auf Ihrer Website die Browser-Konsole: Der Tracker sagt dort ausdrücklich, wenn ein Schlüssel abgelehnt wurde oder die Website nicht unter den erlaubten Domains steht.
Wie es weitergeht
Ab jetzt werden Seitenaufrufe, Klicks auf anklickbare Dinge und Formularübermittlungen ohne weiteren Code erfasst. Geben Sie den Teilen Ihres Produkts, die Sie interessieren, mit dem Element Picker Namen – auch dafür brauchen Sie keinen Code. Ist Ihre Website mit React, Next.js, Nuxt oder Ähnlichem gebaut, hilft Framework-Anleitungen weiter. Unter Tracker-Einstellungen ändern Sie, was wie oft erfasst wird, und unter Datenschutz & Sicherheit legen Sie fest, welche Websites Ihren Schlüssel überhaupt verwenden dürfen.