# 積分インテグレーション

> アプリケーションの作成、プレースメントの追加、広告ユニットの設定によって、Unity LevelPlay で Mintegral を広告ネットワークとして設定します。

> **Important:**
>
> 以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
> その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
> サードパーティ製品を使用する際は、その製品の規約に従うものとします。
> Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。

> **Note:**
>
> このメディエーション ネットワークのアダプタ変更ログを表示するには、[Unity 向けメディエーション ネットワーク](/grow/levelplay/sdk/unity/mediation-networks.md.md#integrate-network-adapters) を参照してください。

このガイドでは、Unity LevelPlay Mediation プラットフォームで Mintegral を広告ネットワークとして稼働させる方法をステップごとに説明します。

統合ネットワークの場合、自動設定ツールはステップ 1 の完了後に使用できます。自動設定ツールは、アプリケーションと入札者の配置を作成し、Mintegralから配置の詳細を取得するため、LevelPlayプラットフォームとMintegralプラットフォームを切り替える必要はありません。または、設定全体を手動で完了することもできます。

## 前提条件

リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md.md)
* [フラッター](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md.md)
* [リアクトネイティブ](/grow/levelplay/sdk/react/rewarded-ads-integration.md.md)

**Interstitial integration:**

* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/interstitial-integration.md.md)
* [フラッター](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [React ネイティブ](/grow/levelplay/sdk/react/interstitial-integration.md.md)

**Banner integration:**

* [Unity](/grow/levelplay/sdk/unity/banner-integration.md.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/banner-integration.md.md)
* [フラッター](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [React ネイティブ](/grow/levelplay/sdk/react/banner-integration.md.md)

## ステップ 1. 統合アカウントの作成

1. Mintegral でアカウントを作成します。[ここで](https://dev.mintegral.com/user/signup)行うことができます。
2. アカウントが確認されると、パートナー ログイン[はこちら](https://dev.mintegral.com/user/login)からログインできます。

> **Note:**
>
> ステップ 1 を完了したら、ステップ 3 にスキップして自動入札者設定ツールを使用して、Unity LevelPlay で Mintegral 入札者とともに起動し、実行することができます。手動設定を続行する場合は、ステップ 2 に進みます。

## ステップ 2. Mintegral でのアプリケーションの作成

初めて Mintegral アカウントを設定する場合は、以下に進みます。

1. **Login**
   1. 初回ログイン時に「**アプリケーション設定**」を選択
      ![アプリケーション設定メニュー](/api/media?file=/grow/media/images/Screen-Shot-2022-10-12-at-13.46.49.png)
2. **アプリケーションの追加**
   1. 「+ アプリケーションを追加」をクリックすると、設定モジュールが表示されます。「Configure your application settings(アプリケーション設定の構成)」(メディエーションプラットフォームとしてIronsourceを選択)。LevelPlay アカウントと同様に、プラットフォーム (iOS + Android) ごとに一意の Mintegral アプリケーションが必要です。

      ![Ironsourceをメディエーション プラットフォームとするアプリケーション設定の追加](/api/media?file=/grow/media/images/Screen-Shot-2022-10-12-at-13.47.41.png)

   2. 設定を定義したら、アプリケーションに配信**しない**広告タイプを選択することができます。

      ![広告タイプの選択](/api/media?file=/grow/media/images/Screen-Shot-2022-10-12-at-13.51.00.png)
3. **プレースメント\*\*\*\*の追加**
   1. アプリケーション設定を定義した後で、ダッシュボードから関連するアプリケーションを選択し、**配置管理**を選択します。

      ![配置管理ボタン](/api/media?file=/grow/media/images/Screen-Shot-2022-10-12-at-13.52.12.png)

   2. **Add Placement** (プレースメントを追加) を選択します。

      ![配置追加ボタン](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.37.55.png)

   3. 統合アダプタでは、**リワード広告**、**インタースティシャル、バナー**を配信できます。ニーズに合わせて「AD形式」を選択します。バナーの場合は、**自動更新**の値を「No」に設定することを強く推奨します。これは、メディエーションプラットフォームで更新頻度をコントロールできるためです。

      ![AD 形式選択](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.39.15.png)

   4. 広告単位を定義します。Mintegral ネットワークは入札者のみであるため、Biding Type として「Header Bidding」を選択する必要があります。

      ![ヘッダー入札の選択](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.39.25.png)

## ステップ 3. LevelPlay ネットワークワーク設定モジュールで Mintegral をアクティベートする

* 左側のナビゲーションバーで **SDK Networks** を選択します。次に、ページの上部にある **Available networks** を選択し、サポートされているネットワークのリストから Mintegral を選択します。

  ![使用可能なネットワークから Mintegral を選択します。](/api/media?file=/grow/media/images/Screenshot-2024-01-30-at-9.56.36.png)

* Mintegral アカウントの値は、LevelPlay ネットワーク設定モジュールに挿入する必要があります。

| App Key  | Mintegral のダッシュボードでアプリケーションに割り当てられた一意の ID。 |
| -------- | ------------------------------------------ |
| **SKey** | **レポート用の API キー**                          |
| **秘密**   | **Mintegral ユーザーに割り当てられた一意の ID。**          |

この情報を取得したら、LevelPlay **アカウント**で Mintegral のパラメータを設定する必要があります。上記の情報を正しく追加することで、Mintegral の広告インベントリおよびレポートデータを Ironsource メディエーションプラットフォームで最大限に活用できるようになります。

> **Note:**
>
> SKeyまたはSecretの値が見つからない場合は、接触
> [d](mailto:developer@mintegral.com)[eveloper@mintegral.com](mailto:developer@mintegral.com)
> または Mintegral のアカウントマネージャーにご連絡ください。

### App Key

Mintegral ダッシュボードでアプリケーションを作成したら (ステップ 2 を参照)、'アプリケーション Settings' 画面に移動します。このページの上部に **アプリケーション キー** があります。

![アプリケーション設定のアプリケーション キーの場所](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.40.50.png)

### SKey + Secret

Mintegralユーザーにログインしたら(ステップ1で説明)、上部メニューのアカウントタブのAPIツールに移動します。これで、ページの下部に**キー**と**シークレット**が表示されます。

![API ツールの SKey と Secret](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.42.42.png)

## ステップ 4. アプリケーションレベルでの Mintegral の設定

* LevelPlay で Mintegral bid 設定を取得するには、2 つの方法があります。
  1. **自動設定** - 新しいアプリケーションと配置入札者を自動的に作成し、Mintegralから必要な構成設定をすべて取得します。
  2. **手動** - LevelPlay プラットフォームと Mintegral プラットフォーム間を移動して、必要な情報を取得して入力します。

### 自動設定

* 自動設定特徴をアクティベートするには、入札者自動設定ツールのトグルを使用します。これにより、MIntegral プラットフォームでアプリケーションと入札者の配置を自動的に作成し、LevelPlay が Mintegral から配置の詳細を取得できるようになります。

  ![トグル入札者自動設定ツール](/api/media?file=/grow/media/images/Screenshot-2024-01-30-at-10.00.46.png)

> **Note:**
>
> 自動設定ツールをオンにトグルしても、MIntegral は
> LevelPlay での手動入札

* Mintegral のインタースティシャル広告、リワード広告、またはバナー広告を実行するアプリケーションを選択します。次に、Mintegral 行の定義アイコンを選択します。

  ![アプリケーションと定義アイコンを選択](/api/media?file=/grow/media/images/Screenshot-2024-01-30-at-10.03.02.png)

* 「**Add bids(入札**者の追加)」を選択して、Mintegralプラットフォームに新しいアプリケーションと入札プレースメントを自動的に作成し、App ID、配置ID、広告単位IDをインポートします。

  ![Add bid (入札者の追加) ボタン](/api/media?file=/grow/media/images/Screenshot-2024-01-30-at-10.04.02.png)

**Save (保存**) を選択して、すべての設定を承認および承認します。保存せずにモジュールを閉じると、データを Levelplay プラットフォームにインポートせずに Mintegral プラットフォームにアセットが作成されます。

> **Note:**
>
> Mintegral 入札者インスタンスの状態は、
> ironsource Ads 入札者のためにアクティベートされました。例えば、
> リワード広告の Ironsource 入札者の場合、
> Mintegral ネットワーク用にアクティブ化されます。Mintegralbidding インスタンスのアクティベート
> リワード広告の場合は、Mintegralの行を選択し、広告単位をトグルします。

### 手動での設定

* SDKネットワーク ページで、設定するアプリケーションを選択し、Mintegral bidsの下の**設定**を選択します。

* App IDを入力し、Mintegral biderで使用する広告単位ごとに配置IDと広告単位IDを入力します。

  ![App ID、配置 ID、および広告単位 ID フィールドによる手動設定](/api/media?file=/grow/media/images/Screenshot-2024-01-30-at-10.04.02.png)

* これらのパラメーターは Mintegral アアカウントから取得できます。
  1. App ID (アプリ ID)

     ![アプリ ID の場所](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.46.29.png)

  2. プレースメント ID

     ![配置 ID の場所](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.50.17.png)

  3. 広告単位 ID

     ![広告単位 ID の場所](/api/media?file=/grow/media/images/Screen-Shot-2022-10-13-at-10.51.43.png)

## ステップ 5.ビルドへの Mintegral Adapter の追加##step-5.-add-the-mintegral-adapter-to-your-build

### LevelPlay ネットワーク マネージャ（推奨）##levelplay-network-manager-(recommended)

SDK インテグレーションが完了したら、LevelPlay ネットワーク マネージャを使用して Mintegral Adapter をダウンロードできます。

Unity Development プラットプラットフォームで、Ads Mediation > ネットワーク Manager (ネットワークマネージャー) に移動します。

すでに最新バージョンのアダプタがある場合は、**アクション** ボタンが「Updated」に変わり、無効になります。

### Android (手動解決)##android-(manual-resolve)

変更を適用するには、必ず「解決」プロセスを使用してください。これにより、選択に応じて関連するアーティファクトがすべてダウンロードされます。詳細については、[Unity パッケージインテグレーション](/grow/levelplay/sdk/unity/package-integration.md)を参照してください。

#### ProGuard ユーザーのみ (Android)##for-proguard-users-only-(android)

Mintegral アダプタで ProGuard を使用している場合は、ProGuard ファイルに以下のコードを追加する必要があります。

AndroidX サポート:

```java
-keepattributes シグネチャ
-keepattributes *Annotation*
-keep class com.mbridge.** {*; }
-keep interface com.mbridge.** {*; }
-keep class android.support.v4.** { *; }
-dontwarn com.mbridge.**
-keep クラス **.R$* { public 静的 final int mbridge*; }
-keep public class com.mbridge.* extends androidx.** { *; }
-keep public class androidx.viewpager.widget.PagerAdapter{ *; }
-keep public class androidx.viewpager.widget.ViewPager.OnPageChangeListener{ *; }
-keep interface androidx.annotation.IntDef{ *; }
-keep interface androidx.annotation.Nullable{ *; }
-keep interface androidx.annotation.CheckResult{ *; }
-keep interface androidx.annotation.NonNull{ *; }
-keep public class androidx.fragment.app.Fragment{ *; }
-keep public class androidx.core.content.FileProvider{ *; }                                                 
-keep public class androidx.core.app.NotificationCompat{ *; }                                                
-keep public class androidx.appcompat.widget.AppCompatImageView { *; }
-keep public class androidx.recyclerview.*{ *; }
```

AndroidX を使用していない場合は、[Mintegral Web サイト](http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-ios\&lang=en)の手順に従ってください。

> **Note:**
>
> MTG SDKを使用する場合は、クラッシュの可能性を避けるため、RecyclerViewの依存関係をプロジェクトに導入してください。

## ステップ 6.Mintegral の追加設定##step-6.-mintegral-additional-settings

### COPPA の設定##set-coppa

Unity LevelPlay を使用すると、パブリッシャーは Mintegral COPPA 設定を Mintegral ネットワークに直接通信できます。この特徴は、LevelPlay SDK 7.2.4.1 以降、Mintegral Unity Adapter 4.3.12 以降を使用して有効化されます。

以下の構文を使用して、Mintegral COPPA の値を true に設定し、子をレポートします。

```cs
LevelPlay.SetMetaData("Mintegral_COPPA","true");
```

以下の構文を使用して、Mintegral COPPA の値を false に設定し、成人をレポートします。

```cs
LevelPlay.SetMetaData("Mintegral_COPPA","false");
```

Mintegral ネットワークの年齢制限設定の詳細については、[こちら](http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-android\&lang=en)を参照してください。

これで、アプリケーション内で統合広告を配信できるようになりました。
