DocumentationConfiguration du script

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

HTML
<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-id de 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.hash compte 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, *.local et file:// (Tester sur localhost). Le data-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

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

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

Afficher le code pour

<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énementQuand
pageviewLe chargement de la page, et chaque route d’une application monopage.
engageTemps 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.
goalUn objectif, depuis un appel ou un clic.
outboundUn clic sur un lien vers un autre hôte.
identifyUn 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 sans data-api).
  • La page est sur localhost sans data-allow-localhost, ou le navigateur est automatisé sans data-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.