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 desta página mesclam perfis duplicados no dashboard. Você também pode combinar ou redirecionar perfis pelos endpoints de dados de usuários da Braze:
- POST: Identificar usuários (
/users/identify): Combina um perfil que tem apenas alias, apenas e-mail ou apenas número de telefone com um perfil que tem umexternal_id. - POST: Mesclar usuários (
/users/merge): Mescla um perfil de usuário em outro, inclusive quando os dois perfis já têm umexternal_id. Confira os pré-requisitos e o comportamento de mesclagem antes de chamar esse endpoint.
Quando um perfil anônimo corresponde a um perfil identificado existente (por exemplo, por meio de uma chamada changeUser() do SDK ou de /users/identify), a Braze torna o perfil anônimo órfão 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ê estiver planejando uma mesclagem complexa envolvendo vários valores de external_id ou grandes migrações de perfis, entre em contato com o gerente de sucesso do cliente da Braze para receber orientação antes de usar /users/merge.
A Braze lida de forma diferente com três tipos de usuários ao mesclar: usuários marcados para exclusão, usuários teste e usuários do Grupo de controle global. Para saber mais, consulte Comportamento de mesclagem de usuários.
Mesclagem individual
Se uma pesquisa de usuário retornar perfis duplicados, você poderá mesclar cada perfil individualmente a partir do perfil do usuário no dashboard da Braze.
Etapa 1: Pesquise um perfil duplicado
Na Braze, selecione Público > Pesquisa de usuários.
Insira um identificador exclusivo do perfil duplicado, como um endereço de e-mail ou número de telefone, e selecione Pesquisar.
Etapa 2: Mescle os 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é mesclar todos os perfis duplicados.
Não é possível recuperar perfis de usuário duplicados depois da 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. Primeiro, a Braze prioriza perfis com um external_id e depois aplica suas configurações de Resolução de empates: Resolver empates usando e Priorização. Se nenhum perfil tiver um external_id, a Braze usa Resolver empates usando e Priorização entre os perfis sem external_id. A Braze só mescla usuários quando essas configurações identificam um único perfil a manter. Por exemplo, se Resolver empates usando estiver definido como Data de atualização e ambos os perfis tiverem o mesmo registro de data e hora da última atualização, a Braze não consegue resolver o empate. Então, esses usuários não são mesclados.
Etapa 1: Acesse Gerenciar público
No dashboard da Braze, selecione Público > Gerenciar público.
Etapa 2: Visualize os resultados (opcional)
Para ter uma prévia dos resultados antes de mesclar as duplicatas, selecione Gerar lista de duplicatas.
A Braze gera a prévia e a envia para seu endereço de e-mail como um arquivo CSV.
O CSV inclui uma coluna Criado a partir de, que mostra como cada perfil foi criado originalmente (por exemplo, pelo SDK, pela REST API ou por importação de CSV). Isso ajuda você a entender a origem do perfil antes de mesclar as duplicatas.
Ao revisar as linhas duplicadas, compare Criado a partir de 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 principal antes de selecionar Mesclar todas as duplicatas.
O campo Criado a partir de é especialmente útil quando perfis duplicados têm valores parecidos, mas vêm de jornadas de ingestão diferentes. Ele dá à sua equipe mais contexto para as decisões de mesclagem e ajuda a evitar mesclagens acidentais de perfis que você prefere manter separados até uma revisão mais detalhada.
No exemplo a seguir, a Braze usa o ID externo do usuário para sinalizar perfis duplicados e identificar qual deles manter. Se esses perfis forem mesclados em massa, a Braze usará o perfil com ID externo como o novo perfil principal do usuário.
| Endereço de e-mail | ID externo | Número de telefone | ID da Braze | Identificador da regra | Criado a partir de | Perfil a manter | Perfil a mesclar |
|---|---|---|---|---|---|---|---|
| [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 em branco do perfil mantido com valores do perfil mesclado. Para ver a lista dos campos que serão preenchidos, consulte Comportamento de mesclagem.
Etapa 3: Mescle suas duplicatas
Se estiver satisfeito com os resultados da prévia, selecione Mesclar todas as duplicatas.
Perfis de usuário 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 fazer uma mesclagem. Assim, o perfil de usuário mais relevante é mantido. Quando as regras estão definidas, a Braze mantém os perfis que correspondem aos seus critérios.
Etapa 1: Defina suas regras
- Acesse Público > Gerenciar público > Editar regras.
- Na seção Perfil a manter do painel Editar regras, selecione o Identificador dos perfis que serão mantidos ao mesclar duplicatas. Pode ser o endereço de e-mail ou o número de telefone.
- Na seção Resolução de empates, selecione os critérios para resolver empates entre perfis que atendem aos mesmos critérios de Perfil a manter. Você pode selecionar:
- Resolver empates usando: Data de criação, Data de atualização, Última sessão
- Priorização: Mais recente, Mais antigo
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 os empates usando o campo Data de atualização e priorizar o usuário atualizado mais recentemente.
Etapa 2: Visualize os resultados (opcional)
Depois de salvar suas regras, você pode ver uma prévia de como elas vão funcionar selecionando Gerar uma lista de duplicatas. A Braze vai gerar a prévia e enviá-la para o seu endereço de e-mail como um arquivo CSV. Esse arquivo mostra quais usuários seriam mantidos e mesclados se as suas regras fossem aplicadas.
Etapa 3: Mescle as duplicatas
Se estiver satisfeito com os resultados da prévia, volte à página Gerenciar público e selecione Mesclar todas as duplicatas.
Não é possível recuperar perfis de usuário duplicados depois da mesclagem.
Mesclagem agendada
Assim como a mesclagem baseada em regras, a mesclagem agendada permite automatizar a mesclagem diária de perfis de usuário com regras pré-configuradas.
Depois que o recurso é ativado, a Braze atribui automaticamente um horário para executar o processo de mesclagem todos os dias, por volta de 0h no fuso horário da empresa do usuário. Você pode desativar a mesclagem agendada a qualquer momento. A Braze notifica os administradores do seu espaço de trabalho 24 horas antes da mesclagem agendada. Assim, eles recebem um lembrete e têm tempo para revisar a configuração.
Não é possível recuperar perfis de usuário duplicados depois da 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 com o mesmo endereço de e-mail quando esses perfis são criados por identificadores diferentes, 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 de exportação de 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 pelo e-mail em Público > Pesquisa de usuários para revisar as duplicatas no dashboard.