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
<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-idvon 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/eventunter 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.hashzählt als neue Seite, für Apps, die hinter einem#routen. data-allow-localhostFlag- Sendet Events von
localhost,127.0.0.1,*.localhost,*.localundfile://-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
// 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
<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
| Event | Wann |
|---|---|
pageview | Die Seite lädt, und jede Route einer Single-Page-App. |
engage | Aktive Zeit und Scrolltiefe: wenn die Seite verborgen oder verlassen wird, bei einem Routenwechsel und alle 30 Sekunden, solange jemand liest. |
goal | Ein Ziel, aus einem Aufruf oder einem Klick. |
outbound | Ein Klick auf einen Link zu einem anderen Host. |
identify | Eine 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-siteoder keine Adresse, an die gesendet werden kann (eine inline eingefügte Kopie des Skripts ohnedata-api). - Die Seite läuft auf localhost ohne
data-allow-localhost, oder der Browser ist automatisiert ohnedata-allow-automation. - Der Browser hat sich mit
localStorage.datafast_ignore = trueausgeschlossen.
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.