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

Реклама

Обзор​

GamePush позволяет реализовать показ рекламных объявлений или видео с вознаграждением в игре. Работа с рекламой в GamePush происходит с помощью Менеджера рекламы gp.ads. Менеджер управляет баннерами на странице игры, отвечает за:

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

Для корректного отображения этого раздела отключите AdBlock.

Менеджер рекламы​

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

Доступные свойства менеджера рекламы:

// Проверка включенного AdBlock
gp.ads.isAdblockEnabled;

// Проверка доступности баннера
gp.ads.isStickyAvailable;
gp.ads.isFullscreenAvailable;
gp.ads.isRewardedAvailable;
gp.ads.isPreloaderAvailable;

// Проверка рекламы
gp.ads.isStickyPlaying;
gp.ads.isFullscreenPlaying;
gp.ads.isRewardedPlaying;
gp.ads.isPreloaderPlaying;

// Проверка включенных рекламных оверлеев
// Включен оверлей обратного отсчета перед показом фулскрин рекламы
gp.ads.showCountdownOverlay;
// Включен оверлей при неудачном показе rewarded video
gp.ads.showRewardedFailedOverlay;

// Можно ли на площадке показывать фулскрин рекламу перед началом геймплея
gp.ads.canShowFullscreenBeforeGamePlay;

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

// Начался показ рекламы
gp.ads.on('start', () => {});
// Закончился показ рекламы
gp.ads.on('close', (success) => {});

Fullscreen​

Fullscreen баннер или interstitial - всплывающая, часто полноэкранная реклама с возможностью пропуска (иногда только через несколько секунд). Обычно показывается в переходах между уровнями. Его показ многими площадками запрещен во время самого геймплея. Разрешено показывать лишь в перерывах между игровыми сессиями.

Площадкой VK Games запрещается так же во время навигации, соответственно будем считать это плохой практикой и на других площадках.

Пример вызова:

// Показать fullscreen, возвращает промис
gp.ads.showFullscreen();

// Показать fullscreen с окном обратного отсчета перед показом рекламы
gp.ads.showFullscreen({ showCountdownOverlay: true });

// Начался показ
gp.ads.on('fullscreen:start', () => {});
// Закончился показ
gp.ads.on('fullscreen:close', (success) => {});

Preloader​

Preloader — баннер, появляющийся во время загрузки игры. На многих площадках реализован через Fullscreen баннер, но не завязан на его таймеры (кроме Яндекс.Игр).

Разрешен показ только перед началом игры.

Пример вызова:

// Показать preloader, возвращает промис
gp.ads.showPreloader();

// Начался показ
gp.ads.on('preloader:start', () => {});
// Закончился показ
gp.ads.on('preloader:close', (success) => {});

Rewarded Video​

Rewarder Video — видеореклама без возможности пропуска, цель которой для игрока — получить награду за просмотр. Запрещается показывать без начисления награды.

Пример вызова:

// Показать rewarded video, возвращает промис
gp.ads.showRewardedVideo();

// Показать rewarded video с опцией показа оверлея
// при неудачном показе rewarded video
gp.ads.showFullscreen({ showCountdownOverlay: true });

// Асинхронно
const success = await gp.ads.showRewardedVideo();
if (success) {
    gp.player.add('gold', 5000);
}

// Начался показ
gp.ads.on('rewarded:start', () => {});
// Закончился показ
gp.ads.on('rewarded:close', (success) => {});
// Получена награда
gp.ads.on('rewarded:reward', () => {});

Sticky Banner​

Sticky баннер — фиксированный баннер в нижней части экрана, занимает ~50-100px (110px VK Direct Games). Баннер не должен закрывать игровую область.

В панели можно настроить частоту автообновления. Баннер будет обновляться с указанной частотой сразу после старта.

Пример вызова:

// Показать sticky баннер, дальше автообновляется сам
gp.ads.showSticky();
// Обновить sticky баннер, принудительное обновление
gp.ads.refreshSticky();
// Закрыть sticky баннер
gp.ads.closeSticky();

// Открыли баннер
gp.ads.on('sticky:start', () => {});
// Баннер показался на экране
gp.ads.on('sticky:render', () => {});
// Баннер обновился
gp.ads.on('sticky:refresh', () => {});
// Закрыли баннер
gp.ads.on('sticky:close', () => {});

Поддерживаемые площадки​

  • ✅CrazyGames
  • ✅GameDistribution
  • ✅Yandex Games
  • ✅VK Games
  • ✅OK Games
    • Площадки без поддержки
  • ❌GamePix
  • ❌GameMonetize
  • ❌Poki
  • ❌SmartMarket
  • ❌VK Play

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

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

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

    Для ваших обращений e-mail: [email protected]

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