このガイドでは、Google Mobile Ads SDK を使用して、ウォーターフォール統合をカバーするメディエーションによって maio から広告を読み込んで表示する方法について説明します。ここでは、広告ユニットのメディエーション設定に maio を追加する方法と、maio SDK とアダプタを Unity アプリに統合する方法について説明します。
maio のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、ここの説明と手順では、ラベルとボタンは英語の同等のものを使用しています。たとえば「URL スキーム」は「URL スキーム」などです。
サポートされている統合と広告フォーマット
maio 用メディエーション アダプタには次の機能があります。
統合 | |
---|---|
入札 | |
ウォーターフォール | |
形式 | |
バナー | |
インタースティシャル | |
特典 |
要件
- Unity 4 以降
- 最新の Google Mobile Ads SDK
- Android にデプロイするには
- Android API レベル 19 以降
- iOS にデプロイする場合
- iOS デプロイ ターゲットが 12.0 以降であること
- Google Mobile Ads SDK を使って動作する Unity プロジェクトが設定されていること。詳しくは、使ってみるをご覧ください。
- メディエーションのスタートガイドを完了します。
ステップ 1: maio UI で設定を行う
まず、maio アカウントに登録またはログインします。左側のサイドバーにある [アプリケーション管理] ボタンをクリックし、[新しいアプリ] をクリックします。
目的の広告タイプに対応するタブを選択します。
インタースティシャル
アプリの名前を入力し、プラットフォームを選択して、アプリの URL を入力します。広告タイプとして [動画インタースティシャル] を選択し、[更新] をクリックします。
Android
iOS
特典
アプリの名前を入力し、プラットフォームを選択して、アプリの URL を入力します。広告タイプとして [動画リワード] を選択し、[更新] をクリックします。
Android
iOS
[アプリケーション管理] ページで、[メディア ID] をメモします。これは、次のセクションで AdMob 広告ユニットを設定するために必要です。
Android
iOS
[ゾーン管理] ページで、[ゾーン ID] をメモします。また、次のセクションで広告ユニットを設定するときにも必要になります。 AdMob
Android
iOS
ステップ 2: 管理画面で maio デマンドを AdMob 設定する
広告ユニットのメディエーション設定を行う
ステップ 3: maio SDK とアダプターをインポートする
maio の変更履歴のダウンロード リンクから maio 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsMaioMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom
Package] を選択し、ダウンロードした GoogleMobileAdsMaioMediation.unitypackage
ファイルを見つけます。すべてのファイルが選択されていることを確認し、[Import] をクリックします。
次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolver] を選択します。Unity Play Services Resolver ライブラリは、依存関係の解決をゼロから行い、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: 必要なコードを追加する
Android
maio との統合には、追加のコードは必要ありません。
iOS
SKAdNetwork との統合
maio のドキュメントに沿って、プロジェクトの Info.plist
ファイルに SKAdNetwork ID を追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob。
Google Mobile Ads SDK のバージョン 7.26.0 以降を使用している場合、リクエストの送信時に、テストデバイスとして登録されているスマートフォンやタブレットに maio からテスト広告が自動的に送信されます。
テスト広告を確認する
maioからテスト広告を受信していることを確認するには、広告インスペクタで maio (Bidding) and maio (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
エラーコード
アダプタが maio から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo
を使用して、広告レスポンスの根本的なエラーを確認できます。
Android
形式 | クラス名 |
---|---|
インタースティシャル | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
特典 | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
形式 | クラス名 |
---|---|
インタースティシャル | GADMMaioInterstitialAdapter |
特典 | GADMMaioRewardedAdapter |
広告の読み込みに失敗したときに maio アダプタによってスローされるコードと付随するメッセージは次のとおりです。
Android
エラーコード | 理由 |
---|---|
0-10 | maio が SDK 固有のエラーを返しました。詳細については、code と maio のドキュメントをご覧ください。 |
101 | Maio には広告がありません。 |
102 | サーバー パラメータが無効です(プレースメント ID が指定されていないなど)。 |
103 | 広告の読み込みに使用されたコンテキストが「Activity」インスタンスではありません。 |
iOS
エラーコード | 理由 |
---|---|
0-10 | maio が SDK 固有のエラーを返しました。詳しくは、maio のコードをご覧ください。 |
101 | maio にはまだ広告がありません。 |
102 | サーバー パラメータが無効です(プレースメント ID が指定されていないなど)。 |
103 | maio アダプターは、リクエストされた広告フォーマットをサポートしていません。 |
104 | このネットワーク設定の広告はすでに読み込まれています。 |
maio Unity メディエーション プラグインに関する変更履歴
バージョン 2.0.0
- maio Android アダプター バージョン 1.1.16.2 をサポートしています。
- maio iOS アダプタ バージョン 2.1.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 8.6.0 でビルドおよびテストされています。
バージョン 1.4.3
- アダプターのコンテンツを
GoogleMobileAds/Mediation/Maio/
に移動しました。 - maio Android アダプター バージョン 1.1.16.2 をサポートしています。
- maio iOS アダプタ バージョン 1.6.3.1 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 8.1.0 でビルドおよびテストされています。
バージョン 1.4.2
- maio Android アダプター バージョン 1.1.16.1 をサポートします。
- maio iOS アダプタ バージョン 1.6.3.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.4.0 でビルドおよびテストされています。
バージョン 1.4.1
- maio Android アダプター バージョン 1.1.16.1 をサポートします。
- maio iOS アダプタ バージョン 1.6.2.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.1.0 でビルドおよびテストされています。
バージョン 1.4.0
- maio Android アダプター バージョン 1.1.16.0 をサポートします。
- maio iOS アダプタ バージョン 1.6.0.1 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルドおよびテストされています。
バージョン 1.3.6
- maio Android アダプター バージョン 1.1.16.0 をサポートします。
- maio iOS アダプタ バージョン 1.5.8.0 をサポートします。
バージョン 1.3.5
- maio Android アダプター バージョン 1.1.15.0 をサポートしています。
- maio iOS アダプタ バージョン 1.5.6.1 をサポートします。
バージョン 1.3.4
- maio Android アダプター バージョン 1.1.11.1 をサポートしています。
- maio iOS アダプタ バージョン 1.5.4.0 をサポートします。
バージョン 1.3.3
- maio Android アダプター バージョン 1.1.11.1 をサポートしています。
- maio iOS アダプタ バージョン 1.5.3.1 をサポートします。
バージョン 1.3.2
- maio Android アダプター バージョン 1.1.11.0 をサポートします。
- maio iOS アダプタ バージョン 1.5.2.1 をサポートします。
バージョン 1.3.1
- maio Android アダプター バージョン 1.1.10.0 をサポートしています。
- maio iOS アダプタ バージョン 1.5.1.0 をサポートします。
バージョン 1.3.0
- maio Android アダプター バージョン 1.1.10.0 をサポートしています。
- maio iOS アダプタ バージョン 1.5.0.0 をサポートします。
バージョン 1.2.3
- 新しい リワード広告 API をサポートするようにプラグインを更新しました。
- maio Android アダプター バージョン 1.1.7.0 をサポートしています。
- maio iOS アダプタ バージョン 1.4.6.0 をサポートしています。
バージョン 1.2.2
- maio Android アダプター バージョン 1.1.6.0 をサポートしています。
- maio iOS アダプタ バージョン 1.4.2.0 をサポートしています。
バージョン 1.2.1
- maio Android アダプター バージョン 1.1.6.0 をサポートしています。
- maio iOS アダプタ バージョン 1.4.1.0 をサポートしています。
バージョン 1.2.0
- maio Android アダプター バージョン 1.1.4.1 をサポートしています。
- maio iOS アダプタ バージョン 1.4.0.0 をサポートしています。
バージョン 1.1.3
- maio Android アダプター バージョン 1.1.3.1 をサポートしています。
- maio iOS アダプタ バージョン 1.3.2.0 をサポートしています。
バージョン 1.1.2
- maio Android アダプター バージョン 1.1.3.0 をサポートしています。
- maio iOS アダプタ バージョン 1.3.2.0 をサポートしています。
バージョン 1.1.1
- maio Android アダプター バージョン 1.1.1.0 をサポートしています。
- maio iOS アダプタ バージョン 1.3.1.1 をサポートしています。
バージョン 1.1.0
- maio Android アダプター バージョン 1.1.0.0 をサポートしています。
- maio iOS アダプタ バージョン 1.3.0.0 をサポートしています。
バージョン 1.0.2
- maio Android SDK バージョン 1.0.8 をサポートしています。
- maio iOS SDK バージョン 1.2.19 をサポートしています。
バージョン 1.0.1
- maio Android SDK バージョン 1.0.7 をサポートしています。
- maio iOS SDK バージョン 1.2.19 をサポートしています。
バージョン 1.0.0
- 初回リリース
- maio Android SDK バージョン 1.0.6 をサポートしています。
- maio iOS SDK バージョン 1.2.18 をサポートしています。