ironSourceプレイアブル広告（MRAID）

PlayCanvasは、公式の外部ツールを介して、ironSource MRAID Playable Adフォーマットと要件をサポートしていますGitHub。

ironSourceの再生可能な広告はMRAID 2.0 API標準を使用し、広告のアセットは埋め込みではなくindex.htmlの外部にある必要があります。

外部アセットは、ironSourceがネットワーク上で広告を提供するために、独自のサーバーまたはCDNにアップロードする必要があります。

ツールには、GitHubのドキュメントで見つかるいくつかの制限があります。

サンプルプロジェクト

Cube Jump projectは、ironSource MRAID Playable Adフォーマットにエクスポートする準備が整っており、予想されるHTML出力はこちらで見つかります。

ファイルサイズのヒント

非圧縮で5MBの制限があるため、広告のアセットの使用を計画し予算を立てる必要があります。

ミニファイされたPlayCanvasエンジンコードは、 ~ 1.2MB非圧縮であり、アセットファイルをBase64文字列にエンコードする必要があるため、各アセットファイルのサイズに**~30%**追加されます。

これは、Base64エンコード前にアセットに約~3MBの余裕があることを意味します。

画像は可能な限り小さく保ち、TinyPNGのようなツールを使用して、ファイルサイズをさらに縮小してください。

再生可能な広告のチェックリスト:

呼び出しアクションコールバックの一部としてmraid.open(非ストアURL用)またはmraid.openStoreUrl(ストアアプリ用)の関数コールが追加されていますか?

エクスポートの方法

GitHubリポジトリのreadmeからセットアップ手順に従います。

ironSource Playable Test Toolでテストする

ironSourceには、再生可能な広告の要件のチェックリストを実行するために使用できる素晴らしいテストツールがあります。

テストモードとMRAIDの両方がページで有効になっていることを確認してください。

以下のオプションをconfig.jsonで示されるように設定します。これにより、アセットデータとPlayCanvas Engineコードがindex.htmlから別々のファイルとしてZIPファイルが生成されます。

    "one_page": {
        "patch_xhr_out": false,
        "inline_game_scripts": false,
        "extern_files": {
            "enabled": true,
            "folder_name": "assets",
            "external_url_prefix": ""
        },
        "mraid_support": true
    }

そして、コマンドを実行する:

npm run one-page

オプションとコマンドの完全な詳細は、「プロジェクトを単一のHTMLファイルに変換する」のreadmeセクションで見つかります。

ironSourceのテストツールでテストするために、HTTPSエンドポイントからファイルを提供する必要があります。

推奨されるアプローチは、ローカルホストにホストし、ngrokを使用して、コンピューターにHTTPSトンネルを作成してアプリにアクセスすることです。

これにより、エンドポイントの一意のURLが提供され、外部ファイルを参照しているindex.htmlに追加する必要がある。

index.htmlの終わりを以下のように変更します

</style>

    <title>Cube Jump MRAID</title>
    <script src="mraid.js"></script>
    <script src="assets/playcanvas-stable.min.js"></script>
    <script src="assets/one-page-mraid-resize-canvas.js"></script>
    <script src="assets/__settings__.js"></script>
</head>
<body>
    <script src="assets/__start__.js"></script>
</body>
</html>

(XXXXXXXはngrokからのユニークなサブドメインです)。

</style>

    <title>Cube Jump MRAID</title>
    <script src="mraid.js"></script>
    <script src="https://XXXXXXX.ngrok.io/assets/playcanvas-stable.min.js"></script>
    <script src="https://XXXXXXX.ngrok.io/assets/one-page-mraid-resize-canvas.js"></script>
    <script src="https://XXXXXXX.ngrok.io/assets/__settings__.js"></script>
</head>
<body>
    <script src="https://XXXXXXX.ngrok.io/assets/__start__.js"></script>
</body>
</html>

index.html をダブルクリックして、ローカルのPC上でテストし、正しく再生されることを確認してください。

もしPC上で正しく再生される場合は、ironSourceのテストツールでテストすることができます。index.html の内容をコピーして、テストツールのMRAIDタグの領域に貼り付けてください。

「広告をテストする」をクリックし、レンダリングが完了したら、CTAボタンに到達するために広告を再生してください。CTAボタンを押した後、ツールはすべてのテストが合格したことを示し、コードを生成するオプションを提供します。

これは、AndroidとiOSの両方で利用可能な彼らのアプリを使用して、デバイス上でテストするために使用されます。

ironSourceの最終エクスポート

広告がironSourceに提出する準備が整ったら、外部アセットを独自のサーバーまたはCDNにアップロードし、オプションのexternal_url_prefixプロパティを介してconfig.jsonにURLを追加します。

    "one_page": {
        "patch_xhr_out": false,
        "inline_game_scripts": false,
        "extern_files": {
            "enabled": true,
            "folder_name": "assets",
            "external_url_prefix": "https://some-cdn.com/unique-id"
        },
        "mraid_support": true
    }

提出可能な広告の手順については、ironSourceのドキュメントをフォローしてください。