Сбор email-адресов и номеров телефонов
Как это работает
Продукт Login автоматически сохраняет в базе данных Xsolla контактные данные пользователей, переданные вашему варианту авторизации в процессе регистрации или входа в приложение. Под контактными данными подразумеваются email-адрес и номер телефона пользователя. В некоторых случаях могут передаваться не все контактные данные, например:
- При авторизации без пароля вашему варианту авторизации передаются только те контактные данные, которые были указаны пользователем для получения одноразового кода подтверждения, то есть только email-адрес или только номер телефона.
- При авторизации через социальную сеть ее провайдер может не передать информацию об email-адресах пользователей.
Вы можете дополнительно запрашивать недостающие контактные данные с помощью продукта Login и использовать их, чтобы:
- экспортировать email-адреса пользователей в ваш аккаунт Mailchimp и добавлять их в новостные рассылки;
- гарантировать, что email-адрес или номер телефона пользователя будет его уникальным ID в проекте.
%%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }}}%%
sequenceDiagram
participant U as Пользователь
participant YC as Ваш клиент
participant XL as Сервер Xsolla Login
participant SN as Сервер социальной сети
U->>YC: Нажимает на иконку социальной сети
YC->>XL: Отправляет запрос на аутентификацию через социальную сеть
activate XL
XL-->>U: Перенаправляет пользователя на страницу входа социальной сети
deactivate XL
activate U
U->>SN: Вводит учетные данные социальной сети
deactivate U
activate SN
note right of SN: Авторизует пользователя
deactivate SN
SN->>XL: Передает параметры пользователя
activate XL
note right of XL: Обрабатывает полученные данные
deactivate XL
opt Email-адреса пользователя нет в базе данных
XL-->>U: Отображает форму для ввода email-адреса
activate U
U->>XL: Вводит email-адрес
deactivate U
XL-->>U: Отправляет письмо с подтверждением
activate U
U->>XL: Подтверждает email-адрес
deactivate U
activate XL
note right of XL: Сохраняет email-адрес пользователя в базу данных
deactivate XL
end
Для кого подходит
Для партнеров, у которых уже интегрирован продукт Login, а также настроена возможность входа в приложение через социальные сети или используется вариант авторизации без пароля.
Как настроить
Вы можете настроить сбор контактных данных пользователей, исходя из выбранного варианта интеграции продукта Login:
Сбор email-адресов и номеров телефонов через виджет авторизации версии 2.0
С помощью виджета версии 2.0 вы можете запрашивать у пользователей их email-адреса и/или номера телефонов, если они не были предоставлены:
- при регистрации через социальные сети;
- при входе в приложение по одноразовому коду (то есть при авторизации без пароля).
После того как вы активируете запрос email-адресов и/или номеров телефонов в Личном кабинете, ваш вариант авторизации будет автоматически:
- отображать пользователю формы для ввода email-адреса и/или номера телефона;
- после заполнения форм отправлять пользователю код или ссылку для подтверждения введенной информации;
- проверять код подтверждения и сохранять полученную информацию в базе данных.
Заполнение форм можно сделать обязательным для пользователей.
Чтобы активировать сбор email-адресов и номеров телефонов пользователей:
- Откройте проект в Личном кабинете и перейдите в раздел Игроки > Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Аутентификация и выберите раздел Форма дополнительного запроса информации.
После того как вы активируете запрос email-адресов и/или номеров телефонов в аккаунте для мобильных игр, ваш вариант авторизации будет автоматически:
- отображать пользователю формы для ввода email-адреса и/или номера телефона;
- после заполнения форм отправлять пользователю код или ссылку для подтверждения введенной информации;
- проверять код подтверждения и сохранять полученную информацию в базе данных.
Заполнение форм можно сделать обязательным для пользователей.
Чтобы активировать сбор email-адресов и номеров телефонов пользователей:
- Откройте проект в аккаунте для мобильных игр и перейдите в раздел Другие инструменты > Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Аутентификация и выберите раздел Форма дополнительного запроса информации.
После того как вы активируете запрос email-адресов и/или номеров телефонов в аккаунте, ваш вариант авторизации будет автоматически:
- отображать формы для ввода email-адреса и/или номера телефона пользователю;
- после заполнения форм отправлять пользователю код или ссылку для подтверждения введенной информации;
- проверять код подтверждения и сохранять полученную информацию в базе данных.
Заполнение форм можно сделать обязательным для пользователей.
Чтобы активировать сбор email-адресов и номеров телефонов пользователей:
- В вашем проекте в аккаунте перейдите в раздел Игроки > Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Аутентификация и выберите раздел Miscellaneous data form.
После того как вы активируете запрос email-адресов и/или номеров телефонов в аккаунте, ваш вариант авторизации будет автоматически:
- отображать формы для ввода email-адреса и/или номера телефона пользователю;
- после заполнения форм отправлять пользователю код или ссылку для подтверждения введенной информации;
- проверять код подтверждения и сохранять полученную информацию в базе данных.
Заполнение форм можно сделать обязательным для пользователей.
Чтобы активировать сбор email-адресов и номеров телефонов пользователей:
- В вашем проекте в аккаунте перейдите в раздел Игроки > Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Аутентификация и выберите раздел Miscellaneous data form.
После того как вы активируете запрос email-адресов и/или номеров телефонов в аккаунте, ваш вариант авторизации будет автоматически:
- отображать формы для ввода email-адреса и/или номера телефона пользователю;
- после заполнения форм отправлять пользователю код или ссылку для подтверждения введенной информации;
- проверять код подтверждения и сохранять полученную информацию в базе данных.
Заполнение форм можно сделать обязательным для пользователей.
Чтобы активировать сбор email-адресов и номеров телефонов пользователей:
- В вашем проекте в аккаунте перейдите в раздел Игроки > Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Аутентификация и выберите раздел Miscellaneous data form.
- Чтобы ваш вариант авторизации отображал пользователю форму для указания email-адреса:
- Установите переключатель Собирать email-адрес пользователя в положение On.
- Выберите способ подтверждения email-адреса: С помощью кода или С помощью кода и ссылки.
- Чтобы обязать пользователя указывать свой email-адрес, установите переключатель Запрашивать заполнение формы сбора email-адреса в положение On.
- Чтобы ваш вариант авторизации отображал пользователю форму для указания номера телефона, установите переключатель Собирать номер телефона пользователя в положение On.
- Чтобы обязать пользователя указывать свой номер телефона, установите переключатель Запрашивать заполнение формы сбора номера телефона в положение On.
- Если вы активировали как форму сбора email-адреса, так и форму сбора номера телефона, выберите порядок их отображения пользователю в раскрывающемся списке внизу страницы.
Сбор email-адресов с помощью Login API
С помощью Login API вы можете запрашивать у пользователей email-адреса, если они не были предоставлены при регистрации через социальные сети.
Если у вас настроена интеграция через методы API:
- При использовании метода
Auth via social network по стандарту JWT добавьте параметрfields=email.
Пример запроса:
http
- http
- curl
1GET https://login.xsolla.com/api/social/{providerName}/login_redirect?projectId={projectId}&fields=email&login_url={login_url} HTTP/1.1
1curl --request GET \
2 --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.
Пример запроса:
http
- http
- curl
1GET 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
1curl --request GET \
2 --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'
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.