Definir IDs de usuário

Saiba como definir IDs de usuário por meio do SDK do Braze. Esses são identificadores exclusivos que permitem rastrear usuários em dispositivos e plataformas, importar seus dados por meio da API de dados de usuários e enviar mensagens direcionadas por meio da API de envio de mensagens. Se você não atribuir uma ID exclusiva a um usuário, o Braze atribuirá a ele uma ID anônima - 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.

Definição de um ID de usuário

Para definir um ID de usuário, chame o método changeUser() depois que o usuário fizer o registro inicial. Os IDs devem ser exclusivos e seguir nossas práticas recomendadas de nomenclatura.

Se, em vez disso, estiver fazendo hashing de um identificador exclusivo, certifique-se de normalizar a entrada da sua função de hashing. Por exemplo, ao fazer o hash de um endereço de e-mail, remova todos os espaços à esquerda ou à direita e leve em conta a localização.

• web
• android
• swift
• cordova
• roku
• unity

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");

Alias do usuário

Como eles 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

Definição de um alias de usuário

Um alias de usuário consiste em duas partes: um nome e um rótulo. O nome se refere ao próprio identificador, enquanto o rótulo se refere ao tipo de identificador ao qual ele pertence. Por exemplo, se você tiver um usuário em uma plataforma de suporte ao cliente de terceiros com o ID externo 987654, poderá atribuir a ele um alias no Braze com o nome 987654 e o rótulo support_id, para que possa fazer o rastreamento em todas as plataformas.

• web
• android
• swift
• rest api

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)
}

Práticas recomendadas de nomenclatura de ID

Recomendamos que você crie IDs de usuário usando o padrão UUID (Universally Unique Identifier), o que significa que são strings de 128 bits aleatórias e bem distribuídas.

Como alternativa, é possível fazer hash de um identificador exclusivo existente (como um nome ou endereço de e-mail) para gerar seus IDs de usuário. Se fizer isso, certifique-se de implementar a autenticação do SDK, para evitar a simulação do usuário.

Embora seja essencial nomear corretamente seus IDs de usuário desde o início, você sempre poderá renomeá-los no futuro usando o ponto de extremidade /users/external_ids/rename ponto final.