Eventos personalizados

Cualquier cosa a la que pueda asociar un controlador de clic puede ser un evento.

window.seean.track("signup");
window.seean.track("download", { file: "pricing.pdf" });

Los eventos aparecen en Resumen (tarjeta Eventos), en el registro de actividad de Eventos, en los embudos como pasos y en los informes de campañas cuando coinciden con los objetivos de conversión activados (o con todos los eventos personalizados cuando no hay objetivos activados). Las propiedades se envían con el evento, pero la tabla actual del registro de actividad no las muestra.

Nombres

Use nombres cortos y estables: signup, cta_click, newsletter_signup. Renombrar más tarde divide su historial.

Cargue antes de llamar

Llame a track después de que el script del rastreador generado se haya ejecutado. No hay una cola integrada para las llamadas hechas antes de la carga. Para HTML plano, coloque el script diferido de su aplicación después del script diferido de Seean; para un framework, siga su guía de instalación.

Para un botón de descarga, asocie el controlador después de que ese botón exista:

document.querySelector("#download-pricing")?.addEventListener("click", () => {
  window.seean?.track("download", { file: "pricing.pdf" });
});

Esto cuenta el clic, no demuestra que una descarga terminó. El encadenamiento opcional evita una excepción cuando el rastreador no está disponible, pero no guarda ni reintenta el evento. Un visitante ignorado puede tener métodos del rastreador sin efecto, así que la presencia de window.seean por sí sola no demuestra que haya recopilación.

Para un formulario, llame al rastreador en su ruta existente de envío correcto:

// Después de que su servidor haya confirmado que el registro al boletín tuvo éxito:
window.seean?.track("newsletter_signup", { form: "footer" });

No envíe también este evento de éxito desde el clic del botón de envío: la validación o la solicitud pueden fallar, y conectar ambos contaría dos veces los envíos correctos. Conserve la validación y el manejo de errores normales de su formulario.

Clics y formularios declarativos

Añada data-seean-event="signup" a un botón o enlace para enviar ese evento al hacer clic, incluidos los clics en sus elementos anidados. En un formulario, el atributo envía al enviar el formulario en lugar de con los clics en sus campos. Los elementos dinámicos funcionan mediante escuchadores delegados. Los preajustes de conversión automáticos omiten los elementos marcados para evitar el doble recuento; no llame también a seean.track() para la misma acción. Los atributos declarativos no necesitan la activación de data-conversions. Los nombres no deben estar vacíos, tienen como máximo 64 caracteres y no pueden ser pageview.

<button data-seean-event="download" data-seean-event-source="footer">Download</button>
<form data-seean-event="contact_submit">…</form>

Añada data-seean-event-PROPERTY="value" al mismo elemento marcado para enviar una propiedad. El ejemplo anterior envía { "source": "footer" }. Los valores de atributo siguen siendo cadenas ("2" no es el número 2); HTML normaliza los nombres de atributo a minúsculas. Solo se leen los atributos con prefijo explícito de ese elemento. Las propiedades de ancestros o hijos, los valores de los campos del formulario y los atributos no relacionados no se recopilan. Cambiar un atributo antes de una interacción posterior usa su nuevo valor.

Se aplican los límites de propiedades de abajo. Una clave no válida, demasiadas propiedades o un valor demasiado grande hacen que el recolector rechace el evento; los valores no se truncan en silencio. Use la API de JavaScript para valores tipados de número, booleano o null.

Un evento de clic o envío no confirma que su servidor completó la acción. Use el método del controlador de éxito descrito arriba cuando necesite esa confirmación.

Identifique a los usuarios con sesión iniciada

window.seean?.identify("user_42", { plan: "pro" });

identify(id, properties?) asocia su propio ID de usuario (de 1 a 64 caracteres de A–Z a–z 0–9 _ . : @ -, nunca un correo electrónico) a todos los registros posteriores de la página abierta y registra un evento identify con las propiedades opcionales. Solo tiene efecto en los sitios web que activaron Identify users (Identificar usuarios) en Settings → Installation; vea Personas y retención.

Límites de propiedades

Los nombres de evento aceptan hasta 64 caracteres. Cada evento puede incluir hasta 20 propiedades; el objeto de propiedades serializado no debe superar los 4.096 caracteres. Las claves de propiedad empiezan por una letra y contienen solo letras, números o guiones bajos, hasta 64 caracteres. Los valores pueden ser una cadena de hasta 512 caracteres, un número finito, un booleano o null. Los objetos anidados y las matrices se rechazan.

Use etiquetas no sensibles, como la ubicación de un formulario o la categoría de un producto. Nunca envíe contraseñas, direcciones de correo, datos de pago ni tokens privados. Las propiedades no están disponibles actualmente como columnas del registro de actividad ni como filtros de propiedad del panel; enviar una propiedad no crea un nuevo control de informe.

Verifique un evento

Realice la acción una vez y abra el registro de actividad de Eventos del sitio web seleccionado en el período actual. Compruebe su nombre, ruta y recuento. Los eventos personalizados usan las mismas señales de privacidad, exclusiones y cuota de recopilación que las páginas vistas; una solicitud rechazada o ignorada puede no dejar fila. Un evento llamado pageview se cuenta como página vista en lugar de como evento personalizado.

Si falta una fila, compruebe que el script está listo, la carga de la solicitud y la resolución de problemas de instalación. track() no devuelve una confirmación de que el almacenamiento tuvo éxito, y el rastreador no proporciona una cola de reintentos persistente.

Páginas 404

Añada <meta name="seean:status" content="404"> a su página de no encontrado y su página vista automática llevará status: 404, así que aparecerá en Pages → 404s (Páginas → 404) sin un segundo evento.

Llamar a track("pageview", { status: 404 }) en su lugar añade una segunda página vista. Vea seguimiento de 404.

¿Algo no queda claro? Contacte con soporte.