Aller au contenu principal

Collecter le profil utilisateur

Cloud availabilityOSS availability

Au-delà des identifiants d'authentification et des informations d'identification nécessaires à la connexion de l'utilisateur, votre application peut avoir besoin de collecter des informations supplémentaires sur le profil utilisateur stockées dans Logto pour une récupération facile via les revendications JWT ou les API afin de fournir des expériences produits personnalisées. Vous pouvez collecter les données utilisateur par les méthodes suivantes :

  • Lors de l'inscription d'un nouvel utilisateur : Utilisez la fonctionnalité Collecter le profil utilisateur pour ajouter une étape "Parlez-nous de vous" prête à l'emploi qui collecte des informations supplémentaires sur le profil utilisateur lors de l'inscription. Les nouveaux utilisateurs doivent remplir tous les champs obligatoires avant que l'inscription ne soit considérée comme terminée. Ce document se concentre sur cette approche.

  • Après l'inscription de l'utilisateur : Utilisez l'Account API pour mettre en œuvre des expériences en libre-service lors des parcours d'intégration, des centres de compte ou tout au long de l'utilisation du produit afin de mettre à jour les informations du profil utilisateur.

Principaux avantages

La fonctionnalité Collecter le profil utilisateur vous permet de recueillir des informations supplémentaires sur l'utilisateur lors de l'expérience d'inscription de l'utilisateur final. Nous recommandons de ne collecter que les informations essentielles nécessaires à votre produit afin d'éviter des parcours d'inscription trop longs qui pourraient impacter les taux de conversion.

Cette fonctionnalité vous permet de :

  • Capturer des données utilisateur complètes : Collectez toutes les données utilisateur à des fins commerciales ou de conformité, y compris les propriétés utilisateur standard OIDC et les données personnalisées.

  • Personnalisation flexible des champs : Choisissez parmi différents types de champs tels que texte, nombre, date, case à cocher, liste déroulante (sélection), URL et validation par expression régulière pour répondre à vos besoins spécifiques.

  • Expérience utilisateur optimisée : Personnalisez l'affichage avec des libellés, descriptions, espaces réservés et règles de validation. Configurez les champs comme obligatoires ou optionnels selon vos besoins métier.

  • Configurations de champs intégrées : Utilisez des champs de données de base préconfigurés pour les propriétés utilisateur courantes avec une configuration prête à l'emploi. Profitez des champs composites (adresse, nom complet) pour recueillir efficacement des données structurées en une seule étape.

Démarrage rapide

  1. Rendez-vous sur Console Logto > Expérience de connexion > Collecter le profil utilisateur.
  2. Cliquez sur "Ajouter des champs de profil" et choisissez un champ intégré ou définissez une donnée personnalisée (clé alphanumérique) à créer.
  3. Ouvrez les détails du champ pour définir le type de champ, le libellé, la description, le caractère obligatoire et les paramètres spécifiques au type (longueur, plage, format, options, etc.). Cliquez sur "Enregistrer les modifications".
  4. Retournez dans Expérience de connexion > Collecter le profil utilisateur, faites glisser et déposez les champs pour les réorganiser ; les modifications seront automatiquement appliquées.
  5. Testez l'expérience utilisateur avec l'aperçu en direct Logto ou votre application de test. Que les utilisateurs créent un nouveau compte via identifiant (e-mail / numéro de téléphone / nom d'utilisateur), connexion sociale, ou SSO d’entreprise, ils verront tous la page "Parlez-nous de vous" lors de l'inscription.
Collecter le profil utilisateur lors de l'inscription

Types de données utilisateur

Les données utilisateur peuvent être consultées dans chaque profil utilisateur. Pour une vue d'ensemble complète de toutes les catégories de données utilisateur, consultez la documentation sur la structure des données utilisateur. La fonctionnalité Collecter le profil utilisateur vous permet de recueillir à la fois des données utilisateur de base et des données personnalisées lors de l'inscription.

Champs de données utilisateur de base

Les champs de données utilisateur de base fournis par Logto sont stockés directement dans la propriété user ou user.profile. Ces champs disposent de valeurs de configuration par défaut et de traductions i18n, prêtes à l'emploi après création. Vous pouvez également personnaliser les types de champs et les paramètres selon vos besoins spécifiques.

Nom du champClé de donnée utilisateurDescription
Nomuser.nameLe nom complet de l'utilisateur sous une forme affichable incluant tous les composants du nom (ex : "Jane Doe").
Nom completuser.profile.givenName
user.profile.middleName
user.profile.familyName
Le nom légal complet de l'utilisateur. Combine de manière flexible familyName, givenName et middleName selon la configuration.
Surnomuser.profile.nicknameNom familier ou usuel de l'utilisateur, qui peut différer de son nom légal.
Date de naissanceuser.profile.birthdateDate de naissance de l'utilisateur dans un format spécifié (ex : "MM-jj-aaaa").
Genreuser.profile.genderGenre auto-identifié de l'utilisateur (ex : "Femme", "Homme", "Préfère ne pas dire").
Profiluser.profile.profileURL de la page de profil lisible de l'utilisateur (ex : profil de réseau social).
Site webuser.profile.websiteURL du site personnel ou du blog de l'utilisateur.
Adresseuser.profile.address.formatted
user.profile.address.streetAddress
user.profile.address.region
user.profile.address.zoneinfo
user.profile.address.postalCode
user.profile.address.country
Adresse complète de l'utilisateur (ex : "123 rue Principale, Ville, France 12345"). Choisissez entre une seule ligne (address.formatted) ou plusieurs lignes avec composants configurables (rue, ville, état, code postal, pays).

Champs de données utilisateur personnalisées

Les champs de données utilisateur personnalisées sont des champs définis par l'utilisateur qui capturent des informations supplémentaires non couvertes par les champs de base, telles que les préférences, centres d'intérêt, taille de l'entreprise ou autres attributs spécifiques à l'activité.

Lors de la création de champs personnalisés, utilisez uniquement des caractères alphanumériques pour la clé de donnée utilisateur (ex : customData.companySize). Vous pouvez ensuite configurer le type de champ et personnaliser les propriétés supplémentaires selon vos besoins.

Pour plus d'informations sur la récupération et la mise à jour des données utilisateur personnalisées après la création de l'utilisateur, consultez structure des données utilisateur.

Types de champs

Nous pouvons simplement catégoriser les champs par simplicité :

  • Primitif : Texte, Nombre, Date, Case à cocher (Booléen), Liste déroulante (Sélection unique), URL, Expression régulière.
  • Composite : Nom complet, Adresse.

Propriétés communes

PropriétéS'applique àRemarques
LibelléTousNom affiché à l'utilisateur. Flotte en haut lorsque le champ a une valeur ou est sélectionné. Champ obligatoire.
Espace réservéTous (sauf case à cocher)Indice en ligne visible lorsque le libellé flotte (exemple de texte / guide de formatage).
DescriptionTous (sauf case à cocher)Texte d'accompagnement sous le champ pour des instructions plus longues ou un contexte supplémentaire.
ObligatoireTous (sauf case à cocher)Si activé, la soumission est bloquée si vide. Si désactivé, une étiquette (Optionnel) est ajoutée au libellé.

Configurations spécifiques au type

TypeAspects configurablesRemarques
Textelongueur min/maxLimite la longueur minimale et maximale du texte saisi par l'utilisateur.
Nombrevaleur min/maxLimite la plage numérique minimale et maximale de la valeur saisie.
DateFormat de date (prédéfini/perso)Choisissez des formats prédéfinis (MM/jj/aaaa, jj/MM/aaaa, aaaa-MM-jj). Changer l'espace réservé remplace les interactions par défaut. Ou utilisez des motifs date-fns entièrement personnalisables.
Case à cocherValeur par défautCoché (Vrai) / Non coché (Faux).
Liste déroulante (Sélection)Liste d'options (≥1)Utilisez valeur:libellé par ligne. Si le libellé est omis, la valeur est affichée.
URLN/AN/A
RegexExpression régulièreMotif de validation (sans les barres obliques de début/fin). Ex : ^\d3-\d2-\d4$ pour un numéro de sécurité sociale.
AdresseComposantsUne ou plusieurs lignes ; sous-composants : rue, ville, état, code postal, pays.
Nom completComposantsSous-composants : prénom, deuxième prénom, nom de famille.

Validation

La validation des champs est effectuée lors de la soumission utilisateur à l'étape finale de l'inscription. Les vérifications suivantes sont appliquées :

  • Présence requise (sauf case à cocher).
  • Limites de longueur (Texte).
  • Plage numérique (Nombre).
  • Correspondance de motif (Regex, Date avec format, URL, appartenance à une option de sélection).
  • Structure de l'URL (validation syntaxique de base, pas d'accessibilité).

S'applique également aux sous-composants des deux champs composites : address et fullname. Les composants individuels doivent également respecter les mêmes critères de validation.

Localisation

Logto fournit des traductions système pour les champs de données utilisateur de base, tels que firstName, lastName, gender et birthdate. Le libellé de ces champs est configurable dans la Console Logto. Vous pouvez remplacer ces libellés en fournissant vos propres traductions dans Logto > Expérience de connexion > Contenu

Les champs personnalisés dépendent entièrement des libellés, espaces réservés et descriptions que vous fournissez. Pour la localisation des champs personnalisés, vous pouvez gérer les traductions en utilisant Apportez votre UI ou nous contacter avec vos retours.

Management API (points de terminaison clés)

MéthodePoint de terminaisonObjectif
GET/api/custom-profile-fieldsLister tous les champs.
GET/api/custom-profile-fields/:nameRécupérer la définition d'un champ par nom.
POST/api/custom-profile-fieldsCréer un champ.
POST/api/custom-profile-fields/batchCréation en masse (≤20 éléments par requête).
PUT/api/custom-profile-fields/:nameMettre à jour un champ par nom et ensemble complet.
DELETE/api/custom-profile-fields/:nameSupprimer un champ.
POST/api/custom-profile-fields/properties/sie-orderMettre à jour l'ordre des champs dans l'expérience de connexion.

Bonnes pratiques

  • Collectez uniquement les données essentielles à l'inscription ; reportez les informations facultatives à une complétion ultérieure du profil.
  • Utilisez les champs composites pour les données structurées (adresse, nom complet) pour la cohérence et la localisation.
  • Fournissez des exemples clairs / espaces réservés pour les champs sensibles au format (regex, date, plages numériques).

FAQ

Les champs de profil collectent-ils les données des utilisateurs existants ?

Non, ils ne collectent que les informations lors de l'étape finale de l'inscription d'un nouvel utilisateur.

Que se passe-t-il si je supprime un champ ? Est-ce que cela supprime la donnée utilisateur ?

Non, cela ne supprimera pas les données utilisateur existantes. Seul le champ sera retiré du formulaire d'inscription dans l'expérience utilisateur finale.

Puis-je collecter le pays avec une liste contrôlée au lieu d'un champ texte classique ?

Oui, vous pouvez basculer le composant "Pays" en un champ "Liste déroulante (Sélection unique)" avec des options standardisées.