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
<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-idde 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/eventen 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.hashes 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,*.localyfile://(Probar en localhost). También sirvedata-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
// 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
<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
| Evento | Cuándo |
|---|---|
pageview | Al cargar la página, y en cada ruta de una app de una sola página. |
engage | Tiempo 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. |
goal | Un objetivo, desde una llamada o un clic. |
outbound | Un clic en un enlace a otro host. |
identify | Un 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 sindata-api). - La página está en localhost sin
data-allow-localhost, o el navegador está automatizado sindata-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.