Eventos personalizados y objetivos

Qué es un evento personalizado

Un evento personalizado es una acción que decides enviar desde tu propio código: window.atriqo.track(name, properties) (el nombre del evento y, opcionalmente, sus propiedades). El nombre es obligatorio; las propiedades son opcionales.

Los nombres tienen de 1 a 64 caracteres y solo pueden usar letras, dígitos, _ y - — sin espacios, acentos, puntos ni emojis. Los nombres distinguen mayúsculas de minúsculas: Signup_Click y signup_click son dos eventos distintos. Un nombre que incumple estas reglas se ignora en silencio: no hay error y no llega nada a tu dashboard — así que revisa la ortografía si un evento no aparece.

Las propiedades añaden detalle a un evento. Puedes enviar hasta 10 propiedades por evento; las claves y los valores se cortan a 64 caracteres, y los valores se envían como texto — envía por tanto valores de texto sencillos (un objeto llegaría como [object Object]).

Ejemplo: mide los clics en tu botón de registro

Esto cuenta cada clic en un botón y registra de cuál se trata, mediante una propiedad cta:

<a id="signup" href="/signup">Registrarse</a>

<script>
  document.getElementById('signup').addEventListener('click', function () {
    if (window.atriqo) {
      window.atriqo.track('signup_click', { cta: 'hero' });
    }
  });
</script>

El snippet de Atriqo se carga con async, así que window.atriqo no existe hasta que track.js se ha ejecutado. El código lo comprueba primero: sin esa comprobación, un clic que llegue antes de que cargue el script — o si está bloqueado — lanzaría un error en tu página. Añade el escuchador de clics una sola vez: si se añade de nuevo (por ejemplo cada vez que un componente de un framework se vuelve a renderizar), cada clic registra un evento por cada escuchador. Un clic que ocurra antes de que el script haya cargado no se cuenta.

Si usas un framework como React, Vue o Svelte, pon la misma llamada en el manejador de clic del componente. No hace falta que llames a nada manualmente para las páginas vistas: el tracker ya registra una página vista en cada navegación del lado del cliente.

Enlaces que sacan al visitante de la página. El tracker envía los eventos con fetch y keepalive, que está diseñado para sobrevivir a la navegación, así que un clic en un enlace que abre otra página debería registrarse igualmente. Si el enlace va a otro hostname (también un subdominio como app.ejemplo.com), Atriqo también lo registra automáticamente como clic en un enlace externo mientras ese ajuste esté activado en tu sitio — tu evento personalizado es un segundo evento, distinto.

Atriqo usa esto en su propio sitio: los botones de registro de atriqo.com envían un evento signup_click con una propiedad, cta, que indica en qué botón se hizo clic.

Dónde verlo

Abre el resumen de tu sitio, busca la tarjeta Eventos y elige la pestaña Personalizados. Cada nombre de evento aparece con su recuento del periodo seleccionado, en todos los planes.

En los planes Growth y Business, al desplegar un nombre de evento se muestran sus propiedades — cada clave con sus valores — para que puedas comparar, por ejemplo, cta=hero con otro botón. En los demás planes la tarjeta muestra una línea para mejorar de plan; tus propiedades siguen incluidas en el export CSV.

Conviértelo en un objetivo

Los objetivos están disponibles en los planes Growth y Business. En los demás planes no se pueden crear objetivos — los eventos personalizados siguen apareciendo en la tarjeta Eventos.

1. Abre Ajustes del sitio y ve a la pestaña Objetivos.
2. Pulsa Añadir objetivo y ponle un nombre al objetivo.
3. Elige Tipo: Evento personalizado.
4. En Nombre del evento, escribe el nombre exacto que envías — por ejemplo signup_click.

El nombre se compara exactamente, mayúsculas incluidas. Solo puede usar letras, dígitos, _ y - (hasta 64 caracteres), y no se acepta un nombre que el filtro automático de datos personales de Atriqo modificaría.

Un objetivo cuenta sesiones que contienen el evento, no clics. Diez clics en una misma sesión son una conversión. En Atriqo una sesión es una ventana fija de 30 minutos alineada con el reloj, y el identificador del visitante cambia cada día — por eso una conversión solo se cuenta dentro de una única sesión y un único día. No hay atribución entre sesiones ni entre días.

Los resultados aparecen en la sección Conversiones (misma sesión) del resumen. Cubren los eventos registrados con ese nombre durante el periodo que hayas elegido — incluidos los enviados antes de crear el objetivo.

Cuánto cuesta

Cada evento personalizado cuenta para tu cuota mensual de eventos facturables, y también lo hace un clic en un enlace externo que se registra automáticamente. Un botón de registro que enlaza a otro hostname (por ejemplo un subdominio como app.ejemplo.com) registra por tanto dos eventos por clic. Registra acciones que importen — altas, compras, envíos de formulario — en lugar de interacciones de alta frecuencia. Para saber cómo funciona la cuota, consulta Planes, límites y facturación.

Deja fuera los datos personales

No pongas datos personales — emails, nombres, identificadores de usuario o texto libre — en los nombres ni en las propiedades de los eventos. Prefiere un vocabulario fijo, como cta=hero. Atriqo aplica una limpieza automática a algunos patrones, pero solo como una red de seguridad, sin garantías: no cuentes con ella para limpiar lo que envías.