Атрибуты пользователя

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

Атрибуты — это характеристики пользователя, хранящиеся в виде пар ключ-значение. На основании атрибутов можно:

• сегментировать пользователей;
• подготавливать персональные витрины товаров для каждой группы пользователей в Web Shop;
• передавать информацию о пользователе между разными платформами публикации.

Атрибуты делятся на 2 типа:

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

• Серверные. Значения для таких атрибутов задаются и редактируются только на серверной части вашего приложения. Серверные атрибуты рекомендуется использовать для управления характеристиками игрового персонажа или параметрами пользователя, которые важно защитить от лишних изменений. Примеры: шанс выпадения бонуса, ключевые параметры игрового персонажа, категория пользователя.

При необходимости для обеспечения целостности передаваемых данных вы можете задать правила валидации атрибутов в виде JSON-схемы в Личном кабинете. Вы можете управлять атрибутами с помощью методов Login API или вебхуков. Значения атрибутов пользователей можно редактировать в Личном кабинете.

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

Чтобы настроить атрибуты пользователей:

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

4. Задайте правила ввода атрибутов в виде JSON-схемы:

1. • В объекте properties задайте перечень атрибутов пользователей и их свойств. Допустимые типы данных: string, number, integer или boolean. Глубина объекта: 1.
   • В поле additionalProperties укажите, можно ли создавать атрибуты, не перечисленные в объекте properties. Установите значение true, если хотите разрешить дополнительные поля, false — для запрета.
   • В массиве required укажите перечень обязательных атрибутов.
   • В поле type укажите тип object.

{
	"$schema": "https://json-schema.org/draft/2020-12/schema",
	"properties": {
		"game": {
			"description": "Name of the game played by user.",
			"type": "string"
		},
		"age": {
			"description": "User's age.",
			"type": "integer"
		},
		"had_ban": {
                 "description": "Whether the user was banned.",
			"type": "boolean"
		},
		"last_purchase": {
                 "description": "Date of user's last purchase.",
			"type": "string",
		}
	},
	"additionalProperties": false,
	"required": [
		"age",
		"game",
		"last_purchase"
	],
	"type": "object"
}

5. На вашем сайте или в приложении реализуйте необходимую логику работы с атрибутами пользователя с помощью следующих методов Login API:
   • для управления JSON-схемой:
     • Delete Schema
     • Get Schema
     • Update Schema
     • Update user’s attributes from server
     • Update user’s read-only attributes from server
     • Update user’s attribute from client

1. • Для передачи значений атрибутов в хранилище:
     • Update user’s attributes from server
     • Update user’s read-only attributes from server
     • Auth by custom ID
     • Update user’s attribute from client

1. • Для получения данных из хранилища:
     • Get user’s attributes from client
     • Get user’s read-only attributes from client
     • Get users by attribute from server
     • Get user’s attributes from server
     • Get user’s read-only attributes from server

Как редактировать значения атрибутов пользователей

Чтобы редактировать значения атрибутов:

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

4. Найдите в таблице нужного вам пользователя и нажмите Атрибуты в соответствующей строке.

5. Во всплывающем окне выберите атрибут, который вы хотите изменить, нажмите значок карандаша, внесите изменения и нажмите Сохранить.