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

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

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

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

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

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

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

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

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

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

4. Выберите, какую информацию о пользователях вы хотите собирать. Доступны следующие поля:
   • Имя пользователя;
   • Имя;
   • Фамилия;
   • Дата рождения;
   • Страна;
   • Пол.
5. Чтобы сделать ввод информации обязательным, нажмите значок ★ в строке с описанием соответствующего поля. Значок станет синим.

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

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

Помимо полей, доступных в Личном кабинете, вы можете добавить в форму регистрации собственные поля. Для этого обратитесь к аккаунт-менеджеру проекта (или напишите на адрес am@xsolla.com) и передайте список полей с указанием следующей информации для каждого поля:

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

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

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

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

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

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

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

POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
Content-Type: application/json

{
  "username": "john-email@email.com",
  "password": "123456",
  "email": "john-email@email.com",
  "fields": {
     "nickname": "John",
     "country-name": "US",
     "bday": "1997-07-16"
  }
}

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

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

• Хранилище Иксоллы
• Хранилище PlayFab
• Хранилище Firebase
• Собственное хранилище

Хранилище Иксоллы

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

Хранилище PlayFab

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

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

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

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

Хранилище Firebase

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

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

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

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

Пример:

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

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

При регистрации пользователя сервер Авторизации Иксоллы отправит на URL для создания пользователя запрос следующего вида:

POST https://your.hostname/new_user_url.path HTTP/1.1
Content-Type: application/json
Authorization: Bearer {JWT}

{
  "email": "john@gmail.com",
  "password": "123456",
  "country-name": "DE",
  "nickname": "JohnSnow",
  "platform": ["windows", "mac os"]
}

curl --request POST \
  --url 'https://your.hostname/new_user_url.path' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!