このガイドでは、GMA Next-Gen SDK を使用して メディエーションで Mintegral の広告を読み込んで表示する方法を、ウォーターフォール統合と入札統合の両方を含めて説明します。また、広告ユニットのメディエーション設定に Mintegral を追加する方法と、Mintegral SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Mintegral 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札単価 | 1 |
| ウォーターフォール | |
| フォーマット | |
| アプリの起動 | |
| バナー | |
| インタースティシャル | |
| リワード | |
| リワード インタースティシャル | |
| ネイティブ | |
要件
- Android API レベル 24 以降
- [入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、Mintegral アダプタ 16.5.91.1 以降（最新バージョンを推奨）を使用します。
最新の GMA Next-Gen SDK。
メディエーションのスタートガイドの手順を完了していること
ステップ 1: Mintegral の管理画面で構成を設定する
Mintegral アカウントに登録するか、ログインします。
アプリキーを見つける
[APP Setting] タブに移動し、[APP Key] をメモします。
新しいアプリケーションを追加する
[APP Setting] タブで、[Add APP] ボタンをクリックします。
[Platform] を選択し、フォームの残りの部分を入力します。[保存] をクリックします。
アプリケーションの アプリ ID をメモします。
広告プレースメントを作成する
アプリケーションを作成したら、[Placements & Units] タブに移動し、下の図に示すように [Add Placement] ボタンをクリックして広告プレースメントを作成します。
[プレースメント名] と [広告フォーマット] を入力します。
[入札タイプ] として [ヘッダー入札] を選択します。フォームの残りの部分に記入し、[保存] をクリックします。
広告プレースメントを作成したら、プレースメント ID をメモしておきます。
[1 個の広告ユニット] プルダウンをクリックし、広告ユニット ID をメモします。
Mintegral Reporting API キーを確認する
入札単価
入札統合の場合、この手順は必要ありません。
ウォーターフォール
アド マネージャーの広告ユニット ID を設定するには、Mintegral Reporting API キーが必要です。[Account] > [API Tools] に移動します。Skey とシークレットをメモします。
app-ads.txt を更新する
アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。
Mintegral に app-ads.txt を実装するには、app-ads.txt が広告不正対策にどのように役立つかをご覧ください。
ステップ 2: アド マネージャーの管理画面で Mintegral のデマンドを設定する
アド マネージャー アカウントにログインします。
[Companies] に Mintegral を追加する
入札単価
入札統合の場合、この手順は必要ありません。
ウォーターフォール
[管理] > [会社] に移動し、[すべての会社] タブで [新しい会社] ボタンをクリックします。[広告ネットワーク] を選択します。
[広告ネットワーク] で [Mintegral] を選択し、一意の名前を入力して、[メディエーション] を有効にします。
ユーザー名やパスワードを入力する必要はありません。完了したら、[保存] をクリックします。
セキュア シグナルの共有を有効にする
入札単価
[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。
ウォーターフォール
ウォーターフォール統合の場合、この手順は必要ありません。
入札リクエストでセキュア シグナルを共有する
入札単価
[広告枠] > [セキュア シグナル] に移動します。[セキュア シグナル] で、Mobvista/Mintegral を検索し、[アプリ統合を有効にする] をオンにします。
[保存] をクリックします。
ウォーターフォール
ウォーターフォール統合の場合、この手順は必要ありません。
SDK 入札のセキュア シグナルの共有を許可する
入札単価
[配信] > [デマンド チャネルの設定] に移動します。[デフォルト設定] タブで、[SDK 入札] の [セキュア シグナルの共有を許可する] をオンにします。
[保存] をクリックします。
ウォーターフォール
ウォーターフォール統合の場合、この手順は必要ありません。
Mintegral の入札を設定する
入札単価
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
[新しいビッダー] をクリックします。
ビッダーとして [Mintegral] を選択します。
[続行] をクリックして、このビッダーの SDK 入札を有効にします。
[完了] をクリックします。
ウォーターフォール
ウォーターフォール統合の場合、この手順は必要ありません。
広告ユニットのマッピングを設定する
入札単価
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
Mintegral で使用する会社を選択します。
[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。
[特定の広告ユニット] を選択します。広告ユニットと広告フォーマットを選択します。[広告枠のタイプ] として [モバイルアプリ] を選択し、対象のモバイルアプリを選択します。次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。最後に [保存] をクリックします。
ウォーターフォール
[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。モバイルアプリを選択します。
下にスクロールして [収益パートナーを追加] をクリックします。
前のセクションで Mintegral 用に作成した会社を選択します。[統合タイプ] で [モバイル SDK メディエーション]、[プラットフォーム] で [Android]、[ステータス] で [有効] を選択します。
前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID と、デフォルトの CPM の値を入力します。[保存] をクリックします。
GDPR と米国の州規制に関する広告パートナー リストに Mobvista/Mintegral を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに Mobvista/Mintegral を追加します。
ステップ 3: Mintegral の SDK とアダプタをインポートする
Android Studio の統合（推奨）
プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:mintegral:17.0.81.0") } 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:mintegral:17.0.81.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
手動による統合
Mintegral SDK を組み込むには、Android 向け Mintegral SDK にアクセスしてください。
Google の Maven リポジトリの Mintegral アダプタ アーティファクトに移動します。最新バージョンを選択し、Mintegral アダプタの
.aarファイルをダウンロードして、プロジェクトに追加します。
ステップ 4: Mintegral SDK にプライバシー設定を実装する
EU ユーザーからの同意と GDPR
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
Mintegral SDK には、同意情報を Mintegral SDK に渡すための setConsentStatus メソッドが含まれています。
次のサンプルコードは、同意情報を Mintegral SDK に渡す方法を示しています。これらのオプションは、GMA Next-Gen SDK を初期化する前に設定する必要があります。これにより、Mintegral SDK に正しく転送されます。
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
詳しくは、Mintegral のプライバシーに関するドキュメントをご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
Mintegral SDK には、同意情報を Mintegral SDK に渡すための setDoNotTrackStatus メソッドが含まれています。
次のサンプルコードは、同意情報を Mintegral SDK に渡す方法を示しています。このメソッドを呼び出す必要がある場合は、GMA Next-Gen SDK を初期化した後、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出します。
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
詳しくは、Mintegral のプライバシーに関するドキュメントをご覧ください。
ステップ 5: 必要なコードを追加する
Mintegral の統合に、追加のコードは必要ありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
アド マネージャー用のテストデバイスを登録してください。
バナー、インタースティシャル、リワード、ネイティブの各広告フォーマットで Mintegral のテスト広告を取得するには、Mintegral テスト ID ページに記載されているアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を使用することをおすすめします。
テスト広告を確認する
Mintegral からテスト広告を受信していることを確認するには、Mintegral（入札）と Mintegral（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能なステップ
CCPA 広告パートナー リストに Mintegral を追加する
CCPA 設定の手順に沿って、アド マネージャーの管理画面で CCPA 広告パートナーのリストに Mintegral を追加します。
ネイティブ広告
広告のレンダリング
Mintegral アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。NativeAd の次のフィールドに入力します。
| フィールド | Mintegral アダプタで常に含まれるアセット |
|---|---|
| 広告見出し | |
| 画像 | 1 |
| 本文 | |
| アイコン | |
| 行動を促すフレーズ | |
| 評価 | |
| ストア | |
| 価格 | |
| 広告主様 |
1 Mintegral アダプタは、ネイティブ広告のメイン画像アセットへの直接アクセスを提供しません。代わりに、アダプタは MediaView に動画または画像を設定します。
エラーコード
アダプタが Mintegral から広告を受信できなかった場合は、次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスから根本原因のエラーを確認できます。
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
広告の読み込みに失敗した場合に Mintegral アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | サーバー パラメータが無効です（アプリ ID やプレースメント ID がないなど）。 |
| 102 | com.google.ads.mediation.mintegral | リクエストされた広告サイズが、Mintegral でサポートされているバナーサイズと一致しません。 |
| 103 | com.google.ads.mediation.mintegral | 入札レスポンスがないか、無効です。 |
| 104 | com.google.ads.mediation.mintegral | Mintegral SDK が広告なしエラーを返しました。 |