Définir les ID des utilisateurs pour iOS

Les ID utilisateur doivent être définis pour chacun de vos utilisateurs. Ils doivent être inchangés et accessibles lorsqu’un utilisateur ouvre l’application. Nommer correctement vos ID d’utilisateur dès le départ est l’une des étapes les plus cruciales de la mise en place des ID d’utilisateur. Nous vous conseillons vivement d’utiliser la norme Braze pour les UUID et les GUID (voir ci-dessous). Nous vous recommandons vivement de fournir cet identifiant, car il vous permettra de.. :

• Suivre vos utilisateurs sur les appareils et plateformes, améliorant la qualité de vos données comportementales et démographiques.
• Importez des données sur vos utilisateurs à l’aide de notre API de données d’utilisateurs.
• Ciblez des utilisateurs spécifiques avec notre API d’envoi de messages pour les messages généraux et transactionnels.

Convention de dénomination des ID utilisateurs suggérée

Chez Braze, nous recommandons vivement de nommer les ID utilisateurs, également appelés ID externes, dans un format UUIDs et GUIDs. Les UUID et les GUID sont des identificateurs universellement uniques qui consistent en un nombre de 128 bits utilisé pour identifier les informations dans les systèmes informatiques. Cela signifie que ces UUID sont longs, aléatoires et bien distribués. Si vous choisissez une autre méthode pour nommer vos ID d’utilisateur, ils doivent également être longs, aléatoires et bien répartis. Il est également important de noter que les ID utilisateurs sont sensibles à la casse. Par exemple, « Abcdef » est un utilisateur différent de « abcdef ».

Si vous constatez que vos ID comprennent des noms, des adresses e-mail, des horodatages ou des incréments, nous vous suggérons d’utiliser une nouvelle méthode de dénomination plus sûre afin que vos ID ne soient pas aussi faciles à deviner ou à usurper. Si vous choisissez de l’inclure dans vos ID d’utilisateur, nous vous recommandons vivement d’ ajouter notre fonctionnalité d’authentification SDK pour empêcher l’usurpation d’identité.

La communication de ces informations à des tiers peut permettre à des personnes extérieures à votre organisation de glaner des informations sur la façon dont vos ID d’utilisateur sont structurés, ce qui expose votre organisation à des mises à jour potentiellement malveillantes ou à la suppression d’informations. Le choix d’une convention d’appellation correcte dès le départ est l’une des étapes les plus importantes de la mise en place des ID utilisateurs. Toutefois, une migration est possible en utilisant notre endpoint de migration de l’ID externe.

Attribuer un ID utilisateur

Vous devez effectuer l’appel suivant dès que l’utilisateur est identifié (généralement après la connexion) pour définir l’ID utilisateur :

• objective-c
• swift

1
[[Appboy sharedInstance] changeUser:@"YOUR_USER_ID_STRING"];

1
Appboy.sharedInstance()?.changeUser("YOUR_USER_ID")

N’oubliez pas d’employer cette méthode dans le fil principal de votre application. L’utilisation asynchrone de la méthode peut entraîner un comportement non défini.

En outre, nous vous déconseillons de modifier l’ID de l’utilisateur lorsqu’il se déconnecte, car cela vous empêche de cibler l’utilisateur précédemment connecté avec des campagnes de réengagement. Si vous envisagez plusieurs utilisateurs sur le même appareil, mais que vous souhaitez n’en cibler qu’un seul lorsque votre application est déconnectée, nous vous recommandons de suivre séparément l’ID utilisateur que vous souhaitez cibler lorsqu’il est déconnecté et de revenir à cet utilisateur. ID dans le cadre du processus de déconnexion de votre application.

Meilleures pratiques et remarques sur l’intégration de l’ID utilisateur

Sauvegarde automatique de l’historique d’utilisateur anonyme

Reportez-vous à la section Profils utilisateurs identifiés pour plus d’informations sur ce qui se passe lorsque vous identifiez des utilisateurs anonymes.

Remarques supplémentaires et meilleures pratiques

Notez ce qui suit :

• Si votre appli est utilisée par plusieurs personnes, vous pouvez attribuer à chaque utilisateur un identifiant unique pour le suivre.
• Une fois qu’un ID d’utilisateur a été défini, vous ne pouvez pas ramener cet utilisateur à un profil anonyme.
• Ne changez pas l’ID de l’utilisateur lorsqu’il se déconnecte, car cela risque de dissocier l’appareil du profil utilisateur.
  • Par conséquent, vous ne pourrez pas cibler l’utilisateur précédemment déconnecté avec des messages de réengagement. Si vous anticipez plusieurs utilisateurs sur le même appareil, mais que vous souhaitez uniquement cibler l’un d’eux lorsque votre application est à l’état déconnecté, nous vous recommandons de suivre séparément l’ID utilisateur que vous souhaitez cibler durant la déconnexion et de basculer vers cet ID utilisateur dans le cadre du processus de déconnexion de votre application. Par défaut, seul le dernier utilisateur connecté recevra des notifications push de votre application.
• Le passage d’un utilisateur identifié à un autre est une opération relativement coûteuse.
  • Lorsque vous demandez un changement d’utilisateur, la session actuelle de l’utilisateur précédent est automatiquement fermée et une nouvelle session est lancée. Braze effectuera automatiquement une demande d’actualisation des données pour les messages in-app et les autres ressources de Braze pour le nouvel utilisateur.

Alias d’utilisateurs

Un alias d’utilisateur sert d’identifiant unique alternatif pour l’utilisateur. Vous pouvez utiliser des aliases pour identifier les utilisateurs selon d’autres critères que votre ID principal :

• Définissez un identifiant cohérent pour l’analyse qui suivra un utilisateur donné avant et après qu’il s’est connecté à une application mobile ou un site Internet.
• Ajoutez les identifiants utilisés par un fournisseur tiers à vos utilisateurs Braze afin de faciliter le rapprochement de vos données en externe.

Chaque alias se compose de deux parties : un nom pour l’identifiant lui-même et une étiquette indiquant le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec différentes étiquettes, mais un seul nom par étiquette.

Pour plus d’informations sur la définition d’alias d’utilisateur par rapport à un profil utilisateur, reportez-vous à la section Alias d’utilisateur.

• objective-c
• swift

1
 [[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];

1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)