Objetos de conta

Use objetos de conta para segmentar e personalizar o envio de mensagens com dados de conta.

Com objetos de conta, você pode:

• Criar Segments com critérios de conta
• Personalizar mensagens com atributos de conta usando Liquid
• Gerenciar registros de conta em um só lugar

Objetos de conta são modelos de dados no nível do espaço de trabalho conectados a perfis de usuário. Um registro de conta é uma conta específica com os dados de campo associados a ela. Use objetos de conta quando o contexto da conta, como atributos da empresa, ajudar você a direcionar e personalizar o envio de mensagens. Você também pode modelar hierarquias de contas (como contas pai e filho) e vincular um perfil de usuário a várias contas.

Por que usar objetos de conta?

Alguns casos de uso exigem contexto no nível da conta, mesmo quando suas Campaigns e Canvas enviam mensagens para usuários individuais.

Com os objetos de conta, você armazena os dados da conta uma única vez e os reutiliza para segmentação e personalização em toda a Braze.

Isso permite que você:

• Segmente por atributos da conta
• Personalize mensagens com contexto compartilhado da conta (como nome da empresa ou setor)
• Modele relacionamentos entre contas e conecte um perfil de usuário a várias contas

Essa abordagem substitui a duplicação dos mesmos atributos de conta em vários perfis de usuário.

Pré-requisitos

Antes de começar:

• Seu espaço de trabalho precisa estar provisionado para Accounts. Embora o Accounts esteja disponível para todos, você precisa solicitar o provisionamento antes de usá-lo no dashboard ou pelos endpoints de Data Objects. Para ver as etapas, consulte Etapa 1: Ativar o Accounts.
• Você já precisa ter usuários na Braze.

Modelo de dados da conta

Cada conta exige um identificador (id) e um nome (name).

Os campos de conta nesta seção definem o esquema do objeto Account. Esses campos se aplicam a cada registro de conta individual que você armazena na Braze.

A Braze inclui objetos de conta com campos padrão por padrão. Você pode adicionar e remover campos personalizados de acordo com seu caso de uso. Os nomes de campo id, object_id e display_name são reservados, então você não pode usá-los como nomes de campos personalizados.

Opções de integração de dados

Você pode gerenciar registros de contas por meio de:

• Endpoints da REST API para registros de contas
• Edição no navegador em Configurações de dados > Contas para registros individuais

Primeiros passos

Etapa 1: Ativar Contas

O recurso Contas é ativado no nível da empresa. Para solicitar o provisionamento:

1. No dashboard da Braze, acesse Configurações de dados > Contas.
2. Preencha o questionário.

Depois que você enviar o questionário, ele será encaminhado para análise da Braze. Você deve receber uma resposta em até uma semana. Casos de uso de alta escala podem levar mais tempo.

Quando o provisionamento for concluído, acesse Configurações de dados > Contas e conclua o fluxo de inicialização única, se solicitado.

Etapa 2: Adicionar registros de conta

Adicione ou atualize registros de conta pela REST API ou pela edição no navegador.

Etapa 3: Criar um filtro calculado para os critérios de conta

Antes de segmentar com base em dados de conta, crie um filtro calculado que defina seus critérios de conta:

1. Acesse Público > Filtros calculados.
2. Selecione Criar filtro e, em seguida, selecione Filtros de objeto de dados.
3. Defina seus critérios de conta.

Para mais detalhes, consulte Filtros calculados.

Etapa 4: Usar o filtro calculado no criador de segmentos

No criador de segmentos, selecione o filtro calculado que você criou e adicione quaisquer filtros de atributo de usuário adicionais que apoiem o direcionamento da sua Campaign ou do seu Canvas.

Limites

Os Accounts incluem os seguintes limites padrão para atender à maioria dos casos de uso:

Essas são as capacidades iniciais. Se precisar de mais registros de conta ou de um limite maior, entre em contato com a equipe de conta da Braze para solicitar um aumento.

Para saber mais sobre os códigos de erro de limite e o que acontece quando uma solicitação de API ultrapassa um limite, consulte Limites do produto.

Crie segmentos baseados em contas

Depois que seus registros de contas e o filtro calculado estiverem prontos:

1. Acesse o criador de segmentos.
2. Adicione seu filtro calculado pré-configurado para os critérios da conta.
3. Adicione outros filtros de atributo de usuário, se necessário.
4. Salve seu segmento.

Por exemplo:

• Filtro calculado: o industry da conta é exatamente healthcare
• Filtro de atributo de usuário: days_since_last_login é menor que 30

Personalize com Liquid

Use a Liquid tag {% data_object account %} para carregar os dados de conta do usuário no array data_objects.

Nota

Ao usar Prévia e teste, use um Segment que inclua dados de conta para que a personalização seja resolvida corretamente.

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 as contas correspondentes:

1
2
3
4

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

Noções básicas da API

Você pode usar a REST API para gerenciar registros de contas.

Para obter detalhes sobre os endpoints, consulte Endpoints de Data Objects.

Para conhecer a autenticação e o básico dos endpoints REST, consulte a visão geral da API da Braze.

Ingestão de dados na nuvem

Você pode usar a ingestão de dados na nuvem (CDI) para sincronizar registros de contas diretamente do seu data warehouse com a Braze. Para ver as etapas de configuração e as opções de sincronização, consulte Sincronizar objetos de dados com a ingestão de dados na nuvem.

Perguntas frequentes

Posso adicionar campos personalizados às contas?

Sim. Você pode definir e gerenciar campos de conta personalizados no seu espaço de trabalho. Para conhecer os requisitos dos campos, consulte Modelo de dados de conta.

O Accounts é um complemento pago?

Não. O Accounts não é um complemento pago e está disponível em todos os planos. Seu espaço de trabalho precisa ser provisionado antes que você possa usá-lo. Para ver as etapas, consulte Etapa 1: Ativar o Accounts.