Сигнатура метода

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

FAPI.UI.showLoadedAd()

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

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

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

Пример коллбека

В результате выполнения функции в параметре data указывается информация о процессе показа рекламы

Коллбек для случая, если видео для показа найдено

method: “showAd”

result: “ok”

data: “ready”

Коллбек для случая, когда реклама не найдена

method: “showAd”

result: “error”

data: “no_ads”

Коллбек для случая, когда реклама найдена

method: “showAd”

result: “ok”

data: “ad_prepared”

Коллбек для случая, когда показ рекламы завершен

method: “showAd”

result: “ok”

data: “ad_shown”

Детализация ошибок рекламы на Android

В случае возникновения ошибки при попытке поиска рекламы на платформе Android вам будет возвращена ошибка вида native ads failed: {error_code}.

Параметр error_code может иметь следующие значения:

  • -1 - достигнут лимит частоты вызова рекламы. Вызов метода доступен не чаще 1 раза в 30 секунд;
  • -2 - ошибка вызова клиентского коллбека;
  • -3 - реклама на Android недоступна пользователю (например, он использует старую версию приложения);
  • -4 - в данный момент уже идёт показ рекламы.

Статистика

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

  • вкладка “Реклама” -> график “Промежуточные показы рекламы на платформе Android” - для рекламы на платформе android.

Для платформы android мы считаем показ успешным, если после вызова метода показа вернулся ответ ad_shown.

API статистики

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

  • метод - stat.getFromServer;
  • статистическая таблица ad_shown_android, столбец IntermedCalls - для сбора статистики по рекламе на платформе android.