收集邮箱地址和手机号码

运行机制

登录管理器产品自动保存用户在注册或登录您的应用程序时向您的登录管理器项目提供的联系信息。该信息存储在艾克索拉数据库中，包含用户的邮箱地址和手机号码。在部分情况下，并不传入所有的联系信息，例如下列情形：

• 使用免密登录选项时，只有用户选择用于接收一次性验证码的联系信息（即邮箱地址或手机号码）会传入您的登录管理器项目。
• 通过社交网络授权时，社交网络提供商可能不会传入用户邮箱地址的信息。

您可以使用登录管理器产品另外请求缺少的联系信息并通过它们：

• 将用户邮箱导出到您的Mailchimp帐户，然后将它们加入电子简讯接收列表；
• 根据用户的邮箱地址或手机号为用户创建唯一标识符。

适用对象

集成了登录管理器并配置了通过社交网络或使用免密授权登录应用程序的合作伙伴。

如何获取

根据登录管理器项目所选的集成方案，您可以配置通过以下方式收集邮箱地址和手机号：

• 通过登录管理器小组件v2.0
• 通过Login API调用

通过登录管理器小组件v2.0收集邮箱地址和手机号

通过登录管理器小组件v2.0，如遇下列情形用户未提供邮箱地址和/或手机号时，可提示用户提供这些信息：

• 通过社交网络注册时；
• 通过一次性验证码进入应用程序时（如使用免密认证）。

在发布商帐户中启用请求获得邮箱地址和/或手机号后，登录管理器项目将自动执行如下操作：

1. 向用户显示输入邮箱地址和/或手机号的表单；
2. 填写表单后，向用户发送一个验证码或链接以确认输入的信息；
3. 检查验证码是否正确并将收到的信息存储在数据库中。

您可以设置强制要求用户完成表单。

要启用收集用户的邮箱地址和手机号：

1. 在发布商帐户中打开您的项目，然后前往登录管理器部分。
2. 在登录管理器项目面板中单击配置。
3. 前往身份认证区块，然后选择补充数据表单部分。

4. 如要您的登录管理器项目显示一个用户可以填写邮箱地址的表单：
   1. 将收集用户邮箱地址开关设置为开。
   2. 选择一种邮箱地址验证方式：通过验证码或通过验证码和链接。
5. 如要求用户必须提供邮箱地址，请将要求用户完成邮箱表单开关设置为开。
6. 如要您的登录管理器项目显示一个用户可以填写手机号码的表单，请将收集用户手机号码开关设置为开。

7. 如要求用户必须提供手机号，请将要求用户完成手机号码开关设置为开。
8. 如同时启用了邮箱地址和手机号收集表单，请在页面底部的下拉菜单中选择两者向用户显示的顺序。

通过Login API调用

通过Login API，如果用户在通过社交网络注册时未提供邮箱地址，可提示用户提供该信息。

如果已通过Login API调用集成艾克索拉登录管理器，则：

• 使用基于JWT标准的Auth via social network调用时，请添加fields=email参数。

请求示例：

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'

• 如果使用基于OAuth 2.0协议的Auth via social network调用，请添加scope=email参数。

请求示例：

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'