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

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

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

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

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

2 ネイティブ広告フォーマットの入札とウォーターフォールの統合はオープンベータ版です。

要件

  • iOS デプロイ ターゲットが 11.0 以降

  • [入札の場合]: 入札にサポートされているすべての広告フォーマットを統合するには、Mintegral アダプター 7.5.3.0 以降（最新バージョンを推奨）を使用します。

  • 最新の 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 とアダプタをインポートする

  • プロジェクトの Podfile に次の行を追加します。

    pod 'GoogleMobileAdsMediationMintegral'

  • コマンドラインから次のコマンドを実行します。

    pod install --repo-update

手動による統合

  • 最新バージョンの Mintegral SDK for iOS をダウンロードし、プロジェクト内のすべての .framework ファイルとバンドルをリンクします。
  • 変更ログのダウンロード リンクから Mintegral アダプターの最新バージョンをダウンロードし、プロジェクトの MintegralAdapter.xcframework にリンクします。

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

Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域（EEA）のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。

Mintegral SDK には、同意情報を Mintegral SDK に渡す setConsentStatus メソッドが含まれています。

次のサンプルコードは、同意情報を Mintegral SDK に渡す方法を示しています。これらのオプションは、Mintegral SDK に正しく転送されるように、Google Mobile Ads SDK を初期化する前に設定する必要があります。

Swift 

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

詳しくは、Mintegral のプライバシーに関するドキュメントをご覧ください。

米国のプライバシー関連州法

米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を法律で定めています（用語は法律の定義に基づく）。「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

Mintegral SDK には、同意情報を Mintegral SDK に渡す setDoNotTrackStatus メソッドが含まれています。

次のサンプルコードは、同意情報を Mintegral SDK に渡す方法を示しています。このメソッドを呼び出す必要がある場合は、Google Mobile Ads SDK を初期化する前に呼び出して、Mintegral SDK に適切に転送されるようにしてください。

Swift 

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

詳しくは、Mintegral のプライバシーに関するドキュメントをご覧ください。

ステップ 5: 必要なコードを追加する

SKAdNetwork の統合

Mintegral のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。

ステップ 6: 実装をテストする

テスト広告を有効にする

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

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

テスト広告を確認する

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

省略可能なステップ

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

CCPA 設定の手順に沿って、AdMob 管理画面の CCPA 広告パートナーのリストに Mintegral を追加します。

ネイティブ広告

広告のレンダリング

Mintegral アダプタは、ネイティブ広告を GADNativeAd オブジェクトとして返します。GADNativeAd の次のフィールドに入力されます。

フィールド Mintegral アダプタによって常に含まれるアセット
広告見出し
画像 1
本文
アイコン
行動を促すフレーズ
評価
ストア
価格
広告主様

1 Mintegral アダプターは、ネイティブ広告のメイン画像アセットに直接アクセスできません。代わりに、アダプタは GADMediaView に動画または画像を入力します。

エラーコード

アダプターが Mintegral から広告を受信できない場合は、次のクラスの GADResponseInfo.adNetworkInfoArray を使用して、広告レスポンスから根本的なエラーを確認できます。

GADMediationAdapterMintegral

広告の読み込みに失敗したときに Mintegral アダプタによってスローされるコードと付随するメッセージは次のとおりです。

エラーコード ドメイン 理由
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 iOS メディエーション アダプタの変更履歴

バージョン 7.7.3.0

  • Mintegral SDK バージョン 7.7.3 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.10.0。
  • Mintegral SDK バージョン 7.7.3。

バージョン 7.7.2.1

  • アダプタは、インタースティシャル広告とリワード広告を表示する前に、広告が準備されているかどうかをチェックしなくなりました。
  • CFBundleShortVersionString を更新し、4 つではなく 3 つのコンポーネントを使用するようにしました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.10.0。
  • Mintegral SDK バージョン 7.7.2。

バージョン 7.7.2.0

  • Mintegral SDK バージョン 7.7.2 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.9.0。
  • Mintegral SDK バージョン 7.7.2。

バージョン 7.7.1.0

  • Mintegral SDK バージョン 7.7.1 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.8.0。
  • Mintegral SDK バージョン 7.7.1。

バージョン 7.7.0.0

  • Mintegral SDK バージョン 7.7.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.8.0。
  • Mintegral SDK バージョン 7.7.0。

バージョン 7.6.9.0

  • Mintegral SDK バージョン 7.6.9 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.7.0。
  • Mintegral SDK バージョン 7.6.9。

バージョン 7.6.8.0

  • Mintegral SDK バージョン 7.6.8 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.7.0。
  • Mintegral SDK バージョン 7.6.8。

バージョン 7.6.7.0

  • Mintegral SDK バージョン 7.6.7 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.6.0。
  • Mintegral SDK バージョン 7.6.7。

バージョン 7.6.6.0

  • Mintegral SDK バージョン 7.6.6 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.5.0。
  • Mintegral SDK バージョン 7.6.6。

バージョン 7.6.4.0

  • Mintegral SDK バージョン 7.6.4 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.4.0。
  • Mintegral SDK バージョン 7.6.4。

バージョン 7.6.3.0

  • Mintegral SDK バージョン 7.6.3 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.3.0。
  • Mintegral SDK バージョン 7.6.3。

バージョン 7.6.2.0

  • Mintegral SDK バージョン 7.6.2 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.3.0。
  • Mintegral SDK バージョン 7.6.2。

バージョン 7.6.1.0

  • Mintegral SDK バージョン 7.6.1 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.3.0。
  • Mintegral SDK バージョン 7.6.1。

バージョン 7.6.0.0

  • Mintegral SDK バージョン 7.6.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.2.0。
  • Mintegral SDK バージョン 7.6.0。

バージョン 7.5.9.0

  • Mintegral SDK バージョン 7.5.9 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.2.0。
  • Mintegral SDK バージョン 7.5.9。

バージョン 7.5.8.0

  • Mintegral SDK バージョン 7.5.8 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.1.0。
  • Mintegral SDK バージョン 7.5.8。

バージョン 7.5.7.0

  • Mintegral SDK バージョン 7.5.7 との互換性が確認されました。
  • iOS の最小バージョンが 12.0 に引き上げられました。
  • Google Mobile Ads SDK バージョン 11.0 以降が必要になりました。
  • MintegralAdapter.xcframework 内のフレームワークに Info.plist を含めました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.0.1。
  • Mintegral SDK バージョン 7.5.7。

バージョン 7.5.6.0

  • Mintegral SDK バージョン 7.5.6 との互換性を確認しました。
  • GADMediationAdapterMintegral.h を公開ヘッダーにしました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.0.0。
  • Mintegral SDK バージョン 7.5.6。

バージョン 7.5.3.0

  • Mintegral SDK バージョン 7.5.3 との互換性が確認されました。
  • アプリ起動広告フォーマットの入札サポートを追加しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.14.0。
  • Mintegral SDK バージョン 7.5.3。

バージョン 7.4.8.0

  • Mintegral SDK バージョン 7.4.8 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.13.0。
  • Mintegral SDK バージョン 7.4.8。

バージョン 7.4.7.0

  • MintegralAdSDK ではなく MintegralAdSDK/All に依存するように podspec ファイルを更新しました。
  • Mintegral SDK バージョン 7.4.7 との互換性が確認されました。
  • アプリ起動広告フォーマットのウォーターフォールのサポートを追加しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.12.0。
  • Mintegral SDK バージョン 7.4.7。

バージョン 7.4.4.0

  • 入札広告の透かしのサポートを追加しました。
  • Mintegral SDK バージョン 7.4.4 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.10.0。
  • Mintegral SDK バージョン 7.4.4。

バージョン 7.4.3.0

  • Mintegral SDK バージョン 7.4.3 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.9.0。
  • Mintegral SDK バージョン 7.4.3。

バージョン 7.4.1.0

  • Mintegral SDK バージョン 7.4.1 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.7.0。
  • Mintegral SDK バージョン 7.4.1。

バージョン 7.3.9.0

  • Mintegral SDK バージョン 7.3.9 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.7.0。
  • Mintegral SDK バージョン 7.3.9。

バージョン 7.3.8.0

  • Mintegral SDK バージョン 7.3.8 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.6.0。
  • Mintegral SDK バージョン 7.3.8。

バージョン 7.3.7.0

  • Mintegral SDK バージョン 7.3.7 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.5.0。
  • Mintegral SDK バージョン 7.3.7。

バージョン 7.3.6.0

  • Mintegral SDK バージョン 7.3.6 との互換性を確認しました。
  • armv7 アーキテクチャのサポートを削除しました。
  • iOS の最小バージョンが 11.0 に引き上げられました。
  • Google Mobile Ads SDK バージョン 10.4.0 以降が必要になりました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.5.0。
  • Mintegral SDK バージョン 7.3.6。

バージョン 7.3.4.0

  • Mintegral SDK バージョン 7.3.4 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.2.0。
  • Mintegral SDK バージョン 7.3.4。

バージョン 7.3.3.0

  • Mintegral SDK バージョン 7.3.3 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.2.0。
  • Mintegral SDK バージョン 7.3.3。

バージョン 7.3.0.0

  • Mintegral SDK バージョン 7.3.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.1.0。
  • Mintegral SDK バージョン 7.3.0。

バージョン 7.2.9.1

  • バナー（MREC を含む）、インタースティシャル、リワード、ネイティブの各広告フォーマットのウォーターフォールのサポートを追加しました。
  • Google Mobile Ads SDK バージョン 10.0.0 以降が必要です。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.0.0。
  • Mintegral SDK バージョン 7.2.9。

バージョン 7.2.9.0

  • Mintegral SDK バージョン 7.2.9 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 9.14.0。
  • Mintegral SDK バージョン 7.2.9。

バージョン 7.2.8.0

  • Mintegral SDK バージョン 7.2.8 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 9.14.0。
  • Mintegral SDK バージョン 7.2.8。

バージョン 7.2.6.0

  • 初回リリース
  • バナー（MREC を含む）、インタースティシャル、リワード、ネイティブの各広告フォーマットの入札サポートを追加しました。
  • Mintegral SDK バージョン 7.2.6 との互換性を確認しました。
  • Google Mobile Ads SDK バージョン 9.8.0 以降が必要です。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 9.13.0。
  • Mintegral SDK バージョン 7.2.6。