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

このガイドでは、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 アカウントに登録またはログインします。

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

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

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

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

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

新しい広告スポットを使用できるようになりました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。

パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後で AdMob 管理画面でメディエーション用に i-mobile を構成するときに必要になります。

ステップ 2: Ad Manager UI で i-mobile デマンドを設定する

ステップ 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.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

手動による統合

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

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

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

i-mobile の統合に追加のコードは必要ありません。

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

テスト広告を有効にする

AdMob にテストデバイスを登録してください。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.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 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 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 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 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

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