このガイドでは、GMA Next-Gen SDK を使用して AdMob メディエーションで Mintegral の広告を読み込んで表示する方法を、ウォーターフォール統合と入札統合の両方について説明します。また、広告ユニットのメディエーション設定に Mintegral を追加する方法と、Mintegral SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Mintegral 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | |
| ウォーターフォール | |
| フォーマット | |
| アプリの起動 | |
| バナー | |
| インタースティシャル | |
| リワード | |
| リワード インタースティシャル | |
| ネイティブ | |
要件
- 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 キーを確認する
入札単価
入札統合の場合、この手順は必要ありません。
ウォーターフォール
AdMob 広告ユニット 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: AdMob の管理画面で Mintegral のデマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に Mintegral を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Mintegral を追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
広告ユニット カードに選択した広告ユニットが表示されます。
広告ソースとして Mintegral を追加する
入札単価
[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[Mintegral] を選択します。
[パートナー契約への署名手順] をクリックし、Mintegral との入札パートナーシップを設定します。
[確認して同意する] をクリックし、[続行] をクリックします。
Mintegral のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。[完了] をクリックします。
ウォーターフォール
[広告のソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。
[Mintegral] を選択します。 次に、Mintegral の eCPM 値を入力し、[続行] をクリックします。
Mintegral のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。[完了] をクリックします。
GDPR と米国の州規制に関する広告パートナー リストに Mobvista/Mintegral を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに 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: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録してください。
バナー、インタースティシャル、リワード、ネイティブの各広告フォーマットで Mintegral のテスト広告を取得するには、Mintegral テスト ID ページに記載されているアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を使用することをおすすめします。
テスト広告を確認する
Mintegral からテスト広告を受信していることを確認するには、Mintegral（入札）と Mintegral（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能なステップ
CCPA 広告パートナー リストに Mintegral を追加する
CCPA 設定の手順に沿って、AdMob 管理画面の 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 が広告なしエラーを返しました。 |