Skip to content

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 segmentos com critérios de conta
  • Personalizar mensagens com atributos de conta por meio de 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 e seus dados de campo associados. Use objetos de conta quando o contexto da conta, como atributos da empresa, ajuda 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 para usuários individuais.

Objetos de conta permitem armazenar dados de conta uma vez e reutilizá-los para segmentação e personalização na Braze.

Isso permite que você:

  • Segmente por atributos de conta
  • Personalize mensagens com contexto de conta compartilhado (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 deve estar habilitado para o acesso antecipado de Contas. Entre em contato com a equipe de conta da Braze.
  • Você já deve ter usuários na Braze.
  • Depois que Contas for ativado, ele aparecerá em Configurações de dados > Contas. Se esta for a primeira vez que você usa Contas, siga as instruções de inicialização na tela.

Modelo de dados de conta

Cada conta requer um ID externo (id) e um nome (name).

Os campos de conta nesta seção definem o esquema do objeto de conta. 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 com base no seu caso de uso.

Nome do campo Tipo do campo Obrigatório Descrição
id string Sim O ID do sistema para a conta (por exemplo, ID do CRM). Deve ser único no seu espaço de trabalho.
name string Sim Nome da conta.
type string Não Tipo de conta, como cliente, parceiro ou revendedor.
annual_revenue number Não Receita anual da conta.
industry string Não Setor da conta.
number_of_employees number Não Número de colaboradores.
address string Não Endereço.
city string Não Cidade.
state string Não Estado ou província.
postal_code string Não Código postal.
country string Não País.
notes string Não Notas adicionais.
website string Não URL do website.
main_phone string Não Número de telefone principal.
created_date time Não Data e hora de criação da conta.
sic_code string Não Código de Classificação Industrial Padrão.
Campos personalizados custom Não Campos que você define e gerencia.

Opções de integração de dados

Você pode gerenciar registros de conta por meio de:

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

Primeiros passos

Etapa 1: Ativar Contas

Contas é ativado no nível da empresa. Durante o acesso antecipado, a equipe de conta da Braze realiza a ativação única.

Quando Contas estiver ativado, 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 por meio da REST API ou da edição no navegador.

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

Antes de segmentar com base em dados de conta, crie um filtro calculado que defina seus critérios de conta. Para mais detalhes, consulte Como os filtros calculados funcionam.

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 suportem o direcionamento da sua Campaign ou Canvas.

Criar segmentos baseados em conta

Depois que seus registros de conta e filtro calculado estiverem prontos:

  1. Acesse o criador de segmentos.
  2. Adicione seu filtro calculado pré-configurado para critérios de conta.
  3. Adicione quaisquer filtros de atributo de usuário adicionais.
  4. Salve seu segmento.

Por exemplo:

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

Personalizar com Liquid

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

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 conta durante o acesso antecipado.

Para autenticação e noções básicas de endpoints REST, consulte a Visão geral da API da Braze.

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 requisitos de campo, consulte Modelo de dados de conta.

Contas é um complemento pago?

Não. Contas não é um complemento pago e está disponível em todos os planos. Durante o acesso antecipado, a equipe de conta da Braze deve ativá-lo para o seu espaço de trabalho.
New Stuff!