Ir para o conteúdo

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 mensagens para usuários individuais.

Os objetos de conta permitem armazenar dados de conta uma única 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 Accounts. Entre em contato com a equipe de conta da Braze.
  • Você já deve ter usuários na Braze.
  • Depois que o Accounts for ativado, ele aparecerá em Data Settings > Accounts. Se esta é a primeira vez que você usa o Accounts, siga as instruções de inicialização exibidas na tela.

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 individual de conta armazenado 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. 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.

Nome do campo Tipo de 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 da 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 Timestamp 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 contas por meio de:

  • Endpoints da REST API para registros de contas
  • Edição no navegador em Data Settings > Accounts para registros individuais

Primeiros passos

Etapa 1: Ativar Accounts

O Accounts é ativado no nível da empresa. Durante o Acesso Antecipado, sua equipe de conta da Braze cuida da ativação única.

Quando o Accounts estiver ativado, acesse Configurações de dados > Accounts 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:

  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 Canvas.

Criar segmentos baseados em contas

Quando seus registros de conta e filtro calculado estiverem prontos:

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

Por exemplo:

  • Filtro calculado: conta industry é 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 da conta do usuário no 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 as contas correspondentes:

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

Noções básicas de API

Você pode usar a REST API para gerenciar registros de conta durante o Acesso Antecipado.

Para detalhes sobre endpoints, consulte Endpoints de objetos de dados.

Para autenticação e noções básicas de endpoints REST, consulte 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 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. Durante o Acesso Antecipado, sua equipe de conta da Braze precisa ativá-lo para o seu espaço de trabalho.

New Stuff!