Rewarded

Rewarded ads are opt-in full-screen ads. The player chooses to watch in exchange for an in-game reward, such as an extra life, double coins, a hint, or a skip. They usually have high eCPM and low friction because the player consents.

When to use

The player can use a small boost (revive, extra hint, skip a hard level).
You have premium content gated behind a soft paywall — let non-paying players unlock it via an ad.
You want to convert engagement into revenue without hurting retention.

Reward the player only when the state is rewarded. Granting on closed lets players claim rewards without watching the ad.

Ad settings are stored in playgama-bridge-config.json. Use the config editor to create or update them.

Is Rewarded Supported

Check this before showing a rewarded-ad button.

bridge.advertisement.isRewardedSupported

Platform support · 26 of 28 platforms

Supports: absolute_games, bitquest, crazy_games, dlightek, facebook, game_distribution, gamepush, gamesnacks, huawei, jio_games, lagged, microsoft_store, msn, ok, playdeck, playgama, poki, portal, samsung, telegram, tiktok, vk, xiaomi, y8, yandex, youtube

Does not support: discord, reddit

Rewarded State

Track state changes to grant the reward only when the final state is rewarded. For muting and pausing the game, prefer the universal platform AUDIO_STATE_CHANGED / PAUSE_STATE_CHANGED events described below instead of reacting to each ad state separately.

bridge.advertisement.rewardedState

Possible values: loading, opened, closed, rewarded, failed.

// To track rewarded ad state changes, subscribe to the event
bridge.advertisement.on(
    bridge.EVENT_NAME.REWARDED_STATE_CHANGED, 
    state => console.log('Rewarded state: ', state)
)

Bridge.advertisement.rewardedState

Possible values: Loading, Opened, Closed, Rewarded, Failed.

// To track rewarded ad state changes, subscribe to the event
private void Start()
{
    Bridge.advertisement.rewardedStateChanged += OnRewardedStateChanged;
}

private void OnRewardedStateChanged(RewardedState state)
{
    Debug.Log(state);
}

Bridge.advertisement.rewarded_state

Returns the current state of the rewarded ad. Possible values: loading, opened, closed, rewarded, failed.

# To track rewarded ad state changes, connect to the signal
func _ready():
    Bridge.advertisement.connect("rewarded_state_changed", self, "_on_rewarded_state_changed")

func _on_rewarded_state_changed(state):
    print(state)

# To track rewarded ad state changes, connect to the signal
func _ready():
    Bridge.advertisement.connect("rewarded_state_changed", Callable(self, "_on_rewarded_state_changed"))

func _on_rewarded_state_changed(state):
    print(state)

playgama_bridge_advertisement_rewarded_state()

Possible values: loading, opened, closed, rewarded, failed.

// To track rewarded ad state changes, subscribe to the event

// via Async Social Event
if async_load[? "type"] == "playgama_bridge_advertisement_rewarded_state_changed" {
    switch async_load[? "data"] {
        case "loading":
            // your logic here
            break
        case "opened":
            // your logic here
            break
        case "closed":
            // your logic here
            break
        case "failed":
            // your logic here
            break
    }
}

bridge.advertisement.rewarded_state()

Possible values: loading, opened, closed, rewarded, failed.

local bridge = require("bridge.bridge")

function init(self)
	bridge.advertisement.on("rewarded_state_changed", function (_, state)
		print("Rewarded state changed: ", state)
	end)
end

bridge.advertisement.rewardedState

Possible values: loading, opened, closed, rewarded, failed.

// To track rewarded ad state changes, subscribe to the event
bridge.advertisement.on(EVENT_NAME.REWARDED_STATE_CHANGED, this.onRewardedStateChanged.bind(this));

onRewardedStateChanged(state: REWARDED_STATE) {
    console.log("Rewarded state: ", state);
    switch (state) {
        case 'loading':
            break;
        case 'opened':
            break;
        case 'rewarded':
            break;
        case 'closed':
            break;
        case 'failed':
            break;
    }
}

While the rewarded ad is open, the game must be muted and paused. The recommended way to handle this is once, in a single place, by subscribing to the platform AUDIO_STATE_CHANGED and PAUSE_STATE_CHANGED events instead of duplicating the logic per ad type. Bridge raises those events whenever the host requests it — interstitials, rewarded ads, browser tab switches, system pauses — so a single universal handler covers every case.

Reward the player only when the state is rewarded.

Rewarded Placement

Read the current rewarded placement when one button can request different rewards. Use it to decide which reward to grant after the state becomes rewarded.

bridge.advertisement.rewardedPlacement

Show Rewarded Ad

Request a rewarded ad from a direct player action, such as tapping "Watch ad for reward".

let placement = 'test_placement' // optional
bridge.advertisement.showRewarded(placement)

PreviousInterstitial NextBanner

Last updated 4 days ago

hashtagWhen to use

hashtagIs Rewarded Supported

hashtagRewarded State

hashtagRewarded Placement

hashtagShow Rewarded Ad

When to use

Is Rewarded Supported

Rewarded State

Rewarded Placement

Show Rewarded Ad