このガイドでは、Google Mobile Ads SDK で maio から広告を読み込み、表示する方法を説明します。 メディエーション、でウォーターフォールとの統合をカバーしています。広告ユニットのメディエーション構成に maio を追加する方法と、maio SDK とアダプタをAndroid アプリに統合する方法について説明します。
maio のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは英語で表記しています。たとえば、「URL スキーム」は「URL Scheme」になります。
サポートされている統合と広告フォーマット
maio のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 単価設定 | |
| 滝 | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| ネイティブ | |
要件
- Android API レベル 21 以降
- maio SDK 1.0.7 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 1: maio UI で設定をセットアップする
まず、maio アカウントに登録するかログインします。左側のサイドバーにある [アプリケーション管理] ボタンをクリックし、[新しいアプリ] をクリックします。
ご希望の広告タイプのタブを選択します。
インタースティシャル
アプリの名前を入力し、プラットフォームを選択してアプリの URL を指定します。[広告タイプ] として [動画インタースティシャル] を選択し、[更新] をクリックします。
特典
アプリの名前を入力し、プラットフォームを選択してアプリの URL を指定します。[広告タイプ] として [動画リワード] を選択し、[更新] をクリックします。
[Application Management] ページで、Media ID をメモします。これは、次のセクションで AdMob 広告ユニットを設定する際に必要になります。
[ゾーン管理] ページで、ゾーン ID をメモします。また、次のセクションで AdMob 広告ユニットを設定するときにも必要です。
ステップ 2: Ad Manager UI でマインドオーバーのデマンドを設定する
ステップ 3: maio SDK とアダプターをインポートする
Android Studio との統合（推奨）
プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
次に、アプリレベルの build.gradle.kts ファイルで、次の実装依存関係と構成を追加します。maio SDK とアダプタの最新バージョンを使用します。
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
手動による統合
- maio Android SDK の最新バージョンをダウンロードしてプロジェクトに追加します。
- Google の Maven リポジトリで maio アダプター アーティファクトに移動します。最新バージョンを選択し、Maio アダプターの .aar ファイルをダウンロードしてプロジェクトに追加します。
ステップ 4: 必要なコードを追加する
maio Android との統合にコードを追加する必要はありません。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob 用にテストデバイスを登録してください。
Google Mobile Ads SDK バージョン 11.6.0 以降を使用しているパブリッシャーは、リクエスト時にテストデバイスとして登録されているスマートフォンとタブレットで、maio からテスト広告を自動的に受け取ります。
テスト広告を確認する
maio からテスト広告が配信されていることを確認するには、広告インスペクタで maio（ウォーターフォール）広告ソースを使用して単一の広告ソースのテストを有効にします。
エラーコード
アダプターが maio から広告を受信できない場合、パブリッシャーは
ResponseInfo.getAdapterResponses()
次のクラスで、広告レスポンスから根本的なエラーを確認できます。
| 形式 | クラス名 |
|---|---|
| インタースティシャル | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| 特典 | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
広告の読み込みに失敗したときに、Maio アダプタからスローされるコードと付随するメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| 0-10 | maio から SDK 固有のエラーが返されました。詳細については、コードと maio のドキュメントをご覧ください。 |
| 101 | Maio には広告が表示されません。 |
| 102 | 無効なサーバー パラメータ（プレースメント ID がないなど）。 |
| 103 | 広告の読み込みに使用されたコンテキストが「Activity」インスタンスではありませんでした。 |
maio Android メディエーション アダプターの変更履歴
バージョン 1.1.16.3
- 最低限必要な Google Mobile Ads SDK のバージョンを 23.0.0 に更新しました。
- maio SDK バージョン 1.1.16 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- Maio SDK バージョン 1.1.16。
バージョン 1.1.16.2
- 新しい
VersionInfoクラスを使用するようにアダプターを更新しました。 - 必須の Google Mobile Ads SDK バージョンを 22.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0 にアップデートします。
- Maio SDK バージョン 1.1.16。
バージョン 1.1.16.1
compileSdkVersionとtargetSdkVersionを API 31 に更新しました。- 必須の Google Mobile Ads SDK バージョンを 21.0.0 に更新しました。
- 必要最小限の Android API レベルを 19 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.0.0。
- Maio SDK バージョン 1.1.16。
バージョン 1.1.16.0
- 追加の maio エラーをキャプチャするようにエラーコードを更新しました。
- maio SDK バージョン 1.1.16 との互換性を確認しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 20.4.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.4.0。
- Maio SDK バージョン 1.1.16。
バージョン 1.1.15.0
- maio SDK バージョン 1.1.15 との互換性を検証しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 20.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.0.0。
- Maio SDK バージョン 1.1.15。
バージョン 1.1.14.0
- 標準化されたアダプタのエラーコードとメッセージを追加しました。
- maio SDK バージョン 1.1.14 との互換性を検証しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 19.8.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.8.0。
- Maio SDK バージョン 1.1.14。
バージョン 1.1.13.0
- maio SDK バージョン 1.1.13 との互換性を検証しました。
- 必須となる Google Mobile Ads SDK のバージョンを 19.5.0 に更新しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 19.5.0。
- Maio SDK バージョン 1.1.13。
バージョン 1.1.12.0
- 必要最小限の Google Mobile Ads SDK バージョンを 19.4.0 に更新しました。
以下を使用してビルドとテストを行う:
- Google Mobile Ads SDK バージョン 19.4.0。
- Maio SDK バージョン 1.1.12。
バージョン 1.1.11.1
- タイムアウトを制限するため、maio に表示可能な広告がない場合に広告リクエストが直ちに失敗するようになりました。
- 必須となる Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.1.0。
- Maio SDK バージョン 1.1.11。
バージョン 1.1.11.0
- maio SDK バージョン 1.1.11 との互換性を検証しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 18.3.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 18.3.0.
- Maio SDK バージョン 1.1.11。
バージョン 1.1.10.0
- maio SDK バージョン 1.1.10 との互換性を検証しました。
- 必須となる Google Mobile Ads SDK のバージョンを 18.2.0 に更新しました。
バージョン 1.1.8.0
- maio SDK バージョン 1.1.8 との互換性を検証しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 18.1.0 に更新しました。
バージョン 1.1.7.0
- バグを修正しました。
- maio SDK バージョン 1.1.7 との互換性を検証しました。
バージョン 1.1.6.1
- 新しい Rewarded API をサポートするようにアダプターを更新しました。
- 最低限必要な Google Mobile Ads SDK のバージョンを 17.2.0 に更新しました。
バージョン 1.1.6.0
- maio SDK バージョン 1.1.6 との互換性を検証しました。
バージョン 1.1.5.0
- maio SDK バージョン 1.1.5 との互換性を検証しました。
バージョン 1.1.4.0
- maio SDK バージョン 1.1.4 との互換性を検証しました。
バージョン 1.1.3.1
- シングルトンではなくインスタンス クラスで動作するようにアダプターを更新しました。
バージョン 1.1.3.0
- maio SDK バージョン 1.1.3 との互換性を検証しました。
バージョン 1.1.2.1
- アダプターを更新し、初期化関数を更新しました。
バージョン 1.1.2.0
- maio SDK バージョン 1.1.2 との互換性を検証しました。
バージョン 1.1.1.1
onRewardedVideoComplete()広告イベントを呼び出すようにアダプターを更新しました。
バージョン 1.1.1.0
- maio SDK バージョン 1.1.1 との互換性を確認しました。
バージョン 1.1.0.0
- maio SDK バージョン 1.1.0 との互換性を検証しました。
バージョン 1.0.8.0
- maio SDK バージョン 1.0.8 との互換性を検証しました。
バージョン 1.0.7.1
- 広告の読み込みに失敗したときに NullPointerException が発生する可能性がある問題を修正しました。
バージョン 1.0.7.0
- テストデバイス ID を
AdRequestに追加してテストモードを有効にする機能を追加しました。 - maio SDK バージョン 1.0.7 との互換性が確認されました。
バージョン 1.0.6.0
- 初回リリースです。
- インタースティシャル広告とリワード動画広告のサポートを追加しました。