FAPI.invokeUIMethod("prepareMidroll")

Пример

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

Результат

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

data: "prepareMidroll$ok$ready"

Возможны следующие варианты ответа:

  • ok:ready - видео для показа найдено;
  • error:{errorReason} - видео для показа не найдено.

Возможные причины ошибки:

  • empty - видео для показа не найдено;
  • disabled - показ видео для данного пользователя выключен. Видео показывается только пользователям, не являющимся плательщиками в играх.

Как работает

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

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

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

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

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

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

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

Статистика

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

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

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