Définir les ID d’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 sur différents appareils et plateformes, d’importer leurs données via l’API de données utilisateur et d’envoyer des messages ciblés via l’API d’envoi de messages. Si vous n’attribuez pas d’ID unique à un utilisateur, Braze lui attribue un ID anonyme à la place. Toutefois, vous ne pourrez pas utiliser ces fonctionnalités tant que vous ne l’aurez pas fait.

À propos des utilisateurs anonymes

Après avoir intégré le SDK Braze, les utilisateurs qui lancent votre application pour la première fois seront considérés comme “anonymes” jusqu’à ce que vous appeliez la méthode changeUser et que vous leur attribuiez un external_id. Une fois attribués, vous ne pouvez plus les rendre anonymes. Cependant, s’ils désinstallent et réinstallent votre application, ils redeviendront anonymes jusqu’à ce que changeUser soit appelé.

Si un utilisateur anonyme démarre une session sur un nouvel appareil, toute son activité anonyme sera automatiquement synchronisée avec son profil existant après que vous ayez appelé changeUser sur cet appareil à l’aide de son external_id. Cela inclut tous les attributs, événements ou historiques collectés au cours de la session sur le nouvel appareil.

Empêcher le suivi des utilisateurs anonymes

Si votre cas d’utilisation exige qu’aucune donnée ne soit collectée avant l’identification d’un utilisateur, vous pouvez retarder l’initialisation du SDK Braze jusqu’à ce que l’utilisateur se connecte et qu’un external_id soit disponible. Définissez un indicateur dans votre code qui passe à true lorsque l’utilisateur se connecte, et n’initialisez le SDK que lorsque cet indicateur est activé.

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 bonnes pratiques de dénomination.

Si vous hachez 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 en début et en fin de chaîne et tenez compte de la localisation.

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

Fonctionnement de changeUser()

Lorsque vous appelez changeUser(), les comportements suivants s’appliquent :

• Appeler changeUser() avec le même ID utilisateur que celui déjà défini n’a aucun effet sur le compteur de sessions.
• Appeler changeUser() avec un ID utilisateur différent met automatiquement fin à la session en cours et en démarre une nouvelle.
• Lorsqu’un utilisateur anonyme appelle changeUser() avec un nouvel ID utilisateur (qui n’existe pas encore dans Braze), les données du profil anonyme sont fusionnées dans le nouveau profil identifié.
• Lorsqu’un utilisateur anonyme appelle changeUser() avec un ID utilisateur existant, les données du profil anonyme ne sont pas fusionnées dans le profil identifié.

Alias d’utilisateur

Fonctionnement

Bien que les utilisateurs anonymes n’aient pas de external_ids, vous pouvez leur attribuer un alias d’utilisateur. Vous devez attribuer un alias utilisateur lorsque vous souhaitez ajouter d’autres identifiants à l’utilisateur mais que vous ne connaissez pas son external_id (par exemple, il n’est pas connecté). Avec les aliasing de l’utilisateur, vous pouvez également :

• Utilisez l’API de Braze pour journaliser les événements et les attributs associés aux utilisateurs anonymes.
• Utilisez le filtre de segmentation ID externe est vide pour cibler les utilisateurs anonymes dans votre envoi de messages.

Définition d’un alias d’utilisateur

Un alias d’utilisateur se compose de deux parties : un nom et un libellé. Le nom correspond à l’identifiant lui-même, tandis que le libellé désigne le type d’identifiant auquel il appartient. Par exemple, si vous avez un utilisateur dans une plateforme d’assistance client tierce avec l’ID externe 987654, vous pouvez lui attribuer un alias dans Braze avec le nom 987654 et le libellé support_id, afin de pouvoir le suivre sur l’ensemble des plateformes.

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

Bonnes pratiques de dénomination des ID

Nous vous recommandons de créer des ID utilisateur en utilisant la norme UUID (Universally Unique Identifier), c’est-à-dire des chaînes de caractères de 128 bits, 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 utilisateur. Dans ce cas, veillez à mettre en œuvre l’authentification SDK afin d’empêcher l’usurpation d’identité.

Bien qu’il soit essentiel de nommer correctement vos ID utilisateur dès le départ, vous pouvez toujours les renommer ultérieurement via l’endpoint /users/external_ids/rename.