Видеореклама в играх

Важно! Видеореклама в играх это не способ рекламы игры на Одноклассниках, а способ монетизации неплатящей аудитории игры

В приложениях на Одноклассниках есть дополнительный источник монетизации неплатящей аудитории с помощью видеорекламы.

С помощью нашего API разработчик может получить рекламный ролик для показа пользователю в игре, предолжив ему за просмотр внутриигровую валюту или другие бонусы, которые прежде могли быть доступны только с помощью покупки.

Видеореклама поддерживается для всех приложений, которые работают как на веб-версии нашего портала (HTML-приложения), так и на мобильной версии Одноклассников (MOBILE_HTML-приложения).

Величина выплат за видеорекламу

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

В остальном формула прозрачна:

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

Показ рекламы в HTML-играх

Для показа рекламы в вашем HTML-приложении должен быть подключен наш javascript SDK.

Далее процесс достаточно прост:

  1. Сначала надо убедиться, что для текущего пользователя есть реклама, и подобрать рекламу для просмотра с помощью метода ui.prepareMidroll.
    • Если выполнение метода завершилось успешно, то в интерфейсе можно отображать ваш блок с предложением посмотреть рекламу.
    • Если выполнение метода завершилось с ошибкой, то скорее всего в данный момент рекламы для пользователя нет. Надо переспросить наш сервис позже, а пока реклама не нашлась, предлагать её просмотр пользователю лучше не стоит.
    • Также убедительно просим периодически обновлять видео для рекламы даже если выполнение метода завершилось успешно и видео нашлось. Например, по истечению 5 минут после предыдущего успешного получения рекламы, переполучите её снова.
  2. Если реклама нашлась, и пользователь возжелал её просмотреть, то для инициации процесса показа рекламы используйте метод ui.showMidroll
    • Если видео есть, то пользователю начнет показываться реклама. Экран игры будет перекрыт видеорекламой, которая будет показана пользователю.
    • При завершении рекламы вам поступит ответ, что просмотр рекламы завершен.
    • В случае, если пользователь решит перейти на время показа рекламы в другую вкладку браузера, то показ рекламы будет приостановлен, а возобновится он только в случае, если пользователь снова вернется на страницу вашего приложения.

Показ рекламы в MOBILE_HTML-играх

Для показа рекламы в MOBILE_HTML-играх перед вызовом FAPI-методов по подготовке и показу рекламы вам надо произвести дополнительное действие - добавить на страницу игры виджет показа рекламы.

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

https://connect.ok.ru/dk?st.cmd=WidgetVideoAdv&st.app={application_id}&st.sig={signature}&st.call_id=1&st.session_key={session_key}

ПараметрОбязательныйОписание
st.appДаИдентификатор приложения (application id)
st.sigДаЦифровая подпись запроса: md5(“call_id=1” + sessionSecretKey)
st.session_keyДаКлюч сессии пользователя в Одноклассниках
st.call_idДаОбязательное значение параметра = 1

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

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

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

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

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

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

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

Подсчет статистики

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

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

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

Если в процессе интеграции видеорекламы у вас возникли какие-либо технические вопросы, то можно обратиться в нашу службу поддержки по адресу api-support@ok.ru.