Atributo
Los atributos son datos descriptivos detallados del comportamiento del usuario, clasificados en tres tipos: atributos de evento, atributos de usuario y atributos de dispositivo. Al definir con mayor detalle eventos, usuarios y dispositivos mediante atributos, estos se pueden utilizar como condiciones de filtrado en los recorridos de usuario.
Tipos de atributos
Los atributos se clasifican en tres categorías: atributos de evento, atributos de usuario y atributos de dispositivo. Cada categoría se subdivide a su vez en atributos estándar, recomendados y personalizados.
| Categoría | Tipo de atributo | Descripción |
|---|---|---|
| Atributos de evento | Estándar | Atributos de evento predefinidos recopilados y reportados automáticamente por el SDK o generados mediante cálculos del backend |
| Recomendado | Atributos de evento predefinidos reportados por los desarrolladores mediante llamadas a la API | |
| Personalizado | Atributos de evento creados y reportados por los desarrolladores en función de las necesidades del negocio | |
| Atributos de dispositivo | Estándar | Información de dispositivo predefinida recopilada y reportada automáticamente por el SDK o generada mediante cálculos del backend |
| Atributos de usuario | Estándar | Información de usuario predefinida recopilada y reportada automáticamente por el SDK o generada mediante cálculos del backend |
| Recomendado | Atributos de usuario predefinidos reportados por los desarrolladores mediante llamadas a la API | |
| Personalizado | Atributos de usuario creados y reportados libremente por los desarrolladores en función de las necesidades del negocio |
Tipos de datos de atributos
| Tipo de datos | Descripción |
|---|---|
| STRING | Tipo cadena; por ejemplo, "Nombre de usuario" suele configurarse como tipo STRING |
| NUMBER | Tipo numérico; admite enteros y decimales; por ejemplo, "Número de compras" suele configurarse como tipo NUMBER |
| BOOL | Tipo booleano; admite true/false; por ejemplo, "Es miembro VIP" suele configurarse como tipo BOOL |
| DATETIME | Tipo fecha y hora; admite datos reportados en formato ISO8601. Por ejemplo, "Hora de registro de la cuenta" suele configurarse como tipo DATETIME |
| LIST | Tipo lista; es un array de elementos de tipo cadena (p. ej., ["Tesla", "Volkswagen", "Audi"]); por ejemplo, "Etiquetas de interés" suele configurarse como tipo LIST |
Atributos personalizados
Además de los atributos estándar y recomendados predefinidos, los desarrolladores pueden crear atributos de evento y de usuario personalizados según las necesidades del negocio. Los atributos personalizados se pueden crear mediante dos métodos: creación en la página y creación mediante API.
Creación en la página
Los atributos se pueden crear previamente en la página, ya sea de forma individual o en bloque mediante importación de Excel. La información obligatoria incluye:
| Información | Obligatorio | Descripción |
|---|---|---|
| Nombre del atributo | Obligatorio | El nombre del atributo reportado; admite letras minúsculas, números y guiones bajos, y debe comenzar con una letra; por ejemplo, open_app. Una vez configurado, no se puede cambiar. |
| Descripción del atributo | Obligatorio | Se puede añadir una nota para facilitar la comprensión del atributo, hasta 50 caracteres. Se permiten modificaciones después de configurarlo. |
| Tipo de datos | Obligatorio | El tipo de datos determina cómo el sistema de MA procesa los datos del atributo. Si los datos reportados no coinciden con el tipo, se convertirán de forma forzada. Si la conversión falla, los datos se descartarán. Los tipos admitidos incluyen STRING, NUMBER, BOOL, DATETIME y LIST. |
Creación mediante API
Los atributos se pueden reportar libremente mediante llamadas a la API. Si el atributo no existe, se creará automáticamente:
- Si el atributo de evento no existe, se creará automáticamente y se asociará al evento.
- Si el atributo de usuario no existe, se creará automáticamente.
Interfaces de API para el reporte de eventos: Android API, iOS API, Web API, REST API
Interfaces de API para el reporte de atributos de usuario: Android API, iOS API, Web API, REST API
Estado del atributo
Una vez creados los atributos personalizados de evento o de usuario, su estado inicial se establece en "Visible". Se puede modificar su estado según los requisitos del negocio.
| Estado | Descripción |
|---|---|
| Visible | Se muestra en el filtro de atributos y puede recibir reportes de atributos |
| Oculto | No se muestra en el filtro de atributos, pero puede recibir reportes de atributos |
| Deshabilitado | No se muestra en el filtro de atributos y no puede recibir reportes de atributos |
Atributos estándar
EngageLab ha predefinido los nombres y las descripciones de atributos de evento, atributos de usuario y atributos de dispositivo. Los datos se recopilan y reportan automáticamente mediante el SDK o se generan mediante cálculos del backend.
Los atributos estándar no se pueden editar ni eliminar. La lista de atributos estándar se puede ver en la página o descargar como archivo de Excel para referencia.
Atributos recomendados
EngageLab ha predefinido los atributos de evento y atributos de usuario, y los datos son reportados por los desarrolladores mediante llamadas a la API.
Se recomienda reportar los atributos recomendados en la mayor medida posible para facilitar análisis posteriores.
Los atributos recomendados no se pueden editar ni eliminar. La lista de atributos recomendados se puede ver en la página o descargar como archivo de Excel para referencia.
