DokuSkript-Konfiguration

04 · Tracking

Jedes Attribut, das das Tag liest

Das Tag braucht nur data-site. Der Rest ändert, wohin Events gehen, wie Besucher gezählt werden und wann lokale und automatisierte Besuche zählen.

01Die Attribute des Tags

HTML
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>
data-siteerforderlich
Die ID der Website, von ihrer Setup-Seite. data-website-id von DataFast wird genauso gelesen.
data-modecookiecookielessconsent
Wie Besucher gezählt werden (Datenschutzmodi). Ohne das Attribut: Cookie-Modus. Jeder andere Wert gilt als Modus ohne Cookies, sodass ein Tippfehler nie Cookies setzt, die die Website nicht wollte.
data-apiPfad oder Adresse
Wohin Events gehen: standardmäßig an /api/event unter der eigenen Adresse des Skripts. Ein Pfad wird relativ zur Seite aufgelöst, für einen Proxy auf deiner eigenen Domain (Über deine eigene Domain ausliefern).
data-hashFlag
Schon eine reine Änderung von location.hash zählt als neue Seite, für Apps, die hinter einem # routen.
data-allow-localhostFlag
Sendet Events von localhost, 127.0.0.1, *.localhost, *.local und file://-Seiten (Auf localhost testen). data-allow-localhost="true" von DataFast geht auch.
data-allow-automationFlagnur für Tests
Sendet Events aus einem automatisiert gesteuerten Browser (WebDriver, Playwright, Puppeteer). Auf deiner Live-Website weglassen.
deferbeibehalten
Lädt das Skript, ohne die Seite aufzuhalten.

Ein Flag ist aktiv, wenn es vorhanden ist, außer sein Wert ist false.

02Die Aufrufe, die deine Seite machen kann

JavaScript
// Calls made before the script loads wait in a queue:
window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };

tally('signup', { plan: 'pro' });   // a goal, with properties
tally('identify', { email: user.email });   // match payments by email
tally('consent', true);   // consent mode: the banner said yes
tally('consent', false);  // ...or no

Jeder Aufruf scheitert still: Er wirft nie einen Fehler in deiner Seite. window.datafast(…) ist dieselbe Funktion. Ziele und identify hat die Regeln für Namen.

03Beispiele

Code anzeigen für

<script defer data-site="k3xq2mfa7twp" data-mode="consent" src="https://t.tallybyoutpost.com/script.js"></script>

<script defer data-site="k3xq2mfa7twp" data-hash src="https://t.tallybyoutpost.com/script.js"></script>

<script defer data-site="k3xq2mfa7twp" src="/js/script.js"></script>

<script defer data-site="k3xq2mfa7twp" data-allow-localhost src="https://t.tallybyoutpost.com/script.js"></script>

04Was es sendet

EventWann
pageviewDie Seite lädt, und jede Route einer Single-Page-App.
engageAktive Zeit und Scrolltiefe: wenn die Seite verborgen oder verlassen wird, bei einem Routenwechsel und alle 30 Sekunden, solange jemand liest.
goalEin Ziel, aus einem Aufruf oder einem Klick.
outboundEin Klick auf einen Link zu einem anderen Host.
identifyEine E-Mail für den Abgleich mit Zahlungen.

Jedes ist eine kleine JSON-Anfrage, ohne Cookies gesendet; alles über 8 KB wird nicht gesendet. Eine Seite, die durch Prerendering im Hintergrund geöffnet wird, zählt erst, wenn jemand sie tatsächlich öffnet.

05Wann es nichts sendet

  • Es gibt kein data-site oder keine Adresse, an die gesendet werden kann (eine inline eingefügte Kopie des Skripts ohne data-api).
  • Die Seite läuft auf localhost ohne data-allow-localhost, oder der Browser ist automatisiert ohne data-allow-automation.
  • Der Browser hat sich mit localStorage.datafast_ignore = true ausgeschlossen.

Die Aufrufe deiner Seite funktionieren dann trotzdem: Sie tun nichts.

06Was es nicht liest

Fehlt etwas, oder sieht es bei dir anders aus? Schreib an support@tallybyoutpost.com und nenne die Seite.