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

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

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

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

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

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

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

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

  • Для партнеров, у которых подключен продукт Buy Button и настроена продажа игровых ключей.
  • Для партнеров, которые хотят использовать персонализацию каталога игр, реализованную на стороне Xsolla, или свою собственную персонализацию.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы создать правило отображения каталога:
  1. Откройте проект в Личном кабинете.
  2. Нажмите Магазин в боковом меню.
  3. В панели Управление каталогом нажмите Настроить.
  1. В панели Правила отображения каталога нажмите Настроить.
  1. Нажмите Создать правило.
  1. Укажите название правила и задайте условия отображения товара в каталоге.
  1. Выберите товары, к которым будет применяться правило.
  1. Проверьте настройки. При необходимости нажмите кнопку Редактировать в нужном разделе и внесите изменения.
  1. Нажмите Сохранить и выйти.

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

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

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

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

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

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

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

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

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

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

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

  1. Неавторизованный пользователь переходит к каталогу игр и видит все товары.
  2. Пользователь нажимает Войти и авторизуется через Xsolla Login.
  1. Xsolla отправляет вебхук с запросом игр по ID пользователя.
  2. В ответе от партнера возвращается список артикулов игр, доступных этому пользователю.
  3. Пользователь видит персонализированный каталог игр и нажимает Купить сейчас.
  1. На стороне 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 получает несколько запросов каталога одновременно, а сервер игры отвечает с задержкой.

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

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

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 16 июля 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!