Видеореклама

Этот модуль реализует interstitial-видео и rewarded-видеорекламу. Ознакомьтесь с разделом, относящимся к вашему игровому движку, на странице JOGOS_SDK Введение и используйте функционал видеорекламы следующим образом:

window.JOGOS_SDK.ad;

Требования к рекламе

Обязательно ознакомьтесь с нашими требованиями к рекламе, так как если ваша игра не соответствует этим требованиям, она будет отклонена без обратной связи.

Запрос показа видеорекламы

Мы поддерживаем два различных типа видеорекламы: interstitial (midgame) и rewarded (rewarded);

• Interstitial-реклама: может показываться при смерти пользователя, завершении уровня и т.д.
• Rewarded-реклама: пользователь добровольно смотрит рекламу для получения вознаграждения (дополнительные жизни, возрождение персонажа, бонусные предметы и т.д.).

// Функции обратного вызова
const callbacks = {
  // Вызывается при начале показа рекламы
  onstarted: () => console.log('ad started'),
  // Вызывается при завершении показа рекламы
  onfinished: () => console.log('ad finished'),
  // Вызывается при ошибке показа рекламы
  onerror: (error) => console.log('ad error:', error),
};

// Запрос показа interstitial-рекламы
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Запрос показа rewarded-рекламы
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

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

• Interstitial-реклама имеет минимальный интервал обновления (обычно 60 секунд). Частые вызовы приведут к ошибке: 500 At least a ${time} second interval is required to display new advertisements.

• Rewarded-реклама имеет дневное ограничение (обычно 30 показов на пользователя в день). Превышение вызовет ошибку: 500 You can only watch up to ${max} rewarded ads per day.

• Рекомендуем реализовать систему cooldown или дневных лимитов для rewarded-рекламы. Вы можете использовать следующий API для проверки оставшегося количества показов:

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

Обнаружение блокировки рекламы

Требования к рекламе

Наша игровая механика позволяет продолжать игру при блокировке рекламы, но система детектирования может ошибаться. Во избежание ложных срабатываний рекомендуем мягкие ограничения: ограничивайте премиум-контент (скины, уровни) только для пользователей с блокировщиком, с возможностью восстановления функционала после отключения блокировщика. Обязательно реализуйте систему автосохранения, чтобы избежать потери прогресса при перезагрузке страницы.

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

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);