Сбор email-адресов и номеров телефонов

Как это работает

Продукт Login автоматически сохраняет в базе данных Xsolla контактные данные пользователей, переданные вашему варианту авторизации в процессе регистрации или входа в приложение. Под контактными данными подразумеваются email-адрес и номер телефона пользователя. В некоторых случаях могут передаваться не все контактные данные, например:

• При авторизации без пароля вашему варианту авторизации передаются только те контактные данные, которые были указаны пользователем для получения одноразового кода подтверждения, то есть только email-адрес или только номер телефона.
• При авторизации через социальную сеть ее провайдер может не передать информацию об email-адресах пользователей.

Вы можете дополнительно запрашивать недостающие контактные данные с помощью продукта Login и использовать их, чтобы:

• экспортировать email-адреса пользователей в ваш аккаунт Mailchimp и добавлять их в новостные рассылки;
• гарантировать, что email-адрес или номер телефона пользователя будет его уникальным ID в проекте.

Для кого подходит

Для партнеров, у которых уже интегрирован продукт Login, а также настроена возможность входа в приложение через социальные сети или используется вариант авторизации без пароля.

Как настроить

Вы можете настроить сбор контактных данных пользователей, исходя из выбранного варианта интеграции продукта Login:

• через виджет авторизации версии 2.0;
• с помощью методов Login API.

Сбор email-адресов и номеров телефонов через виджет авторизации версии 2.0

С помощью виджета версии 2.0 вы можете запрашивать у пользователей их email-адреса и/или номера телефонов, если они не были предоставлены:

• при регистрации через социальные сети;
• при входе в приложение по одноразовому коду (то есть при авторизации без пароля).

После того как вы активируете запрос email-адресов и/или номеров телефонов в Личном кабинете, ваш вариант авторизации будет автоматически:

1. отображать пользователю формы для ввода email-адреса и/или номера телефона;
2. после заполнения форм отправлять пользователю код или ссылку для подтверждения введенной информации;
3. проверять код подтверждения и сохранять полученную информацию в базе данных.

Заполнение форм можно сделать обязательным для пользователей.

Чтобы активировать сбор email-адресов и номеров телефонов пользователей:

1. Откройте проект в Личном кабинете и перейдите в раздел Login.
2. Нажмите Настроить в панели нужного варианта авторизации.
3. Перейдите к блоку Аутентификация и выберите раздел Форма дополнительного запроса информации.

4. Чтобы ваш вариант авторизации отображал пользователю форму для указания email-адреса:
   1. Установите переключатель Собирать email-адрес пользователя в положение On.
   2. Выберите способ подтверждения email-адреса: С помощью кода или С помощью кода и ссылки.
5. Чтобы обязать пользователя указывать свой email-адрес, установите переключатель Запрашивать заполнение формы сбора email-адреса в положение On.
6. Чтобы ваш вариант авторизации отображал пользователю форму для указания номера телефона, установите переключатель Собирать номер телефона пользователя в положение On.

7. Чтобы обязать пользователя указывать свой номер телефона, установите переключатель Запрашивать заполнение формы сбора номера телефона в положение On.
8. Если вы активировали как форму сбора email-адреса, так и форму сбора номера телефона, выберите порядок их отображения пользователю в раскрывающемся списке внизу страницы.

Сбор email-адресов с помощью Login API

С помощью Login API вы можете запрашивать у пользователей email-адреса, если они не были предоставлены при регистрации через социальные сети.

Если у вас настроена интеграция через методы API:

• При использовании метода Auth via social network по стандарту JWT добавьте параметр 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'

• При использовании метода Auth via social network по протоколу OAuth 2.0 добавьте параметр 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'