Mintegral を入札と統合する(ベータ版)

このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を メディエーション、 ウォーターフォールと入札の両方の統合に対応しています。内容 広告ユニットのメディエーション設定に Mintegral を追加する方法 Mintegral SDK とアダプタを Android アプリ

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

Mintegral のメディエーション アダプタの機能は次のとおりです。

統合
単価設定  1
 2
フォーマット
アプリの起動  1  2
バナー
インタースティシャル
特典
リワード インタースティシャル
ネイティブ  1  3
1 入札の統合は終了しています ベータ版。

2 ウォーターフォール統合は クローズド ベータ版。

要件

  • Android API レベル 21 以降

ステップ 1: Mintegral UI で設定をセットアップする

Mintegral アカウントに登録またはログインします。

アプリキーを見つける

[アプリの設定] タブに移動し、[アプリキー] をメモします。

新しいアプリケーションの追加

[アプリの設定] タブで、[アプリを追加] ボタンをクリックします。

[Platform] を選択し、フォームの残りの部分に入力します。[保存] をクリックします。

アプリケーションのアプリ ID をメモします。

広告プレースメントを作成する

アプリを作成したら、[プレースメントとユニット] タブに移動し、以下に示すように [プレースメントを追加] ボタンをクリックして広告のプレースメントを作成します。

プレースメント名広告のフォーマットを入力します。

[入札タイプ] で [ヘッダー入札] を選択します。フォームの残りの項目を入力し、[保存] をクリックします。

広告のプレースメントを作成したら、プレースメント ID をメモします。

[1 個の AD ユニット] プルダウンをクリックし、AD ユニット ID をメモします。

Mintegral Reporting API キーを確認する

入札

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

ウォーターフォール

Ad Manager 広告ユニット ID を設定するには、Mintegral Reporting API キーが必要です。[Account] > [API Tools] に移動します。SkeySecret をメモします。

ステップ 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 とアダプタをインポートする

プロジェクト レベルの 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.2.0")
    implementation("com.google.ads.mediation:mintegral:16.7.81.0")
}

手動による統合

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

  2. [ Mintegral アダプタのアーティファクト Google の Maven リポジトリにあります最新バージョンを選択して Mintegral をダウンロードしてください。 アダプタの .aar ファイルを開き、プロジェクトに追加します。

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

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 から広告掲載なしエラーが返されました。
101 com.google.mediation.mintegral サーバー パラメータが無効です(例: アプリ ID やプレースメント ID がない)。
102 com.google.mediation.mintegral Mintegral SDK から広告掲載なしエラーが返されました。
103 com.google.mediation.mintegral Mintegral SDK の広告の表示に失敗しました。
104 com.google.mediation.mintegral リクエストされた広告サイズは、Mintegral でサポートされているバナーサイズと一致しません。

Mintegral Android メディエーション アダプタの変更履歴

バージョン 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.