Descripción general de las propiedades de usuario y de eventos en

En , propiedades Son atributos que brindan contexto adicional sobre los usuarios y los eventos que desencadenan. Existen dos tipos de propiedades en :

Propiedades del usuario: Las propiedades de usuario son los atributos de cada usuario. Las propiedades de usuario más comunes incluyen el tipo de dispositivo, la ubicación, el ID de usuario y si el usuario es un cliente que paga o no. Un atributo puede reflejar valores actuales o anteriores, según su naturaleza y la frecuencia con la que se actualiza.

Propiedades del evento: Las propiedades de evento son atributos de un evento en particular. Los valores que contienen son actuales en el momento en el que se activó el evento. Por ejemplo, el evento JoinCommunity podría tener una propiedad de evento de Type , que indica el tipo de comunidad a la que se unió. En el momento de ese evento.

Este artículo describirá qué hacen las propiedades de usuario y evento, cómo las actualiza y aplica, y cómo puede ocultar propiedades individuales en un proyecto de .

Propiedades del usuario

Como se mencionó anteriormente, una propiedad de usuario es un atributo que describe un detalle útil sobre el usuario al que está asociada. envía propiedades de usuario con cada evento.

Los SDK de rastrean las siguientes propiedades de usuario de forma predeterminada:

Plataforma Tipo de dispositivo Familia de dispositivos País Ciudad Región Versión de inicio Versión Operador SO Idioma Biblioteca Dirección IP

Puede encontrar las definiciones de cada propiedad aquí.

También puedes configurar propiedades de usuario personalizadas. Asegúrate de elegir características y rasgos que sean intrínsecos al usuario o al dispositivo que esté usando; de lo contrario, los datos que recopiles de tus propiedades de usuario no serán tan útiles. Algunos ejemplos comunes de propiedades de usuario personalizadas incluyen la fuente de referencia, el tipo de plan, la cantidad de amigos o el nivel actual en un juego.

Puede diferenciar entre las propiedades de usuario predeterminadas de y las propiedades de usuario personalizadas buscando el logotipo de . Si lo ve, habrá encontrado una propiedad de usuario predeterminada. Los nombres de las propiedades de usuario personalizadas no tendrán como prefijo ese logotipo.

Los clientes de normalmente implementan hasta 20 propiedades de usuario personalizadas, además de las propiedades predeterminadas.

Cómo actualiza las propiedades del usuario

Cuando un usuario activa un evento capturado por , se incluyen los valores actuales de cada propiedad del usuario, pero estos valores pueden cambiar con el tiempo. Por ejemplo, un usuario puede mudarse de Nueva York a Dallas o pasar de ser un usuario gratuito a uno de pago. Cuando esto sucede, actualiza las propiedades del usuario y aplica los nuevos valores a los eventos que el usuario envía a partir de ese momento. Las actualizaciones de los valores de las propiedades del usuario no se aplican de forma retroactiva y los valores anteriores se mantienen en los datos históricos. En otras palabras, los valores de las propiedades siempre deben reflejar los valores en el momento del evento.

Por ejemplo, en la imagen de abajo, este usuario vio un artículo a las 10:11 am. El valor de la propiedad de la ciudad pasó a ser San Francisco.

Este usuario también vio un artículo hace aproximadamente una semana. Cuando se selecciona ese evento, la propiedad Ciudad se muestra como Nueva York, que era el valor en el momento en que se activó el evento Ver artículo.

Las propiedades del usuario que se muestran con cada evento en el flujo de eventos individual de un usuario capturan el valor de la propiedad del usuario. en el momento del eventoEsta información se deriva del evento más reciente enviado a través de una llamada de identificación.

Cuando los valores de propiedad de usuario antiguos y nuevos se superponen

Cuando cambia el valor de una propiedad de usuario, los gráficos de pueden mostrar al usuario tanto en la categoría de propiedad de usuario nueva como en la antigua. Esta superposición solo se aplica al día específico en el que cambió el valor de la propiedad.

A continuación, se muestra un ejemplo de cómo podría funcionar: el 1 de julio, un usuario inicia sesión en su aplicación de juegos (actualmente en la versión 1.8) y juega algunos juegos. Más tarde ese día, actualiza a la nueva versión 2.0 y juega un poco más. Si segmenta el gráfico de usuarios activos diarios por versión y luego compara la versión 1.0 y la 2.0, ese usuario aparecerá en ambos segmentos para ese día. Sin embargo, a partir del 2 de julio, solo aparecerá en el segmento de la versión 2.0, hasta que actualice a una versión más nueva.

Algo similar puede suceder cuando se aplica un segmento de usuario a un gráfico. mostrará valores (ninguno) si el usuario no tenía ningún valor para una propiedad de usuario en el momento del evento. Si un usuario inicialmente tenía isPaying = (none) para su primer evento de PlaySong, pero luego tenía isPaying = True para el siguiente evento de PlaySong, el usuario aparecerá en ambos grupos. Si observa la página Actividad del usuario de ese usuario, solo aparecerá su valor más reciente para esa propiedad en la sección superior de su perfil.

Cómo aplica propiedades de usuario a eventos

Las propiedades de usuario se pueden aplicar a los eventos de tres maneras diferentes:

La propiedad del usuario se actualiza antes Se envía un evento: El valor de la propiedad se actualiza en la tabla de propiedades del usuario y se aplica al próximo evento que se envía a . Este es el método recomendado y esperado para actualizar las propiedades del usuario de modo que el valor de la propiedad actualizada se aplique correctamente al evento.

La propiedad del usuario se actualiza después Se envía un evento: El evento se envía a y, luego, el valor de la propiedad se actualiza en la tabla de propiedades del usuario. El valor actualizado no se refleja en la IU hasta que se envía otro evento. Si se envía una llamada de Identificación después del evento, el valor actualizado se no Se reflejará con el evento. Se reflejará en la parte superior del perfil de un usuario, pero no aparecerá en los resultados del gráfico hasta que se envíe otro evento después de la llamada de identificación.

Se envía la propiedad del usuario con un evento: En el caso de los eventos enviados a través de la API HTTP de , puedes incluir propiedades de usuario con la llamada del lado del servidor. El valor de propiedad de usuario actualizado se refleja en la interfaz de usuario tan pronto como recibe el evento; la tabla de propiedades de usuario también se actualiza una vez que se ingiere el evento. Los eventos futuros tendrán el valor de propiedad de usuario actualizado hasta que el valor en la tabla de propiedades de usuario se actualice nuevamente.

Para que un nuevo valor de propiedad de usuario se refleje en la interfaz de usuario, se debe enviar un evento después de la actualización o junto con ella. Las propiedades de usuario se pueden actualizar a través de la API de identificación. Lea y comprenda completamente la documentación de la API de identificación antes de usarla.

Propiedades del evento

Las propiedades de evento son atributos de los eventos que activan los usuarios y que luego envías a . Cada evento tendrá su propio conjunto de propiedades de evento. La naturaleza de estas propiedades depende tanto del tipo de producto que tengas como de la información específica que más te interese descubrir. Por ejemplo, si Swipe es un evento que estás rastreando, la propiedad de evento Direction podría tener los valores Left o Right .

Algunos ejemplos de propiedades de eventos son descripción, categoría, tipo, duración, nivel, porcentaje completado, recuento, origen, estado, número, vidas, autenticado, número de error, rango, acción y modo. Use las propiedades de eventos para reducir la cantidad de eventos que rastrea o para analizar mejor sus eventos.

NOTA: Debido a que es una plataforma basada en eventos, los eventos se registran con las propiedades del evento y las propiedades del usuario presentes en el momento en que se activó el evento. Esto se refleja en los gráficos. Si el gráfico no muestra los resultados esperados, es posible que esté consultando el tipo de propiedad incorrecto.

Por ejemplo, imagina que tienes una propiedad de usuario llamada email y una propiedad de evento separada también llamada email. La propiedad de usuario email almacena todos los datos, pero si en cambio estás consultando la propiedad de evento email, tu gráfico devolverá resultados inesperados. Si te desplazas hacia arriba o hacia abajo en la lista desplegable, verás Propiedades del evento y Propiedades del usuario—¡Asegúrate de seleccionar el correcto!

Ocultar propiedades

Puede ocultar propiedades antiguas o con errores según sea necesario. Ocultar propiedades de eventos o de usuario solo impedirá que aparezcan en la interfaz de usuario de la plataforma y no las eliminará. Siempre puede mostrar las propiedades si cambia de opinión.