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

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

Все показы рекламы, которые были совершены ДО заключения договора, учтены не будут, и вы не получите за них вознаграждение.

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

Этот вид рекламы позволяет заранее произвести поиск рекламы для пользователя, а затем в виде отдельного действия показать её пользователю.

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

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

  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);
};

Величина выплат

Выплаты за показы данного вида рекламы учитывают только успешные факты показа рекламы пользователю.

Формула прозрачна:

  • для разработчиков, платящих НДС: за каждые 1000 показов мы платим 70 рублей;
  • для разработчиков-нерезидентов, а также неплательщиков НДС: за каждые 1000 показов мы платим 58 рублей.

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

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

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

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

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

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

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

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

Если в предыдущем этапе реклама была найдена,то её можно показывать. Делается это с помощью одного из методов:

  • FAPI.UI.showLoadedAd - предпочтительный вариант показа рекламы, поддерживается на всех платформах.

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

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

После завершения показа рекламы снова будет вызвана функция API_callback.

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

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

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

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

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

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

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

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

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