Definir IDs de usuários

Aprenda como definir IDs de usuários através do SDK do 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, o Braze atribuirá a ele um ID anônimo em vez disso—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.

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. IDs devem ser únicos e seguir nossas melhores práticas de nomenclatura.

Se você estiver hashando um identificador único em vez disso, certifique-se de normalizar a entrada da sua função de hash. Por exemplo, ao hashar 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");

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

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 no 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 ID

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 que são aleatórias e bem distribuídas.

Alternativamente, você pode hash um identificador único existente (como um nome ou endereço de e-mail) para gerar seus IDs de usuários. Se você fizer isso, tenha certeza de implementar autenticação do SDK, para que você possa 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.