Mesclar usuários duplicados
Saiba como encontrar e mesclar usuários duplicados para maximizar a eficácia das suas Campaigns e Canvas.
REST API: identificar e mesclar usuários
As ferramentas nesta página mesclam perfis duplicados no dashboard. Você também pode combinar ou redirecionar perfis por meio dos endpoints de dados de usuários da Braze:
- POST: Identificar usuários (
/users/identify): Combina um perfil somente com alias, somente com e-mail ou somente com número de telefone com um perfil que tenha umexternal_id. - POST: Mesclar usuários (
/users/merge): Mescla um perfil de usuário em outro, inclusive quando ambos os perfis já possuem umexternal_id. Revise os Pré-requisitos e o Comportamento da mesclagem antes de chamar esse endpoint.
Quando um perfil anônimo é associado a um perfil identificado existente (por exemplo, por meio de uma chamada changeUser() do SDK ou /users/identify), a Braze descarta o perfil anônimo e copia apenas determinados campos para o perfil identificado. Para saber mais, consulte O que acontece quando você identifica usuários anônimos.
Mesclagens de usuários são difíceis de desfazer. Se você está planejando uma mesclagem complexa envolvendo múltiplos valores de external_id ou grandes migrações de perfis, entre em contato com seu gerente de sucesso do cliente da Braze para orientação antes de usar /users/merge.
A Braze trata três tipos de usuários de forma diferente ao mesclar: usuários marcados para exclusão, usuários teste e usuários do Grupo de controle global. Para mais informações, consulte Comportamento da mesclagem de usuários.
Mesclagem individual
Se uma pesquisa de usuários retornar perfis duplicados, você pode mesclar cada perfil individualmente a partir do perfil do usuário no dashboard da Braze.
Etapa 1: Pesquisar um perfil duplicado
Na Braze, selecione Audience > User Search.

Insira um identificador único, como um endereço de e-mail ou número de telefone, para o perfil duplicado e selecione Search.

Etapa 2: Mesclar duplicados
Para iniciar o processo de mesclagem, selecione Merge duplicates.

Escolha qual perfil de usuário manter e qual mesclar e selecione Merge profiles. Repita esse processo até que todos os perfis duplicados tenham sido mesclados.


Perfis de usuários duplicados não podem ser recuperados após a mesclagem.
Mesclagem em massa
Quando você mescla usuários duplicados em massa, a Braze encontra perfis com identificadores correspondentes (como um endereço de e-mail) e mantém um perfil. A Braze primeiro prioriza perfis com um external_id e, em seguida, aplica suas configurações de Resolving ties: Resolve ties using e Prioritization. Se não houver perfis com um external_id, a Braze usa Resolve ties using e Prioritization entre perfis sem um external_id. A Braze só mescla usuários quando essas configurações identificam um perfil a ser mantido. Por exemplo, se Resolve ties using for Updated date e ambos os perfis tiverem o mesmo timestamp de última atualização, a Braze não consegue resolver o empate, então esses usuários não são mesclados.
Etapa 1: Acessar Gerenciar público
No dashboard da Braze, selecione Audience > Manage Audience.

Etapa 2: Pré-visualizar os resultados (opcional)
Para pré-visualizar os resultados antes de mesclar os duplicados, selecione Generate list of duplicates.

A Braze gerará a pré-visualização e a enviará para o seu endereço de e-mail como um arquivo CSV.

No exemplo a seguir, a Braze usa o ID externo do usuário para sinalizar perfis duplicados e identificar qual deve ser mantido. Se esses perfis forem mesclados em massa, a Braze usará o perfil com um ID externo como o novo perfil principal do usuário.
| Email Address | External ID | Phone Number | Braze ID | Identifier for rule | Profile to keep | Profile to merge |
|---|---|---|---|---|---|---|
| [email protected] | A8i3mkd99 | (555) 123-4567 | 65fcaa547f470494d1370 | TRUE | FALSE | |
| [email protected] | (555) 987-6543 | 65fcaa547f47d004d1348 | FALSE | TRUE | ||
| [email protected] | (555) 321-0987 | 65fcaa547f47d0049135c | FALSE | TRUE |
Comportamento da mesclagem
A Braze preencherá os campos vazios no perfil mantido com valores do perfil mesclado. Para ver a lista de campos que serão preenchidos, consulte Comportamento da mesclagem.
Etapa 3: Mesclar os duplicados
Se estiver satisfeito com os resultados da pré-visualização, selecione Merge all duplicates.

Perfis de usuários duplicados não podem ser recuperados após a mesclagem.

Mesclagem baseada em regras
Você pode usar regras para controlar como os perfis duplicados são resolvidos ao executar uma mesclagem, garantindo que o perfil de usuário mais relevante seja mantido. Quando as regras são definidas, a Braze manterá os perfis que correspondem aos seus critérios.
Etapa 1: Definir suas regras
- Acesse Audience > Manage Audience > Edit rules.
- Na seção Profile to keep do painel Edit rules, selecione o Identifier para os perfis que serão mantidos ao mesclar duplicados. Pode ser o endereço de e-mail ou o número de telefone.
- Na seção Resolving ties, selecione os critérios para determinar como resolver empates entre perfis com critérios correspondentes de Profile to keep. Você pode selecionar o seguinte:
- Resolve ties using: Created date, Updated date, Last session
- Prioritization: Newest, Oldest

Por exemplo, você pode manter o perfil que tem um número de telefone. Se vários usuários tiverem o mesmo número de telefone, você pode resolver empates usando o campo Updated date e priorizar o usuário atualizado mais recentemente.
Etapa 2: Pré-visualizar os resultados (opcional)
Após salvar suas regras, você pode pré-visualizar como elas funcionarão selecionando Generate a list of duplicates. A Braze gerará a pré-visualização e a enviará para o seu endereço de e-mail como um arquivo CSV que mostra quais usuários seriam mantidos e mesclados se suas regras fossem aplicadas.
Etapa 3: Mesclar duplicados
Se estiver satisfeito com os resultados da pré-visualização, volte à página Manage Audience e selecione Merge all duplicates.

Perfis de usuários duplicados não podem ser recuperados após a mesclagem.
Mesclagem programada
Semelhante à mesclagem baseada em regras, a mesclagem programada permite automatizar a mesclagem de perfis de usuários diariamente usando regras pré-configuradas.

Após a ativação do recurso, a Braze atribuirá automaticamente um horário para executar o processo de mesclagem diariamente, por volta das 0h no fuso horário da empresa do usuário. Você pode desativar a mesclagem programada a qualquer momento. A Braze notificará os administradores do seu espaço de trabalho 24 horas antes da mesclagem programada, fornecendo um lembrete e tempo para revisar a configuração.

Perfis de usuários duplicados não podem ser recuperados após a mesclagem.