In-Game Store / Уникальное предложение каталога
  На главную

In-Game Store

Уникальное предложение каталога

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

Уникальное предложение каталога — возможность отображения скрытых товаров в каталоге для пользователей, которые ввели код уникального предложения. Если код не введен, товары не отображаются.

Основные возможности:

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

Ограничения:
  • Пользователь должен быть авторизован, чтобы воспользоваться кодом.
  • Если к коду привязаны товары с региональным ограничением, пользователь из региона, в котором товары недоступны, не сможет увидеть уникальные предложения по данному коду.
    Пример: После ввода кода должен отображаться Legendary Starter Pack. На Legendary Starter Pack действует региональное ограничение – доступен для покупки только в США. Если пользователь не из США вводит код, в ответе на метод Verify promotion code вернется ошибка и пользователь не сможет увидеть и купить Legendary Starter Pack.

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

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

Сценарий интеграции

  1. Настройте акцию с уникальным предложением каталога.
  2. Реализуйте отображение каталога товаров пользователю, используя методы для построения каталога из подраздела Catalog группы методов Virtual Items & Currency.
  3. В каталоге реализуйте отображение поля, в которое пользователь вводит код.
  4. С помощью метода Verify promotion code реализуйте проверку корректности введенного кода.
  5. Реализуйте отображение каталога товаров с учетом введенного кода. Для этого передайте значение кода в query-параметре promo_code в методы построения каталога из подраздела Catalog группы методов Virtual Items & Currency.
  6. Для создания заказа с уникальным товаром используйте метод Create order with specified item. В теле запроса передайте значение кода в параметре promo_code. Если вы хотите использовать корзину, передайте код в параметре promo_code в теле запросов при создании корзины и создании заказа.

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

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

  1. Зарегистрируйтесь в Личном кабинете.
  2. Подключите Магазин и настройте модули Виртуальные товары, Виртуальная валюта или Бандлы.
Примечание
Если уникальное предложение каталога — это виртуальные предметы или бандлы, мы рекомендуем создать отдельную группу для этих уникальных товаров для более удобного расположения в каталоге.

Настройка акции с уникальными предложениями

Для настройки акции используйте методы API.
  1. Создайте акцию с уникальным предложением, используя метод Create unique catalog offer promotion. В массиве items передайте артикулы товаров, которые будут отображаться после активации кода. Вы также можете задать:
    • Период действия акции, для этого передайте:
      • Дату начала действия акции в параметре date_start.
      • Дату окончания действия акции в параметре date_end. Если дата окончания не указана, акция будет бессрочной.
    • Ограничения:
      • количество использований акции для конкретного пользователя в параметре redeem_user_limit;
      • количество использований кода в параметре redeem_code_limit;
      • общее количество использований акции в параметре redeem_total_limit.
  2. Сгенерируйте коды для созданной акции, используя метод Generate unique catalog offer codes, или создайте код, используя метод Create unique catalog offer code. При необходимости вы можете сгенерировать дополнительные коды. Чтобы получить сгенерированные коды используйте метод Get unique catalog offer codes method.
  3. Активируйте акцию, используя метод Activate unique catalog offer promotion.
Внимание
При создании уникального предложения автоматически создается правило отображения каталога. Не следует удалять или изменять это правило во избежании нарушений в работе акции с уникальным предложением каталога.

Для управления акцией используйте методы:

Для получения информации об уникальных предложениях используйте методы:

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

В другой раз

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

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

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