Comment Gérer les Attributs Utilisateurs ?
1. Qu'est-ce que les Attributs Utilisateur ?
Les attributs utilisateur sont des informations essentielles qui décrivent les caractéristiques des utilisateurs et peuvent servir de critères de filtrage dans les parcours utilisateur. EngageLab prend en charge trois types d'attributs utilisateur : Standard, Recommandé et Personnalisé. Vous pouvez effectuer des opérations telles que Ajouter, Modifier et Supprimer sur les attributs personnalisés dans Gestion des Métadonnées > Gestion des Attributs > Attributs Utilisateur.
Description des types d'attributs :
Attributs standard : Prédéfinis par le système, collectés automatiquement par le SDK ou calculés en arrière-plan.
Attributs recommandés : Prédéfinis par le système, nécessitant une déclaration par les développeurs via des appels API.
Attributs personnalisés : Créés indépendamment en fonction des besoins métier.
2. Comment Créer des Attributs Utilisateur
2.1 Création via l'interface
Il est possible de créer des attributs individuellement ou d'en importer en masse à l'aide d'Excel. Les informations requises et leurs descriptions sont les suivantes :
| Information | Obligatoire | Description |
|---|---|---|
| Nom de l'Attribut | Obligatoire | Nom de l'attribut déclaré. Prend en charge les lettres minuscules, chiffres et traits de soulignement, et doit commencer par une lettre (ex. : open_app). Ne peut pas être modifié une fois défini. |
| Description de l'Attribut | Obligatoire | Note explicative claire pour l'attribut (jusqu'à 50 caractères). Modifiable après la création. |
| Type de Données | Obligatoire | - |
2.2 Création via API
Vous pouvez déclarer librement des attributs via l'API. Si un attribut n'existe pas, il sera automatiquement créé lors de la déclaration.
APIs disponibles pour la déclaration des attributs utilisateur : API Android, API iOS, API Web, API Rest.
3. Quels Sont les Statuts des Attributs Utilisateur ?
Les attributs utilisateur personnalisés sont définis par défaut sur Visible après leur création. Vous pouvez ajuster leur statut à tout moment en fonction de vos besoins métier.
| Statut | Description |
|---|---|
| Visible | Affiché dans les filtres d'attributs et peut recevoir des déclarations. |
| Masqué | Non affiché dans les filtres d'attributs, mais peut recevoir des déclarations. |
| Désactivé | Non affiché dans les filtres d'attributs et ne peut pas recevoir de déclarations. |
4. Quels Types de Données Sont Pris en Charge pour les Attributs Utilisateur ?
| Type de Données | Description |
|---|---|
| STRING | Type chaîne de caractères, par exemple, « Nom d'utilisateur » est généralement défini comme STRING. |
| NUMBER | Type numérique, prend en charge les entiers et les décimaux ; par exemple, « Nombre d'achats » est généralement défini comme NUMBER. |
| BOOL | Type booléen, prend en charge Vrai/Faux ; par exemple, « Est membre VIP » est généralement défini comme BOOL. |
| DATETIME | Type date et heure, prend en charge le format ISO8601 ; par exemple, « Date d'inscription du compte » est généralement défini comme DATETIME. |
| LIST | Type collection, c'est-à-dire un tableau d'éléments de type chaîne (ex. : [« Tesla », « Volkswagen », « Audi »]) ; par exemple, « Tags d'intérêt » est généralement défini comme LIST. |
5. Comment les Attributs Utilisateur Sont-ils Mis à Jour ?
Contrairement aux attributs d'événement uniques, le système crée et maintient pour chaque utilisateur un Tableau des Attributs Utilisateur dynamique, qui est continuellement mis à jour lors des appels aux APIs d'attributs utilisateur.
5.1 Consultation et traçabilité des données
- Page des attributs utilisateur : Consultez toutes les valeurs actuelles des attributs d'un utilisateur dans Gestion des utilisateurs > Détails utilisateur > Attributs utilisateur.
- Page des détails d'événement : Consultez un instantané des attributs utilisateur au moment où un événement spécifique s'est produit dans Gestion des utilisateurs > Détails utilisateur > Activité utilisateur > Détails de l'événement.
- Historique des mises à jour d'attributs : Consultez l'historique de chaque modification d'attribut (valeurs avant et après modification) dans Gestion des utilisateurs > Détails utilisateur > Activité utilisateur > Historique des mises à jour d'attributs.
5.2 Méthodes de mise à jour prises en charge
Pour répondre à divers scénarios métier, cinq APIs flexibles de mise à jour des attributs sont proposées :
| Méthode | Description |
|---|---|
| set | Remplace la valeur de l'attribut. |
| increase | Pour les attributs de type entier, additionne toutes les valeurs déclarées. Si l'attribut n'existait pas auparavant, la valeur initiale est considérée comme 0. |
| add | Pour les attributs de type LIST, ajoute une valeur spécifique. |
| remove | Pour les attributs de type LIST, supprime une valeur spécifique. |
| delete | Supprime toutes les valeurs de l'attribut. |
Pour les méthodes d'appel spécifiques, veuillez consulter la documentation API de chaque plateforme (Android / iOS / Web / Rest API) ou contacter le service client pour plus de détails.
