Collecte d’adresses e-mail et de numéros de téléphone

Comment ça marche

Le produit Login enregistre automatiquement les informations de contact que l’utilisateur fournit à votre projet de connexion lorsqu’il s’enregistre ou se connecte à votre application. Ces informations sont stockées dans la base de données Xsolla et comprennent l’adresse e-mail et le numéro de téléphone de l’utilisateur. Dans certains cas, toutes les informations de contact peuvent ne pas être passées. Par exemple :

• Avec l’option de connexion sans mot de passe, seules les informations spécifiées par l’utilisateur pour recevoir un code de confirmation à usage unique sont passées à votre projet de connexion, c’est-à-dire uniquement l’adresse e-mail ou le numéro de téléphone.
• Lors de l’autorisation via un réseau social, son fournisseur peut ne pas passer d’informations sur l’adresse e-mail de l’utilisateur.

Vous pouvez également demander les informations de contact manquantes à l’aide du produit Login et les utiliser pour :

• exporter les adresses e-mail des utilisateurs vers votre compte Mailchimp et les ajouter à votre liste de newsletter ;
• créer un identifiant unique pour l’utilisateur sur la base de son adresse e-mail ou de son numéro de téléphone.

Qui peut l'utiliser

Les partenaires qui ont déjà intégré Login et configuré la connexion dans l’application via les réseaux sociaux ou l’autorisation sans mot de passe.

Comment configurer

En fonction de l’option d’intégration sélectionnée pour votre projet connexion, vous pouvez configurer la collecte des adresses e-mail et des numéros de téléphone :

• via le widget Login v2.0 ;
• via les appels Login API.

Collecte d'adresses e-mail et de numéros de téléphone via le widget Login v2.0

Avec le widget Login v2.0, vous pouvez demander aux utilisateurs leur adresse e-mail et/ou leur numéro de téléphone si ces informations n’ont pas été fournies :

• lors de l’enregistrement via les réseaux sociaux ;
• lors de la connexion dans l’application à l’aide d’un code à usage unique (c’est-à-dire lors de l’utilisation de l’authentification sans mot de passe).

Après avoir activé la demande d’adresses e-mail et/ou de numéros de téléphone dans le Compte éditeur, votre projet de connexion :

1. Affichera automatiquement des formulaires permettant à l’utilisateur de saisir son adresse e-mail et/ou son numéro de téléphone ;
2. Après avoir rempli les formulaires, l’utilisateur recevra un code ou un lien pour confirmer les informations saisies ;
3. Vérifiera le code de confirmation et stockera les informations reçues dans la base de données.

Vous pouvez rendre le remplissage de ces formulaires obligatoire pour l’utilisateur.

Pour activer la collecte d’adresses e-mail ou de numéros de téléphone utilisateur :

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 Authentication et sélectionnez la section Miscellaneous data form.

4. Si vous souhaitez que votre projet de connexion affiche un formulaire dans lequel l'utilisateur peut spécifier son adresse e-mail :
   1. Réglez la bascule Collect user email address sur On ;
   2. Sélectionnez une méthode de confirmation de l'adresse e-mail : Par code ou Par code et lien.
5. Pour obliger l'utilisateur à fournir son adresse e-mail, réglez la bascule Require user to complete email form sur On.
6. Si vous voulez que votre projet de connexion affiche un formulaire dans lequel l'utilisateur peut spécifier son numéro de téléphone, réglez la bascule Collect user phone number sur On.

7. Pour obliger les utilisateurs à fournir leur numéro de téléphone, réglez la bascule Require user to complete phone number sur On.
8. Si vous avez activé à la fois le formulaire de collecte d'adresse e-mail et le formulaire de collecte de numéro de téléphone, sélectionnez l'ordre dans lequel ils seront affichés à l'utilisateur dans la liste déroulante située au bas de la page.

Collecte d'adresses e-mail par le biais d'appels Login API

Avec Login API, vous pouvez demander aux utilisateurs leur adresse e-mail si elle n’a pas été fournie lors de l’enregistrement via les réseaux sociaux.

Si vous avez intégré votre projet de connexion via des appels Login API :

• Lorsque vous utilisez l’appel Auth via social network avec une norme JWT, ajoutez le paramètre fields=email.

Exemple de requête :

GET https://login.xsolla.com/api/social/{providerName}/login_redirect?projectId={projectId}&fields=email&login_url={login_url} HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/social/providerName/login_redirect?projectId=projectId&fields=email&login_url=login_url'

• Lorsque vous utilisez l'appel Auth via social network avec le protocole OAuth 2.0, ajoutez le paramètre scope=email.

Exemple de requête :

GET https://login.xsolla.com/api/oauth2/social/{providerName}/login_redirect?scope=email&client_id={client_id}&redirect_uri={redirect_uri}&state={state}&response_type=code HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/social/provider_name/login_redirect?scope=email&client_id=client_id&redirect_uri=redirect_uri&state=state&response_type=code'