Configuração de 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

After you integrate the Braze SDK, users who launch your app for the first time will be considered “anonymous” until you call the changeUser method and assign them an external_id. Once assigned, you can’t make them anonymous again. However, if they uninstall and reinstall your app, they will become anonymous again until changeUser is called.

If a previously-identified user starts a session on a new device, all of their anonymous activity will automatically sync to their existing profile after you call changeUser on that device using their external_id. This includes any attributes, events, or history collected during the session on the new device.

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.

• android
• swift
• web
• cordova
• roku
• unity
• unreal engine

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
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
UBraze->ChangeUser(TEXT("YOUR_USER_ID_STRING"));

Alias do usuário

Como eles funcionam

Although anonymous users don’t have external_ids, you can assign them a user alias instead. You should assign a user alias when you want to add other identifiers to the user but don’t know what their external_id is (for example, they aren’t logged in). With user aliases, you also can:

• Use the Braze API to log events and attributes associated with anonymous users
• Use the External User ID is blank segmentation filter to target anonymous users in your messaging

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.

• android
• swift
• web
• api de descanso

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
braze.getUser().addAlias(ALIAS_NAME, 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.