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

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

このガイドでは、GMA Next-Gen SDK を使用してメディエーションで 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 ダッシュボードに追加します。

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

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

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

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

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

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

app-ads.txt を更新する

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

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

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

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

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

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

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

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

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

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

[**自動データ収集**] をオンにして、 **ログイン名** と **API パスワード** を入力します。

[収益パートナー] を選択したら、[モバイル 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")
    }
  }
}

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    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")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    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'
}

手動による統合

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

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.getAdSourceResponses() を使用して、広告レスポンスから根本原因のエラーを確認できます。

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