InMobi をメディエーションと統合する

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

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

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

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

要件

• Android API レベル 24 以降

• [入札の場合]: 入札でサポートされているすべての広告フォーマットを統合するには、InMobi アダプタ 10.6.3.0 以降（最新バージョンを推奨）を使用します。

• GMA Next-Gen SDK の最新動画

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

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

InMobi アカウントに登録します。

アカウントが確認されたら、ログインします。

アプリを追加

アプリを InMobi ダッシュボードに追加するには、[Inventory > Inventory Settings] をクリックします。

[インベントリを追加] をクリックし、プルダウン メニューから [モバイルアプリ] チャネルを選択します。

検索バーに公開済みのアプリストアの URL の入力を開始し、自動入力された結果からアプリを選択します。[続行] をクリックします。

アプリが公開されていない場合は、[手動でリンク] をクリックして、必要な詳細情報を入力します。[続行] をクリックします。

[アプリとウェブサイトのコンプライアンス] の設定を確認し、[保存してプレースメントを作成] をクリックします。

プレースメント

インベントリを設定すると、プレースメント作成ワークフローにリダイレクトされます。

プレースメントが作成されると、その詳細が表示されます。プレースメント ID をメモします。この ID は、アド マネージャーの広告ユニットの設定に使用します。

アカウント ID

InMobi アカウント ID は、[Finance（財務）> Payment Settings（お支払い設定）> Payment Information（お支払い情報）] で確認できます。

InMobi Reporting API キーを確認する

app-ads.txt を更新する

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

InMobi に app-ads.txt を実装するには、パーソナライズされたコード スニペットを追加します。

テストモードをオンにする

すべてのライブ インプレッションまたは特定のテストデバイスのみで、プレースメントのテストモードを有効にします。

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

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

[Companies] に InMobi を追加する

セキュア シグナルの共有を有効にする

入札リクエストでセキュア シグナルを共有する

SDK 入札のセキュア シグナルの共有を許可する

InMobi の入札を設定する

広告ユニットのマッピングを設定する

GDPR と米国の州規制の広告パートナー リストに InMobi を追加する

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに InMobi を追加します。

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

Android Studio の統合（推奨）

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

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

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.24.0-beta02'
    implementation 'com.google.ads.mediation:inmobi:11.1.1.0'
}

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

手動による統合

1. InMobi Android SDK をダウンロードし、libs フォルダにある InMobiSDK.aar ファイルを抽出して、プロジェクトに追加します。

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

3. InMobi では、他の依存関係も含める必要があります。詳しくは、InMobi のドキュメントをご覧ください。

ステップ 4: InMobi SDK にプライバシー設定を実装する

EU の同意に関する規制と GDPR

Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

バージョン 7.1.0.0 で、InMobi アダプタに InMobiConsent クラスが追加されました。このクラスを使用すると、同意情報を InMobi に渡すことができます。次のサンプルコードは、InMobiConsent クラスで updateGDPRConsent() を呼び出します。このメソッドを呼び出す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出すことをおすすめします。

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

InMobi がこの同意オブジェクトで受け入れるキーと値について詳しくは、InMobi の GDPR 実装の詳細をご覧ください。

米国のプライバシー関連州法

米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。

バージョン 10.5.7.1 では、InMobi アダプタで共有設定から IAB 米国プライバシー文字列を読み取るサポートが追加されました。米国のプライバシー関連州法に関するドキュメントの手順に沿って、共有設定で米国のプライバシー文字列を設定します。

また、InMobi ダッシュボードで CCPA 設定を有効にする方法については、InMobi の CCPA に関するドキュメントをご覧ください。

ステップ 5: 必要な追加コード

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

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

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録し、InMobi の管理画面でテストモードを有効にしてください。

テスト広告を確認する

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

省略可能なステップ

権限

最適なパフォーマンスを得るため、InMobi はアプリの AndroidManifest.xml ファイルに次のオプションの権限を追加することをおすすめします。

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

ネットワーク固有のパラメータ

InMobi アダプタは、Android Bundle としてアダプタに渡すことができる追加のリクエスト パラメータをサポートしています。アダプタはバンドル内で次のキーを検索します。

広告リクエスト パラメータを設定するコードの例を次に示します。

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

• AD_UNIT_ID は、実際の広告ユニット ID に置き換えてください。

• AREA_CODE_VALUE は、市外局番に置き換えます。

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

広告のレンダリング

InMobi アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。NativeAd の次のフィールドに入力します。

¹ InMobi アダプタは、ネイティブ広告のメイン画像アセットへの直接アクセスを提供しません。代わりに、アダプタは MediaView に動画または画像を設定します。

インプレッションとクリックのトラッキング

GMA Next-Gen SDK は、インプレッションとクリックのトラッキングに InMobi SDK のコールバックを使用するため、両方のダッシュボードのレポートはほぼ一致し、不一致はほとんどありません。

エラーコード

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

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

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