Управление сбором информации о пользователях

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

Во время регистрации пользователя запрашиваются следующие основные данные:

При использовании методов API:
- имя пользователя;
- email-адрес;
- пароль.
При использовании виджета авторизации:
- email-адрес;
- пароль.

Вы можете запросить у пользователя дополнительные персональные данные. Для этого в Личном кабинете укажите, какие дополнительные поля нужно включить в форму регистрации. Регистрация пользователя возможна только после того, как он заполнит все поля, обозначенные вами как обязательные. Предоставленные пользователем данные хранятся в его профиле в базе данных.

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

Вы можете запросить у пользователей дополнительные персональные данные. Для этого в вашем аккаунте укажите, какие дополнительные поля должны быть включены в форму регистрации. Регистрация пользователя возможна только после заполнения всех полей, которые вы отметили как обязательные. Данные, предоставленные пользователями, хранятся в их профилях в базе данных.

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

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

Настройте ваш вариант авторизации в Личном кабинете.
Направьте запрос персональному менеджеру проекта на добавление в форму регистрации ваших собственных полей (необязательно).
Интегрируйте решение на стороне вашего приложения.

Настройте ваш вариант авторизации в аккаунте для мобильных игр.
Направьте запрос персональному менеджеру проекта на добавление в форму регистрации ваших собственных полей (необязательно).
Интегрируйте решение на стороне вашего приложения.

Настройте ваш вариант авторизации в аккаунте.
Отправьте запрос вашему персональному менеджеру проекта на добавление ваших собственных полей в форму регистрации (необязательно).
Интегрируйте решение на стороне вашего приложения.

Настройка в Личном кабинете

Откройте проект в Личном кабинете и перейдите в раздел Игроки > Авторизация.
Нажмите Настроить в панели нужного варианта авторизации.
Перейдите к блоку База пользователей и выберите раздел Дополнительная информация о пользователе.

Выберите, какую информацию о пользователях вы хотите собирать. Следующие поля и флажки могут быть отображены в форме регистрации пользователя:
- Имя пользователя.
- Имя.
- Фамилия.
- Дата рождения.
- Страна.
- Пол.
- Новостная рассылка — флажок, с помощью которого пользователь может дать согласие на получение новостной рассылки. При установке пользователем флажка контакт пользователя автоматически экспортируется в Mailchimp, если Mailchimp подключен для вашего проекта.
- Дополнительное соглашение — флажок, с помощью которого пользователь может подписать ваше дополнительное соглашение. Вы можете получить список пользователей, подписавших дополнительное соглашение, через Личный кабинет или через метод API. Список будет доступен в файле additional_agreement.csv.

Настройка в вашем аккаунте

Откройте проект в аккаунте для мобильных игр и перейдите в раздел Другие инструменты > Авторизация.
Нажмите Настроить в панели нужного варианта авторизации.
Перейдите к блоку База пользователей и выберите раздел Дополнительная информация о пользователе.

Выберите, какую информацию о пользователях вы хотите собирать. Следующие поля и флажки могут быть отображены в форме регистрации пользователя:
- Имя пользователя.
- Имя.
- Фамилия.
- Дата рождения.
- Страна.
- Пол.
- Новостная рассылка — флажок, с помощью которого пользователь может дать согласие на получение новостной рассылки. При установке пользователем флажка контакт пользователя автоматически экспортируется в Mailchimp, если Mailchimp подключен для вашего проекта.
- Дополнительное соглашение — флажок, с помощью которого пользователь может подписать ваше дополнительное соглашение. Вы можете получить список пользователей, подписавших дополнительное соглашение, через аккаунт для мобильных игр или через метод API. Список будет доступен в файле additional_agreement.csv.

Откройте проект в аккаунте для мобильных игр и перейдите в раздел Другие инструменты > Авторизация.
Нажмите Настроить в панели нужного варианта авторизации.
Перейдите к блоку База пользователей и выберите раздел Дополнительная информация о пользователе.

Откройте проект в аккаунте для мобильных игр и перейдите в раздел Другие инструменты > Авторизация.
Нажмите Настроить в панели нужного варианта авторизации.
Перейдите к блоку База пользователей и выберите раздел Дополнительная информация о пользователе.

Откройте проект в аккаунте для мобильных игр и перейдите в раздел Другие инструменты > Авторизация.
Нажмите Настроить в панели нужного варианта авторизации.
Перейдите к блоку База пользователей и выберите раздел Дополнительная информация о пользователе.

Следующие поля и флажки могут быть отображены в форме регистрации пользователя:
- Имя пользователя.
- Имя.
- Фамилия.
- Дата рождения.
- Страна.
- Пол.
- Новостная рассылка — флажок, позволяющий пользователю подписаться на рассылку. Когда пользователь отмечает этот флажок, его контакты автоматически экспортируются в Mailchimp, если Mailchimp подключен к вашему проекту.
- Дополнительное соглашение — флажок, позволяющий пользователю подписать ваше дополнительное соглашение. Вы можете получить список пользователей, подписавших дополнительное соглашение, через аккаунт или через метод API. Список будет доступен в файле additional_agreement.csv.

Чтобы сделать ввод информации обязательным, нажмите значок ★ в строке с описанием соответствующего поля. Значок станет синим.

Чтобы кастомизировать тексты флажков Новостная рассылка и Дополнительное соглашение, воспользуйтесь инструкцией.

Нажмите Сохранить изменения.

Запрос на добавление собственных полей в форму регистрации

Помимо полей, доступных в Личном кабинете, вы можете добавить в форму регистрации собственные поля. Для этого обратитесь к персональному менеджеру проекта или напишите на [email protected] и передайте список полей с указанием следующей информации для каждого поля:

название на английском языке;
тип:
- string;
- date;
- select — выбор одного варианта из списка;
- multi-select — выбор нескольких вариантов из списка;
является ли обязательным.

Помимо полей, доступных в аккаунте для мобильных игр, вы можете добавить в форму регистрации собственные поля. Для этого обратитесь к персональному менеджеру проекта или напишите на [email protected] и передайте список полей с указанием следующей информации для каждого поля:

название на английском языке;
тип:
- string;
- date;
- select — выбор одного варианта из списка;
- multi-select — выбор нескольких вариантов из списка;
является ли обязательным.

Помимо полей, доступных в аккаунте, вы можете добавить свои собственные поля в форму регистрации. Для этого обратитесь к вашему персональному менеджеру проекта или напишите на [email protected] и предоставьте список полей с следующей информацией для каждого поля:

название поля на английском языке;
тип:
- string;
- date;
- select — выбор одного варианта из списка;
- multi-select — выбор нескольких вариантов из списка;
является ли поле обязательным.

Для полей с типами select и multi-select также передайте персональному менеджеру проекта наборы возможных значений этих полей.

Хранилище Xsolla не поддерживает использование собственных полей в форме регистрации.

Интеграция на стороне приложения

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

При интеграции через Xsolla SDK сбор дополнительной информации о пользователях пока недоступен.

При интеграции через Login API в запросе Register new user передайте собранные дополнительные данные пользователя с помощью параметра fields. Данный параметр представляет собой набор пар свойство-значение. Полям формы регистрации, которые можно подключить в Личном кабинете, соответствуют следующие свойства параметра fields:

При интеграции через Login API в запросе Register new user передайте собранные дополнительные данные пользователя с помощью параметра fields. Данный параметр представляет собой набор пар свойство-значение. Полям формы регистрации, которые можно подключить в аккаунте для мобильных игр, соответствуют следующие свойства параметра fields:

При интеграции через Login API передайте собранные дополнительные данные пользователя в запросе Register new user с помощью параметра fields. Этот параметр представляет собой набор пар свойство-значение. Полям формы регистрации, которые можно подключить в аккаунте, соответствуют следующие свойства параметра fields:

Название поля	Тип	Свойство параметра `fields`
Имя пользователя	string	username
Имя	string	given-name
Фамилия	string	family-name
Дата рождения	date (YYYY-MM-DD)	bday
Страна	select (ISO 3166-1 alpha-2)	country-name
Пол	enum (со значениями `f` и `m`)	gender

В запросе метода Register new user должны быть переданы значения всех обязательных полей.

Пример запроса:

Copy

Full screen

Small screen

http

 1POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
 2Content-Type: application/json
 3
 4{
 5  "username": "[email protected]",
 6  "password": "123456",
 7  "email": "[email protected]",
 8  "fields": {
 9     "nickname": "John",
10     "country-name": "US",
11     "bday": "1997-07-16"
12  }
13}

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

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

Хранилище Xsolla
Хранилище PlayFab
Хранилище Firebase
Собственное хранилище

Хранилище Xsolla

Если вы используете хранилище Xsolla, в форму регистрации можно добавить только поля, доступные в Личном кабинете. Собранная дополнительная информация о пользователях хранится на стороне Xsolla.

Если вы используете хранилище Xsolla, в форму регистрации можно добавить только поля, доступные в аккаунте для мобильных игр. Собранная дополнительная информация о пользователях хранится на стороне Xsolla.

Если вы используете хранилище Xsolla, вы можете добавить в форму регистрации только поля, доступные в вашем аккаунте. Собранная дополнительная информация о пользователях хранится на стороне Xsolla.

Хранилище PlayFab

Если вы используете хранилище PlayFab, вы можете добавить в форму регистрации как поля, доступные в Личном кабинете, так и собственные поля.

Если вы используете хранилище PlayFab, вы можете добавить в форму регистрации как поля, доступные в аккаунте для мобильных игр, так и собственные поля.

Если вы используете хранилище PlayFab, вы можете добавить как поля, доступные в вашем аккаунте, так и свои собственные поля в форму регистрации.

Информация о дополнительных полях и их значения сохраняются как пользовательские данные в вашем хранилище PlayFab. Вы можете получить пользовательские данные через PlayFab API или в вашем кабинете PlayFab:

Перейдите в раздел Players и нажмите ID пользователя.

Выберите вкладку Player Data (Title).

Хранилище Firebase

Если вы используете хранилище Firebase, вы можете добавить в форму регистрации как поля, доступные в Личном кабинете, так и собственные поля. Собранная дополнительная информация о пользователях хранится на стороне Xsolla.

Если вы используете хранилище Firebase, вы можете добавить в форму регистрации как поля, доступные в аккаунте для мобильных игр, так и собственные поля. Собранная дополнительная информация о пользователях хранится на стороне Xsolla.

Если вы используете хранилище Firebase, вы можете добавить как поля, доступные в вашем аккаунте, так и свои собственные поля в форму регистрации. Собранная дополнительная информация о пользователях хранится на стороне Xsolla.

Собственное хранилище

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

Информация о дополнительных полях и их значения отправляются сервером Xsolla Login в запросе на регистрацию на URL-адрес, который был указан в Личном кабинете при подключении собственного хранилища в поле URL для создания пользователя.

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

Информация о дополнительных полях и их значения отправляются сервером Xsolla Login в запросе на регистрацию на URL-адрес, который был указан в аккаунте для мобильных игр при подключении собственного хранилища в поле URL для создания пользователя.

Если вы используете собственное хранилище, вы можете добавить как поля, доступные в вашем аккаунте, так и свои собственные поля в форму регистрации.

Информация о дополнительных полях и их значениях отправляется сервером Xsolla Login в запросе на регистрацию на URL, который был указан в поле New user URL в аккаунте при подключении вашего собственного хранилища.

Пример:

В форму регистрации пользователей добавлены следующие поля:

страна;
собственное поле nickname типа string;
собственное поле platform типа multi-select с возможными значениями: windows, mac os и linux.

При регистрации пользователя сервер Xsolla Login отправит на URL для создания пользователя запрос следующего вида: