このガイドでは、Google Mobile Ads SDK を使用し、メディエーションを使って Maio から広告を読み込み、表示する方法を説明します。ここでは、ウォーターフォールの統合についても説明します。ここでは、広告ユニットのメディエーション設定に maio を追加する方法と、maio SDK とアダプタを Unity アプリに統合する方法について説明します。
maio のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、ここで説明する説明や手順では、対応する英語のラベルやボタンを使用しています。「URL 候補」は“URL Scheme”などです
サポートされている統合と広告フォーマット
maio 用メディエーション アダプタの機能は次のとおりです。
統合 | |
---|---|
入札 | |
ウォーターフォール | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 |
要件
- Unity 4 以降
- 最新の Google Mobile Ads SDK
- Android にデプロイするには
- Android API レベル 21 以降
- iOS にデプロイするには
- iOS デプロイ ターゲットが 12.0 以降であること
- Google Mobile Ads SDK で構成された Unity プロジェクトが動作している。詳しくは、使ってみるをご覧ください。
- メディエーションのスタートガイドを完了している
ステップ 1: maio UI で設定をセットアップする
まず、maio アカウントに登録またはログインします。左側のサイドバーにある [アプリケーション管理] ボタンをクリックし、[新しいアプリ] をクリックします。
目的の広告タイプに対応するタブを選択します。
インタースティシャル
アプリの名前を入力し、プラットフォームを選択して、アプリの URL を入力します。広告タイプとして [動画インタースティシャル] を選択し、[更新] をクリックします。
Android
iOS
特典
アプリの名前を入力し、プラットフォームを選択して、アプリの URL を入力します。広告タイプとして [動画リワード] を選択し、[更新] をクリックします。
Android
iOS
[アプリケーション管理] ページで、[メディア ID] をメモします。これは、次のセクションで Ad Manager 広告ユニットを設定するために必要です。
Android
iOS
[ゾーン管理] ページで、[ゾーン ID] をメモします。また、次のセクションで広告ユニットを設定するときにも必要になります。 Ad Manager
Android
iOS
ステップ 2: 管理画面で Ad Manager メインのデマンドを設定する
広告ユニットのメディエーション設定を行う
ステップ 3: maio SDK とアダプタをインポートする
maio 用の変更履歴にあるダウンロード リンクから maio 用 Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsMaioMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで [Assets] > [Import Package] > [Custom
Package] を選択し、ダウンロードした GoogleMobileAdsMaioMediation.unitypackage
ファイルを見つけます。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import](インポート)をクリックします。
次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play 開発者サービス リゾルバ ライブラリは、依存関係の解決をゼロから実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: 必要なコードを追加する
Android
maio 統合には追加のコードは必要ありません。
iOS
SKAdNetwork との統合
maio のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist
ファイルに追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
Ad Manager。
Google Mobile Ads SDK のバージョン 7.26.0 以降を使用している場合、リクエストの送信時に、テストデバイスとして登録されているスマートフォンやタブレットに maio からテスト広告が自動的に送信されます。
テスト広告を確認する
maioからテスト広告を受信していることを確認するには、広告インスペクタで 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 | マイオさんには広告がありません。 |
102 | サーバー パラメータが無効です(プレースメント ID が指定されていないなど)。 |
103 | 広告の読み込みに使用されたコンテキストが「Activity」インスタンスではありません。 |
iOS
エラーコード | 理由 |
---|---|
0-10 | maio が SDK 固有のエラーを返しました。詳しくは、maio のコードをご覧ください。 |
101 | maio にはまだ広告がありません。 |
102 | サーバー パラメータが無効です(プレースメント ID が指定されていないなど)。 |
103 | maio アダプタは、リクエストされた広告フォーマットに対応していません。 |
104 | このネットワーク設定の広告はすでに読み込まれています。 |
maio Unity メディエーション プラグインの変更履歴
バージョン 2.0.2
- maio Android アダプター バージョン 1.1.16.3 をサポートしています。
- maio iOS アダプター バージョン 2.1.4.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 2.0.1
- maio Android アダプター バージョン 1.1.16.2 をサポートしています。
- maio iOS アダプター バージョン 2.1.3.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 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 Plugin バージョン 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 をサポートしています。