Rastrear las acciones de los usuarios

Docs > RUM y Session Replay > Monitorización del RUM Browser > Rastrear las acciones de los usuarios

Información general

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

Administrar la información recopilada

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:

Se detecta la actividad posterior al clic. Consulta Cómo se calcula la actividad de la página para obtener más información.
El clic no genera que se cargue una nueva página, en cuyo caso, el SDK del navegador de Datadog genera otro evento de vista de RUM.
Se puede calcular un nombre para la acción. Consulta Declarar un nombre para las acciones de clics para obtener más información.

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.