このガイドでは、Google Mobile Ads SDK を使用して、メディエーションで Moloco の広告を読み込んで表示する方法を説明します。入札統合についても説明します。このガイドでは、広告ユニットのメディエーション設定に Moloco を追加する方法と、Moloco SDK とアダプタを Unity アプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
Moloco の AdMob メディエーション アダプタには、次の機能があります。
統合 | |
---|---|
入札単価 | 1 |
滝 | |
フォーマット | |
アプリの起動 | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル |
1 入札の統合はクローズド ベータ版です。
要件
- 最新の Google Mobile Ads SDK
- Unity 5.6 以降
- Moloco Unity プラグイン 1.2.0 以降
- Android にデプロイするには
- Android API レベル 23 以降
- iOS にデプロイするには
- iOS のデプロイ ターゲットが 12.0 以降
- Google Mobile Ads SDK が構成された Unity プロジェクト。詳しくは、スタートガイドをご覧ください。
- メディエーションのスタートガイドの手順を完了していること
ステップ 1: Moloco UI で設定を行う
Moloco パブリッシャー ポータルにログインします。
[概要] > [アプリ] タブに移動し、[アプリを追加] ボタンをクリックして新しいアプリを作成します。
アプリの [OS] と [プライバシー設定] を選択し、フォームの残りの部分を入力して、[作成] をクリックします。
Android
iOS
アプリを作成したら、[アプリ] タブからアプリを選択して詳細を表示し、アプリキーをメモします。
Android
iOS
[概要] > [広告ユニット] タブに移動し、プルダウン メニューからアプリを選択して、[新しい広告ユニット] をクリックします。
[オークション方法] で [アプリ内入札] を選択し、フォームの残りの部分を入力します。次に、[作成] をクリックします。
[広告ユニット] タブで、新しく作成した広告ユニットに移動して詳細を表示します。広告ユニット ID をメモします。
ステップ 2: AdMob の管理画面で Moloco のデマンドを設定する
広告ユニットのメディエーション設定を構成する
GDPR と米国の州の規制の広告パートナー リストに Moloco Ads を追加
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州の規制と米国の州の規制に関する広告パートナーのリストに Moloco Ads を追加します。
ステップ 3: Moloco SDK とアダプタをインポートする
OpenUPM-CLI
OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Google Mobile Ads Moloco Ads SDK Mediation Plugin for Unity をプロジェクトにインストールできます。
openupm add com.google.ads.mobile.mediation.moloco
OpenUPM
Unity プロジェクト エディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager Settings を開きます。
[Scoped Registries] タブで、次の詳細を使用して OpenUPM をスコープ付きレジストリとして追加します。
- 名前:
OpenUPM
- URL:
https://package.openupm.com
- スコープ:
com.google
次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。
[Google Mobile Ads Moloco Mediation] パッケージを選択し、[インストール] をクリックします。
Unity パッケージ
変更ログのダウンロード リンクから、Moloco Ads SDK 用の最新バージョンの Google Mobile Ads メディエーション プラグインをダウンロードし、ZIP ファイルから GoogleMobileAdsMolocoMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsMolocoMediation.unitypackage
ファイルを探します。すべてのファイルが選択されていることを確認して、[インポート] をクリックします。
次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリは、依存関係の解決を最初から実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: 必要なコードを追加する
Moloco との統合に、追加のコードは必要ありません。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob 用にテストデバイスを登録してください。
テスト広告を確認する
Moloco Ads SDK からテスト広告を受け取っていることを確認するには、Moloco(入札)の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
エラーコード
アダプタが Moloco から広告を受け取れなかった場合、パブリッシャーは次のクラスの ResponseInfo
を使用して、広告レスポンスから根本原因のエラーを確認できます。
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
広告の読み込みに失敗した場合に Moloco アダプタがスローするコードとメッセージは次のとおりです。
Android
エラーコード | ドメイン | 理由 |
---|---|---|
101 | com.google.ads.mediation.moloco | Moloco アプリキーがないか、無効です。 |
102 | com.google.ads.mediation.moloco | Moloco 広告ユニット ID がないか、無効です。 |
103 | com.google.ads.mediation.moloco | 返された Moloco 広告オブジェクトが null でした。 |
-1 ~ 5000 | com.moloco.sdk | Moloco SDK がエラーを返しました。詳しくは、Moloco のドキュメントをご覧ください。 |
iOS
エラーコード | ドメイン | 理由 |
---|---|---|
101 | com.google.ads.mediation.moloco | Moloco SDK は、iOS 12 以前での広告配信をサポートしていません。 |
102 | com.google.ads.mediation.moloco | Moloco アプリキーがないか、無効です。 |
103 | com.google.ads.mediation.moloco | Moloco 広告ユニット ID がないか、無効です。 |
104 | com.google.ads.mediation.moloco | 広告を表示する準備ができていません。 |
105 | com.google.ads.mediation.moloco | 広告が表示されませんでした。 |
106 | com.google.ads.mediation.moloco | 広告をレンダリングするためのレンダリング データがありません。 |
-1 ~ 5000 | Moloco SDK によって送信 | Moloco SDK がエラーを返しました。詳しくは、Moloco のドキュメントをご覧ください。 |
リワードのサーバーサイド検証
サーバーサイド認証(SSV)コールバックを検証する場合、Moloco の広告ソース ID は 8267622065755668722
です。
Moloco Unity メディエーション プラグインの変更履歴
バージョン 1.5.0
- Moloco Android アダプタ バージョン 3.11.0.0 をサポートしています。
- Moloco iOS アダプタ バージョン 3.11.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 10.3.0 でビルドおよびテストされています。
バージョン 1.4.0
- Moloco Android アダプタ バージョン 3.10.0.0 をサポートします。
- Moloco iOS アダプター バージョン 3.10.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 10.2.0 でビルドおよびテスト済み。
バージョン 1.3.1
- Moloco Android アダプタ バージョン 3.9.0.0 をサポートしています。
- Moloco iOS アダプタ バージョン 3.9.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 10.1.0 でビルドおよびテストされています。
バージョン 1.3.0
- Moloco Android アダプタ バージョン 3.9.0.0 をサポートしています。
- Moloco iOS アダプタ バージョン 3.9.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 10.1.0 でビルドおよびテストされています。
バージョン 1.2.1
- Moloco Android アダプタ バージョン 3.8.0.1 をサポートしています。
- Moloco iOS アダプター バージョン 3.8.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 10.0.0 でビルドおよびテストされています。
バージョン 1.2.0
- Moloco Android アダプタ バージョン 3.8.0.0 をサポートしています。
- Moloco iOS アダプター バージョン 3.8.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 10.0.0 でビルドおよびテストされています。
バージョン 1.1.0
- Moloco Android アダプタ バージョン 3.7.2.0 をサポートしています。
- Moloco iOS アダプター バージョン 3.7.2.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 10.0.0 でビルドおよびテストされています。
バージョン 1.0.0
- 初回リリース!
- Moloco Android アダプタ バージョン 3.7.0.0 をサポートしています。
- Moloco iOS アダプター バージョン 3.6.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.6.0 でビルドおよびテストされています。