Skip to content

Curso de Braze LearningAtributos 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.

Ejemplos

Algunos ejemplos comunes de uso de atributos personalizados incluyen:

  • Segmentar y suprimir audiencias segmentando usuarios en función de 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 recompensas o categoría favorita
  • Hacer seguimiento de las etapas del ciclo de vida y los estados del usuario, como la etapa de incorporación, el estado de la cuenta o la 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 mediante 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 mediante 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 panel, ve a Configuración de datos > Atributos personalizados.

Cuatro atributos personalizados que son booleanos.

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.

Solución de problemas de atributos personalizados o eventos duplicados

Si ves dos entradas de datos personalizados con el mismo nombre visible, es posible que una de ellas incluya un espacio invisible al inicio o al final.

Para solucionar y corregir esto:

  1. Ve a Configuración de datos > Atributos personalizados o Eventos personalizados, y localiza las dos entradas que parecen tener el mismo nombre.
  2. Confirma si uno de los nombres contiene espacios en blanco ocultos:
    1. Haz clic derecho en cada nombre y selecciona Inspeccionar.
    2. Revisa el valor del texto HTML en las herramientas de desarrollador de tu navegador.
    3. Compara los valores (por ejemplo, email frente a ` email`).
    4. Si es necesario, consulta Inspeccionar y editar páginas y estilos con Chrome DevTools.
  3. Decide qué nombre debe permanecer como tu clave canónica y estandariza esa ortografía y uso de mayúsculas exactos.
  4. Si una entrada incluye espacios al inicio o al final y fue creada directamente en el panel, deja de usar esa entrada y cambia a la clave canónica:
    • Actualiza cualquier flujo de trabajo del panel, importaciones CSV y runbooks internos para usar la clave canónica.
    • Bloquea datos personalizados de la entrada incorrecta cuando estés listo para retirarla.
  5. Verifica tus rutas de ingesta:
    • Las cargas útiles de API y SDK eliminan automáticamente los espacios al inicio y al final.
    • Los nombres creados en el panel no se recortan automáticamente, por lo que se requieren entrada manual y gobernanza.

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 panel con el permiso “View Custom Attributes Marked as 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:

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 Segment activos. Si intentas cambiar el tipo de datos mientras el atributo aún está referenciado, el panel muestra un error y bloquea el cambio.

Cambiar el tipo de datos

  1. Detén cualquier Campaign o Canvas activo que utilice el atributo en Segments o filtros.
  2. Elimina el atributo de todos los filtros de Segment, Campaign 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, utilizando el endpoint /users/track).
  5. Vuelve a aplicar el atributo a los Segments, Campaigns y Canvas relevantes, y luego reactiva cualquier Campaign o Canvas detenido.

Cosas que debes saber

  • 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 los valores que coincidan con el nuevo tipo de datos.
  • Los filtros no se actualizan automáticamente. Los Segments y los filtros de Campaign 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 enumera todos los Canvas, Campaigns y Segments que utilizan un atributo personalizado específico. Esta lista no incluye los 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 basándose 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 utilizarse para la solución de problemas ni para ejemplos que requieran incorporar datos de todos los usuarios.

Informe de uso de atributos personalizados seleccionados con una pestaña "Valores" abierta que muestra un gráfico circular de valores del atributo de país, como "US" y "PR".

Configurar atributos personalizados

A continuación se enumeran los métodos en varias plataformas que se utilizan para configurar atributos personalizados.

Ampliar para ver la documentación por plataforma

Almacenamiento de atributos personalizados

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

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

Cadenas vacías frente a valores nulos

Al borrar o desactivar un atributo personalizado, el comportamiento difiere en función de si pasas una cadena vacía ("") o null:

Valor Comportamiento
"" (cadena vacía) El atributo se establece con un valor vacío y permanece visible en el perfil de usuario.
null El atributo se elimina completamente del perfil de usuario.

Este comportamiento también afecta a la segmentación. Para los atributos personalizados, el filtro IS NOT BLANK comprueba si hay un valor no vacío. Esto significa que una cadena vacía ("") no coincide, aunque el atributo siga visible en el perfil. Un valor null tampoco coincide, porque el atributo se elimina del perfil.
New Stuff!