このページは Cloud Translation API によって翻訳されました。

Mintegral を入札と統合する（ベータ版）

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

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

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

統合
単価設定	¹
滝	²
フォーマット
アプリの起動
バナー
インタースティシャル
特典
リワードインタースティシャル
ネイティブ

¹ 入札の統合はクローズドベータ版です（オープンベータ版のネイティブ広告フォーマットを除く）。

² ウォーターフォールの統合はクローズドベータ版です。

要件

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

単価設定

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

滝

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

ステップ 2: アドマネージャーの管理画面で Mintegral のデマンドを設定する

アドマネージャーアカウントにログインします。

会社に Mintegral を追加する

単価設定

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

滝

[管理] > [会社] に移動し、[すべての会社] タブで [新しい会社] ボタンをクリックします。[広告ネットワーク] を選択します。

[広告ネットワーク] として [Mintegral] を選択し、一意の名前を入力して [メディエーション] を有効にします。

[ユーザー名] や [パスワード] を入力する必要はありません。完了したら、[保存] をクリックします。

セキュアシグナルの共有を有効にする

単価設定

[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュアシグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。

滝

この手順は、ウォーターフォール統合では必要ありません。

Mintegral 入札を設定する

単価設定

[配信] > [入札者（ビッダー）] に移動し、[SDK 入札] タブで [新しいビッダー] をクリックします。

ビッダーとして [Mintegral] を選択します。

[許可したシグナルのリストにこのビッダーのシグナルライブラリを追加する] と [このビッダーとのシグナルの共有を許可する] をオンにします。その後、[続行] をクリックします。

[続行] をクリックします。

[完了] をクリックします。

滝

この手順は、ウォーターフォール統合では必要ありません。

広告ユニットのマッピングを設定する

単価設定

[配信] > [入札者（ビッダー）] に移動し、[SDK 入札] タブで Mintegral の会社を選択します。

[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。

[特定の広告ユニット] を選択します。広告ユニットとフォーマットを選択し、[広告枠のタイプ] で [モバイルアプリ] を選択し、[モバイルアプリ] を選択します。次に、前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID を入力します。確認したら、[保存] をクリックします。

滝

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。モバイルアプリを選択します。

下にスクロールして [収益パートナーを追加] をクリックします。

前のセクションで Mintegral 用に作成した会社を選択します。[統合タイプ] で [モバイル SDK メディエーション]、[プラットフォーム] で [iOS]、[ステータス] で [有効] を選択します。

前のセクションで取得したアプリキー、アプリ ID、プレースメント ID、広告ユニット ID、デフォルトの CPM 値を入力します。[保存] をクリックします。

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

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

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

CocoaPods を使用する（推奨）

プロジェクトの Podfile に次の行を追加します。
```
pod 'GoogleMobileAdsMediationMintegral'
```
コマンドラインから次のコマンドを実行します。
```
pod install --repo-update
```

手動による統合

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

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

EU ユーザーの同意と GDPR

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

テスト広告を有効にする

アドマネージャーでテストデバイスを登録してください。

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

テスト広告を確認する

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

省略可能なステップ

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

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

ネイティブ広告

広告のレンダリング

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

フィールド	Mintegral アダプタによって常に含まれるアセット
広告見出し
画像	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 でサポートされているバナーサイズと一致しません。