Сигнатура метода
Метод предназначен для показа ранее найденной с помощью метода FAPI.UI.requestBannerAds баннерной рекламы
Метод делает видимым баннерный блок, в котором отображается баннерная реклама. Позиция баннерного блока управляется параметром position. Например, для горизонтального формата есть такие опции показа:
- bottom - баннер показывается в нижней части экрана устройства (значение по умолчанию);
- top - баннер показывается в верхней части экрана устройства.
Полный список доступных форматов баннеров и позиций их показа всегда можно получить через метод FAPI.UI.getBannerFormats.
Чтобы выбрать нужный формат баннерной рекламы, требуется использовать метод FAPI.UI.setBannerFormat.
Размеры баннера
Размер баннера, который показывается при вызове метода, зависит от следующих параметров:
- платформа;
- формат отображения;
- ориентация экрана пользователя (для мобильных платформ).
На каждой платформе в каждом из состояний экрана пользователя размеры баннера предопределены.
Платформа | Формат | Ориентация экрана | Ширина | Высота |
android | bar | портретная | 100% | 106dp |
android | bar | альбомная | 362dp | 106dp |
mobile web | bar | портретная | 404px | 106dp |
mobile web | bar | альбомная | 404px | 106dp |
web | bar | - | 404px | 96px |
android | bar_outer | портретная | 100% | 106dp |
android | bar_outer | альбомная | 100 | 106dp |
mobile web | bar_outer | портретная | 100% | 96px |
mobile web | bar_outer | альбомная | 100% | 96px |
web | bar_outer | - | 100% | 96px |
android | thin | альбомная | 100% | 56dp |
mobile web | thin | альбомная | 100% | 48px |
web | thin | - | 404px | 48px |
android | thin_outer | альбомная | 100% | 56dp |
mobile web | thin_outer | альбомная | 100% | 48px |
web | thin_outer | - | 100% | 48px |
android | vertical | альбомная | 120dp | 202dp-284dp |
mobile web | vertical | альбомная | 104px | 276px |
web | vertical | - | 240px | 400px |
android | vertical_outer | альбомная | 120dp | 100% |
mobile web | vertical_outer | альбомная | 104px | 100% |
web | vertical_outer | - | 240px | 400px |
Показ нескольких баннеров
В случае, если была выбрана опция показа нескольких баннеров с помощью метода FAPI.UI.setBannersCount, то стоит учесть, что кроме показа нескольких баннеров также между ними будут присутствовать отступы в 16px.
Пример вызова
Пример коллбека
В результате вызова метода игре вернется коллбек, оповещающий о произошедшем событии. Возможные коллбеки описаны ниже.
Коллбек для случая, если рекламный блок начал отображаться
method: “showBannerAds”
result: “ok”
data: “true”
Коллбек для случая, если рекламный блок не начал отображаться
method: “showBannerAds”
result: “ok”
data: “false”