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 de alias, somente de e-mail ou somente de número de telefone com um perfil que possui 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. Consulte Pré-requisitos e Comportamento de 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 via /users/identify), a Braze desvincula 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 vários valores de external_id ou migrações de perfis em grande escala, entre em contato com seu gerente de sucesso do cliente da Braze para orientação antes de utilizar o /users/merge.
A Braze lida de forma diferente com três tipos de usuários durante a mesclagem: usuários marcados para exclusão, usuários teste e usuários do Grupo de controle global. Para mais detalhes, consulte Comportamento de mesclagem de usuários.
Mesclagem individual
Se uma pesquisa de usuário 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 Público > Pesquisa de usuário.
Insira um identificador exclusivo, como um endereço de e-mail ou número de telefone, para o perfil duplicado, e selecione Pesquisar.
Etapa 2: Mesclar duplicados
Para iniciar o processo de mesclagem, selecione Mesclar duplicados.
Escolha qual perfil de usuário manter e qual mesclar, e selecione Mesclar perfis. Repita esse processo até que todos os perfis duplicados tenham sido mesclados.
Perfis de usuário duplicados não podem ser recuperados após a mesclagem.
Mesclagem em massa
Ao mesclar 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 prioriza primeiro os 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 os perfis sem external_id. A Braze só mescla usuários quando essas configurações identificam um perfil a ser mantido. Por exemplo, se Resolve ties using estiver definido como Updated date e ambos os perfis tiverem o mesmo timestamp de última atualização, a Braze não consegue resolver o empate e esses usuários não são mesclados.
Etapa 1: Acessar Manage Audience
No dashboard da Braze, selecione Audience > Manage Audience.
Etapa 2: Visualizar os resultados (opcional)
Para visualizar os resultados antes de mesclar os duplicados, selecione Generate list of duplicates.
A Braze gera a prévia e a envia para o seu endereço de e-mail como um arquivo CSV.
O CSV inclui uma coluna Created from que mostra como cada perfil foi criado inicialmente (por exemplo, por meio do SDK, da REST API ou de importação CSV). Isso ajuda a entender a origem do perfil antes de mesclar os duplicados.
Ao revisar as linhas duplicadas, compare Created from com identificadores como external_id, endereço de e-mail e número de telefone. Use esse contexto para decidir qual perfil deve ser mantido como o perfil principal antes de selecionar Merge all duplicates.
O campo Created from é especialmente útil quando perfis duplicados contêm valores semelhantes, mas foram criados por diferentes caminhos de ingestão. Ele fornece à sua equipe mais contexto para decisões de mesclagem e ajuda a reduzir mesclagens acidentais de perfis que você preferiria manter separados até uma análise mais aprofundada.
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 usa 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 | Created from | Profile to keep | Profile to merge |
|---|---|---|---|---|---|---|---|
| [email protected] | 123-external-id | 555 123-4567 | example-id-12345 | sdk | TRUE | FALSE | |
| [email protected] | 555 123-4567 | example-id-12346 | rest | FALSE | TRUE | ||
| [email protected] | 555 123-4567 | example-id-12347 | csv | FALSE | TRUE |
Comportamento de mesclagem
A Braze preencherá os campos vazios no perfil mantido com os valores do perfil mesclado. Para consultar a lista de campos que serão preenchidos, acesse Comportamento de mesclagem.
Etapa 3: Mesclar os duplicados
Se você estiver satisfeito com os resultados da prévia, selecione Merge all duplicates.
Os 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 perfis duplicados são resolvidos ao executar uma mesclagem, garantindo que o perfil de usuário mais relevante seja mantido. Quando as regras estão definidas, a Braze mantém 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 o critério para determinar como resolver empates entre perfis com critérios correspondentes de Profile to keep. Você pode selecionar as seguintes opções:
- Resolve ties using: Created date, Updated date, Last session
- Prioritization: Newest, Oldest
Por exemplo, você poderia manter o perfil que tem um número de telefone. Se vários usuários tiverem o mesmo número de telefone, você poderia resolver empates usando o campo Updated date e priorizar o usuário atualizado mais recentemente.
Etapa 2: Visualizar os resultados (opcional)
Após salvar suas regras, você pode visualizar como elas funcionarão selecionando Generate a list of duplicates. A Braze gerará a prévia e a enviará para seu endereço de e-mail como um arquivo CSV mostrando quais usuários seriam mantidos e mesclados se suas regras fossem aplicadas.
Etapa 3: Mesclar duplicados
Se você estiver satisfeito com os resultados da prévia, retorne à página Manage Audience e selecione Merge all duplicates.
Perfis de usuário duplicados não podem ser recuperados após a mesclagem.
Mesclagem programada
Assim como a mesclagem baseada em regras, a mesclagem programada permite automatizar a mesclagem de perfis de usuário diariamente usando regras pré-configuradas.
Depois que o recurso é ativado, a Braze atribui automaticamente um horário para realizar 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ário duplicados não podem ser recuperados após a mesclagem.
Por que há vários perfis de usuário associados ao mesmo endereço de e-mail?
A Braze armazena vários perfis de usuário que compartilham o mesmo endereço de e-mail quando os perfis são criados por meio de diferentes identificadores, importações ou sessões anônimas antes da identificação. Esse é o comportamento esperado quando os usuários não compartilham um único external_id.
Antes de mesclar duplicatas, use o endpoint Exportar perfil de usuário por identificador para confirmar quais perfis existem para um endereço de e-mail e quais campos cada perfil contém. Você também pode pesquisar por e-mail em Audience > User Search para revisar duplicatas no dashboard.