このガイドでは、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 で設定をセットアップする
Sign up or log in to your i-mobile account.
Add your app to the i-mobile dashboard by clicking the サイト/アプリ管理 (Site/Application Management) tab and the button for your app's platform.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/select_platform_Android.png?authuser=3&hl=ja)
Fill out the form and click the 新規登録 (Sign up) button.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/add_app_name_Android.png?authuser=3&hl=ja)
To create a new Advertising Spot, select your app under the サイト/アプリ管理 (Site/Application Management) tab.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/app_list_Android.png?authuser=3&hl=ja)
Navigate to the 広告スポット管理 (Ad Spot Management) tab and click the 新規広告スポット (New Ad Spot) button.
Next, fill out the form by providing the 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) and other details. Then, click the 新規登録 (Sign up) button.
Your new Ad spot is ready. To view its integration details, click the アプリ設定取得 (Get App settings) button.
Take note of the パブリッシャーID (Publisher ID), メディアID (Media ID), and スポットID (Spot ID). You'll need these parameters later when configuring i-mobile for mediation in the Ad Manager UI.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/ad_spot_details_Android.png?authuser=3&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
- 初回リリース
- バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。