# HyprMX インテグレーション

> HyprMX アカウントを作成し、必要な認証情報を取得し、プロジェクトに HyprMX アダプターを追加することで、HyprMX を Unity LevelPlay と統合します。

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

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

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

## 前提条件##prerequisites

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

  **Integration guides:**

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

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

* HyprMX SDK API 16 以上でコンパイルし、API 28 以上で広告を表示する

## ステップ 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

LevelPlay SDK は Gradle の依存関係と手動ダウンロードメカニズムの両方をサポートします。

### Gradle##gradle

1. アプリケーションモジュールの ビルド.gradle スクリプトに以下の Maven URL があることを確認します。

```groovy
repositories {
    mavenCentral()
}
```

2. アダプターの Maven 名をアプリケーションモジュールの ビルド.gradle スクリプトに追加します。

```groovy
dependencies {
    implementation 'com.unity3d.ads-mediation:hyprmx-adapter:5.1.0'
    implementation 'com.hyprmx.android:HyprMX-SDK:6.4.5'
}
```

3. プロジェクトの ビルド.gradle スクリプトが 3.3.1 以上のクラスパスをサポートしていることを確認してください。

```groovy
classpath 'com.android.tools.build:gradle:3.3.1'
```

## ステップ 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 に設定します。

```java
LevelPlay.setMetaData("HyprMX_ageRestricted","true");
```

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

```java
LevelPlay.setMetaData("HyprMX_ageRestricted","false");
```

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

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

Unity LevelPlay を通じて追加の広告ネットワークを活用するには、アダプタを統合し、インテグレーションガイドに従います。

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/mediation-networks.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md)
* [React ネイティブ](/grow/levelplay/sdk/react/mediation-networks.md)