DocumentationLe snippet

02 · Installation

Une balise dans le head de chaque page

Collez une balise dans vos pages et Tally compte les visites, les sources, le temps actif, les objectifs et les clics sur les liens sortants, et dispose d’un identifiant de visiteur que votre paiement peut transporter.

01La balise

Une seule balise <script> fait tout tourner. Elle pèse environ 3 KB, n’a aucune dépendance et se charge avec defer, si bien qu’elle ne retarde jamais votre page :

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

La balise propre à votre site se trouve à l’étape du snippet quand vous ajoutez le site, et sur sa page Setup, avec son identifiant dans data-site. Un site compté en mode sans cookie ou consentement d’abord porte aussi son mode :

Afficher le code pour

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

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

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

La page Configuration du script liste chaque attribut que lit la balise.

02Où la placer sur votre plateforme

PlateformeOù
HTMLCollez-la dans le <head> de chaque page.
Next.jsDans app/layout.tsx, le layout racine : à l’intérieur de son <head>.
React et ViteDans index.html, à l’intérieur du <head> : toutes les routes de l’application le partagent.
WordPressDans le header.php d’un thème classique, juste avant </head>, ou dans une extension de code d’en-tête.
WebflowSite settings › Custom code › Head code, puis publiez.
FramerSite settings › General › Custom code, à la fin de la balise <head>, puis publiez.
ShopifyNulle part à la main : l’app Tally l’ajoute via un app embed de thème que vous activez dans l’éditeur de thème, sans code dans le thème. La fiche de l’app est en cours d’examen.

Une application monopage n’a besoin de rien d’autre : chaque route vers laquelle l’application navigue compte comme une page vue à part entière.

03Ce qui est envoyé

  • Les pages vues : la première au chargement de la page, puis une pour chaque route d’une application monopage (pushState, replaceState et le bouton Retour). Un changement de la seule chaîne de requête ou du seul fragment (hash) n’est pas une nouvelle page, sauf si la balise porte data-hash.
  • Le temps actif et la profondeur de défilement : le temps compte tant que la page est visible et que quelqu’un l’a utilisée dans les 30 dernières secondes. Il est envoyé quand la page est masquée ou quittée, et toutes les 30 secondes tant qu’elle reste ouverte.
  • Les objectifs, depuis votre code ou un attribut data-tally-goal (Objectifs et identify).
  • Les clics sur des liens vers d’autres sites, envoyés au moment où le navigateur quitte la page, sans retarder le clic.
  • Un e-mail pour rapprocher les acheteurs, quand votre page appelle identify.

Les événements partent en JSON vers /api/event à l’adresse du script lui-même, sans cookie. Le script ne lève jamais d’erreur dans votre page et ne retarde jamais une navigation.

04Vérifier que tout fonctionne

05Ce qu’elle ne peut pas compter

Il manque quelque chose, ou ce n’est pas ce que vous voyez ? Écrivez à support@tallybyoutpost.com en précisant la page.