このガイドでは、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 ダッシュボードに追加します。
![](https://developers.google.cn/admob/images/mediation/imobile/select_platform_Android.png?authuser=0&hl=ja)
フォームに入力し、[新規登録] ボタンをクリックします。
![](https://developers.google.cn/admob/images/mediation/imobile/add_app_name_Android.png?authuser=0&hl=ja)
新しい広告スポットを作成するには、[サイト / アプリ管理(サイト / アプリケーション管理)] タブでアプリを選択します。
![](https://developers.google.cn/admob/images/mediation/imobile/app_list_Android.png?authuser=0&hl=ja)
[広告スポット管理(広告スポット管理)] タブに移動し、[新規広告スポット(新しい広告スポット)] ボタンをクリックします。
次に、「広告スポット名(広告スポット名)」や「広告スポットサイズ(広告スポットのサイズ)」などの情報をフォームに記入します。次に、[新規登録] ボタンをクリックします。
新しい広告スポットの準備ができました。統合の詳細を表示するには、[アプリ設定取得(App settings を取得)] ボタンをクリックします。
パブリッシャー ID(パブリッシャー ID)、メディア ID(メディア ID)、スポット ID(スポット ID)をメモします。これらのパラメータは、後で UI でメディエーション用に i-Mobile を設定するときに必要になります。 Ad Manager
![](https://developers.google.cn/admob/images/mediation/imobile/ad_spot_details_Android.png?authuser=0&hl=ja)
ステップ 2: 管理画面で i-mobile デマンドを設定する Ad Manager
広告ユニットのメディエーション設定を行う
アド マネージャー アカウントにログインします。
[配信] > [収益グループ] に移動して、[新しい収益グループ] ボタンをクリックします。
収益グループの一意の名前を入力し、[ステータス] を [有効] に設定して [広告フォーマット] を選択し、[広告枠のタイプ] を [モバイルアプリ] に設定します。[ターゲティング] > [広告枠] で、[広告枠] と [モバイル アプリケーション] でメディエーションを追加する広告ユニットを選択します。
次に、[収益パートナーを追加] ボタンをクリックします。
「i-mobile」の収益パートナーがすでにある場合は、そのパートナーを選択できます。それ以外の場合は、[新しい収益パートナーを作成] を選択します。
[広告ネットワーク] として i-mobile を選択し、固有の名前を入力して [メディエーション] を有効にします。
[自動データ収集] をオンにして、前のセクションで取得したLogin name and API Password
[収益パートナー] を選択したら、[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [Android]、[ステータス] として [有効] を選択します。前のセクションで取得したPublisher ID, Media ID and Spot 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.2.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: 実装をテストする
テスト広告を有効にする
Ad Manager。 i-mobile ではテスト用のスポット ID、メディア ID、パブリッシャー ID を提供しています。こちらで確認できます。
テスト広告を確認する
i-mobileからテスト広告を受信していることを確認するには、広告インスペクタで i-mobile (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
省略可能なステップ
ネイティブ広告を使用する
広告のレンダリング
i-mobile アダプターによって、
NativeAd
について以下の
フィールド
が入力されます。
項目 | i-mobile アダプタに常に含まれるアセット |
---|---|
見出し | |
画像 | |
本文 | |
アプリのアイコン | 1 |
行動を促すフレーズ | |
評価 | |
ストア | |
Price |
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 | UI で設定した Ad Manager i-mobile サーバー パラメータがないか、無効です。 |
103 | リクエストされた広告サイズは、i-mobile でサポートされているバナーサイズと一致しません。 |
104 | i-mobile のネイティブ広告の読み込み成功コールバックから、空のネイティブ広告リストが返されました。 |
0-10 | i-mobile SDK からエラーが返されました。詳しくは、コードをご覧ください。 |
101 | UI で設定した Ad Manager i-mobile サーバー パラメータがないか、無効です。 |
102 | リクエストされた広告サイズは、i-mobile でサポートされているバナーサイズと一致しません。 |
103 | i-mobile が広告を表示できませんでした。 |
104 | i-mobile が空のネイティブ広告配列を返しました。 |
105 | i-mobile がネイティブ広告アセットをダウンロードできませんでした。 |
106 | i-mobile では、同じ Spot ID を使用して複数のインタースティシャル広告をリクエストすることはできません。 |
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 Kubernetes Engine
- Google Mobile Ads SDK バージョン 20.5.0.
- IMobile SDK バージョン 2.0.23。
バージョン 2.0.22.2
- 標準化されたアダプターのエラーコードとメッセージを追加しました。
- 必要な最小バージョンの Google Mobile Ads SDK を 20.1.0 に更新しました。
Google Kubernetes Engine
- Google Mobile Ads SDK バージョン 20.1.0.
- IMobile SDK バージョン 2.0.22。
バージョン 2.0.22.1
- 必要な最小バージョンの Google Mobile Ads SDK を 20.0.0 に更新しました。
Google Kubernetes Engine
- Google Mobile Ads SDK バージョン 20.0.0 にアップデートします。
- IMobile SDK バージョン 2.0.22。
バージョン 2.0.22.0
- i-mobile SDK v2.0.22 との互換性を検証しました。
- インライン アダプティブ バナー リクエストをサポートするようにアダプタを更新しました。
Google Kubernetes Engine
- 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 Kubernetes Engine
- Google Mobile Ads SDK バージョン 19.1.0.
- IMobile SDK バージョン 2.0.21.
バージョン 2.0.20.2
- 柔軟なバナー広告のサポートが追加されました。
- 必要な最小バージョンの Google Mobile Ads SDK を 18.3.0 に更新しました。
Google Kubernetes Engine
- Google Mobile Ads SDK バージョン 18.3.0.
- IMobile SDK バージョン 2.0.20.
バージョン 2.0.20.1
- アダプターがゼロ以外の
mediaContent
アスペクト比を返すようになりました。
Google Kubernetes Engine
- Google Mobile Ads SDK バージョン 18.2.0.
- IMobile SDK バージョン 2.0.20.
バージョン 2.0.20.0
- 初回リリース
- バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。