# HyprMX インテグレーション

> HyprMX アダプターをビルドに追加し、Ironsource ダッシュボードで設定することで、HyprMX を Unity LevelPlay の設定に広告ネットワークワークとして統合します。

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

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

## 前提条件##prerequisites

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

  **Integration guides:**

  * [リワード広告](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md)
  * [インタースティシャル](/grow/levelplay/sdk/flutter/interstitial-integration.md)
  * [バナー](/grow/levelplay/sdk/flutter/banner-integration.md)

* アダプタのバージョンが低いものから 4.1.2 以降にアップグレードする場合は、プラットフォーム内でそれらの HyprMX パラメータを新しいものに再設定してください。 HyprMX の新しいパラメータを取得するには、[インテグレーション@hyprmx.com](mailto:integration@hyprmx.com) に連絡する必要があります。

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

HyprMX はマネージサービスを提供します。アカウントを作成するには、[インテグレーション@hyprmx.com](mailto:integration@hyprmx.com) に直接接触してください。アカウントの作成後、アプリケーションの設定や LevelPlay アカウントで HyprMx をアクティベートするために必要なパラメータの取得のヘルプが表示されます。

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

HyprMX アカウントから 3 つのデータを LevelPlay ネットワーク設定モジュールに挿入して、HyprMX を Ironsource と正しく接続する必要があります。

| **APIキー**                | これは、HyprMX システムでのアカウントの一意の識別子です。     |
| ------------------------ | ------------------------------------ |
| **ディストリビューター\*\*\*\*ID** | これは、HyprMX が広告を配信する一意のアプリケーション識別子です。 |
| **配置\*\*\*\*名**          | これは、HyprMX を使用した配置の一意の識別子です。         |

この情報を取得したら、LevelPlay アカウントで **HyprMX のパラメータ**上記の情報を正しく追加することで、HyprMX の広告インベントリと Unity LevelPlay Mediation のレポートデータを最大限に活用できるようになります。

### LevelPlay アカウントへの HyprMX のパラメータの設定

* 上記のパラメータを取得したら、Ironsource アカウントにログインし、「**Monetize」**＞ **「SDK Networks**」に移動します。

![SDK Networks 設定](/api/media?file=/grow/media/images/1-15.png)

* 使用可能な広告ネットワークのリストから HyprMX を選択し、HyprMX **API キー**を入力します。

![API キーの入力](/api/media?file=/grow/media/images/1-16.png)

![入力した API キー](/api/media?file=/grow/media/images/1-17.png)

* 次に、HyprMX で Unity LevelPlay Mediation を実行するアプリケーションを選択し、**設定**を選択します。次に、関連するフィールドに**ディストリビューター** **ID** と**配置名**を入力します。

![HyprMX 設定](/api/media?file=/grow/media/images/1-21.png)

![Enter credentials](/api/media?file=/grow/media/images/unnamed-file.png)

* 設定ダッシュボードで HyprMX がメディエーションに対して**アクティブ**と表示されます。

![アクティブ状態](/api/media?file=/grow/media/images/1-20.png)

## ステップ 3. HyprMX Adapter をビルドに追加する##step-3.-add-the-hyprmxadapter-to-your-build

[Android](/grow/levelplay/sdk/android/networks/guides/hyprmx.md)および[iOS](/grow/levelplay/sdk/ios/networks/guides/hyprmx.md)用のネイティブ アダプターを使用して、インテグレーションを継続します。

## ステップ 4. HyprMX の追加設定##step-4.-hyprmx-additional-settings

### 年齢制限ユーザー##age-restricted-users

Unity LevelPlay メディエーションを使用すると、パブリッシャーは HyprMX ageRestrictedUser 設定を HyprMX ネットワークに直接通知できます。この特徴は、LevelPlay SDK 7.2.4 以降、HyprMX Android Adapter 4.3.2 以降を使用して有効化されます。

HyprMX によると、Google 再生 再生 の ファミリ (ファミリー) セクションにリスト再生る、または、子向けとしてフラグ設定された終了ユーザーの AAID へのアクセスを防ぐために、ターゲットオーディエンスの 1 つに子を含むアプリケーション内のすべてのユーザーに ageRestrictedUser パラメーターを設定することが推奨されます。

LevelPlay SDK を初期化する**前**に フラグを設定します。

以下の構文を使用して、ageRestrictedUser を持つ HyprMX フラグを true に設定します。

```dart
LevelPlay.setMetaData({"HyprMX_ageRestricted": ["true"]});
```

以下の構文を使用して、ageRestrictedUser を持つ HyprMX フラグを false に設定します。

```dart
LevelPlay.setMetaData({"HyprMX_ageRestricted": ["false"]});
```

これで、アプリケーション内で HyprMX を提供できるようになりました。

## 次のステップ##next-steps

Unity LevelPlay Mediation を通じて追加の広告ネットワークを活用するには、[アダプタ](/grow/levelplay/sdk/flutter/mediation-networks.md)を統合し、インテグレーションガイドに従ってください。