04 · Suivi
Tous les attributs que lit la balise
La balise n’a besoin que de data-site. Le reste change la destination des événements, la façon de compter les visiteurs, et quand les visites locales et automatisées comptent.
01Les attributs de la balise
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>data-siteobligatoire- L’identifiant du site, donné sur sa page Setup. Le
data-website-idde DataFast est lu de la même façon. data-modecookiecookielessconsent- La façon dont les visiteurs sont comptés (Modes de confidentialité). Sans lui, mode cookie. Toute autre valeur vaut sans cookie : une faute de frappe ne dépose donc jamais de cookies que le site n’a pas demandés.
data-apichemin ou adresse- Où vont les événements : par défaut
/api/eventà l’adresse du script lui-même. Un chemin est résolu par rapport à la page, pour un proxy sur votre propre domaine (Le servir depuis votre domaine). data-hashindicateur- Un simple changement de
location.hashcompte comme une nouvelle page, pour les applications qui routent après un#. data-allow-localhostindicateur- Envoie les événements depuis les pages
localhost,127.0.0.1,*.localhost,*.localetfile://(Tester sur localhost). Ledata-allow-localhost="true"de DataFast fonctionne aussi. data-allow-automationindicateurtests uniquement- Envoie les événements depuis un navigateur piloté par automatisation (WebDriver, Playwright, Puppeteer). Ne l’activez pas sur votre site en production.
deferà conserver- Charge le script sans retarder la page.
Un indicateur est actif quand il est présent, sauf si sa valeur est false.
02Les appels que votre page peut faire
// 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
Chaque appel échoue en silence : il ne lève jamais d’erreur dans votre page. window.datafast(…) est la même fonction. La page Objectifs et identify donne les règles des noms.
03Exemples
<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>04Ce qui est envoyé
| Événement | Quand |
|---|---|
pageview | Le chargement de la page, et chaque route d’une application monopage. |
engage | Temps actif et profondeur de défilement : quand la page est masquée ou quittée, à un changement de route, et toutes les 30 secondes tant que quelqu’un lit. |
goal | Un objectif, depuis un appel ou un clic. |
outbound | Un clic sur un lien vers un autre hôte. |
identify | Un e-mail pour rapprocher les paiements. |
Chacun est une petite requête JSON, envoyée sans cookie ; tout ce qui dépasse 8 KB n’est pas envoyé. Une page ouverte en arrière-plan par le prérendu compte une fois que quelqu’un l’ouvre réellement.
05Quand il n’envoie rien
- Il n’y a pas de
data-site, ou pas d’adresse où envoyer (une copie du script collée en ligne sansdata-api). - La page est sur localhost sans
data-allow-localhost, ou le navigateur est automatisé sansdata-allow-automation. - Le navigateur s’est exclu avec
localStorage.datafast_ignore = true.
Les appels de votre page fonctionnent quand même : ils ne font rien.
06Ce qu’il ne lit pas
Il manque quelque chose, ou ce n’est pas ce que vous voyez ? Écrivez à support@tallybyoutpost.com en précisant la page.