FAPI.invokeUIMethod("prepareMidroll")

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

FAPI.invokeUIMethod("prepareMidroll");

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

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

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

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

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

method: “prepareMidroll”

result: “ok”

data: “ready”

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

method: “prepareMidroll”

result: “error”

data: “empty”

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

method: “prepareMidroll”

result: “error”

data: “disabled”

Как это работает

При вызове функции производится поиск видеорекламы, которая может быть показана пользователю во время игровой сессии.
Подбор видео является персонализированным и зависит от характеристик пользователя.
После вызова метода по подготовке рекламы необходимо использовать метод FAPI.invokeUIMethod(“showMidroll”) для её показа пользователю.
Показ необходимо инициировать только если видео для показа было найдено.

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

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

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

  • нажать на кнопку “prepare midroll”;
  • нажать на кнопку “show midroll”.

А для мобильной версии:

  • нажать на кнопку “inject frame”;
  • нажать на кнопку “prepare midroll”;
  • нажать на кнопку “show”.

Статистика

На странице вашей игры в разделе со статистикой теперь показываются данные о том, сколько рекламных видео просмотрели ваши пользователи.

Учтите, что мы считаем показ успешным, если:

  • просмотр рекламы пользователем длился как минимум 10 секунд;
  • показ рекламы был успешно завершен (вам должен был прийти ответ showMidroll$ok$complete).