このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを使用して i-mobile から広告を読み込んで表示する方法について説明します。ウォーターフォール統合についても説明します。ここでは、i-mobile を広告ユニットのメディエーション構成に追加する方法と、i-mobile SDK とアダプタを Android アプリに統合する方法について説明します。
i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されます。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは翻訳され、英語の同義語がかっこで囲まれて表示されます。
サポートされている統合と広告フォーマット
i-mobile のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 単価設定 | |
| 滝 | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| ネイティブ | |
要件
- Android API レベル 21 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 1: i-mobile UI で設定を行う
[サイト/アプリ管理] タブと、アプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。
フォームに入力し、[新規登録] ボタンをクリックします。
新しい広告スポットを作成するには、[サイト/アプリ管理] タブでアプリを選択します。
[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。
次に、フォームに広告スポット名（Ad Spot name）、広告スポットサイズ（Ad Spot size）などの詳細情報を入力します。[新規登録] ボタンをクリックします。
新しい広告スポットが作成されました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。
パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後でアド マネージャー UI でメディエーション用に i-mobile を構成する際に必要になります。
ステップ 2: アド マネージャーの管理画面で i-mobile デマンドを設定する
広告ユニットのメディエーション設定を構成する
アド マネージャー アカウントにログインします。
[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。
収益グループの一意の名前を入力し、ステータスを [有効] に設定し、広告フォーマットを選択し、広告枠タイプを [モバイルアプリ] に設定します。[ターゲティング > 広告枠] セクションで、メディエーションを追加する広告ユニットを [広告枠] と [モバイルアプリ] で選択します。
次に、[収益パートナーを追加] ボタンをクリックします。
i-mobile の収益パートナーをすでにご利用の場合は、そのパートナーを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。
[広告ネットワーク] として [i-mobile] を選択し、一意の名前を入力して、[メディエーション] を有効にします。
[データの自動収集] をオンにして、ログイン名と API パスワードを入力します。
[収益パートナー] を選択したら、[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [Android]、[ステータス] として [有効] を選択します。前のセクションで取得したパブリッシャー ID、メディア ID、スポット ID を入力します。次に、[デフォルト CPM] の値を入力します。
完了したら、ページの下部にある [保存] をクリックします。
ステップ 3: i-mobile SDK とアダプタをインポートする
Android Studio との統合（推奨）
プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
次に、アプリレベルの build.gradle.kts ファイルで、次の実装依存関係と構成を追加します。i-mobile SDK とアダプタの最新バージョンを使用します。
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
手動による統合
最新バージョンの i-mobile SDK をダウンロードし、
sdkフォルダにandroid-ad-sdk.aarを抽出してプロジェクトに追加します。Google の Maven リポジトリで i-mobile アダプター アーティファクトに移動します。最新バージョンを選択し、i-mobile アダプターの
.aarファイルをダウンロードしてプロジェクトに追加します。
ステップ 4: 必要なコードを追加する
i-mobile の統合に追加のコードは必要ありません。
ステップ 5: 実装をテストする
テスト広告を有効にする
アド マネージャーでテストデバイスを登録してください。 i-mobile では、テスト用のSpot ID、Media ID、Publisher ID を提供しています。テスト用 ID は こちらで確認できます。
テスト広告を確認する
i-mobile からテスト広告が配信されていることを確認するには、広告インスペクタで i-mobile（ウォーターフォール）広告ソースを使用して単一の広告ソースをテストします。
省略可能なステップ
ネイティブ広告を使用する
広告のレンダリング
i-mobile アダプタは、NativeAd の次のフィールドに値を入力します。
| フィールド | i-mobile アダプタによって常に含まれるアセット |
|---|---|
| 広告見出し | |
| 画像 | |
| 本文 | |
| アプリのアイコン | 1 |
| 行動を促すフレーズ | |
| 評価 | |
| ストア | |
| 価格 |
1 ネイティブ広告の場合、i-mobile SDK はアプリアイコン アセットを提供しません。代わりに、i-mobile アダプタはアプリアイコンに透明な画像を配置します。
エラーコード
アダプターが i-mobile から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスから根本的なエラーを確認できます。
| 形式 | クラス名 |
|---|---|
| バナー | com.google.ads.mediation.imobile.IMobileAdapter |
| インタースティシャル | com.google.ads.mediation.imobile.IMobileAdapter |
| ネイティブ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
広告の読み込みに失敗したときに i-mobile アダプターからスローされるコードと付随するメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| 0-99 | i-mobile SDK からエラーが返されました。詳しくは、コードをご覧ください。 |
| 101 | i-mobile では、広告を読み込むために Activity コンテキストが必要です。 |
| 102 | アド マネージャーの管理画面で設定された i-mobile サーバー パラメータが存在しないか、無効です。 |
| 103 | リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。 |
| 104 | i-mobile のネイティブ コンテンツ広告の読み込み成功コールバックから、空のネイティブ コンテンツ広告リストが返されました。 |
i-mobile Android メディエーション アダプターの変更履歴
バージョン 2.3.2.0
- i-mobile SDK v2.3.2 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.1.0。
- IMobile SDK バージョン 2.3.2。
バージョン 2.3.1.2
- 必須の Google Mobile Ads SDK バージョンを 23.0.0 に更新しました。
- i-mobile SDK v2.3.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- IMobile SDK バージョン 2.3.1。
バージョン 2.3.1.1
- 新しい
VersionInfoクラスを使用するようにアダプターを更新しました。 - 必須の Google Mobile Ads SDK バージョンを 22.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0。
- IMobile SDK バージョン 2.3.1。
バージョン 2.3.1.0
- i-mobile SDK v2.3.1 との互換性を確認しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 21.5.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- IMobile SDK バージョン 2.3.1。
バージョン 2.3.0.0
- i-mobile SDK v2.3.0 との互換性を確認しました。
- 必須の Google Mobile Ads SDK バージョンを 21.3.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.3.0。
- IMobile SDK バージョン 2.3.0。
バージョン 2.0.23.1
compileSdkVersionとtargetSdkVersionを API 31 に更新しました。- 必須の Google Mobile Ads SDK バージョンを 21.0.0 に更新しました。
- 必要最小限の Android API レベルを 19 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.0.0。
- IMobile SDK バージョン 2.0.23。
バージョン 2.0.23.0
- i-mobile SDK v2.0.23 との互換性を確認しました。
- 必須となる Google Mobile Ads SDK のバージョンを 20.5.0 に更新しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 20.5.0。
- IMobile SDK バージョン 2.0.23。
バージョン 2.0.22.2
- 標準化されたアダプタのエラーコードとメッセージを追加しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 20.1.0 に更新しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 20.1.0。
- IMobile SDK バージョン 2.0.22。
バージョン 2.0.22.1
- 必要最小限の Google Mobile Ads SDK バージョンを 20.0.0 に更新しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 20.0.0。
- IMobile SDK バージョン 2.0.22。
バージョン 2.0.22.0
- i-mobile SDK v2.0.22 との互換性が確認されました。
- インライン アダプティブ バナー リクエストをサポートするようにアダプターを更新しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 19.1.0。
- IMobile SDK バージョン 2.0.22。
バージョン 2.0.21.0
- i-mobile SDK v2.0.21 との互換性を確認しました。
- 必須となる Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。
- アダプティブ バナー広告のスケーリングのサポートを追加しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 19.1.0。
- IMobile SDK バージョン 2.0.21。
バージョン 2.0.20.2
- 柔軟なバナー広告サイズのサポートを追加しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 18.3.0 に更新しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 18.3.0。
- IMobile SDK バージョン 2.0.20。
バージョン 2.0.20.1
- アダプターがゼロ以外の
mediaContentアスペクト比を返すようになりました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 18.2.0。
- IMobile SDK バージョン 2.0.20。
バージョン 2.0.20.0
- 初回リリース
- バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。