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 no perfil de usuário dele. Depois que um perfil de usuário é criado, seja pela API ou depois que o SDK reconhece um usuário, você pode 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 para dispositivos móveis, mas não criaram um perfil.

Inicialmente, quando o SDK reconhece um usuário, é criado um perfil de usuário anônimo com um braze_id associado. Esse é um identificador exclusivo atribuído automaticamente pela Braze, que não pode ser editado e é específico do dispositivo. Você pode usar esse identificador para atualizar o perfil de usuário por meio da API.

Perfis de usuários identificados

Depois que um usuário passa a ser reconhecível no seu app (porque forneceu algum tipo 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). Com um external_id, você consegue identificar o mesmo perfil de usuário em vários dispositivos.

Outros benefícios de usar um external_id:

• Oferecer uma experiência consistente em vários dispositivos e plataformas. Por exemplo, você evita enviar notificações de usuário inativo para o tablet Android de um usuário que é fiel ao app de iPhone.
• Melhorar a precisão da sua análise de dados, garantindo que os usuários não criem um novo perfil sempre que desinstalam e reinstalam o app ou o instalam em outro dispositivo.
• Importar dados de usuários de fontes externas ao app usando os endpoints de dados de usuários e direcionar usuários com mensagens transacionais usando nossos endpoints de envio de mensagens.
• Pesquisar usuários individuais usando nossos filtros de “Teste” no segmentador e na página Pesquisar usuários.

Considerações sobre IDs externos

Aviso

Não atribua um external_id a um perfil de usuário antes de poder identificá-lo exclusivamente. Depois de identificar um usuário, não é possível revertê-lo para anônimo.

Um external_id pode ser atualizado usando o endpoint /users/external_ids/rename. No entanto, qualquer tentativa de definir um external_id diferente durante a sessão de um usuário criará um novo perfil de usuário com o novo external_id associado a ele. Nenhum dado será transmitido entre os dois perfis.

Riscos 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 ID externo na Braze pode simplificar o gerenciamento de identidades entre suas fontes de dados. No entanto, é importante considerar os possíveis riscos à privacidade dos usuários e à segurança dos dados.

• Informações fáceis de adivinhar: Endereços de e-mail são fáceis de adivinhar, o que os torna vulneráveis a ataques.
• Risco de exploração: Se um usuário mal-intencionado alterar o navegador web para enviar o endereço de e-mail de outra pessoa como ID externo, ele poderá acessar mensagens confidenciais ou informações da conta.

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

Um destes dois cenários pode 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 atributos e o 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, esse usuário já foi identificado no sistema de outra forma, como por outro dispositivo (um tablet, por exemplo) ou por dados de usuários importados.

Ou seja, você já tem um perfil para esse usuário. Nesse caso, a Braze faz o seguinte:

1. Torna o usuário anônimo órfão
2. Mescla, a partir do perfil anônimo, os campos específicos do perfil de usuário que ainda não existem no perfil do usuário identificado
3. Remove o perfil anônimo da sua base de usuários, para que a contagem de usuários não fique inflada

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 será mesclado ao perfil do usuário conhecido, desde que esse valor esteja entre estes campos específicos do perfil de usuário.

Importante

Nem todos os dados do perfil anônimo são mesclados. Tokens por push e o histórico de engajamento com mensagens são transferidos (usados para Campaigns recebidas e segmentação). Já atributos personalizados, eventos personalizados e histórico de compras do perfil anônimo são mesclados ao usuário identificado somente quando esses campos ainda não existem no perfil do usuário identificado. Quando há dados conflitantes, os valores do usuário identificado são mantidos. Note que a guia Histórico de mensagens é alimentada pelo nosso data warehouse e não é atualizada após uma mesclagem, então os eventos anteriores à mesclagem não aparecem nela. Consulte o comportamento de mesclagem para ver a lista completa de campos que são e que não são transferidos, incluindo as superfícies que não refletem as mesclagens.

Para saber 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 que permanece (o identificado). O Currents, o Query Builder e a guia Histórico de mensagens continuam atribuindo o envio ao ID de usuário do perfil órfão, ou seja, o ID no momento do envio. Esse comportamento é esperado. Para ver a lista completa de campos transferidos, consulte o comportamento de mesclagem.

Para encontrar esse envio no Currents, no Query Builder ou no Histórico de mensagens, pesquise 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.

Nota

Usuários órfãos não são elegíveis para receber mensagens.

Mesclagem de usuários duplicados

Quando você identificar perfis de usuário duplicados no seu espaço de trabalho, poderá 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 aos 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 funciona em conjunto com o braze_id ou o external_id do usuário, e não como substituto deles. 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 de 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 rótulo deve ser único em toda a sua base de usuários (assim como acontece com o external_id). Se você tentar atualizar um segundo perfil de usuário com uma combinação de rótulo e nome já existente, o perfil de usuário não será atualizado.

Atualização de aliases de usuário

Depois de definido, um alias pode ser atualizado com um novo nome para um determinado rótulo. Para isso, use nossos endpoints de dados de usuários ou envie um novo nome pelo SDK. O alias de usuário ficará visível quando você exportar os dados desse usuário.

Marcação de usuários anônimos

Os aliases de usuário também permitem marcar usuários anônimos com um identificador. Por exemplo, se um usuário fornecer o endereço de e-mail ao 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. Depois, esses usuários podem 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 alias for reconhecido posteriormente com um external_id, ele será tratado como um perfil de usuário identificado normal. No entanto, ele manterá o alias existente e ainda poderá ser referenciado por esse alias.

Pesquisa de um alias de usuário

Se você souber o nome e o rótulo do alias de um usuário, poderá encontrá-lo em Pesquisar usuários com o formato alias_label:alias_name. Por exemplo, se você tiver um perfil somente com alias com o nome alias_name: bobby_alias e o rótulo alias_label: m4pzOndtA-CnO0u, poderá encontrar esse usuário digitando m4pzOndtA-CnO0u:bobby_alias.

Se você não tiver essas informações, 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 esse usuário por outro ID externo. Por exemplo, um usuário pode ter um ID de uma ferramenta de business intelligence (como um ID da Amplitude) que você queira referenciar na Braze.

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

Dica

Está com dificuldade para visualizar como isso funciona no ciclo de vida do perfil de usuário dos seus clientes? Acesse Melhores práticas para ver as melhores práticas de coleta de dados de usuários.

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ários. No entanto, não é possível definir aliases de usuário pela API para um perfil de usuário desconhecido existente.

Os aliases de usuário também são mesclados nesse processo. No entanto, se o usuário que se tornará órfão e o usuário-alvo tiverem um alias com o mesmo rótulo, apenas o alias do usuário-alvo 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 Adicionar usuários teste.

Importante

A Braze bloqueia perfis de usuário que crescem de forma anormal (“usuários fictícios”), pois esses perfis geralmente são resultado de uma integração incorreta. Um perfil é bloqueado quando ultrapassa qualquer um dos seguintes limites:

• Mais de 5.000.000 de sessões
• Mais de 20.000 nomes distintos de eventos personalizados
• Mais de 20.000 nomes distintos de produtos em compras

Depois que um perfil é bloqueado, a Braze para de ingerir todos os dados recebidos para esse perfil, tanto dos SDKs quanto da REST API. Se isso tiver acontecido com um usuário legítimo, entre em contato com o gerente da sua conta Braze. Para saber mais, consulte Bloqueio de spam.