Cómo gestionar los atributos de usuario
1. ¿Qué son los atributos de usuario?
Los atributos de usuario son datos clave que describen las características de cada usuario y pueden utilizarse como criterios de segmentación en los recorridos.
MA admite tres tipos de atributos de usuario: estándar, recomendados y personalizados. Los atributos personalizados se pueden añadir, editar y eliminar desde Gestión de metadatos > Gestión de atributos > Atributos de usuario.
Descripción de los tipos de atributos:
Atributos estándar: los define el sistema; se recopilan automáticamente a través del SDK o se calculan en segundo plano.
Atributos recomendados: los define el sistema y requieren que el equipo de desarrollo los envíe mediante llamadas a la API.
Atributos personalizados: se crean según las necesidades del negocio.
2. Cómo crear atributos de usuario
2.1 Creación desde la página
Se pueden crear atributos de forma individual o importarlos en bloque mediante Excel. A continuación, se detallan los campos necesarios:
| Información | Obligatorio | Descripción |
|---|---|---|
| Nombre del atributo | Obligatorio | Nombre del atributo reportado. Admite letras minúsculas, números y guiones bajos, y debe empezar por una letra (p. ej., open_app). No se puede modificar una vez establecido. |
| Descripción del atributo | Obligatorio | Explicación clara del atributo, hasta 50 caracteres. Se puede modificar posteriormente. |
| Tipo de dato | Obligatorio | - |
2.2 Creación mediante API
Puede reportar atributos libremente llamando a la API. Si el atributo no existe, se creará automáticamente cuando se envíe por primera vez.
APIs disponibles para reportar atributos de usuario: Android API, iOS API, Web API, Rest API.
3. ¿Qué estados tienen los atributos de usuario?
Los atributos de usuario personalizados se crean con el estado visible de forma predeterminada. Puede ajustarlo en cualquier momento en función de las necesidades del negocio.
| Estado | Descripción |
|---|---|
| Visible | Se muestra en los filtros de atributos y puede recibir reportes de atributos. |
| Oculto | No se muestra en los filtros de atributos, pero puede recibir reportes de atributos. |
| Deshabilitado | No se muestra en los filtros de atributos y no puede recibir reportes de atributos. |
4. ¿Qué tipos de datos se admiten en los atributos de usuario?
| Tipo de dato | Descripción |
|---|---|
| STRING | Tipo cadena. Por ejemplo, «Nombre de usuario» suele configurarse como STRING. |
| NUMBER | Tipo numérico. Admite enteros y decimales. Por ejemplo, «Número de compras» suele configurarse como NUMBER. |
| BOOL | Tipo booleano. Admite True/False. Por ejemplo, «Es miembro VIP» suele configurarse como BOOL. |
| DATETIME | Tipo fecha y hora. Admite datos en formato ISO8601. Por ejemplo, «Hora de registro de la cuenta» suele configurarse como DATETIME. |
| LIST | Tipo colección: un array de elementos de tipo cadena (p. ej., ["Tesla", "Volkswagen", "Audi"]). Por ejemplo, «Etiquetas de interés» suele configurarse como LIST. |
5. ¿Cómo se actualizan los atributos de usuario?
A diferencia de los atributos de evento (que son puntuales), el sistema crea y mantiene para cada usuario una «tabla de atributos de usuario» dinámica, que se actualiza de forma continua a medida que se invocan las APIs de atributos de usuario.
5.1 Consulta y trazabilidad
- Página de atributos de usuario: consulte los valores actuales de todos los atributos del usuario en Gestión de usuarios > Detalles del usuario > Atributos de usuario.
- Página de detalles del evento: consulte una instantánea de los atributos del usuario en el momento en que se produjo un evento concreto en Gestión de usuarios > Detalles del usuario > Actividades > Detalles del evento.
- Historial de actualización de atributos: consulte el historial de cambios de cada atributo (valores antes y después del cambio) en Gestión de usuarios > Detalles del usuario > Actividades > Historial de actualización de atributos.
5.2 Métodos de actualización disponibles
Para cubrir distintos escenarios de negocio, se ofrecen cinco APIs flexibles para actualizar atributos:
| Método | Descripción |
|---|---|
| set | Sobrescribe el valor del atributo. |
| increase | Para atributos de tipo entero, acumula todos los datos reportados. Si el atributo no existía previamente, el valor inicial se considera 0. |
| add | Para atributos de tipo LIST, añade un valor concreto. |
| remove | Para atributos de tipo LIST, elimina un valor concreto. |
| delete | Elimina todos los valores del atributo. |
Para conocer el modo de llamada específico, consulte la documentación de la API de cada plataforma (Android / iOS / Web / Rest API) o póngase en contacto con el servicio de atención al cliente para más información.
