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

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

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

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

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

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

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

Для кого подходит

• Для партнеров, у которых подключен продукт In-Game Store и настроен хотя бы один из типов товаров:
  • виртуальная валюта;
  • виртуальные товары;
  • бандлы.
• Для партнеров, которые хотят использовать персонализацию каталога товаров для пользователей, реализованную на стороне Xsolla, или свою собственную персонализацию.

Предварительные действия

Перед тем, как настраивать персонализацию каталога товаров, интегрируйте продукт In-Game Store.

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

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

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

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

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

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

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

1. Настройте атрибуты пользователя в продукте Login.
2. Задайте правила отображения каталога.

Правила отображения каталога

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

Правило может содержать неограниченное количество товаров следующих типов:

• предмет;
• бандл;
• пакет валют;
• игровые ключи.

В одном правиле можно создавать несколько условий с одним атрибутом пользователя.

Создание правила отображения каталога

Чтобы создать правило отображения каталога:

1. Откройте проект в Личном кабинете.
2. Нажмите Магазин в боковом меню.
3. В панели Управление каталогом нажмите Настроить.

4. В панели Правила отображения каталога нажмите Настроить.

5. Нажмите Создать правило.

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

7. Выберите товары, к которым будет применяться правило.

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

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

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

Вы можете управлять правилами отображения каталога через Личный кабинет или с помощью методов API, выбирая определенный набор и количество товаров, а также условия, которые будут распространяться на эти товары.

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

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

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

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

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

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

Вы можете настроить персонализацию каталога на своей стороне по дополнительному запросу к персональному менеджеру проекта или через email-адрес csm@xsolla.com. Эта возможность подойдет вам, если вы используете расширенную логику персонализации, реализованную на вашей стороне, и не хотите задавать правила и указывать атрибуты на стороне Xsolla.

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

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

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

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

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

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

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

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

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

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

Последнее обновление: 3 октября 2024