Objetos de cuenta
Usa objetos de cuenta para segmentar y personalizar la mensajería con datos de cuenta.

Cuentas se encuentra en acceso anticipado. Estas instrucciones pueden cambiar a medida que la característica evolucione.
Con los objetos de cuenta, puedes:
- Crear segmentos con criterios de cuenta
- Personalizar mensajes con atributos de cuenta a través de Liquid
- Gestionar registros de cuenta en un solo lugar
Los objetos de cuenta son modelos de datos a nivel de espacio de trabajo conectados a perfiles de usuario. Un registro de cuenta es una cuenta específica y sus datos de campo asociados. Usa objetos de cuenta cuando el contexto de la cuenta, como los atributos de la empresa, te ayude a segmentar y personalizar la mensajería. También puedes modelar jerarquías de cuentas (como cuentas principales y secundarias) y vincular un perfil de usuario a múltiples cuentas.
¿Por qué usar objetos de cuenta?
Algunos casos de uso requieren contexto a nivel de cuenta, incluso cuando tus Campaigns y Canvas se envían a usuarios individuales.
Los objetos de cuenta te permiten almacenar datos de cuenta una vez y reutilizarlos para segmentación y personalización en Braze.
Esto te permite:
- Segmentar por atributos de cuenta
- Personalizar mensajes con contexto de cuenta compartido (como el nombre de la empresa o la industria)
- Modelar relaciones entre cuentas y conectar un perfil de usuario a múltiples cuentas
Este enfoque reemplaza la duplicación de los mismos atributos de cuenta en muchos perfiles de usuario.
Requisitos previos
Antes de empezar:
- Tu espacio de trabajo debe estar habilitado para el acceso anticipado de Accounts. Contacta a tu equipo de cuenta de Braze.
- Ya debes tener usuarios en Braze.
- Una vez habilitado Accounts, aparece en Configuración de datos > Accounts. Si es la primera vez que usas Accounts, sigue las instrucciones de inicialización en pantalla.
Modelo de datos de cuenta
Cada cuenta requiere un identificador (id) y un nombre (name).
Los campos de cuenta en esta sección definen el esquema del objeto Cuenta. Esos campos se aplican a cada registro de cuenta individual que almacenas en Braze.
Braze incluye objetos de cuenta con campos estándar de forma predeterminada. Puedes añadir y eliminar campos personalizados según tu caso de uso. Los nombres de campo id, object_id y display_name están reservados, por lo que no puedes usarlos como nombres de campos personalizados.
| Nombre del campo | Tipo de campo | Obligatorio | Descripción |
|---|---|---|---|
id |
cadena | Sí | El ID del sistema para la cuenta (por ejemplo, ID de CRM). Debe ser único en tu espacio de trabajo. |
name |
cadena | Sí | Nombre de la cuenta. |
type |
cadena | No | Tipo de cuenta, como cliente, partner o revendedor. |
annual_revenue |
número | No | Ingresos anuales de la cuenta. |
industry |
cadena | No | Sector de la cuenta. |
number_of_employees |
número | No | Número de empleados/as. |
address |
cadena | No | Dirección postal. |
city |
cadena | No | Ciudad. |
state |
cadena | No | Estado o provincia. |
postal_code |
cadena | No | Código postal. |
country |
cadena | No | País. |
notes |
cadena | No | Notas adicionales. |
website |
cadena | No | URL del sitio web. |
main_phone |
cadena | No | Número de teléfono principal. |
created_date |
hora | No | Marca de tiempo de creación de la cuenta. |
sic_code |
cadena | No | Código de Clasificación Industrial Estándar. |
| Campos personalizados | personalizado | No | Campos que tú defines y gestionas. |
Opciones de integración de datos
Puedes gestionar los registros de cuentas a través de:
- Endpoints de REST API para registros de cuentas
- Edición en el navegador en Configuración de datos > Cuentas para registros individuales
Primeros pasos
Paso 1: Habilitar Accounts
Accounts se habilita a nivel de empresa. Durante el acceso anticipado, tu equipo de cuenta de Braze se encarga de la habilitación única.
Cuando Accounts esté habilitado, ve a Configuración de datos > Accounts y completa el flujo de inicialización única si se te solicita.
Paso 2: Añadir registros de cuenta
Añade o actualiza registros de cuenta a través de la REST API o mediante la edición en el navegador.
Paso 3: Crear un filtro calculado para los criterios de cuenta
Antes de segmentar por datos de cuenta, crea un filtro calculado que defina los criterios de tu cuenta:
- Ve a Audiencia > Filtros calculados.
- Selecciona Crear filtro y luego selecciona Filtros de objetos de datos.
- Define los criterios de tu cuenta.
Para más detalles, consulta Filtros calculados.
Paso 4: Usar el filtro calculado en el generador de Segments
En el generador de Segments, selecciona el filtro calculado que creaste y luego añade cualquier filtro de atributo de usuario adicional que respalde la segmentación de tu Campaign o Canvas.
Crea segmentos basados en cuentas
Una vez que los registros de tu cuenta y el filtro calculado estén listos:
- Ve al generador de Segments.
- Añade tu filtro calculado preconfigurado para los criterios de la cuenta.
- Añade cualquier filtro de atributo de usuario adicional.
- Guarda tu Segment.
Por ejemplo:
- Filtro calculado:
industryde la cuenta es exactamentehealthcare - Filtro de atributo de usuario:
days_since_last_logines menor que30
Personalizar con Liquid
Usa la etiqueta de Liquid {% data_object account %} para cargar los datos de la cuenta del usuario en el array data_objects.

Cuando uses Vista previa y prueba, utiliza un Segment que incluya datos de la cuenta para que la personalización pueda resolverse correctamente.
{% data_object account %}
Hi {{${first_name}}},
We'd love to invite you and your peers at {{ data_objects[0].name }}.
Para iterar sobre todas las cuentas coincidentes:
{% data_object account %}
{% for acct in data_objects %}
- {{ acct.name }}
{% endfor %}
Conceptos básicos de la API
Puedes usar la REST API para gestionar registros de cuentas durante el acceso anticipado.
Para obtener detalles sobre los endpoints, consulta Endpoints de objetos de datos.
Para información sobre autenticación y conceptos básicos de los endpoints REST, consulta Resumen de la API de Braze.
Preguntas frecuentes
¿Puedo añadir campos personalizados a las cuentas?
Sí. Puedes definir y gestionar campos de cuenta personalizados en tu espacio de trabajo. Para conocer los requisitos de los campos, consulta Modelo de datos de cuenta.
¿Accounts es un complemento de pago?
No. Accounts no es un complemento de pago y está disponible en todos los planes. Durante el acceso anticipado, tu equipo de cuenta de Braze debe habilitarlo para tu espacio de trabajo.