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

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

• заключить договор для резидентов РФ (ознакомиться с офертой)
• если вы нерезидент, обратитесь с вопросом по заключению договора в таск модерации игры.

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

Для игр доступно два варианта рекламной монетизации:

• rewarded ads - реклама, показ которой подразумевает награждение за просмотр;
• interstitial ads - реклама, которую можно показывать в перерывах между игровым процессом;
• sticky banners - реклама, которую можно показывать во время игрового процесса, представляет из себя баннер, показываемый поверх игры.

Подключить SDK достаточно просто, надо лишь:

• подключить FAPI в проект;
• объявить функцию для обработки результата вызова (callback-функция);
• реализовать вызов методов SDK для поиска и показа рекламы.

Rewarded ads

Для реализации этого формата рекламы в вашей игре в SDK реализовано два метода, которые позволяют:

• выполнить запрос на поиск рекламы - FAPI.UI.loadAd;
• показать найденную рекламу - FAPI.UI.showLoadedAd.

Эти методы работаю на всех платформах (десктопный и мобильный веб, android, iOS).

Interstitial ads

Для реализации этого формата рекламы требуется использовать лишь один метод:

• выполнить запрос на поиск и показ рекламы - FAPI.UI.showAd.

Этом метод работает на всех платформах (десктопный и мобильный веб, android, iOS).

Banner ads

Для реализации этого формата рекламы доступны следующие методы SDK:

• подбор рекламы - FAPI.UI.requestBannerAds;
• показ блока с рекламой - FAPI.UI.showBannerAds;
• скрытие блока с рекламой - FAPI.UI.hideBannerAds;
• проверка показа баннера с рекламой - FAPI.UI.isBannerAdsVisible.

Этот формат рекламы доступен только на платформе android.

Подключение FAPI

В код вашего приложения надо добавить следующую строчку:

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

Callback-функция

Методы из группы FAPI.UI не требуют передачи callback-функции при вызове. После выполнения метода будет вызвана глобальная функция, которую должен реализовать разработчик. Функция должна иметь следующую сигнатуру:

function API_callback(method, result, data);

Здесь:

• method - название вызванного метода;
• result - результат выполнения (“ok” в случае успеха, “cancel” в случае, если пользователь отменил действие);
• data - дополнительная информация, например, для showInvite() – это список id приглашенных друзей, разделенный запятыми, в формате строки.

Поиск rewarded рекламы

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

/*
* Функция инициирует подготовку рекламы для показа пользователю во время игровой сессии
*/
function prepareRewardedAd() {
    FAPI.UI.loadAd();
}

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

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

/*
* Функция запускает показ рекламы пользователю во время игровой сессии
*/
function showRewardedAd() {
    FAPI.UI.showLoadedAd();
}

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

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

/*
* Функция запускает поиск показ interstitial рекламы пользователю
*/
function showInterstitialAd() {
    FAPI.UI.showAd()
}