banner

Banner

Banners are persistent ads pinned to the top or bottom of the screen. Use them on idle screens — main menu, lobby, pause overlay — and hide them during active gameplay.

When to use

• You have a stable UI region where a banner won't overlap with controls.
• You want medium-tier passive monetization without interrupting the player.
• For more flexible placements (multiple banners, custom positions, responsive layouts) use Advanced Banners instead.

Is Banner Supported

Check this before reserving screen space or showing banner UI. Hide banner areas on platforms that do not support banners.

bridge.advertisement.isBannerSupported

Platform support · 12 of 28 platforms

Supports: bitquest, crazy_games, dlightek, facebook, game_distribution, gamepush, jio_games, msn, ok, vk, xiaomi, yandex

Does not support: absolute_games, discord, gamesnacks, huawei, lagged, microsoft_store, playdeck, playgama, poki, portal, reddit, samsung, telegram, tiktok, y8, youtube

Show Banner

Show a banner in a stable UI area where it will not overlap gameplay controls.

let position = 'bottom' // optional, 'top' | 'bottom', default = bottom
let placement = 'test_placement' // optional
bridge.advertisement.showBanner(position, placement)

Hide Banner

Hide the current banner before gameplay resumes or when the screen no longer has safe space for it.

bridge.advertisement.hideBanner()

Banner State

Track banner state to adjust layout, avoid empty ad space, and debug failed loads.

bridge.advertisement.bannerState

bridge.advertisement.on(EVENT_NAME.BANNER_STATE_CHANGED, this.onBannerStateChanged.bind(this));

onBannerStateChanged(state: BANNER_STATE) {
   console.log('Banner state: ', state)
}

Possible values: loading, shown, hidden, failed.