Atributos personalizados

Esta página trata de los atributos personalizados, que son una colección de los rasgos únicos de tus usuarios. Los atributos personalizados son ideales para almacenar atributos sobre tus usuarios o información sobre acciones de bajo valor dentro de tu aplicación.

Cuando se almacenan en Braze, los atributos personalizados pueden utilizarse para crear segmentos de audiencia y personalizar la mensajería mediante Liquid. Ten en cuenta que Braze no almacena información de series temporales para los atributos personalizados, por lo que no podrás obtener ningún gráfico basado en ellos como puedes hacer con los eventos personalizados.

Casos de uso

Algunos casos de uso comunes de atributos personalizados incluyen:

• Segmentar y suprimir audiencias segmentando usuarios según rasgos como nivel de fidelización, estado de suscripción, idioma preferido o tipo de plan
• Personalizar mensajes con Liquid haciendo referencia a atributos como el nombre del usuario, puntos de recompensa o categoría favorita
• Rastrear etapas del ciclo de vida y estados del usuario, como etapa de incorporación, estado de la cuenta o fecha de fin de prueba
• Contar acciones de bajo valor con atributos numéricos, como incrementar un atributo feature_views_count cada vez que un usuario visualiza una característica
• Registrar cuándo ocurrieron por última vez acciones de bajo valor usando atributos de tiempo, como last_support_ticket_at o last_password_reset_at
• Almacenar intereses e historial del usuario como arrays, como géneros favoritos o contenido visto recientemente, para segmentación basada en intereses
• Almacenar datos de perfil más completos como objetos o arrays de objetos, como preferencias estructuradas o múltiples direcciones guardadas
• Desencadenar mensajes basados en acciones cuando cambia el valor de un atributo usando desencadenadores de atributos, como enviar una notificación de subida de nivel cuando cambia el rewards_tier de un usuario

Gestión de atributos personalizados

Para crear y gestionar atributos personalizados en el dashboard, ve a Configuración de datos > Atributos personalizados.

La columna Última actualización muestra la última vez que se editó el atributo personalizado, como la última vez que se configuró como lista de bloqueo o activo.

Desde esta página, puedes ver, gestionar, crear o bloquear atributos personalizados existentes. Selecciona el menú junto a un atributo personalizado para las siguientes acciones:

Lista de bloqueo

Puedes bloquear atributos personalizados individuales a través del menú de acciones, o seleccionar y bloquear hasta 100 atributos de forma masiva.

Cuando bloqueas un atributo personalizado:

• No se recopilarán datos futuros para ese atributo.
• Los datos existentes no estarán disponibles a menos que se desbloquee ese atributo.
• Ese atributo no aparecerá en filtros ni gráficos.

Además, si un atributo personalizado bloqueado está actualmente referenciado por filtros o desencadenadores en otras áreas de Braze, aparecerá un modal de advertencia explicando que todas las instancias de los filtros o desencadenadores que lo referencian serán eliminadas y archivadas.

Para más detalles sobre el bloqueo y la eliminación de datos personalizados, consulta Bloquear datos personalizados.

Marcar como información de identificación personal (PII)

Los administradores también pueden crear atributos personalizados y marcarlos como PII desde esta página. Estos atributos solo son visibles para administradores y usuarios del dashboard con el permiso “Ver atributos personalizados marcados como PII”.

Añadir descripciones

Puedes añadir una descripción a un atributo personalizado después de crearlo si tienes el permiso de usuario Manage Events, Attributes, Purchases. Selecciona Editar descripción para el atributo personalizado e introduce lo que desees, como una nota para tu equipo.

Añadir etiquetas

Puedes añadir etiquetas a un atributo personalizado después de crearlo si tienes el permiso de usuario “Manage Events, Attributes, Purchases”. Las etiquetas se pueden usar para filtrar la lista de atributos.

Eliminar atributos personalizados

Hay dos formas de eliminar atributos personalizados de los perfiles de usuario:

• Selecciona el nombre del atributo personalizado a eliminar en un paso de Actualización de usuario.
• Establece el valor null en tu solicitud de API al punto de conexión /users/track.

Exportar datos

Para exportar la lista de atributos personalizados como un archivo CSV, selecciona Exportar todo en la parte superior de la página. Se generará el archivo CSV y se te enviará un enlace de descarga por correo electrónico.

Cambiar el tipo de atributo personalizado

Requisitos previos

El atributo personalizado no debe estar actualmente en uso en ninguna Campaign, Canvas ni ningún Segment activo. Si intentas cambiar el tipo de datos mientras el atributo aún está referenciado, el dashboard mostrará un error y bloqueará el cambio.

Cambiar el tipo de datos

1. Detén cualquier Campaign o Canvas activo que use el atributo en Segments o filtros.
2. Elimina el atributo de todos los filtros de Segments, Campaigns y Canvas.
3. Ve a Configuración de datos > Atributos personalizados (o Eventos personalizados), busca el atributo y actualízalo al tipo de datos deseado.
4. Actualiza los valores del atributo en los perfiles de usuario existentes para que coincidan con el nuevo tipo de datos (por ejemplo, usando el punto de conexión /users/track).
5. Vuelve a aplicar el atributo a los Segments, Campaigns y Canvas relevantes, y luego reactiva cualquier Campaign o Canvas detenido.

Cosas a tener en cuenta

• Los datos de usuario no se actualizan retroactivamente. Si un perfil de usuario tenía el atributo con el tipo de datos anterior, ese valor permanece sin cambios. El filtro de segmentación busca el nuevo tipo de datos, por lo que los usuarios con el valor anterior quedan excluidos de los Segments coincidentes hasta que se actualice su perfil.
• Los nuevos datos deben coincidir con el nuevo tipo de datos. Después del cambio, las llamadas a la API o los eventos del SDK que envíen el tipo de datos anterior para este atributo no serán aceptados. Solo se ingieren valores que coincidan con el nuevo tipo de datos.
• Los filtros no se actualizan automáticamente. Los Segments y filtros de Campaigns que hacen referencia al atributo modificado no se actualizan retroactivamente. Debes eliminarlos y volver a añadirlos después del cambio.

Ver informes de uso

El informe de uso muestra todos los Canvas, Campaigns y Segments que utilizan un atributo personalizado específico. Esta lista no incluye usos de Liquid.

Puedes ver hasta 100 informes de uso a la vez seleccionando las casillas de verificación junto a los atributos personalizados correspondientes y luego seleccionando Ver informe de uso.

Pestaña Valores

Al ver un informe de uso, selecciona la pestaña Valores para ver los valores principales de los atributos personalizados seleccionados basados en una muestra de aproximadamente 250.000 usuarios. Ten en cuenta que, dado que los resultados se obtienen de un subconjunto de usuarios, la muestra no incluirá todos los valores existentes. Esto significa que la pestaña Valores no debe usarse para solución de problemas ni para casos de uso que requieran incorporar datos de todos los usuarios.

Establecer atributos personalizados

A continuación se listan los métodos en varias plataformas que se usan para establecer atributos personalizados.

Almacenamiento de atributos personalizados

Todos los datos almacenados en el perfil de usuario, incluidos los datos de atributos personalizados, se conservan indefinidamente mientras cada perfil esté activo.

Para una referencia completa de todos los tipos de datos que puedes almacenar como atributos personalizados, incluyendo booleanos, números, cadenas, arrays, tiempo, objetos y arrays de objetos, consulta Tipos de datos de atributos personalizados.