このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を メディエーション、 ウォーターフォールと入札の両方の統合に対応しています。内容 広告ユニットのメディエーション設定に Mintegral を追加する方法 Mintegral SDK とアダプタを Android アプリ
サポートされている統合と広告フォーマット
Mintegral のメディエーション アダプタの機能は次のとおりです。
統合 | |
---|---|
単価設定 | 1 |
滝 | 2 |
フォーマット | |
アプリの起動 | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル | |
ネイティブ |
2 ウォーターフォール統合は クローズド ベータ版。
要件
- Android API レベル 21 以降
最新の Google Mobile Ads SDK
メディエーションを完了する スタートガイド
ステップ 1: Mintegral UI で設定をセットアップする
アプリキーを見つける
[アプリの設定] タブに移動し、[アプリキー] をメモします。
新しいアプリケーションの追加
[アプリの設定] タブで、[アプリを追加] ボタンをクリックします。
[Platform] を選択し、フォームの残りの部分に入力します。[保存] をクリックします。
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/new_application_Android.png?authuser=6&hl=ja)
アプリケーションのアプリ ID をメモします。
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/app_id_Android.png?authuser=6&hl=ja)
広告プレースメントを作成する
アプリを作成したら、[プレースメントとユニット] タブに移動し、以下に示すように [プレースメントを追加] ボタンをクリックして広告のプレースメントを作成します。
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/create_placement_Android.png?authuser=6&hl=ja)
プレースメント名と広告のフォーマットを入力します。
[入札タイプ] で [ヘッダー入札] を選択します。フォームの残りの項目を入力し、[保存] をクリックします。
広告のプレースメントを作成したら、プレースメント ID をメモします。
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=6&hl=ja)
[1 個の AD ユニット] プルダウンをクリックし、AD ユニット ID をメモします。
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=6&hl=ja)
Mintegral Reporting API キーを確認する
入札
入札の統合では、この手順は必要ありません。
ウォーターフォール
Ad Manager 広告ユニット ID を設定するには、Mintegral Reporting API キーが必要です。[Account] > [API Tools] に移動します。Skey と Secret をメモします。
ステップ 2: 管理画面で Mintegral のデマンドを設定する Ad Manager
アド マネージャー アカウントにログインします。
会社に Mintegral 追加
入札
入札の統合では、この手順は必要ありません。
ウォーターフォール
[管理] > [会社] に移動し、[すべての会社] タブの [新しい会社] ボタンをクリックします。[広告ネットワーク] を選択します。
[広告ネットワーク] として Mintegral を選択し、固有の名前を入力して [メディエーション] を有効にします。
ユーザー名やパスワードを入力する必要はありません。完了したら [保存] をクリックします。
セキュア シグナルの共有を有効にする
入札
[管理] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、セキュア シグナルの共有を確認してオンにします。[保存] をクリックします。
ウォーターフォール
ウォーターフォールの統合では、この手順は必要ありません。
入札を Mintegral 設定
入札
[配信] > [入札者(ビッダー)] に移動し、[SDK 入札] タブで [新しいビッダー] をクリックします。
ビッダーとして Mintegral を選択します。
[許可されたシグナルのリストにこのビッダーのシグナル ライブラリを追加する] と [このビッダーとのシグナルの共有を許可する] をオンにします。[続行] をクリックします。
[続行] をクリックします。
[Done] をクリックします。
ウォーターフォール
ウォーターフォールの統合では、この手順は必要ありません。
広告ユニットのマッピングを設定する
入札
[配信] > [入札者(ビッダー)] に移動し、[SDK 入札] タブでMintegral に会社を選択します。
[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。
[特定の広告ユニット] を選択します。広告ユニットとフォーマットを選択し、[広告枠のタイプ] として [モバイルアプリ]、[モバイルアプリ] を選択します。次に、前のセクションで取得したApp Key, App ID, Placement ID, and Ad Unit ID を入力します。最後に [保存] をクリックします。
ウォーターフォール
[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。モバイルアプリを選択します。
下にスクロールして [収益パートナーを追加] をクリックします。
前のセクションで Mintegral用に作成した会社を選択します。[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [Android]、[ステータス] として [有効] を選択します。
前のセクションで取得した App Key, App ID, Placement ID, and Ad Unit IDと、[デフォルト CPM] の値を入力します。[保存] をクリックします。
GDPR と米国の州規制の広告パートナー リストに Mintegral 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 Ad Manager UI の GDPR および米国の州規制の広告パートナーのリストに 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.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.11.0")
}
手動による統合
Mintegral SDK を組み込むには、Mintegral SDK for Android をご覧ください。
[ Mintegral アダプタのアーティファクト Google の Maven リポジトリにあります最新バージョンを選択して Mintegral をダウンロードしてください。 アダプタの
.aar
ファイルを開き、プロジェクトに追加します。
ステップ 4: Mintegral SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID や個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。
Mintegral SDK には、同意を渡す setConsentStatus
メソッドが含まれています
Mintegral SDK に送信されます
次のサンプルコードは、同意情報を Mintegral に渡す方法を示しています。 できます。これらのオプションは、事前に Google Mobile Ads 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 のプライバシーに関するドキュメントをご覧ください。 をご覧ください。
米国のプライバシー関連州法
米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトするユーザーの「個人情報」(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドでは、 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられます各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります
Mintegral SDK には、同意を渡すための setDoNotTrackStatus
メソッドが含まれています
Mintegral SDK に送信されます
次のサンプルコードは、同意情報を Mintegral に渡す方法を示しています。 できます。このメソッドを呼び出す必要がある場合は、 以降 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: 実装をテストする
テスト広告を有効にする
Ad Manager。
バナー広告、インタースティシャル、リワード広告、ネイティブ広告フォーマットの Mintegral テスト広告を取得するには、 Mintegral テスト ID ページで提供されるアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を使用することをおすすめします。
テスト広告を確認する
Mintegralからテスト広告を受信していることを確認するには、広告インスペクタで Mintegral (Bidding) and Mintegral (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
省略可能なステップ
CCPA 広告パートナーのリストに Mintegral を追加
手順については、 CCPA 設定 して、CCPA 広告パートナーのリストに Mintegral を追加します。 Ad Manager UI。
ネイティブ広告
広告のレンダリング
Mintegral アダプタは、ネイティブ広告を
NativeAd
説明します。次のように入力されています。
フィールド
を
NativeAd
を選択します。
フィールド | Mintegral アダプタに常に含まれるアセット |
---|---|
広告見出し | |
画像 | 1 |
本文 | |
アイコン | |
行動を促すフレーズ | |
評価 | |
ストア | |
価格 | |
広告主様 |
1 Mintegral アダプターでは、
ネイティブ広告のメインの画像アセットに直接アクセスできる。代わりに、
新しい ReplicaSet の
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 メディエーション アダプタの変更履歴
バージョン 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.