Gestion de la collecte de données utilisateur

Comment ça marche

Lors de l’enregistrement utilisateur, les données de base suivantes sont demandées :

• En utilisant Login API :
  • nom d’utilisateur
  • adresse e-mail
  • mot de passe
• En utilisant le widget Login :
  • adresse e-mail
  • mot de passe

Vous pouvez demander des données personnelles supplémentaires aux utilisateurs. Pour ce faire, dans votre Compte éditeur, indiquez les champs supplémentaires à inclure dans le formulaire d’inscription. L’enregistrement d’un utilisateur n’est possible qu’après avoir rempli tous les champs que vous avez marqués comme obligatoires. Les données fournies par les utilisateurs sont stockées dans leur profil dans la base de données.

Si, lors de l’authentification d’un utilisateur précédemment enregistré, il est constaté que certains champs de son profil ne sont pas remplis, le produit Login affichera un formulaire pour collecter les informations manquantes. Pour se connecter, l’utilisateur doit remplir tous les champs obligatoires de ce formulaire.

Comment configurer

1. Configurez votre projet de connexion dans le Compte éditeur.
2. Envoyez une demande à votre responsable de la réussite client pour inclure vos champs personnalisés dans le formulaire d'inscription utilisateur (optionnel).
3. Intégrez la solution du côté de votre application.

Configuration dans le Compte éditeur

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Login.
2. Dans le volet du projet de connexion, cliquez sur Configure.
3. Accédez au bloc User database et sélectionnez la section Supplementary user information.

4. Les champs et cases à cocher suivants peuvent être affichés dans le formulaire d’inscription utilisateur :
   • Username.
   • First name.
   • Last name.
   • Birthdate.
   • Country.
   • Genre.
   • Newsletter — une case à cocher permettant à l’utilisateur de s’abonner à la newsletter. Lorsque l’utilisateur coche la case, ses contacts sont automatiquement exportés vers Mailchimp si Mailchimp est connecté à votre projet.
   • Additional agreement — une case à cocher permettant à l’utilisateur de signer votre accord supplémentaire. La liste des utilisateurs ayant signé l’accord supplémentaire s’obtient via le Compte éditeur ou via méthode API. La liste sera disponible dans le fichier additional_agreement.csv.

5. Pour rendre un champ obligatoire, cliquez sur l'icône ★ dans la ligne de description du champ. L'icône deviendra bleue.

6. Cliquez sur Save Changes.

Demande d'ajout de champs personnalisés au formulaire d'inscription

Outre les champs disponibles dans le Compte éditeur, vous pouvez ajouter vos propres champs au formulaire d’inscription. Pour ce faire, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com et fournissez la liste des champs avec les informations suivantes pour chaque champ :

• nom du champ en anglais ;
• type :
  • string,
  • date,
  • select — sélection d’une option dans une liste,
  • multi-select — sélection de plusieurs options dans une liste ;
• si le champ est obligatoire.

Pour les champs select et multi-select, fournissez également à votre responsable de la réussite client des ensembles de valeurs possibles pour ces champs.

Intégration côté application

Si vous avez utilisé l’intégration via le widget Login, aucune action n’est requise pour intégrer le formulaire d’inscription étendu dans votre application.

Lors de l’intégration via le SDK Xsolla, la collecte d’informations supplémentaires sur les utilisateurs n’est pas encore disponible.

Lors de l’intégration via Login API, passez les données utilisateur supplémentaires collectées dans la requête Register new user à l’aide du paramètre fields. Ce paramètre est un ensemble de paires propriété-valeur. Les champs du formulaire d’inscription qui peuvent être connectés dans le Compte éditeur correspondent aux propriétés suivantes du paramètre fields :

POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
Content-Type: application/json

{
  "username": "john-email@email.com",
  "password": "123456",
  "email": "john-email@email.com",
  "fields": {
     "nickname": "John",
     "country-name": "US",
     "bday": "1997-07-16"
  }
}

curl --request POST \
  --url 'https://login.xsolla.com/api/user?login_url=https%3A%2F%2Fexample.com&projectId=projectId' \
  --header 'content-type: application/json' \
  --data '{"username":"john-email@email.com","password":"123456","email":"john-email@email.com","fields":{"nickname":"John","country-name":"US","bday":"1997-07-16"}}'

Les options d’ajout de champs au formulaire d’inscription et l’emplacement de stockage des informations collectées diffèrent selon le type de stockage des données utilisateur choisi :

• Stockage Xsolla
• Stockage PlayFab
• Stockage Firebase
• Stockage personnalisé

Stockage Xsolla

Stockage PlayFab

Si vous utilisez le stockage PlayFab, vous pouvez ajouter au formulaire d’inscription à la fois les champs disponibles dans votre Compte éditeur et vos propres champs.

Les informations sur les champs supplémentaires et leurs valeurs sont enregistrées en tant que données utilisateur dans votre stockage PlayFab. Vous pouvez accéder à ces données utilisateur par le biais de PlayFab API ou dans votre compte PlayFab :

1. Allez à la section Players et cliquez sur l’ID utilisateur.

2. Sélectionnez l'onglet Player Data (Title).

Stockage Firebase

Stockage personnalisé

Si vous utilisez un stockage personnalisé, vous pouvez ajouter au formulaire d’inscription à la fois les champs disponibles dans votre Compte éditeur et vos propres champs.

Les informations sur les champs supplémentaires et leurs valeurs sont envoyées par le serveur Xsolla Login dans la requête d’enregistrement à l’URL qui a été spécifiée dans le champ New user URL dans le Compte éditeur lors de la connexion de votre stockage personnalisé.

Exemple :

Les champs suivants sont ajoutés au formulaire d’inscription utilisateur :

• pays ;
• champ nickname personnalisé de type string ;
• champ platform de type multi-select avec les valeurs possibles suivantes : windows, mac os et linux.

Lors de l’enregistrement utilisateur, le serveur Xsolla Login enverra la requête suivante à l’URL de nouvel utilisateur :

POST https://your.hostname/new_user_url.path HTTP/1.1
Content-Type: application/json
Authorization: Bearer {JWT}

{
  "email": "john@gmail.com",
  "password": "123456",
  "country-name": "DE",
  "nickname": "JohnSnow",
  "platform": ["windows", "mac os"]
}

curl --request POST \
  --url 'https://your.hostname/new_user_url.path' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'