Ir para o conteúdo

Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução, use o componente de feedback na parte inferior do sumário, à direita da página.

Objetos de conta

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

Importante

Contas está em acesso antecipado. Estas instruções podem mudar conforme o recurso evolui.

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, 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 são enviados 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 elimina a necessidade de duplicar os mesmos atributos de conta em vários perfis de usuário.

Pré-requisitos

Antes de começar:

Seu espaço de trabalho precisa estar ativado para o acesso antecipado a Accounts. Entre em contato com a equipe de conta da Braze.
Você já precisa ter usuários na Braze.
Depois que Accounts for ativado, ele aparecerá em Configurações de dados > Accounts. Se esta for a primeira vez que você usa Accounts, siga as instruções de inicialização exibidas na tela.

Modelo de dados de conta

Cada conta requer 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.

Nome do campo	Tipo de campo	Obrigatório	Descrição
`id`	string	Sim	O ID da conta no seu sistema (por exemplo, o 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 da Classificação Industrial Padrão (SIC).
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 Configurações de dados > Contas para registros individuais

Primeiros passos

Etapa 1: Ativar contas

O recurso de contas é ativado no nível da empresa. Durante o acesso antecipado, a equipe de conta da Braze cuida da ativação, que é feita uma única vez.

Depois que o recurso de contas estiver ativado, acesse Configurações de dados > Contas e conclua o fluxo de inicialização único, se solicitado.

Etapa 2: Adicionar registros de contas

Adicione ou atualize registros de contas 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 contas, crie um filtro calculado que defina seus critérios de conta:

Acesse Público > Filtros calculados.
Selecione Criar filtro e depois Filtros de objeto de dados.
Defina seus critérios de conta.

Para saber mais, consulte Filtros calculados.

Etapa 4: Usar o filtro calculado no criador de segmentos

No criador de segmentos, selecione o filtro calculado que você criou. Em seguida, adicione outros filtros de atributos de usuário que ajudem no direcionamento da sua Campaign ou do seu Canvas.

Criar segmentos baseados em contas

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

Acesse o criador de segmentos.
Adicione seu filtro calculado pré-configurado para os critérios da conta.
Adicione quaisquer filtros de atributos de usuário adicionais.
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

Personalize com Liquid

Use a Liquid tag {% data_object account %} para carregar os dados da 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.

{% 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 da API

Você pode usar a REST API para gerenciar registros de contas durante o acesso antecipado.

Para ver os detalhes dos endpoints, consulte Endpoints de objetos de dados.

Para saber mais sobre autenticação e o básico dos 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 personalizados de conta no seu espaço de trabalho. Para ver os requisitos dos campos, consulte Modelo de dados de contas.

Accounts é um complemento pago?

Não. Accounts não é um complemento pago e está disponível em todos os planos. Durante o acesso antecipado, a equipe de conta da Braze precisa ativar o recurso no seu espaço de trabalho.

New Stuff!