このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを介して Mintegral の広告を読み込んで表示する方法について説明します。ウォーターフォールと入札の両方の統合について説明します。ここでは、広告ユニットのメディエーション構成に Mintegral を追加する方法と、Mintegral SDK とアダプタを Android アプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
Mintegral のメディエーション アダプタには、次の機能があります。
統合 | |
---|---|
単価設定 | 1 |
滝 | 2 |
フォーマット | |
アプリの起動 | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル | |
ネイティブ |
2 ウォーターフォールの統合はクローズド ベータ版です。
要件
Android API レベル 21 以降
[入札の場合]: 入札にサポートされているすべての広告フォーマットを統合するには、Mintegral アダプター 16.5.91.1 以降(最新バージョンを推奨)を使用します。
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 1: Mintegral UI で設定を行う
Mintegral アカウントに登録するか、ログインします。
アプリキーを探す
[APP Setting] タブに移動し、[APP Key] をメモします。
新しいアプリを追加する
[APP Setting] タブで、[Add APP] ボタンをクリックします。
[プラットフォーム] を選択し、フォームの残りの部分に入力します。[保存] をクリックします。
アプリケーションの APP ID をメモします。
広告プレースメントを作成する
アプリケーションが作成されたら、[プレースメントとユニット] タブに移動し、下記のように [プレースメントを追加] ボタンをクリックして広告プレースメントを作成します。
[プレースメント名] と [広告フォーマット] を入力します。
[入札タイプ] として [ヘッダー入札] を選択します。フォームの残りの部分に記入し、[保存] をクリックします。
広告プレースメントを作成したら、プレースメント ID をメモします。
[1 つの広告ユニット] プルダウンをクリックし、[広告ユニット ID] をメモします。
Mintegral Reporting API キーを確認する
単価設定
この手順は、入札の統合では必要ありません。
滝
アド マネージャーの広告ユニット ID を設定するには、Mintegral Reporting API キーが必要です。[アカウント] > [API ツール] に移動します。Skey と Secret をメモします。
ステップ 2: アド マネージャーの管理画面で Mintegral のデマンドを設定する
アド マネージャー アカウントにログインします。
会社に Mintegral を追加する
単価設定
この手順は、入札の統合では必要ありません。
滝
[管理] > [会社] に移動し、[すべての会社] タブで [新しい会社] ボタンをクリックします。[広告ネットワーク] を選択します。
[広告ネットワーク] として [Mintegral] を選択し、一意の名前を入力して [メディエーション] を有効にします。
[ユーザー名] や [パスワード] を入力する必要はありません。完了したら、[保存] をクリックします。
セキュア シグナルの共有を有効にする
単価設定
[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。
滝
この手順は、ウォーターフォール統合では必要ありません。
Mintegral 入札を設定する
単価設定
[配信] > [入札者(ビッダー)] に移動し、[SDK 入札] タブで [新しいビッダー] をクリックします。
ビッダーとして [Mintegral] を選択します。
[許可したシグナルのリストにこのビッダーのシグナル ライブラリを追加する] と [このビッダーとのシグナルの共有を許可する] をオンにします。その後、[続行] をクリックします。
[続行] をクリックします。
[完了] をクリックします。
滝
この手順は、ウォーターフォール統合では必要ありません。
広告ユニットのマッピングを設定する
単価設定
[配信] > [入札者(ビッダー)] に移動し、[SDK 入札] タブで Mintegral の会社を選択します。
[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。
[特定の広告ユニット] を選択します。広告ユニットとフォーマットを選択し、[広告枠のタイプ] で [モバイルアプリ] を選択し、[モバイルアプリ] を選択します。次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。確認したら、[保存] をクリックします。
滝
[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。モバイルアプリを選択します。
下にスクロールして [収益パートナーを追加] をクリックします。
前のセクションで Mintegral 用に作成した会社を選択します。[統合タイプ] で [モバイル SDK メディエーション]、[プラットフォーム] で [Android]、[ステータス] で [有効] を選択します。
前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID、デフォルトの CPM 値を入力します。[保存] をクリックします。
GDPR と米国の州規制の広告パートナー リストに Mobvista/Mintegral を追加
GDPR 設定と米国の州規制の設定の手順に沿って、アド マネージャーの管理画面で GDPR と米国の州規制の広告パートナー リストに 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")
}
}
}
次に、アプリレベルの build.gradle.kts
ファイルで、次の実装依存関係と構成を追加します。Mintegral SDK とアダプタの最新バージョンを使用します。
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}
手動による統合
Mintegral SDK を組み込むには、Mintegral SDK for Android をご覧ください。
Google の Maven リポジトリで Mintegral アダプター アーティファクトに移動します。最新バージョンを選択し、Mintegral アダプターの
.aar
ファイルをダウンロードしてプロジェクトに追加します。
ステップ 4: Mintegral SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域(EEA)のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。
Mintegral SDK には、同意情報を Mintegral SDK に渡す setConsentStatus
メソッドが含まれています。
次のサンプルコードは、同意情報を Mintegral SDK に渡す方法を示しています。これらのオプションは、Mintegral SDK に正しく転送されるように、Google Mobile Ads 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 に渡す方法を示しています。このメソッドを呼び出す必要がある場合は、Google Mobile Ads SDK を初期化した後、Google Mobile Ads 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(ウォーターフォール)の広告ソースを使用して、単一の広告ソースのテストを有効にします。
省略可能なステップ
Mintegral を CCPA 広告パートナーのリストに追加
CCPA 設定の手順に沿って、アド マネージャー管理画面の CCPA 広告パートナーのリストに Mintegral を追加します。
ネイティブ広告
広告のレンダリング
Mintegral アダプタは、ネイティブ広告を NativeAd
オブジェクトとして返します。NativeAd
の次のフィールドに入力されます。
フィールド | Mintegral アダプタによって常に含まれるアセット |
---|---|
広告見出し | |
画像 | 1 |
本文 | |
アイコン | |
行動を促すフレーズ | |
評価 | |
ストア | |
価格 | |
広告主様 |
1 Mintegral アダプターは、ネイティブ広告のメイン画像アセットに直接アクセスできません。代わりに、アダプタは MediaView
に動画または画像を入力します。
エラーコード
アダプターが Mintegral から広告を受信できない場合は、次のクラスの ResponseInfo.getAdapterResponses()
を使用して、広告レスポンスから根本的なエラーを確認できます。
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 から広告なしエラーが返されました。 |
Mintegral Android メディエーション アダプターの変更履歴
次のバージョン
- バックグラウンド スレッドで Mintegral SDK を初期化(ANR を修正するため)。
バージョン 16.8.61.0
- Mintegral SDK 16.8.61 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.3.0。
- Mintegral SDK バージョン 16.8.61。
バージョン 16.8.51.0
- Mintegral SDK 16.8.51 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.3.0。
- Mintegral SDK バージョン 16.8.51。
バージョン 16.8.41.0
- Mintegral SDK 16.8.41 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.3.0。
- Mintegral SDK バージョン 16.8.41。
バージョン 16.8.31.0
- Mintegral SDK 16.8.31 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.2.0。
- Mintegral SDK バージョン 16.8.31。
バージョン 16.8.11.0
- Mintegral SDK 16.8.11 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.2.0。
- Mintegral SDK バージョン 16.8.11。
バージョン 16.7.91.0
- Mintegral SDK 16.7.91 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.2.0。
- Mintegral SDK バージョン 16.7.91。
バージョン 16.7.81.0
- Mintegral SDK 16.7.81 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.2.0。
- Mintegral SDK バージョン 16.7.81。
バージョン 16.7.71.0
- Mintegral SDK 16.7.71 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.1.0。
- Mintegral SDK バージョン 16.7.71。
バージョン 16.7.61.0
- Mintegral SDK 16.7.61 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.1.0。
- Mintegral SDK バージョン 16.7.61。
バージョン 16.7.51.0
- Mintegral SDK 16.7.51 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.1.0。
- Mintegral SDK バージョン 16.7.51。
バージョン 16.7.41.0
- Mintegral SDK 16.7.41 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.1.0。
- Mintegral SDK バージョン 16.7.41。
バージョン 16.7.31.0
- Mintegral SDK 16.7.31 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.1.0。
- Mintegral SDK バージョン 16.7.31。
バージョン 16.7.21.0
- Mintegral SDK 16.7.21 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- Mintegral SDK バージョン 16.7.21。
バージョン 16.7.11.0
- Mintegral SDK 16.7.11 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- Mintegral SDK バージョン 16.7.11。
バージョン 16.6.71.0
- Mintegral SDK 16.6.71 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- Mintegral SDK バージョン 16.6.71。
バージョン 16.6.61.0
- 必須の Google Mobile Ads SDK バージョンを 23.0.0 に更新しました。
- Mintegral SDK 16.6.61 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- Mintegral SDK バージョン 16.6.61。
バージョン 16.6.51.0
- Mintegral SDK 16.6.51 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Mintegral SDK バージョン 16.6.51。
バージョン 16.6.41.0
- Mintegral SDK 16.6.41 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Mintegral SDK バージョン 16.6.41。
バージョン 16.6.34.0
- Mintegral SDK 16.6.34 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Mintegral SDK バージョン 16.6.34。
バージョン 16.6.21.0
- Mintegral SDK 16.6.21 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Mintegral SDK バージョン 16.6.21。
バージョン 16.5.91.1
- アプリ起動広告フォーマットの入札サポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Mintegral SDK バージョン 16.5.91。
バージョン 16.5.91.0
- Mintegral SDK 16.5.91 との互換性を確認しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 22.6.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Mintegral SDK バージョン 16.5.91。
バージョン 16.5.51.0
- Mintegral SDK 16.5.51 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.3.0。
- Mintegral SDK バージョン 16.5.51。
バージョン 16.5.41.0
- Mintegral SDK 16.5.41 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.3.0。
- Mintegral SDK バージョン 16.5.41。
バージョン 16.5.31.0
- Mintegral SDK 16.5.31 との互換性を確認しました。
- アダプタの依存関係を Google Mobile Ads SDK バージョン 22.3.0 に戻しました。
- アプリ起動広告フォーマットのウォーターフォールのサポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.3.0。
- Mintegral SDK バージョン 16.5.31。
バージョン 16.5.21.0
- Mintegral SDK 16.5.21 との互換性が確認されました。
- 必須となる Google Mobile Ads SDK のバージョンを 22.4.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.4.0。
- Mintegral SDK バージョン 16.5.21。
バージョン 16.5.11.0
- 入札広告の透かしのサポートを追加しました。
- Mintegral SDK 16.5.11 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.2.0。
- Mintegral SDK バージョン 16.5.11。
バージョン 16.4.91.0
- Mintegral SDK 16.4.91 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.2.0。
- Mintegral SDK バージョン 16.4.91。
バージョン 16.4.81.0
- Mintegral SDK 16.4.81 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.2.0。
- Mintegral SDK バージョン 16.4.81。
バージョン 16.4.71.0
- Mintegral SDK 16.4.71 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.2.0。
- Mintegral SDK バージョン 16.4.71。
バージョン 16.4.61.0
- Mintegral SDK 16.4.61 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.1.0。
- Mintegral SDK バージョン 16.4.61。
バージョン 16.4.51.0
- Mintegral SDK 16.4.51 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.1.0。
- Mintegral SDK バージョン 16.4.51。
バージョン 16.4.41.0
- バナー広告が正しくないサイズでレンダリングされる問題を修正しました。
- Mintegral SDK 16.4.41 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0。
- Mintegral SDK バージョン 16.4.41。
バージョン 16.4.31.0
- Mintegral SDK 16.4.31 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0。
- Mintegral SDK バージョン 16.4.31。
バージョン 16.4.21.0
- 新しい
VersionInfo
クラスを使用するようにアダプターを更新しました。 - 必須の Google Mobile Ads SDK バージョンを 22.0.0 に更新しました。
- Mintegral SDK 16.4.21 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0。
- Mintegral SDK バージョン 16.4.21。
バージョン 16.3.91.0
- Mintegral SDK 16.3.91 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Mintegral SDK バージョン 16.3.91。
バージョン 16.3.81.0
- Mintegral SDK 16.3.81 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Mintegral SDK バージョン 16.3.81。
バージョン 16.3.71.0
- Mintegral SDK 16.3.71 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Mintegral SDK バージョン 16.3.71。
バージョン 16.3.61.0
- Mintegral SDK 16.3.61 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Mintegral SDK バージョン 16.3.61。
バージョン 16.3.51.1
- バナー(MREC を含む)、インタースティシャル、リワード、ネイティブの各広告フォーマットのウォーターフォールのサポートを追加しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 21.5.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Mintegral SDK バージョン 16.3.51。
バージョン 16.3.51.0
- Mintegral SDK 16.3.51 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.4.0。
- Mintegral SDK バージョン 16.3.51。
バージョン 16.3.41.0
- Mintegral SDK 16.3.41 との互換性が確認されました。
- 必須の Google Mobile Ads SDK バージョンを 21.4.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.4.0。
- Mintegral SDK バージョン 16.3.41。
バージョン 16.3.11.0
- Mintegral SDK 16.3.11 との互換性を確認しました。
- リワード広告を表示するときに
onAdClosed()
の前にonUserEarnedReward()
を転送するようにアダプタを更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.3.0。
- Mintegral SDK バージョン 16.3.11。
バージョン 16.2.61.0
- 初回リリース
- バナー(MREC を含む)、インタースティシャル、リワード、ネイティブの各広告フォーマットの入札サポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.3.0。
- Mintegral SDK バージョン 16.2.61。