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

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

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

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

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

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

要件

Android API レベル 24 以降

GMA Next-Gen SDK の最新動画
メディエーションのスタートガイドの手順を完了していること

ステップ 1: i-mobile の UI で設定を行う

i-mobile アカウントに登録するか、ログインします。

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

パブリッシャー ID、メディア ID、スポット 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 を入力します。[完了] をクリックします。

注: 広告ソースの最適化では、メディエーションネットワークの eCPM を正確に計算するために十分なデータを収集するのに数日かかります。その間、広告ソースの最適化ステータスは PENDING になるため、ネットワークの eCPM 値を手動で設定する必要があります。eCPM を計算できるようになると、広告ソースが自動的に eCPM を更新するようになります。

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

Android Studio の統合（推奨）

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:imobile:2.3.2.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動による統合

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

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

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

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

省略可能なステップ

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

広告のレンダリング

i-mobile アダプタは、NativeAd の次のネイティブ広告フィールドに値を設定します。

フィールド	i-mobile アダプタによって常に含まれるアセット
広告見出し
画像
本文
アプリアイコン	¹
行動を促すフレーズ
評価
ストア
価格

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

エラーコード

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

形式	クラス名
バナー	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 のネイティブ広告読み込み成功コールバックが空のネイティブ広告リストを返しました。