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

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

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

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

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

• многократная генерация кодов.

• Пользователь должен быть авторизован, чтобы воспользоваться кодом.
• Если к коду привязаны товары с региональным ограничением, пользователь из региона, в котором товары недоступны, не сможет увидеть уникальные предложения по данному коду.
  Пример: После ввода кода должен отображаться 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. Подключите магазин и настройте модули Виртуальные товары, Виртуальная валюта или Бандлы.

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

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.

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

• Update unique catalog offer promotion
• Deactivate unique catalog offer promotion

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

• Get list of unique catalog offer promotions
• Get unique catalog offer promotion