Automatically identify your users on your Android apps

Identification des utilisateurs dans une application Android native

Avant d’identifier vos utilisateurs, vous devez initialiser Polaria. Si ce n’est pas encore fait, suivez la documentation : Déploiement dans une application Android native.

Utilisation de la classe PolariaIdentity pour l'identification

La classe PolariaIdentity permet d'identifier les utilisateurs de votre application Android auprès de Polaria. L'identité est synchronisée à chaque appel de la fonction Polaria.show().

Exemple de déclaration et initialisation d’une identité

Étapes :

1. Déclarer une nouvelle instance d'identité :

   PolariaIdentity identity = PolariaIdentity();
   

2. Définir les attributs de l'utilisateur :

   identity.setId("qwerty123"); // Identifiant unique de l'utilisateur
   identity.setIdentityHash("backend_generated_hash"); // HMAC SHA256 généré avec la clé secrète de la marque et l'ID utilisateur
   identity.setName("A Android User"); // Nom de l'utilisateur
   identity.setEmail("[email protected]"); // Adresse e-mail
   identity.setAvatar("https://via.placeholder.com/200x200"); // URL de l’avatar
   identity.setRegisteredAt("1565356073"); // Timestamp sous forme de chaîne
   identity.setCustomAttribute("foo", "bar"); // Attributs personnalisés
   

3. Appliquer cette identité à Polaria :

   Polaria.setIdentity(identity);
   

Exemple de chaînage des appels de méthode

Vous pouvez également utiliser un chaînage de méthodes pour simplifier la définition des attributs et l'application de l'identité :

Polaria.setIdentity(
    PolariaIdentity()
        .setId("qwerty123")
        .setIdentityHash("backend_generated_hash")
        .setName("A Android User")
        .setEmail("[email protected]")
);

Remarque importante

• IdentityHash : Ce hash HMAC SHA256 doit être généré côté serveur en utilisant la clé secrète de la marque et l'ID utilisateur défini dans setId().

• Attributs personnalisés : Utilisez setCustomAttribute pour ajouter des métadonnées spécifiques à vos besoins.

Une fois configurée, l'identité sera synchronisée automatiquement chaque fois que le chatbox sera ouvert avec Polaria.show().