Añada el rastreador
Instale la etiqueta de script de su sitio y compruebe que llegan los eventos. Revise sus requisitos de consentimiento antes de activar la recopilación.
1. Copie su fragmento
Inicie sesión, abra su sitio web y vaya a Settings → Installation → Scripts (Configuración → Instalación → Scripts). Su fragmento se parece a este, con su propio token de sitio. El estilo Minimal (Mínimo) que se muestra aquí lee sus opciones desde Installation → Dashboard; el estilo Explicit (Explícito) escribe las mismas opciones como atributos del script (vea Opciones del script).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Mantenga las direcciones del script y de la API en https://app.seean.io, como se muestra arriba, salvo que la recopilación de primera parte esté activada en Installation; en ese caso se usa para ambas el nombre de host generado <slug>-collect.seean.io, o un dominio de recopilación personalizado propio que esté activo. Un fragmento existente que usa estas direcciones no necesita cambiar cuando Seean actualiza su infraestructura.
2. Péguelo antes de </head>
Use el documento HTML compartido o el diseño raíz de todas las páginas que quiera medir. Siga su guía de plataforma para la colocación correcta. Instale el rastreador una sola vez: usar a la vez un diseño y un gestor de etiquetas puede contar las visitas dos veces.
El rastreador observa la navegación admitida de la History API, como / → /pricing. Las cadenas de consulta no forman parte de la ruta de la página; los fragmentos hash se ignoran salvo que establezca data-hash="true". Un cambio de campaña etiquetada o una sesión expirada aún pueden iniciar una nueva sesión y contar de nuevo la misma ruta. Cargue el rastreador como un script externo clásico; no lo importe en el paquete de su aplicación ni añada type="module".
3. Verifique
Abra el sitio publicado en una pestaña normal del navegador y revise Settings → Installation → Setup health (Estado de la instalación) para el sitio web correspondiente. Last pageview received (Última página vista recibida) muestra la hora de la página vista más reciente conservada; antes de cualquier página vista, Installation verified (Instalación verificada) muestra cuándo la página publicada pasó la comprobación por última vez. Use Check installation (Comprobar instalación) para inspeccionar la página de inicio publicada en busca del rastreador, el token y la política de seguridad. Seean también comprueba automáticamente la página de inicio publicada en segundo plano (cada minuto durante el primer día del sitio web), así que la instalación se verifica en cuanto se publica el fragmento, incluso con el panel cerrado. El aviso de Resumen desaparece entonces sin esperar una visita.
Una referencia en el código fuente o una visita antigua no demuestran que su último despliegue funciona. Haga coincidir una ruta de página y una hora nuevas en Eventos usando las comprobaciones de instalación. La guía de diagnóstico de la configuración explica los resultados, los permisos y los límites.
Opciones del script
Installation → Dashboard contiene las opciones de seguimiento del sitio web: campañas UTM (activado), rutas de página con hash (desactivado), Web Vitals (activado), conversiones automáticas (activado en sitios web nuevos y nunca configurados), registro de depuración (desactivado) y nombres de host entre dominios. Save tracking options (Guardar opciones de seguimiento) las almacena; un fragmento mínimo las aplica en su siguiente carga de página. El estilo de fragmento Explicit escribe las mismas opciones como atributos:
| Atributo | Predeterminado | Efecto |
|---|---|---|
data-conversions="true" |
desactivado en HTML en bruto | Carga los preajustes de conversión automáticos activados una vez por documento. Los fragmentos explícitos generados lo incluyen mientras Conversiones automáticas está activado. |
data-hash="true" |
desactivado | Cuenta los cambios de location.hash como páginas vistas e informa la ruta con su fragmento, por ejemplo /docs#install. |
data-utm="off" |
activado | Deja de leer utm_source, utm_medium y utm_campaign; un enlace etiquetado ya no inicia una nueva sesión. |
data-vitals="off" |
activado | Omite por completo la medición de Web Vitals (sin observadores de rendimiento). |
data-debug="true" |
desactivado | Hace console.debug de cada carga antes de enviarla. Seguro cuando la consola no está disponible. |
data-domains="a.com,b.com" |
desactivado | Traspaso entre dominios: los enlaces a los hosts listados (y sus subdominios) llevan el ID de visitante, y una página de destino adopta un ID entrante. |
Cuando cualquiera de estos atributos está presente, las opciones del panel se ignoran para esa página. Detalles y valores predeterminados: Script y opciones de seguimiento.
Qué envía el rastreador
| Campo | Qué es |
|---|---|
| path | la ruta de la página, sin cadena de consulta (con el fragmento cuando data-hash está activado) |
| hostname | el sitio web que se mide |
| referrer | la URL de referencia del navegador; el recolector conserva solo su nombre de host |
| timezone | respaldo para el país cuando el borde de la red no informa ninguno |
| visitorId, sessionId | las identidades predeterminadas se derivan en el servidor por sitio web y día UTC; el traspaso opcional entre dominios lleva la identidad en el almacenamiento de sesión del mismo día |
| campaign | fuente, medio, campaña, término y contenido UTM cuando están presentes, salvo con data-utm="off" |
| click id | el nombre de un parámetro de ID de clic publicitario presente en la URL de destino (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); el valor nunca se lee. Desactivado con data-utm="off" |
| title | document.title, primeros 200 caracteres |
| uid | su propio ID de usuario tras seean.identify(id), almacenado solo cuando Identify users (Identificar usuarios) está activado para el sitio web |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP y TTFB; mediciones posteriores pueden actualizar una muestra. Desactivado con data-vitals="off" |
El recolector lee el país, la región y la ciudad de las cabeceras del borde de la red de la solicitud, usa el agente de usuario para las categorías de navegador, sistema operativo y dispositivo, registra la primera etiqueta Accept-Language del navegador como idioma del visitante y puede usar la región de ese idioma como respaldo para el país. La dirección IP se compara únicamente con las reglas de exclusión y nunca se almacena. Las cadenas de consulta distintas de los campos UTM y del nombre del ID de clic nunca se recopilan.
El seguimiento predeterminado usa un hash de servidor diario por sitio web sin cookies ni almacenamiento de medición persistente en el navegador. El traspaso opcional entre dominios usa sessionStorage del mismo día. La recopilación se detiene con Do Not Track, Global Privacy Control o la exclusión del navegador descrita en Exclusiones. Donde se aplique un consentimiento o una exclusión, controle la carga del script mediante el mecanismo de consentimiento de su sitio. Vea privacidad técnica y almacenamiento y consentimiento.
Desarrollo local
El rastreador ignora localhost y 127.0.0.1 salvo que añada data-local a la etiqueta de script. Use un sitio web/token de Seean separado para el tráfico de pruebas y copie la dirección de la API del fragmento de ese sitio. Los navegadores automatizados, Do Not Track, Global Privacy Control y la exclusión del navegador aún pueden detener la recopilación; data-local no desactiva esas comprobaciones.
Quite o actualice una instalación
Quite el script de su diseño o gestor de etiquetas y publique el cambio para detener la recopilación futura desde esa instalación. Los informes existentes permanecen. Rotar el token de seguimiento de un sitio invalida de inmediato sus fragmentos antiguos; actualice cada instalación con el nuevo token. Vea configuración del sitio web.
¿Algo no queda claro? Contacte con soporte.