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

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

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

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

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

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

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

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

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

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

1. Настройте акцию с уникальным предложением каталога.
2. Реализуйте отображение каталога товаров пользователю, используя методы для построения каталога из подраздела Catalog из группы методов Виртуальные предметы и валюта.
3. В каталоге реализуйте отображение поля, в которое пользователь вводит код.
4. С помощью метода Подтвердите промокод реализуйте проверку корректности введенного кода.
5. Реализуйте отображение каталога товаров с учетом введенного кода. Для этого передайте значение кода в query-параметре promo_code в методы построения каталога из подраздела Catalog группы методов Виртуальные предметы и валюта.
6. Для создания заказа с уникальным товаром используйте метод Создание заказа с указанным товаром. В теле запроса передайте значение кода в параметре promo_code. Если вы хотите использовать корзину, передайте код в параметре promo_code в теле запросов при создании корзины и создании заказа.

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

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

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

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

1. Создайте акцию с уникальным предложением, используя метод Создайте уникальное акционное предложение по каталогу. В массиве items передайте артикулы товаров, которые будут отображаться после активации кода. Вы также можете задать:
   • Период действия акции, для этого передайте:
     • Дату начала действия акции в параметре date_start.
     • Дату окончания действия акции в параметре date_end. Если дата окончания не указана, акция будет бессрочной.
   • Ограничения:
     • количество использований акции для конкретного пользователя в параметре redeem_user_limit;
     • количество использований кода в параметре redeem_code_limit;
     • общее количество использований акции в параметре redeem_total_limit.
2. Сгенерируйте коды для созданной акции, используя метод Сгенерируйте уникальные коды предложений по каталогу, или создайте код, используя метод Создайте уникальный код предложения по каталогу. При необходимости вы можете сгенерировать дополнительные коды. Чтобы получить сгенерированные коды используйте метод Получите уникальные коды предложений по каталогу.
3. Активируйте акцию, используя метод Активируйте уникальное акционное предложение по каталогу.

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

• Обновите уникальное акционное предложение каталога
• Отключите уникальное акционное предложение по каталогу

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

• Получите список уникальных акционных предложений каталога
• Получите уникальное акционное предложение по каталогу