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

Метод предназначен для получения поддерживаемых на текущем устройстве пользователя форматов отображения баннерной рекламы.

Для десктопа метод также возвращает варианты количества показываемых одновременно баннеров.

Список поддерживаемых форматов зависит от:

  • платформы запроса;
  • версии приложения ОК (в случае платформы android);
  • текущей ориентации экрана на мобильных платформах.
FAPI.invokeUIMethod("getBannerFormats")

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

function getBannerFormats() {
FAPI.invokeUIMethod("getBannerFormats")
}

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

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

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 - справа от игры
альбомная