Rewarded

You are reading the documentation for Bridge SDK v2. If you need the obsolete v1 documentation, see Documentation (v1).

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.

Rewarded integration is highly recommended: it is usually the highest-eCPM ad format, and players opt in willingly.

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.

Configuration

Rewarded settings live in the config under the advertisement.rewarded key.

{
    "advertisement": {
        "rewarded": {
            "disable": false, // disable rewarded ads entirely
            "preloadOnStart": "extra_life", // placement to preload automatically right after SDK initialization
            "placementFallback": "extra_life", // placement used when showRewarded() is called without one
            "placements": [ // map a game-level placement id to native placement ids, keyed by platform id
                { "id": "extra_life", "yandex": "native_placement_id" }
            ]
        }
    }
}

Is Rewarded Supported

Check this before showing a rewarded-ad button.

bridge.advertisement.isRewardedSupported

Platform support · 24 of 26 platforms

Supports: 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);
}

Read the current state from the expression. Possible values: loading, opened, closed, rewarded, failed.

PlaygamaBridge.RewardedState

To react to changes, use the trigger conditions On Rewarded State Changed, On Rewarded Loading, On Rewarded Opened, On Rewarded Rewarded, On Rewarded Closed, On Rewarded Failed. Grant the reward only inside On Rewarded Rewarded.

Copy This Example

{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"on-rewarded-rewarded","objectClass":"PlaygamaBridge"}],"actions":[{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Grant the reward here\""}}]}]}

Read the current state from the expression. Possible values: loading, opened, closed, rewarded, failed.

PlaygamaBridge::RewardedState()

Copy This Example

{"000kind":"GDEVELOP_EventsAndInstructions_CLIPBOARD_KIND-jsBdHbLy912y8Rc","content":{"eventsList":[{"type":"BuiltinCommonInstructions::Standard","conditions":[{"type":{"value":"PlaygamaBridge::OnRewardedRewarded"},"parameters":[""]}],"actions":[{"type":{"value":"DebuggerTools::ConsoleLog"},"parameters":["\"Grant the reward here\"","\"info\"",""]}]}],"eventsCount":1,"actionsList":[],"actionsCount":0,"conditionsList":[],"conditionsCount":0}}

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 (required)NextBanner

Last updated 11 days ago