Rastrear las acciones de los usuarios
La monitorización del navegador detecta automáticamente las interacciones realizadas por los usuarios durante su recorrido y proporciona información sobre su comportamiento sin necesidad de instrumentar de forma manual cada uno de los clics de tu aplicación.
Puedes alcanzar los siguientes objetivos:
- Comprender el rendimiento de las interacciones clave (por ejemplo, un clic en el botón Add to cart [Añadir al carrito]).
- Cuantificar la adopción de las funciones
- Identificar los pasos que llevaron a un error específico en el navegador
El parámetro de inicialización trackUserInteractions activa la recopilación de los clics del usuario en tu aplicación, lo que significa que se pueden incluir datos confidenciales y privados presentes en tus páginas para identificar los elementos con los que ha interactuado un usuario.
Para controlar qué información se envía a Datadog, puedes enmascarar nombres de acciones con opciones de privacidad, configurar manualmente un nombre de acción o implementar una regla de limpieza global en el SDK del navegador de Datadog para RUM.
Administrar las interacciones de los usuarios
El SDK del RUM Browser realiza un rastreo automático de los clics. Se crea una acción de clic cuando se cumplen todas las siguientes condiciones:
Métricas del tiempo de acción
Para obtener información sobre los atributos predeterminados para todos los tipos de eventos de RUM, consulta Datos de RUM Browser recopilados.
| Métrica | Tipo | Descripción |
|---|
action.loading_time | número (ns) | El tiempo de carga de la acción. |
action.long_task.count | número | Número de tareas largas recopiladas para esta acción. |
action.resource.count | número | Número de recursos recopilados para esta acción. |
action.error.count | número | Número de errores recopilados para esta acción. |
El SDK del navegador de Datadog para RUM calcula el tiempo de carga de la acción monitorizando la actividad de la página después de cada clic. Una acción se considera completa cuando la página no tiene más actividad. Consulta Cómo se calcula la actividad de la página para obtener más información.
Para obtener más información sobre la configuración para el muestreo o el contexto global, consulta Modificar los datos y el contexto de RUM.
Atributos de las acciones
| Atributo | Tipo | Descripción |
|---|
action.id | cadena | UUID de la acción del usuario. |
action.type | cadena | Tipo de acción del usuario. En el caso de las acciones personalizadas del usuario, se configura como custom. |
action.target.name | cadena | Elemento con el que ha interactuado el usuario. Solo para acciones recopiladas automáticamente. |
action.name | cadena | Nombre de usuario creado (por ejemplo, Click on #checkout). Si se trata de acciones personalizadas del usuario, el nombre de la acción indicado en la llamada de la API. |
Declarar un nombre para las acciones de clics
El SDK del navegador de Datadog para RUM utiliza varias estrategias para asignar un nombre a las acciones de clics. Si deseas tener un mayor control, puedes definir un atributo data-dd-action-name en los elementos en los cuales se puede hacer clic (o en cualquiera de sus elementos principales) que se utilizan para dar un nombre a la acción.
Por ejemplo:
<a class="btn btn-default" href="#" role="button" data-dd-action-name="Login button">Try it out!</a>
<div class="alert alert-danger" role="alert" data-dd-action-name="Dismiss alert">
<span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
<span class="visually-hidden">Error:</span>
Ingresar una dirección de correo electrónico válida
</div>
A partir de la versión 2.16.0, mediante el parámetro de inicialización actionNameAttribute, es posible especificar un atributo personalizado que se emplee para dar un nombre a la acción.
Por ejemplo:
<script>
window.DD_RUM.init({
...
trackUserInteractions: true,
actionNameAttribute: 'data-custom-name',
...
})
</script>
<a class="btn btn-default" href="#" role="button" data-custom-name="Login button">Try it out!</a>
Cuando ambos atributos están presentes en un elemento, se favorece data-dd-action-name.
Cómo se calculan los nombres de las acciones
El SDK del navegador de Datadog utiliza diferentes estrategias para calcular los nombres de las acciones de clics:
Si el usuario configura explícitamente el atributo data-dd-action-name o un atributo personalizado (como se ha explicado anteriormente) en el elemento sobre el que se ha hecho clic (o en uno de los principales), su valor se utiliza como nombre de la acción.
Si no se configura el atributo data-dd-action-name o su equivalente, según el tipo de elemento, el SDK utiliza otros atributos como label, placeholder, aria-label del elemento o de los principales para construir el nombre de la acción. Si no se encuentra ninguno de estos atributos, el SDK utiliza el texto interior como nombre de la acción.
Enviar acciones personalizadas
Para aumentar la recopilación de interacciones del usuario, envía tus acciones personalizadas mediante la API addAction. Estas acciones personalizadas envían información sobre un evento que se produce durante el recorrido de un usuario.
Para más información, consulta Enviar acciones personalizadas.
Referencias adicionales
Más enlaces, artículos y documentación útiles:
