Skip to content

Ciclo de vida do perfil do usuário

Este artigo descreve o ciclo de vida do perfil de usuário da Braze e as várias maneiras de identificar e fazer referência a um perfil de usuário. Se quiser entender melhor o ciclo de vida do cliente, confira nosso curso do Braze Learning sobre Mapeamento do ciclo de vida do usuário.

Todos os dados persistentes associados a um usuário são armazenados em seu perfil de usuário. Depois que um perfil de usuário é criado, seja por meio da API ou depois que um usuário é reconhecido pelo SDK, é possível atribuir vários parâmetros a esse perfil para identificar e fazer referência a esse usuário.

Esses parâmetros incluem:

  • braze_id (atribuído pela Braze)
  • external_id
  • email
  • phone
  • Qualquer número de aliases de usuário personalizados que você definir

Perfis de usuários anônimos

Qualquer usuário sem um external_id designado é chamado de usuário anônimo. Por exemplo, podem ser usuários que visitaram seu website mas não se inscreveram, ou usuários que baixaram seu app móvel mas não criaram um perfil.

Inicialmente, quando um usuário é reconhecido pelo SDK, um perfil de usuário anônimo é criado com um braze_id associado: um identificador único que é atribuído automaticamente pela Braze, não pode ser editado e é específico do dispositivo. Esse identificador pode ser usado para atualizar o perfil de usuário por meio da API.

Perfis de usuário identificados

Depois que um usuário é reconhecido no seu app (ao fornecer uma forma de ID de usuário ou endereço de e-mail), recomendamos atribuir um external_id ao perfil desse usuário usando o método changeUser (web, iOS, Android). Um external_id permite identificar o mesmo perfil de usuário em vários dispositivos.

Os benefícios adicionais de usar um external_id incluem:

  • Fornecer uma experiência de usuário consistente em vários dispositivos e plataformas (por exemplo, não enviar notificações de usuário inativo para o tablet Android de um usuário quando ele é um usuário fiel do app no iPhone).
  • Melhorar a precisão da análise de dados ao confirmar que os usuários não estão criando um novo perfil de usuário toda vez que desinstalam e reinstalam, ou instalam o app em um dispositivo diferente.
  • Permitir a importação de dados de usuário de fontes externas ao app usando os endpoints de dados de usuário e direcionar usuários com mensagens transacionais usando nossos endpoints de envio de mensagens.
  • Buscar usuários individuais usando os filtros de “Teste” dentro do segmentador e na página Buscar usuários.

Considerações para IDs externos

Risco de usar um e-mail ou e-mail com hash como ID externo

Usar um endereço de e-mail ou um endereço de e-mail com hash como seu ID externo da Braze pode simplificar o gerenciamento de identidade em suas fontes de dados. No entanto, é importante considerar os riscos potenciais para a privacidade do usuário e a segurança dos dados.

  • Informação previsível: endereços de e-mail são facilmente previsíveis, tornando-os vulneráveis a ataques.
  • Risco de exploração: se um usuário mal-intencionado alterar seu navegador web para enviar o endereço de e-mail de outra pessoa como seu ID externo, ele poderá acessar mensagens confidenciais ou informações da conta.

O que acontece quando você identifica usuários anônimos

Dois cenários podem ocorrer quando você identifica usuários anônimos:

1) Um usuário anônimo se torna um novo usuário identificado:
Se o external_id ainda não existir na Braze, o usuário anônimo se torna um novo usuário identificado e mantém todos os mesmos atributos e histórico do usuário anônimo.

2) Um usuário anônimo é identificado como um usuário já existente:
Se o external_id já existir na Braze, então esse usuário foi previamente identificado como um usuário no sistema de alguma outra forma, como por meio de outro dispositivo (como um tablet) ou dados de usuário importados.

Em outras palavras, você já tem um perfil de usuário para esse usuário. Nesse caso, a Braze fará o seguinte:

  1. Tornar o usuário anônimo órfão
  2. Mesclar campos específicos do perfil de usuário que ainda não existam no perfil do usuário identificado a partir do perfil anônimo
  3. Remover o perfil anônimo da sua base de usuários para que a contagem de usuários não fique inflacionada

Se tanto o usuário anônimo quanto o usuário conhecido tiverem um nome, o nome do usuário conhecido é mantido. Se o usuário conhecido tiver um valor nulo e o usuário anônimo tiver um valor, o valor do usuário anônimo é mesclado no perfil do usuário conhecido se o valor estiver entre esses campos específicos do perfil de usuário.

Para saber mais sobre como definir um external_id em um perfil de usuário, consulte nossa documentação (iOS, Android, Web).

Relatórios e perfis mesclados

Quando perfis anônimos e identificados são mesclados após um envio, os resumos de Campaign no dashboard atribuem esse envio ao perfil sobrevivente (identificado). O Currents, o Query Builder e a guia do histórico de mensagens ainda atribuem o envio ao ID de usuário do perfil órfão — o ID no momento do envio. Isso é esperado. Para ver a lista completa de campos que são transferidos, consulte o comportamento de mesclagem.

Para encontrar esse envio no Currents, no Query Builder ou no histórico de mensagens, busque o braze_id do perfil órfão. Uma consulta que usa apenas o braze_id do usuário identificado não retorna o envio anterior à mesclagem.

Mesclando usuários duplicados

Quando você identifica perfis de usuário duplicados no seu espaço de trabalho, pode mesclá-los usando a REST API. Para saber mais sobre a mesclagem de usuários e os métodos disponíveis, consulte Mesclar usuários duplicados.

Aliases de usuário

Para se referir a usuários por identificadores diferentes do external_id da Braze, defina aliases de usuário em um perfil de usuário. Qualquer alias definido em um perfil de usuário funcionará em conjunto com o braze_id ou external_id do usuário, em vez de substituí-lo. Não há limite para o número de aliases que você pode definir em um perfil de usuário.

Cada alias funciona como um par chave-valor composto por duas partes: um alias_label, que define a chave do alias, e um alias_name, que define o valor. Um alias_name para qualquer label individual deve ser único em toda a sua base de usuários (assim como o external_id). Se você tentar atualizar um segundo perfil de usuário com uma combinação de label e nome já existente, o perfil de usuário não será atualizado.

Atualização de aliases de usuário

Um alias pode ser atualizado com um novo nome para um determinado label após ser definido, seja usando nossos endpoints de dados de usuário ou passando um novo nome pelo SDK. O alias de usuário ficará visível ao exportar os dados desse usuário.

Dois perfis de usuário diferentes para usuários distintos com o mesmo label de alias de usuário, mas com nomes de alias diferentes

Marcação de usuários anônimos

Os aliases de usuário também permitem que você marque usuários anônimos com um identificador. Por exemplo, se um usuário fornecer seu endereço de e-mail em seu site de e-commerce, mas ainda não tiver se inscrito, o endereço de e-mail pode ser usado como alias para esse usuário anônimo. Esses usuários podem então ser exportados usando seus aliases ou referenciados pela API.

Comportamento de aliases em perfis de usuários anônimos

Se um perfil de usuário anônimo com um alias for posteriormente reconhecido com um external_id, ele será tratado como um perfil de usuário identificado normal, mas manterá seu alias existente e ainda poderá ser referenciado por esse alias.

Busca por alias de usuário

Se você souber o nome e o label do alias de um usuário, poderá encontrar o usuário em Search Users com o formato alias_label:alias_name. Por exemplo, se você tiver um perfil somente de alias com o nome alias_name: bobby_alias e label alias_label: m4pzOndtA-CnO0u, poderá encontrar esse usuário digitando m4pzOndtA-CnO0u:bobby_alias.

Se você não souber essa informação, poderá chamar o endpoint Export user profile by identifier e encontrar o alias de usuário na resposta da API.

Definição de aliases em perfis de usuários conhecidos

Um alias de usuário também pode ser definido em um perfil de usuário conhecido para referenciar um usuário conhecido por outro ID externamente conhecido. Por exemplo, um usuário pode ter um ID de ferramenta de business intelligence (como um ID da Amplitude) que você deseja referenciar na Braze.

Para informações sobre como definir um alias de usuário, consulte nossa documentação para cada plataforma (iOS, Android, Web).

Um fluxograma do ciclo de vida de um perfil de usuário na Braze. Quando changeUser() é chamado para um usuário anônimo, esse usuário se torna um Usuário Identificado e os dados são migrados para seu perfil de usuário identificado. O Usuário Identificado possui um Braze ID e um ID externo. Nesse ponto, se um segundo usuário anônimo tiver changeUser() chamado, os campos de dados de usuário que ainda não existem no Usuário Identificado serão mesclados. Se o Usuário Identificado tiver um alias adicionado ao seu perfil de usuário existente, nenhum dado será afetado, mas ele se tornará um Usuário Identificado com alias. Se um terceiro usuário anônimo com o mesmo label de alias do Usuário Identificado, mas com um nome de alias diferente, tiver changeUser() chamado, quaisquer campos que não existam no Usuário Identificado serão mesclados e o label de alias no perfil do Usuário Identificado será mantido.

Caso de uso avançado

Você pode definir um novo alias de usuário para perfis de usuário identificados existentes por meio do nosso SDK e da nossa API usando os endpoints de dados de usuário. No entanto, aliases de usuário não podem ser definidos pela API para um perfil de usuário desconhecido já existente.

Os aliases de usuário também são mesclados no processo. Porém, se tanto o usuário a ser desvinculado quanto o usuário de destino tiverem um alias com o mesmo rótulo, apenas o alias do usuário de destino será mantido.

Desinstalar e reinstalar um app gera um novo braze_id anônimo para esse usuário.

Solução de problemas com IDs de usuário

Todos os IDs de usuário podem ser usados para encontrar e identificar usuários no seu dashboard para testes. Para encontrar seu usuário no dashboard da Braze, consulte Adicionando usuários teste.
New Stuff!