In-Game Store / Бонусные акции
  На главную

In-Game Store

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

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

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

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

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

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

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

На бонусные акции нельзя настроить региональные ограничения.

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

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

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

Copy
Full screen
Small screen

{
  "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
  }
}
Примечание

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

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

Примеры

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

Пример ограничения на покупку бонусного товара:

В Личном кабинете для товара Booster задано ограничение на покупку — не более 2 раз для одного пользователя.

Booster является бонусным товаром при покупке товара Empire Lootbox.

Пользователь 1 раз купил Booster и 1 раз купил Empire Lootbox, получив Booster в качестве бонуса.

При попытке купить Empire Lootbox повторно, в ответе на метод создания заказа придет сообщение, что пользователь превысил ограничение на покупку товара Booster.

Пример ограничения на использование бонусной акции:

В Личном кабинете для бонусной акции задано ограничение на использование — не более 1 раза для одного пользователя.

Booster является бонусным товаром при покупке товара Empire Lootbox.

Пользователь 1 раз купил товар Empire Lootbox, получив Booster в качестве бонуса.

При попытке купить Empire Lootbox повторно, бонусный товар Booster не будет показан и не будет доставлен пользователю.

Пример ограничений на покупку бонусного товара и использования акции:

В Личном кабинете для товара Booster задано ограничение на покупку — не более 1 раза для одного пользователя.

Booster является бонусным товаром при покупке товара Empire Lootbox.

Для бонусной акции задано ограничение на использование — не более 2 раз для одного пользователя.

Пользователь 1 раз купил товар Empire Lootbox, получив Booster в качестве бонуса.

При попытке купить Empire Lootbox повторно, в ответе на метод создания заказа придет сообщение, что пользователь превысил ограничение на покупку товара Booster.

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

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

Вы можете настроить бонусные акции одним из следующих способов:

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

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

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

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

Примечание
Созданные акции по умолчанию отключены. Чтобы активировать акцию, перейдите в редактирование акции после ее создания и в правом верхнем углу в раскрывающемся списке выберите Активировать акцию.

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

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

Чтобы выбрать несколько разных типов акционных товаров для одной акции, выберите товары для одного типа, проверьте, что они отобразились в поле Список акционных товаров, после этого вернитесь к полю Акционные товары и укажите еще один тип.

Чтобы выбрать несколько разных типов бонусных товаров для одной акции, выберите товары для одного типа, проверьте, что они отобразились в поле Список бонусных товаров, после этого вернитесь к полю Бонусные товары и укажите еще один тип.

  1. Нажмите Далее.
  2. При необходимости вы можете задать количество использований акции. Для этого на странице Условия и ограничения установите переключатель Ограничивать использование акции пользователем в положение Вкл и введите необходимое число.
  3. Для настройки персонализированной акции установите переключатель Акция для определенных пользователей в положение Вкл и укажите параметры условия. Чтобы настроить персонализацию, воспользуйтесь инструкцией.
  4. Нажмите Далее.
  5. Укажите период действия акции.
  1. Нажмите Далее.
  2. Проверьте настройки и нажмите кнопку Сохранить и выйти.
  3. Чтобы активировать акцию:
    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 вы также можете:

Copy
Full screen
Small screen

“condition”: null
Copy
Full screen
Small screen

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

В другой раз

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

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

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