Fallback Solution

The ad backfill mechanism helps maximize revenue by filling unsold impressions. Whenever an ad request through the platform ad SDK fails, you can display ads using Playgama Ad.

Supported Platforms:

• MSN

Beta Access

Playgama Ad is currently available in closed beta. To request access, please contact us using the Contact Us form at https://playgama.com/adv.

If you are using Playgama Bridge

The backfill mechanism is already built in. All you need to do is provide your IDs in the playgama-bridge-config.json, and everything will run automatically.

• gameId is the identifier of your game on the third-party platform (for example, on MSN)

• backfillId is you personal partner identifier (playgama_clid)

{
    "platforms": {
        ...,
        "msn": {
            "gameId": "<YOUR_GAME_ID>"
        }
    },
    "advertisement": {
        ...,
        "backfillId": "msn-bridge"
    }
}

If you're not using Playgama Bridge

You will need to implement this logic yourself. To see an example of how it works, you can check the Playgama Bridge source code.

Installation

For correct data attribution, you need to pass several IDs:

• <your-clid> means you personal partner identifier (playgama_clid);

• <game-identifier> means the identifier of your game on the third-party platform (for example, on MSN).

<script src="https://playgama.com/ads/msn.v0.1.js"></script>

// Initialize the SDK
await window.pgAds.init('<your-clid>');
window.pgAds.updateTargeting({ gameId: '<game-identifier>' });

Show Interstitial

window.$msstart.loadAdsAsync(false)
    .then((msnAd) => window.$msstart.showAdsAsync(msnAd.instanceId))
    .catch(() => {
        const banner = await window.pgAds.requestOutOfPageAd('interstitial');
        
        if (banner.state === 'ready') {
            banner.show();
        } else if (banner.state === 'empty') {
             // No ad available
        } else {
            banner.addEventListener('ready', () => {
                banner.show();
            });
            banner.addEventListener('empty', () => {
                // No ad available
            });
        }
    });

Show Rewarded

window.$msstart.loadAdsAsync(true)
    .then((msnAd) => window.$msstart.showAdsAsync(msnAd.instanceId))
    .catch(() => {
        const banner = await window.pgAds.requestOutOfPageAd('rewarded');

        if (banner.state === 'ready') {
            banner.show();
        } else if (banner.state === 'empty') {
             // No ad available
        } else {
            banner.addEventListener('ready', () => {
                banner.show();
            });
            banner.addEventListener('empty', () => {
                // No ad available
            });
        }
        
        banner.addEventListener('rewarded', () => {
            console.log('Grant reward to user');
        });
    });