Définir des ID utilisateur
Découvrez comment définir des ID d’utilisateur via le SDK de Braze. Il s’agit d’identifiants uniques qui vous permettent de suivre les utilisateurs à travers les appareils et les plateformes, d’importer leurs données via l’API de données utilisateur et d’envoyer des messages ciblés via l’API de messages. Si vous n’attribuez pas d’ID unique à un utilisateur, Braze lui attribuera un ID anonyme à la place. Toutefois, vous ne pourrez pas utiliser ces fonctionnalités tant que vous ne l’aurez pas fait.
Pour les SDK wrapper non répertoriés, utilisez plutôt la méthode native Android ou Swift correspondante.
À propos des utilisateurs anonymes
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.
Définition d’un ID utilisateur
Pour définir un ID utilisateur, appelez la méthode changeUser()
après la première connexion de l’utilisateur. Les ID doivent être uniques et respecter nos meilleures pratiques en matière de dénomination.
Si vous hachurez plutôt un identifiant unique, veillez à normaliser l’entrée de votre fonction de hachage. Par exemple, lors du hachage d’une adresse e-mail, supprimez les espaces de début et de fin et tenez compte de la localisation.
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"];
Pour une implémentation standard du SDK Web, vous pouvez utiliser la méthode suivante :
1
braze.changeUser(YOUR_USER_ID_STRING);
Si vous souhaitez utiliser Google Tag Manager à la place, vous pouvez utiliser le type d’étiquette Change User pour appeler la méthodechangeUser
. Utilisez-le chaque fois qu’un utilisateur se connecte ou est identifié d’une autre manière avec son identifiant unique external_id
.
Veillez à saisir l’ID unique de l’utilisateur actuel dans le champ ID externe, généralement rempli à l’aide d’une variable de couche de données envoyée par votre site web.
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"));
N’attribuez pas d’ID statique par défaut ou d’appel changeUser()
lorsqu’un utilisateur se déconnecte. En procédant ainsi, vous ne pourrez pas réengager les utilisateurs précédemment connectés sur les appareils partagés. Au lieu de cela, gardez une trace de tous les ID d’utilisateurs séparément et assurez-vous que le processus de déconnexion de votre application permet de revenir à un utilisateur précédemment connecté. Lorsqu’une nouvelle session commence, Braze actualise automatiquement les données pour le profil nouvellement actif.
Alias utilisateurs
Comment ils fonctionnent
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
Définition d’un alias d’utilisateur
Un alias d’utilisateur se compose de deux parties : un nom et un libellé. Le nom fait référence à l’identifiant lui-même, tandis que l’étiquette fait référence au type d’identifiant auquel il appartient. Par exemple, si vous avez un utilisateur dans une plateforme de support client tierce avec l’ID externe 987654
, vous pouvez lui attribuer un alias dans Braze avec le nom 987654
et le libellé d’alias support_id
, afin de pouvoir le suivre à travers les plateformes.
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)
}
Meilleures pratiques en matière d’ID Naming
Nous vous recommandons de créer des ID d’utilisateur en utilisant la norme UUID (Universally Unique Identifier ), ce qui signifie qu’il s’agit de chaînes de caractères de 128 bits qui sont aléatoires et bien réparties.
Vous pouvez également hacher un identifiant unique existant (tel qu’un nom ou une adresse e-mail) pour générer vos ID d’utilisateur. Si vous le faites, veillez à mettre en œuvre l’authentification SDK, afin d’empêcher l’usurpation d’identité de l’utilisateur.
Bien qu’il soit essentiel de nommer correctement vos ID d’utilisateur dès le départ, vous pouvez toujours les renommer à l’avenir en utilisant le point de terminaison /users/external_ids/rename
endpoint.
Recommandé | Non recommandé |
---|---|
123e4567-e89b-12d3-a456-836199333115 | JonDoe829525552 |
8c0b3728-7fa7-4c68-a32e-12de1d3ed2d5 | [email protected] |
f0a9b506-3c5b-4d86-b16a-94fc4fc3f7b0 | NomSociété-1-2-19 |
2d9e96a1-8f15-4eaf-bf7b-eb8c34e25962 | jon-doe-1-2-19 |
Évitez de partager des détails sur la façon dont vous créez les ID utilisateurs, car cela pourrait exposer votre organisation à des attaques malveillantes ou à la suppression de données.