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 Segments 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 varias 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 los datos de la cuenta una sola vez y reutilizarlos para la segmentación y la personalización en todo Braze.

Esto te permite:

• Segmentar por atributos de cuenta
• Personalizar mensajes con contexto compartido de la cuenta (como el nombre de la empresa o el sector)
• Modelar relaciones entre cuentas y conectar un perfil de usuario a varias cuentas

Este enfoque sustituye la duplicación de los mismos atributos de cuenta en muchos perfiles de usuario.

Requisitos previos

Antes de empezar:

• Tu espacio de trabajo debe tener habilitado el aprovisionamiento de cuentas. Aunque las cuentas están disponibles para todos los clientes, debes solicitar el aprovisionamiento antes de poder usarlas en el panel o a través de los endpoints de objetos de datos. Para conocer los pasos, consulta Paso 1: Habilitar cuentas.
• Ya debes tener usuarios en Braze.

Modelo de datos de cuenta

Cada cuenta requiere un identificador (id) y un nombre (name).

Los campos de cuenta de esta sección definen el esquema del objeto Account. Esos campos se aplican a cada registro de cuenta individual que almacenes 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.

Opciones de integración de datos

Puedes administrar los registros de cuentas mediante:

• Endpoints de la 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 Cuentas

Cuentas se habilita a nivel de empresa. Para solicitar el aprovisionamiento:

1. En el panel de Braze, ve a Configuración de datos > Cuentas.
2. Completa el cuestionario.

Después de enviar el cuestionario, se remite a Braze para su revisión. Deberías recibir una respuesta en el plazo de una semana. Los casos de uso a gran escala pueden tardar más.

Cuando se complete el aprovisionamiento, ve a Configuración de datos > Cuentas y completa el flujo de inicialización único si se te solicita.

Paso 2: Añadir registros de cuenta

Añade o actualiza registros de cuenta mediante la REST API o con la edición en el navegador.

Paso 3: Crear un filtro calculado para los criterios de cuenta

Antes de segmentar según los datos de cuenta, crea un filtro calculado que defina tus criterios de cuenta:

1. Ve a Audiencia > Filtros calculados.
2. Selecciona Crear filtro y, a continuación, selecciona Filtros de objetos de datos.
3. Define tus criterios de cuenta.

Para más detalles, consulta Filtros calculados.

Paso 4: Usar el filtro calculado en el Segment Builder

En el Segment Builder, selecciona el filtro calculado que creaste y, a continuación, añade cualquier filtro de atributos de usuario adicional que respalde la segmentación de tu Campaign o Canvas.

Límites

Accounts incluye los siguientes límites predeterminados para admitir la mayoría de los casos de uso:

Estas son las capacidades iniciales. Si necesitas más registros de cuenta o un límite más alto, ponte en contacto con tu equipo de cuenta de Braze para solicitar un aumento.

Para conocer los códigos de error de límite y lo que ocurre cuando una solicitud a la API superaría un límite, consulta Límites del producto.

Crear Segments basados en cuentas

Cuando tus registros de cuenta y tu filtro calculado estén listos:

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

Por ejemplo:

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

Personalizar con Liquid

Utiliza la etiqueta de Liquid {% data_object account %} para cargar los datos de cuenta del usuario en la matriz data_objects.

Nota

Cuando utilices Vista previa y prueba, usa un Segment que incluya datos de cuenta para que la personalización pueda resolverse correctamente.

1
2
3

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

1
2
3
4

{% data_object account %}
{% for acct in data_objects %}
- {{ acct.name }}
{% endfor %}

Conceptos básicos de la API

Puedes utilizar la REST API para administrar los registros de cuentas.

Para obtener más información sobre los endpoints, consulta Endpoints de objetos de datos.

Para conocer la autenticación y los 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 administrar campos de cuenta personalizados en tu espacio de trabajo. Para conocer los requisitos de los campos, consulta Modelo de datos de cuentas.

¿Accounts es un complemento de pago?

No. Accounts no es un complemento de pago y está disponible en todos los planes. Tu espacio de trabajo debe estar aprovisionado antes de que puedas usarlo. Para ver los pasos, consulta Paso 1: Habilitar Accounts.