Dokumentation

Welcher Weg passt

• Ein data-track-Attribut benennt einen Button, einen Link oder ein Formular. Privatrak erfasst die Klicks darauf oder die abgeschickten Formulare unter diesem Namen. Nehmen Sie es für alles, was angeklickt wird.
• Die Funktion track() sendet ein eigenes Event. Nehmen Sie sie, wenn nichts angeklickt wird oder wenn etwas erst zählen soll, sobald es geklappt hat, etwa eine erfolgreiche Zahlung oder ein bis zum Ende angesehenes Video.
• Der Element Picker benennt ein Element ganz ohne Code. Nehmen Sie ihn, wenn Sie den Code nicht ändern können oder wenn jemand ohne Zugriff darauf die Einrichtung übernimmt.

Ein Element mit data-track benennen

Fügen Sie dem Element data-track hinzu. Sein Wert wird zum Namen.

<button data-track="signup-cta">Sign up free</button>

Privatrak erfasst jeden Klick darauf, bei einem Formular jedes Abschicken. Das gilt auch, wenn Interaktionen unter Einstellungen › Tracker ausgeschaltet ist. So erfassen Sie nur die Elemente, die Sie benennen.

Auch ein Klick auf etwas innerhalb des Elements, etwa auf sein Symbol oder seine Beschriftung, zählt unter dem Namen, bis zu 3 Ebenen tief. Die Tiefe ändern Sie mit data-walk-depth, beschrieben in der Tracker-Referenz.

<a href="/pricing" data-track="pricing-card">
  <h3>Pro</h3>
  <span class="icon"></span>  <!-- a click here counts as pricing-card -->
</a>

Bei Namen zählt die Schreibweise. signup-cta und Signup-CTA sind also zwei Features. Behalten Sie einen Namen bei, sobald er genutzt wird, denn ein neuer Name beginnt ein neues Feature.

Details mit data-track-* mitgeben

Mit Attributen, die mit data-track- beginnen, senden Sie bei jedem Klick Details mit. Der Teil nach data-track- wird zum Namen des Details. data-track-plan="pro" kommt also als plan: pro an.

<button
  data-track="upgrade"
  data-track-plan="pro"
  data-track-interval="yearly"
>
  Upgrade to Pro
</button>

Der Name eines Details darf Buchstaben, Ziffern, Bindestriche, Unterstriche und Punkte enthalten. data-track-price-band="20-40" kommt also als price-band: 20-40 an, und Sie können danach filtern und aufschlüsseln wie nach jedem anderen Detail.

Setzen Sie sie auf dasselbe Element wie data-track. Details an anderen Elementen werden nicht gesendet.

Auf der Seite Events und in Insights können Sie nach Details filtern und aufschlüsseln. Ist ein Detail eine Zahl, etwa der Betrag einer Bestellung, kann Insights es auch summieren und mitteln.

Ein eigenes Event mit track() senden

Rufen Sie window.tracker.track() mit einem Namen auf, auf Wunsch mit Details:

// A sign-up that went through
window.tracker.track("signup-completed");

// With details
window.tracker.track("plan-upgraded", {
  plan: "pro",
  interval: "yearly"
});

// A purchase, with its amount as a number
window.tracker.track("purchase_complete", {
  total: 34.5
});

// A search that found nothing
window.tracker.track("search-no-results", {
  section: "help"
});

• name (Text, erforderlich): der Name des Events. Er erscheint auf der Seite Features wie ein data-track-Name. Ein Klick und ein eigenes Event können sich also ein Feature teilen.
• attrs (Objekt, optional): Details, jeder Wert als Text oder Zahl, etwa plan: "pro" oder total: 34.5. Eine Zahl kommt in einfachen Ziffern an, 34.50 also als 34.5 und 1e3 als 1000. 34.5 und "34.5" gelten als derselbe Wert.

Andere Werte, etwa true, null, eine Liste oder NaN, lässt der Tracker weg. Er nennt sie in einer Warnung in der Konsole Ihres Browsers und sendet das Event mit den übrigen Details.

Aufrufe, bevor der Tracker gestartet ist, werden nicht erfasst. Mit dem Skript-Tag von der Seite Einrichtung startet er, sobald er geladen ist. Die übrigen Fälle stehen unter Den Tracker selbst starten.

Prüfen, ob es funktioniert

Öffnen Sie Events in Privatrak und wählen Sie unter Event-Typ den Eintrag Benutzerdefinierte Events, um Ihre track()-Aufrufe zu sehen. Mit data-track benannte Klicks stehen dort als Klicks, ihr Name in der Spalte Feature. Jeder Name erscheint außerdem auf der Seite Features.