Definir IDs de usuários

Aprenda como definir IDs de usuários através do SDK da Braze. Estes são identificadores únicos que permitem rastrear usuários em dispositivos e plataformas, importar seus dados através da API de dados de usuários e enviar mensagens direcionadas através da API de envio de mensagens. Se você não atribuir um ID único a um usuário, a Braze atribuirá a ele um ID anônimo; no entanto, você não poderá usar esses recursos até que o faça.

Sobre usuários anônimos

Após a integração do SDK do Braze, os usuários que iniciarem seu app pela primeira vez serão considerados “anônimos” até que você chame o método changeUser e atribua a eles um external_id. Uma vez atribuídas, não é possível torná-las anônimas novamente. No entanto, se o usuário desinstalar e reinstalar o app, ele se tornará anônimo novamente até que changeUser seja chamado.

Se um usuário previamente identificado iniciar uma sessão em um novo dispositivo, todas as suas atividades anônimas serão automaticamente sincronizadas com o perfil existente depois que você ligar para changeUser nesse dispositivo usando o endereço external_id. Isso inclui quaisquer atribuições, eventos ou histórico coletados durante a sessão no novo dispositivo.

Prevenindo o rastreamento de usuários anônimos

Se o seu caso de uso exige que nenhum dado seja coletado antes de um usuário ser identificado, você pode adiar a inicialização do SDK da Braze até que o usuário faça login e um external_id esteja disponível. Defina uma flag no seu código que mude para true quando o usuário fizer login e só inicialize o SDK quando essa flag estiver definida.

Definindo um ID de usuário

Para definir um ID de usuário, chame o método changeUser() após o usuário fazer login inicialmente. Os IDs devem ser únicos e seguir nossas melhores práticas de nomenclatura.

Se você estiver fazendo hash de um identificador único, certifique-se de normalizar a entrada da sua função de hash. Por exemplo, ao fazer hash de um endereço de e-mail, remova quaisquer espaços em branco no início ou no final e leve em conta a localização.

• web
• android
• swift
• cordova
• roku
• unity
• react native

1
braze.changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING)

1
AppDelegate.braze?.changeUser(userId: "YOUR_USER_ID")

1
[AppDelegate.braze changeUser:@"YOUR_USER_ID_STRING"];

1
BrazePlugin.changeUser("YOUR_USER_ID");

1
m.Braze.setUserId(YOUR_USER_ID_STRING)

1
AppboyBinding.ChangeUser("YOUR_USER_ID_STRING");

1
Braze.changeUser("YOUR_USER_ID_STRING");

Como o changeUser() funciona

Quando você chama changeUser(), os seguintes comportamentos se aplicam:

• Chamar changeUser() com o mesmo ID de usuário que já está definido não tem efeito na contagem de sessões.
• Chamar changeUser() com um ID de usuário diferente encerra automaticamente a sessão atual e inicia uma nova.
• Quando um usuário anônimo chama changeUser() com um novo ID de usuário (que ainda não existe na Braze), os dados do perfil anônimo são mesclados no novo perfil identificado.
• Quando um usuário anônimo chama changeUser() com um ID de usuário existente, os dados do perfil anônimo não são mesclados no perfil identificado.

Alias do usuário

Como funcionam

Embora usuários anônimos não tenham external_ids, você pode atribuir a eles um alias de usuário em vez disso. Você deve atribuir um alias de usuário quando quiser adicionar outros identificadores ao usuário, mas não souber qual é o external_id deles (por exemplo, eles não estão logados). Com aliases de usuário, você também pode:

• Usar a API Braze para registrar eventos e atributos associados a usuários anônimos
• Usar o filtro de segmentação ID de Usuário Externo está em branco para direcionar usuários anônimos em seu envio de mensagens

Definindo um alias de usuário

Um alias de usuário consiste em duas partes: um nome e um rótulo. O nome refere-se ao identificador em si, enquanto o rótulo refere-se ao tipo de identificador ao qual pertence. Por exemplo, se você tiver um usuário em uma plataforma de suporte ao cliente de terceiros com o ID externo 987654, você pode atribuir a ele um alias na Braze com o nome 987654 e o rótulo support_id, para que você possa rastreá-lo entre plataformas.

• web
• android
• swift
• rest api
• react native

1
braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).getCurrentUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).currentUser?.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
 [[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];

1
2
3
4
{
  "alias_name" : (required, string),
  "alias_label" : (required, string)
}

1
Braze.addAlias("ALIAS_NAME", "ALIAS_LABEL");

Melhores práticas para nomeação de IDs

Recomendamos que você crie IDs de usuários usando o padrão Identificador Único Universal (UUID), o que significa que são strings de 128 bits aleatórias e bem distribuídas.

Alternativamente, você pode fazer hash de um identificador único existente (como um nome ou endereço de e-mail) para gerar seus IDs de usuários. Se fizer isso, certifique-se de implementar a autenticação do SDK para evitar a simulação de usuários.

Embora seja essencial que você nomeie corretamente seus IDs de usuários desde o início, você sempre pode renomeá-los no futuro usando o endpoint /users/external_ids/rename.