Сигнатура метода
Метод предназначен для получения поддерживаемых на текущем устройстве пользователя форматов отображения баннерной рекламы.
Для десктопа метод также возвращает варианты количества показываемых одновременно баннеров.
Список поддерживаемых форматов зависит от:
- платформы запроса;
- версии приложения ОК (в случае платформы android);
- текущей ориентации экрана на мобильных платформах.
Пример вызова
Пример коллбека
В результате вызова метода игре вернется коллбек, в котором будет указан список поддерживаемых форматов отображения баннера, а также позиций, на которых он может быть показан.
method: “getBannerFormats”
result: “ok”
data: ‘{“current”:”bar”,”current_count”:1,”count_options”:[1,2],”supported”:{“bar”:[“top”,”bottom”],”bar_outer”:[“top”,”bottom”],”outer”:[“top”,”bottom”],”thin”:[“top”,”bottom”],”thin_outer”:[“top”,”bottom”],”vertical”:[“left”,”right”],”vertical_outer”:[“left”,”right”]}}’
В ответе метода:
- current - текущий формат, в котором показывается баннерная реклама;
- supported - список поддерживаемых форматов отображения, где ключ - формат, значение - список позиций, на которых в этом формате можно разместить баннер;
- restrictions - список ограничений по каждому формату баннерной рекламы. Сейчас для каждого формата определены ограничения по ориентациям устройства (только моб. платформы), в поле перечислены те ориентации, которые запрещены для указанных форматов;
- current_count - текущее количество баннеров для показа за раз;
- count_options - варианты количества баннеров для показа за раз.
Поддерживаемые форматы
На текущий момент поддерживаются следующие форматы баннерной рекламы:
Формат | Описание | Платформы | Позиции размещения | Поддерживаемые ориентации |
bar | Горизонтальный баннер, показываемый поверх контейнера игры | desktop mobile android (с версии 22.11.17) ios(c версии 10.50) | top - над игрой bottom - под игрой | альбомная портретная |
outer (deprecated) bar_outer | Горизонтальный баннер, показываемый со смещением контейнера игры | web mobile android (с версии 23.9.4) ios(c версии 10.50) | top - над игрой bottom - под игрой | альбомная портретная |
thin | Узкий горизонтальный баннер, показываемый поверх контейнера игры | web mobile android (с версии 24.3.4) | top - над игрой bottom - под игрой | альбомная |
thin_outer | Узкий горизонтальный баннер, показываемый со смещением контейнера игры | web mobile android (с версии 24.3.4) | top - над игрой bottom - под игрой | альбомная |
vertical | Вертикальный баннер, показываемый поверх контейнера игры | web mobile android (с версии 24.3.4) ios (c версии 10.50) | left - слева от игры right - справа от игры | альбомная |
vertical_outer | Вертикальный баннер, показываемый со смещением контейнера игры | web mobile android (с версии 24.3.4) ios (c версии 10.50) | left - слева от игры right - справа от игры | альбомная |
Размеры баннера
Размер баннера, который показывается при вызове метода, зависит от следующих параметров:
- платформа;
- формат отображения;
- ориентация экрана пользователя (для мобильных платформ).
На каждой платформе в каждом из состояний экрана пользователя размеры баннера предопределены.
Платформа | Формат | Ориентация экрана | Ширина | Высота |
android | bar | портретная | 100% | 106dp |
android | bar | альбомная | 362dp | 106dp |
ios | bar | портретная | 100% | 106dp |
ios | 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 |
ios | bar_outer | портретная | 100% | 106dp |
ios | 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 |
ios | vertical | альбомная | 120dp | 202dp-284dp |
mobile web | vertical | альбомная | 104px | 276px |
web | vertical | - | 240px | 400px |
android | vertical_outer | альбомная | 120dp | 100% |
ios | vertical_outer | альбомная | 120dp | 100% |
mobile web | vertical_outer | альбомная | 104px | 100% |
web | vertical_outer | - | 240px | 400px |