Персонализация

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

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

Это дает возможность:

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

Доступны следующие типы персонализации:

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

Настройка персонализации доступна при любом типе аутентификации в Веб-магазине — через ID пользователя или Xsolla Login.

Персонализация на стороне Xsolla

Сценарий пользователя

1. Неавторизованный пользователь переходит к каталогу товаров. В зависимости от состояния переключателя Показывать товары неавторизованным пользователям пользователь видит:
   • товары, на которые не настроены правила персонализации;
   • все товары, в том числе те, на которые настроены правила персонализации.
2. Пользователь нажимает Войти и авторизуется через ID пользователя или Xsolla Login.

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

5. Пользователь видит персонализированный каталог и нажимает Купить сейчас.

6. В момент покупки Xsolla еще раз запрашивает атрибуты пользователя и сопоставляет их с правилами персонализации:
   • Если товар перестал быть доступен пользователю, пользователь получает сообщение, что товар невозможно купить.
   • Если товар доступен для покупки, пользователь переходит к оплате товара.

Настройка персонализированного каталога товаров

1. Настройте атрибуты пользователя.
2. Подключите персонализацию.
3. Задайте правила отображения каталога. Вы можете сделать это при подключении персонализации или в проекте в Личном кабинете в разделе Store > Управление каталогом > Правила отображения каталога section.

Чтобы подключить персонализацию:

1. В проекте в Личном кабинете перейдите в раздел Store > Персонализация.
2. Если персонализация еще не настроена, нажмите Настроить персонализацию.
3. Выберете тип персонализации Персонализация на стороне Xsolla.
4. Нажмите Далее.

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

6. Укажите название правила и задайте условия отображения товара в каталоге.

7. Чтобы товары, на которые настроены правила, отображались неавторизованным пользователям, установите переключатель Показывать товары пользователям, которые не авторизовались в положение Вкл.

8. Нажмите Далее.
9. Выберите товары, к которым будет применяться правило.

10. Нажмите Далее.
11. Проверьте настройки. При необходимости нажмите Редактировать в нужном разделе и внесите изменения.

12. Нажмите Сохранить и выйти.

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

Настройка атрибутов

Настройте атрибуты пользователя в продукте Login и поддерживайте значения атрибутов в актуальном состоянии: обновляйте их в Xsolla, когда они меняются у пользователя в игре.

Последовательность обновления атрибутов зависит от варианта авторизации пользователей, используемой в Web Shop.

Настройка персонализированных акций

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

Вы можете задать как одно, так и несколько условий. Необходимо учитывать, что, пока акция будет активна, вы не сможете ее изменять. Подробнее про виды и настройку акций вы можете прочитать в разделе документации Настройка акционных кампаний.

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

1. Настройте атрибуты пользователя в продукте Login.
2. Настройте акционную кампанию с бонусами или скидочную кампанию. Установите переключатель Акция для определенных пользователей в положение Вкл и укажите необходимые условия.

Персонализация на стороне партнера

Этот тип подойдет вам, если вы используете расширенную логику персонализации, реализованную на вашей стороне, и не хотите задавать правила и указывать атрибуты на стороне Xsolla.

Чтобы использовать персонализацию каталога товаров для пользователей, реализованную на вашей стороне:

1. Создайте каталог товаров на стороне Xsolla и синхронизируйте его с каталогом на вашей стороне. У каждого товара в вашей системе должен быть соответствующий item_id или sku в Xsolla.
2. Подключите персонализацию в Личном кабинете.
3. Настройте обработку вебхука Персонализация каталога на стороне партнера.

Сценарий пользователя

1. Неавторизованный пользователь переходит к каталогу товаров. В зависимости от настройки переключателя Показывать товары неавторизованным пользователям пользователь видит:
   • все товары в каталоге;
   • товары, которые вы возвращаете в ответе на вебхук Персонализация каталога на стороне партнера.

Порядок отображения товаров пользователю зависит от настройки переключателя Получать порядок артикулов в ответе вебхука.

2. Пользователь нажимает Войти и авторизуется.

3. Xsolla отправляет вебхук с запросом товаров по ID пользователя.
4. В ответе от партнера возвращается список артикулов товаров, доступных этому пользователю.
5. Пользователь видит персонализированный каталог товаров и нажимает Купить сейчас.

6. На стороне Xsolla выполняются шаги 3 и 4 этого сценария, чтобы проверить доступность товаров в момент покупки:
   • Если товар доступен для покупки, пользователь переходит к оплате товара.
   • Если товар отсутствует, пользователь получает сообщение, что товар невозможно купить.

Настройка персонализированного каталога товаров

Чтобы подключить персонализацию:

1. В проекте в Личном кабинете перейдите в раздел Store > Персонализация.
2. Если персонализация еще не настроена, нажмите Настроить персонализацию.
3. Выберете тип персонализации Персонализация на стороне партнера.

4. Нажмите Далее.
5. Установите правила отображения товаров. Для этого установите в активное положение соответствующие переключатели:
   • Показывать товары неавторизованным пользователям — чтобы неавторизованным пользователям отображались только товары, которые вы возвращаете в ответе на вебхук Персонализация каталога на стороне партнера. Если переключатель неактивен, неавторизованным пользователям отображаются все товары в каталоге.
   • Получать порядок артикулов в ответе вебхука — чтобы товары отображались пользователю в соответствии с порядком, который вы передаете в ответе на вебхук Персонализация каталога на стороне партнера. Если переключатель неактивен, товары отображаются пользователю в порядке, заданном на стороне Xsolla. Чтобы задать порядок отображения товаров на стороне Xsolla или получить информацию о порядке, используйте параметр order в методах подраздела Admin из группы методов Виртуальные предметы и валюта.

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

Настройка обработки вебхука

Xsolla при взаимодействии пользователя с каталогом товаров отправляет вебхук Персонализация каталога на стороне партнера, который содержит параметры пользователя и проекта, на URL-адрес вебхука. Настройте обработку вебхука:

1. В проекте в Личном кабинете перейдите в раздел Настройки проекта > Вебхуки и укажите URL-адрес для отправки вебхуков. Этот шаг является необязательным, если у вас уже настроены вебхуки.
2. В ответе на вебхук вам необходимо вернуть список артикулов товаров, которые доступны пользователю. При этом вы также можете передать информацию о том, что конкретный пользователь может купить определенный товар заданное количество раз, или указать период доступности товара. Эта возможность позволяет регулировать количество и вид товаров, которые доступны пользователю.

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

Если кеш еще не заполнен данными, вебхук partner_side_catalog отправляется при каждом запросе к Xsolla. Например: Xsolla получает несколько запросов каталога одновременно, а сервер игры отвечает с задержкой.

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

Изменение типа персонализации

Настройка в Web Shop

Чтобы товары, на которые настроена персонализация, отображались в Web Shop:

1. В вашем проекте в Личном кабинете перейдите в раздел Site Builder.
2. В панели вашего Web Shop нажмите Открыть Site Builder.
3. В блоке Магазин перейдите в Раздел магазина.
4. В полях Тип товара и Группа товара выберите товары, на которые настроена персонализация.
5. Чтобы изменения вступили в силу, опубликуйте ваш сайт.

Последнее обновление: 21 марта 2025