Бонусные акции

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

Бонусные акции — маркетинговый инструмент для поощрения покупателей виртуальных товаров с помощью начисления им бонусных товаров.

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

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

Примеры использования:

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

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

При построении каталога товаров с использованием методов API вы можете получить информацию об акциях. В ответе, кроме информации о виртуальном товаре, вы получите следующую информацию об акции с типом Бонус:

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

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

{
  "item_id": 400962,
  "sku": "test_item",
  "type": "virtual_good",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "virtual_prices": [
    {
      "description": null,
      "item_id": 322172,
      "sku": "1234500",
      "name": "virt currency only",
      "type": "virtual_currency",
      "amount": 1,
      "amount_without_discount": 1,
      "calculated_price": {
        "amount": "1.00",
        "amount_without_discount": "1.00"
      },
      "is_default": true
    }
  ],
  "can_be_bought": true,
  "promotions": [
    {
      "name": "New Year Bonus",
      "date_start": "2022-12-30T22:00:00+03:00",
      "date_end": "2023-01-02T21:59:59+03:00",
      "discount": null,
      "bonus": [
        {
          "quantity": 3,
          "name": "mybonusitem",
          "sku": "444777",
          "type": "virtual_good"
        }
      ],
      "limits": {
        "per_user": {
          "available": 7,
          "total": 7
        }
      }
    }
  ],
  "limits": null,
  "attributes": [],
  "is_free": false,
  "groups": [
    {
      "external_id": "01022023",
      "name": "Group1"
    }
  ],
  "virtual_item_type": "consumable",
  "inventory_options": {
    "consumable": {
      "usages_count": 1
    },
    "expiration_period": null
  }
}

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

Настройка бонусной акции

• через Личный кабинет;
• через методы API.

Настройка через Личный кабинет

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

• настраивать акции, действующие для всех типов товаров, таких как:

  • пакеты виртуальной валюты;
  • виртуальные предметы (включая предметы с ограниченным сроком действия);
  • игровые ключи;
  • бандлы.

При настройке через Личный кабинет нельзя редактировать бонусные акции со статусом Active.

Расширенные возможности для настройки бонусных акций доступны через методы API.

Чтобы настроить акцию через Личный кабинет:

1. Перейдите в раздел Store > Акции и награды в Личном кабинете.

2. Нажмите кнопку Создать акцию.

3. Задайте необходимые параметры:
   1. Укажите название акции.
   2. В поле Тип акции выберите Бонус.
   3. Укажите акционные товары.
   4. Укажите товар, который будет предоставляться пользователю при покупке акционного товара.

4. Нажмите Далее.
5. При необходимости вы можете задать количество использований акции. Для этого на странице Условия и ограничения установите переключатель Ограничивать использование акции пользователем в положение Вкл и введите необходимое число.
6. Для настройки персонализированной акции установите переключатель Акция для определенных пользователей в положение Вкл и укажите параметры условия. Чтобы настроить персонализацию, воспользуйтесь инструкцией.
7. Нажмите Далее.
8. Укажите период действия акции.

9. Нажмите Далее.
10. Проверьте настройки и нажмите кнопку Сохранить и выйти.
11. Чтобы активировать акцию:
    1. В каталоге акций найдите только что созданную акцию.
    2. Нажмите значок ••• и в раскрывающемся списке выберите Редактировать или перейдите к редактированию, нажав на нужную акцию в каталоге акций.
    3. В правом верхнем углу в раскрывающемся списке выберите Активировать акцию.

Настройка через методы API

Для работы с бонусными акциями используются методы подразделов Common и Bonuses из группы методов Promotions.

Чтобы создать бонусную акцию, используйте метод Create bonus promotion и укажите необходимые параметры.

Чтобы активировать бонусную акцию, используйте метод Update bonus promotion с параметром “is_enabled”:true или метод Activate promotion.

Чтобы деактивировать акцию, используйте метод Deactivate promotion.

Чтобы отредактировать акцию через метод API, вызовите метод Update bonus promotion с новыми параметрами акции. Редактирование акции также доступно для акций со статусом Active.

При создании или редактировании бонусной акции через методы API вы также можете:

• Настроить действие акции на все товары проекта. Передайте в метод Create bonus promotion или Update bonus promotion параметр “condition”:null.

“condition”: null

• Настроить бессрочную акцию. Передайте в метод Create bonus promotion или Update bonus promotion параметр “date_end”:null.

“date_end”: null