Mintegral をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK を使用して AdMob メディエーションを介して Mintegral の広告を読み込み、表示する方法について説明します。ウォーターフォールと入札の両方の統合について説明します。ここでは、広告ユニットのメディエーション構成に Mintegral を追加する方法と、Mintegral SDK とアダプタを Android アプリに統合する方法について説明します。

サポートされている統合と広告フォーマット

Mintegral のメディエーション アダプタには、次の機能があります。

統合
単価設定
滝
フォーマット
アプリの起動  1
バナー
インタースティシャル
特典
リワード インタースティシャル
ネイティブ  2
1 アプリ起動時広告フォーマットの入札とウォーターフォールの統合はクローズド ベータ版です。

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 キーを確認する

単価設定

この手順は、入札の統合では必要ありません。

滝

AdMob 広告ユニット ID を設定するには、Mintegral Reporting API キーが必要です。[アカウント] > [API ツール] に移動します。Skey と Secret をメモします。

ステップ 2: AdMob UI で Mintegral のデマンドを設定する

広告ユニットのメディエーション設定を構成する

広告ユニットのメディエーション設定に Mintegral を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを変更する場合は、そのメディエーション グループの名前をクリックして編集し、Mintegral を広告ソースとして追加するに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

選択した広告ユニットが広告ユニットカードに表示されます。

Mintegral を広告ソースとして追加する

単価設定


[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[Mintegral] を選択します。
[パートナー契約への署名手順] をクリックし、Mintegral との入札パートナーシップを設定します。
[確認して同意する]、[続行] の順にクリックします。
Mintegral のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。[完了] をクリックします。

滝


[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。[Mintegral] を選択します。

[Mintegral] を選択します。 Mintegral の eCPM 値を入力し、[続行] をクリックします。



Mintegral のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。[完了] をクリックします。


GDPR と米国の州規制の広告パートナー リストに Mobvista/Mintegral を追加

GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナー リストに Mobvista/Mintegral を追加します。

ステップ 3: Mintegral SDK とアダプタをインポートする

プロジェクト レベルの 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")
}

手動による統合

  1. Mintegral SDK を組み込むには、Mintegral SDK for Android をご覧ください。

  2. Google の Maven リポジトリで Mintegral アダプター アーティファクトに移動します。最新バージョンを選択し、Mintegral アダプターの .aar ファイルをダウンロードしてプロジェクトに追加します。

ステップ 4: Mintegral SDK にプライバシー設定を実装する

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: 実装をテストする

テスト広告を有効にする

AdMob 用にテストデバイスを登録してください。

バナー、インタースティシャル、リワード、ネイティブの広告フォーマットの Mintegral テスト広告を取得するには、Mintegral のテスト ID ページに記載されているアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を使用することをおすすめします。

テスト広告を確認する

Mintegral からテスト広告が配信されていることを確認するには、広告インスペクタで Mintegral（入札）と Mintegral（ウォーターフォール）の広告ソースを使用して、単一の広告ソースのテストを有効にします。

省略可能なステップ

Mintegral を CCPA 広告パートナーのリストに追加

CCPA 設定の手順に沿って、AdMob 管理画面の 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。