DocumentaciónConfiguración del script

04 · Seguimiento

Cada atributo que lee la etiqueta

La etiqueta solo necesita data-site. El resto cambia adónde van los eventos, cómo se cuentan los visitantes y cuándo cuentan las visitas locales y automatizadas.

01Los atributos de la etiqueta

HTML
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>
data-siteobligatorio
El ID del sitio, de su página Setup. data-website-id de DataFast se lee igual.
data-modecookiecookielessconsent
Cómo se cuentan los visitantes (Modos de privacidad). Sin él, modo cookie. Cualquier otro valor cuenta como modo sin cookies, así que una errata nunca pone cookies que el sitio no pidió.
data-apiruta o dirección
Adónde van los eventos: por defecto, a /api/event en la propia dirección del script. Una ruta se resuelve respecto a la página, para un proxy en tu propio dominio (Servirlo desde tu dominio).
data-hashindicador
Un cambio que solo afecta a location.hash es una página nueva, para las apps que enrutan después de un #.
data-allow-localhostindicador
Envía eventos desde páginas de localhost, 127.0.0.1, *.localhost, *.local y file:// (Probar en localhost). También sirve data-allow-localhost="true" de DataFast.
data-allow-automationindicadorsolo para pruebas
Envía eventos desde un navegador controlado por automatización (WebDriver, Playwright, Puppeteer). No lo actives en tu sitio en producción.
defermantenlo
Carga el script sin frenar la página.

Un indicador está activo cuando está presente, salvo que su valor sea false.

02Las llamadas que puede hacer tu página

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

Cada llamada falla en silencio: nunca lanza un error en tu página. window.datafast(…) es la misma función. Objetivos e identify tiene las reglas para los nombres.

03Ejemplos

Mostrar el código para

<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>

04Qué envía

EventoCuándo
pageviewAl cargar la página, y en cada ruta de una app de una sola página.
engageTiempo activo y profundidad de scroll: cuando la página se oculta o se abandona, en un cambio de ruta y cada 30 segundos mientras alguien lee.
goalUn objetivo, desde una llamada o un clic.
outboundUn clic en un enlace a otro host.
identifyUn email con el que cotejar pagos.

Cada uno es una pequeña solicitud JSON, enviada sin cookies; lo que pase de 8 KB no se envía. Una página abierta en segundo plano por el prerenderizado cuenta cuando alguien la abre de verdad.

05Cuándo no envía nada

  • No hay data-site, o no hay dirección a la que enviar (una copia del script pegada en línea sin data-api).
  • La página está en localhost sin data-allow-localhost, o el navegador está automatizado sin data-allow-automation.
  • El navegador se ha excluido con localStorage.datafast_ignore = true.

Las llamadas de tu página siguen funcionando entonces: no hacen nada.

06Lo que no lee

¿Falta algo o no coincide con lo que ves? Escribe a support@tallybyoutpost.com y dinos qué página.