Ir al contenido

Objetos de cuenta

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

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:

  1. Ve a Audiencia > Filtros calculados.
  2. Selecciona Crear filtro y luego selecciona Filtros de objetos de datos.
  3. 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:

  1. Ve al generador de Segments.
  2. Añade tu filtro calculado preconfigurado para los criterios de la cuenta.
  3. Añade cualquier filtro de atributo de usuario adicional.
  4. Guarda tu Segment.

Por ejemplo:

  • Filtro calculado: industry de la cuenta es exactamente healthcare
  • Filtro de atributo de usuario: days_since_last_login es menor que 30

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.

{% 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.

New Stuff!