Внутриигровой магазин / Персонализация
 На главную

Внутриигровой магазин

  • Руководство по интеграции

  • Возможности

  • Инструкции

  • Расширения

  • Справочники

  • Вебхуки

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

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

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

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

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

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

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

    1. Зарегистрируйтесь в Личном кабинете.
    2. Создайте новый проект.
    3. Подключите Магазин к вашему проекту.
    4. Создайте каталог товаров.

    Персонализация на стороне Иксоллы

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

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

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

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

    Примечание
    При изменении атрибутов пользователя вы должны своевременно передавать обновленные данные в Авторизацию Иксолла.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    В другой раз

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

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

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