# HyprMX 集成

> 通过创建 HyprMX 帐户、获取必要的凭据并将 HyprMX 适配器添加到项目中，将 HyprMX 与 Unity LevelPlay 集成。

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

本指南将逐步说明如何在 Unity LevelPlay Mediation 上将 HyprMX Live 设置为广告网络。

> **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 的新参数，您应该联系 [integration@hyprmx.com](mailto:integration@hyprmx.com)。

* HyprMX SDK 在 API 16 或更高版本上编译，并在 API 28 或更高版本上显示广告服务

## 步骤 1.创建 HyprMX 帐户

HyprMX 提供托管服务。要为他们创建帐户，请直接与他们联系：[integration@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 的报告数据。

### 将 HyprMX 的参数配置为 LevelPlay 帐户

* 获取上述参数后，登录 IronSource 帐户，然后转到 **Monetize** > **SDK Networks**。

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

* 从可用广告网络列表中选择 HyprMX，然后输入 HyprMX **API Key**。

![输入 API 密钥](/api/media?file=/grow/media/images/1-16.png)

![输入的 API 密钥](/api/media?file=/grow/media/images/1-17.png)

* 接下来，选择要使用 HyprMX 运行 Unity LevelPlay Mediation 的应用程序，然后选择 **Setup**。然后在相关字段中输入**分销商\*\*\*\* ID** 和**放置/位置名称**。

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

![输入凭据](/api/media?file=/grow/media/images/unnamed-file.png)

* 然后，您将在 Setup Dashboard（设置后台）上看到 HyprMX 为 **Active** for Mediation（激活聚合）。

![活动状态](/api/media?file=/grow/media/images/1-20.png)

## 步骤 3.将 HyprMX 适配器添加到构建中##step-3.-add-the-hyprmxadapter-to-your-build

LevelPlay SDK 支持 Gradle 依赖关系和手动下载机制。

### Gradle##gradle

1. 确保 app 模块的构建.gradle 脚本中存在以下 Maven 网址。

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

2. 将适配器的 Maven 名称添加到 app 模块的构建.gradle 脚本。

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

3. 确保项目的 构建 脚本支持 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 适配器 4.3.2+ 已启用的。

根据 HyprMX，对于参与 Google 播放 的 Designed for Families 计划、在 Google 播放 的 Family 部分中列出或将子项作为目标受众之一的应用程序中的所有用户，建议设置 ageRestrictedUser 参数，以防止标记为子项的终端用户访问 AAID。

在初始化 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 Native](/grow/levelplay/sdk/react/mediation-networks.md)