Ciclo de vida do perfil do usuário

Este artigo descreve o ciclo de vida do perfil de usuário do 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
• external_id
• 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, esses podem ser usuários que visitaram seu site, mas não inscreveram-se, ou usuários que baixaram seu app para dispositivos móveis, 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 exclusivo que é atribuído automaticamente pelo Braze, não pode ser editado e é específico do dispositivo. Esse identificador pode ser usado para atualizar o perfil do usuário por meio da API.

Perfis de usuários identificados

Depois que um usuário for reconhecido em seu app (fornecendo uma forma de ID de usuário ou endereço de e-mail), sugerimos 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 o seguinte:

• Fornecer uma experiência de usuário consistente em vários dispositivos e plataformas (por exemplo, não enviar notificações de usuário caducas para o tablet Android de um usuário quando ele é um usuário fiel do app para iPhone).
• Melhore a precisão de sua análise de dados confirmando que os usuários não estão criando um novo perfil de usuário sempre que desinstalam e reinstalam ou instalam o app em um dispositivo diferente.
• Ative a importação de dados de usuários de fontes externas ao app usando os pontos de extremidade de dados do usuário e direcione os usuários com mensagens transacionais usando nossos pontos de extremidade de envio de mensagens.
• Pesquise usuários individuais usando nossos filtros “Testing” no segmentador e na seção Pesquisar usuários página.

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

Um dos dois cenários pode ocorrer quando você identifica usuários anônimos:

1) Um usuário anônimo torna-se um novo usuário identificado:
Se o external_id ainda não existir no Braze, o usuário anônimo se tornará um novo usuário identificado e manterá todas as mesmas atribuições 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 no 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. Usuário órfão do usuário anônimo
2. Mesclar campos de perfil de usuário específicos que ainda não existem no perfil de usuário identificado do perfil anônimo
3. Remova o perfil anônimo da sua base de usuários para que a contagem de usuários não seja inflada

Se o usuário anônimo e o usuário conhecido tiverem um primeiro nome, o primeiro nome do usuário conhecido será 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 no perfil do usuário conhecido se o valor se enquadrar nesses campos específicos do perfil do usuário.

Para obter informações sobre como definir um external_id em relação a um perfil de usuário, consulte nossa documentação(iOS, Android, Web).

Alias do usuário

Para se referir aos usuários por outros identificadores que não o Braze external_id, defina aliases de usuário em um perfil de usuário. Qualquer alias definido em um perfil de usuário atuará além do braze_id ou external_id do usuário, em vez de substituí-lo. Não há limite para o número de aliases que podem ser definidos em um perfil de usuário.

Cada alias funciona como um par chave-valor que consiste em 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 único deve ser exclusivo em toda a sua base de usuários (assim como em external_id). Se você tentar atualizar um segundo perfil de usuário com uma combinação de rótulo e nome pré-existente, o perfil de usuário não será atualizado.

Atualização de aliases de usuário

Ao contrário de external_id, um alias pode ser atualizado com um novo nome para um determinado rótulo depois de definido, seja usando nossos User Data endpoints ou passando um novo nome pelo SDK. O alias do usuário ficará visível ao exportar os dados desse usuário.

Tag 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 ao seu site de comércio eletrônico o endereço de e-mail, mas ainda não tiver se inscrito, o endereço de e-mail poderá ser usado como um 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 pseudônimo for posteriormente reconhecido com um external_id, ele será tratado como um perfil de usuário identificado normal, mas manterá seu pseudônimo existente e ainda poderá ser referenciado por esse pseudônimo.

Configuraçã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 fazer referência a um usuário conhecido por outra ID conhecida externamente. Por exemplo, um usuário pode ter um ID de ferramenta de business intelligence (como um ID do Amplitude) que você deseja referenciar na Braze.

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

Caso de uso avançado

É possível definir um novo alias de usuário para perfis de usuários identificados existentes por meio do nosso SDK e da nossa API usando os endpoints de dados de usuários. No entanto, os aliases de usuário não podem ser definidos por meio da API para um perfil de usuário desconhecido existente.

Os aliases de usuário também são mesclados no processo. No entanto, se tanto o usuário órfão 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 gerará 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 dashboard para testes. Para encontrar seu usuário no dashboard da Braze, consulte Adicionando usuários teste.