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 ファイルに、次の実装依存関係と構成を追加します。

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mintegral:17.0.91.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.25.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.91.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. Mintegral SDK を含めるには、Mintegral SDK for Android に移動します。

2. 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 に渡す方法を示しています。これらのオプションは、 を初期化する前に設定して、Mintegral SDK に正しく転送されるようにする必要があります。GMA Next-Gen SDK

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

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

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

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 アダプタは、ネイティブ広告のメイン画像アセットに直接アクセスできません。代わりに、 アダプタは MediaView に動画または画像を入力します。

エラーコード

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

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

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