i-mobile とメディエーションを統合する

このガイドでは、Google Mobile Ads SDK でメディエーションを使用して i-mobile の広告を読み込んで表示する方法を説明します。ウォーターフォールの統合についても説明します。また、広告ユニットのメディエーション設定に i-mobile を追加する方法と、i-mobile SDK とアダプタを Android アプリに統合する方法についても取り上げます。

i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは英語の同等の単語が括弧内に記載されています。

サポートされている統合と広告フォーマット

i-mobile 用のメディエーション アダプタには、次の機能があります。

要件

• Android API レベル 23 以上

• Google Mobile Ads SDK のバージョンが最新であること

• メディエーションのスタートガイドの手順を完了していること

ステップ 1: i-mobile の管理画面で構成を設定する

i-mobile アカウントに登録またはログインします。

[サイト／アプリ管理] タブとアプリのプラットフォームのボタンをクリックして、i-mobile ダッシュボードにアプリを追加します。

フォームに記入し、[新規登録] ボタンをクリックします。

新しい広告枠を作成するには、[サイト/アプリ管理] タブでアプリを選択します。

[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。

次に、広告スポット名、広告スポット サイズなどの詳細を入力してフォームに記入します。[新規登録] ボタンをクリックします。

新しい広告枠が完成しました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。

パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後でアド マネージャー UI でメディエーション用に i-mobile を設定する際に必要になります。

app-ads.txt を更新する

Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。

i-mobile に app-ads.txt を実装するには、よくある質問をご覧ください。

ステップ 2: アド マネージャーの管理画面で i-mobile のデマンドを設定する

広告ユニットのメディエーション設定を構成する

アド マネージャー アカウントにログインします。

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。

収益グループの固有の名前を入力し、[ステータス] を [有効] に設定します。広告フォーマットを選択し、[広告枠タイプ] を [モバイルアプリ] に設定します。 [ターゲティング > 広告枠] セクションで、メディエーションを追加する [広告枠] と [モバイルアプリ] の広告ユニットを選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

i-mobile の収益パートナーがすでにある場合は、それを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] で [i-mobile] を選択し、一意の名前を入力して、[メディエーション] を有効にします。

[Automatic data collection] をオンにして、[Login name] と [API Password] を入力します。

収益パートナーを選択したら、統合タイプとして [モバイル 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:24.7.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

手動による統合

1. i-mobile SDK の最新バージョンをダウンロードし、sdk フォルダの android-ad-sdk.aar を抽出して、プロジェクトに追加します。

2. Google の Maven リポジトリで i-mobile アダプタ アーティファクトに移動します。最新バージョンを選択し、i-mobile アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。

ステップ 4: 必要なコードを追加する

アクティビティ コンテキストで広告を読み込む

バナー広告、インタースティシャル広告、リワード広告、ネイティブ広告の各フォーマットを読み込む際は、Activity コンテキストを渡します。アクティビティ コンテキストがないと、広告の読み込みは失敗します。

ステップ 5: 実装をテストする

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録してください。i-mobile はテスト用のスポット ID、メディア ID、パブリッシャー ID を提供しています。こちらで確認できます。

テスト広告を確認する

i-mobile からテスト広告を受信していることを確認するには、i-mobile（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

省略可能なステップ

ネイティブ広告を使用する

広告のレンダリング

i-mobile アダプタは、NativeAd の次のフィールドに入力します。

¹ ネイティブ広告の場合、i-mobile SDK はアプリ アイコン アセットを提供しません。代わりに、i-mobile アダプタは透明な画像でアプリアイコンを設定します。

エラーコード

アダプタが i-mobile から広告を受信できなかった場合は、次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスから根本原因のエラーを確認できます。

広告の読み込みに失敗した場合に i-mobile アダプタがスローするコードとメッセージは次のとおりです。

i-mobile Android メディエーション アダプタの変更履歴

バージョン 2.3.2.1

• 必要な最小 Android API レベルを 23 に更新しました。
• Google Mobile Ads SDK の必要最小限のバージョンを 24.0.0 に更新しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.0.0。
• IMobile SDK バージョン 2.3.2。

バージョン 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

• アダプターが 0 以外の mediaContent アスペクト比を返すようになりました。

構築およびテストに使用したバージョン

• Google Mobile Ads SDK バージョン 18.2.0。
• IMobile SDK バージョン 2.0.20。

バージョン 2.0.20.0

• 初回リリース
• バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。