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

[プラットフォームを選択]: Android（ベータ版） 新規 Android iOS Unity Flutter

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

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

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

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

統合
入札
ウォーターフォール
フォーマット
バナー
インタースティシャル
リワード
ネイティブ

要件

  • Android API レベル 23 以降

  • 最新の Google Mobile Ads SDK

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

ステップ 1: i-mobile の管理画面で設定を行う

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

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

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

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

[広告枠管理（Ad Spot Management）] タブに移動し、[新規広告枠（New Ad Spot）] ボタンをクリックします。

create_ad_spot

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

new_ad_spot_form

新しい広告スポット が作成されました。統合の詳細を表示するには、[アプリ設定取得（Get App settings）] ボタンをクリックします。

ad_spot_list

パブリッシャー ID（Publisher ID）、メディア ID（Media ID）、 およびスポット ID（Spot ID）をメモしておきます。これらのパラメータは、後で AdMob の管理画面でメディエーション用に i-mobile を設定するときに必要になります。

app-ads.txt を更新する

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

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

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

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

広告ユニットのメディエーション設定に i-mobile を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして i-mobile を追加するステップに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] をクリックします。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、 メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

広告ユニット カードに選択した広告ユニットが表示されます。

広告のソースとして i-mobile を追加する


[広告のソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。

[i-mobile] を選択し、[最適化] スイッチを有効にします。前のセクションで取得したログイン名 と API パスワード を入力して、i-mobile の広告のソースの最適化を設定します。次に、i-mobile の eCPM 値 を入力し、[続行] をクリックします。



i-mobile のマッピングがすでに存在する場合は、それを選択できます。 それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得した パブリッシャー ID、メディア ID、スポット ID を入力します。[完了] をクリックします。

ステップ 3: i-mobile SDK とアダプタをインポートする

プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

アプリレベルの gradle ファイルに、次の実装の依存関係を追加します。

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.1.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.2")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.1.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.2'
}

手動による統合

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

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

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

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

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

省略可能なステップ

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

広告レンダリング

i-mobile アダプタは、次の ネイティブ アドバンス広告フィールドに値を設定します for a 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 AdMob の管理画面で設定した i-mobile サーバー パラメータがないか、無効です。
103 リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
104 i-mobile のネイティブ広告の読み込み成功コールバックから、空のネイティブ広告リストが返されました。
105 リクエストに年齢制限付きの処理が設定されていますが、i-mobile SDK は年齢制限付きのシグナルを受信できません。

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

バージョン 2.3.2.2

  • GMA Next-Gen SDK の依存関係を使用してアダプタをビルドするプロパティを追加しました。
  • バナー広告、インタースティシャル広告、ネイティブ広告の実装を古い API から新しい API に移行しました。

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

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

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

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