Для получения вознаграждения по рекламе необходимо заключить договор по ссылке:

Interstitial реклама - это вид полноэкранной рекламы на платформе Android для показа между игровыми активностями без предварительного поиска рекламы для пользователя.

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

Для показа рекламы с предварительным поиском и показом по действию можно использовать способ показа, доступный по ссылке - rewarded реклама.

Подключение рекламы

Для подключения поддержки рекламы вам надо убедиться, что:

  1. ваше приложение открывается в iframe на мобильных платформах. Если оно открывается как внешняя страница, то вам стоит сделать запрос на включение iframe на api-support@ok.ru;
  2. сделать запрос на api-support@ok.ru для включения поддержки FAPI для мобильной версии вашего приложения.

После этого вы можете подключить FAPI следующим образом:

<script type="text/javascript" src="//api.ok.ru/js/fapi5.js" defer="defer"></script>

И объявить глобальную функцию API_callback для обработки результата показа реклама. Например:

window.API_callback = function(method, result, data) {
   console.log("method=" + method + ", result=" + result + ", data=" + data);
};

Проверка возможности показа рекламы

Перед тем как показать пользователю рекламу, стоит проверить, возможен ли показ рекламы для пользователя.

Для этого предназначен метод FAPI.UI.isNativeAdSupported().

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

/*
* Проверка наличия возможности показать нативную рекламу
*/
function isAdsEnabled() {
    if (FAPI && FAPI.UI.isNativeAdSupported) {
        return FAPI.UI.isNativeAdSupported();
    }
}

Результат выполнения метода (boolean):

  • false - если показ рекламы недоступен;
  • true - если показ рекламы доступен.

Показ рекламы

Если предыдущий этап завершился успешно (метод существует и вернул ответ true), то пользователю можно показать рекламу.

Для показа рекламы следует использовать метод FAPI.UI.showAd.

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

/*
* Показ внутриигровой рекламы
*/
function requestAds() {
    if (FAPI && FAPI.UI.showAd) {
        FAPI.UI.showAd();
    }
}

Callback при показе рекламы

Как и все методы FAPI при любом значимом событии будет вызываться глобальный FAPI-callback - функция API_callback(method, result, data).

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

  • для пользователя рекламы не нашлось:
    • method = showAd;
    • result = error;
    • data = no_ads;
  • реклама для пользователя найдена и подготовлена:
    • method = showAd;
    • result = event;
    • data = ad_prepared;
  • реклама успешно показана:
    • method = showAd;
    • result = ok;
    • data = ad_shown;
  • при показе рекламы произошла ошибка:
    • method = showAd;
    • result = error;
    • data = native ads failed.

Тестовое приложение

Для тестирования рекламы вы можете воспользоваться тестовым приложением по показу рекламы.

Приложение доступно по адресу http://m.ok.ru/game/inappadstest

Для проверки показа такого вида рекламы достаточно:

  • для инициации процесса показа рекламы - нажать на кнопку “load rewarded ad”;
  • нажать на кнопку “show loaded rewarded ad”.