Перейти к основному содержимому

Промокоды и бонусы

Интеграция с системами промокодов и подарков игровых платформ через награды GamePush.

Концепция​

Игровые платформы, такие как Яндекс Игры и ВКонтакте, предоставляют механизмы выдачи промокодов и подарков игрокам. GamePush автоматически синхронизирует эти бонусы с системой наград, позволяя разработчикам легко интегрировать поощрения в свои игры.

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

  1. Платформа выдает бонус - игрок активирует промокод или получает подарок на платформе
  2. Автоматическая синхронизация - при входе в игру GamePush автоматически получает информацию о всех доступных бонусах
  3. Выдача ценностей - вы используете API наград для обработки и выдачи игровых ценностей

Важная информация​

  1. Обязательно проверяйте награды при старте игры.
  2. Показывайте всплывающее / модальное окно с информацией о том, что промокод применен / бонус получен.
  3. Рекомендуем сделать явное действие для получения награды, например, кнопку "Забрать бонус".
caution

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

Поддерживаемые платформы​

Яндекс Игры​

Поддержка промокодов через систему наград.

Настройка:

  1. Создайте награду в панели управления GamePush
  2. Укажите тег для удобного использования (например, starter_pack)
  3. В поле yandexId придумайте ID промокода из Яндекс Игр (например, welcome_pack). Передайте этот промокод менеджеру площадки Яндекс Игры.
  4. При желании, настройте бонусы, которые получит игрок, например, 1000 золота. Либо в коде игры реализуйте логику поощрения самостоятельно.

ВКонтакте​

Поддержка подарков через систему наград.

Настройка:

  1. Создайте награду в панели управления GamePush
  2. Укажите тег для удобного использования (например, starter_pack)
  3. В поле vkId укажите ID подарка из ВКонтакте. Его вам сообщит менеджер площадки.
  4. При желании, настройте бонусы, которые получит игрок, например, 1000 золота. Либо в коде игры реализуйте логику поощрения самостоятельно.

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

Базовая проверка и выдача бонуса​

// Проверяем наличие бонуса при старте игры
if (gp.rewards.hasUnaccepted('newbie_gift')) {
    // Выдаем игровые ценности
    gp.player.add('gold', 1000);

    // Принимаем награду (помечаем как полученную)
    await gp.rewards.accept('newbie_gift');

    // Сохраняем прогресс игрока
    await gp.player.sync();

    console.log('Бонус новичка получен!');
}

Оставайтесь на связи​

С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.

Сообщество GamePush в Telegram: @gs_community.

Для ваших обращений e-mail: official@gamepush.com

Желаем вам успехов!