# HyprMX 集成

> 在 Unity LevelPlay 中将 HyprMX 添加为广告网络，方法是创建帐户、设置广告位并将 HyprMX 适配器添加到构建中。

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

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

> **Note:**
>
> 要查看此聚合网络的适配器更改日志，请参阅[iOS 聚合网络](/grow/levelplay/sdk/ios/mediation-networks.md.md#integrate-network-adapters)。

## 先决条件##prerequisites

* 确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明：

  **Integration guides:**

  * [奖励广告服务](/grow/levelplay/sdk/ios/rewarded-ads-integration.md)
  * [插屏广告](/grow/levelplay/sdk/ios/interstitial-integration.md)
  * [横幅广告](/grow/levelplay/sdk/ios/banner-integration.md)

* 如果从较低的适配器版本升级到 4.1.2 以上版本，请确保在平台中将其 HyprMX 参数重新配置为新的参数。 为了获得 HyprMX 的新参数，您应该联系 [integration@hyprmx.com](mailto:integration@hyprmx.com)。

* 在 iOS 12.0 或更高版本上编译 HyprMX SDK，并在 iOS 15.0 或更高版本上显示广告服务

## 步骤 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

> **Note:**
>
> HyprMX SDK 仅在 iOS12+ 上提供广告服务。

LevelPlay SDK 支持 **Cocoapods** 和 **Manual** 下载机制。

### 将 HyprMX 适配器与 Cocoapods 集成##integrate-hyprmx-adapter-with-cocoapods

要将 HyprMX SDK 与 Cocoapods 集成，请在 pod 文件中输入以下行：

```ruby
pod 'IronSourceHyprMXAdapter','5.2.0'
```

### 手动下载 HyprMX 适配器##download-the-hyprmxadapter-manually

1. \*\*下载 **HyprMX** 适配器和 SDK：\*\*将 HyprMX 适配器和 HyprMX SDK (XCFrameworks) 文件添加到构建中。请参阅 [iOS 调解网络](/grow/levelplay/sdk/ios/mediation-networks.md)。
2. 向项目**添加 HyprMX 框架：** - 将 ISHyprMXAdapter.framework（在 SDK zip 中可用）拖放到 Xcode 项目中，确保复制文件并验证目标成员资格。 - 选择项目文件和目标。在“General”选项卡中，将 HyprMX.XCFrameworks 从文件资源管理器拖入“Frameworks, Libraries, and Embedded Content”部分。 - 将内嵌设置设置为“内嵌和签名”。

#### XCode 项目设置##xcode-project-setup

1. **配置 app Transport Security (ATS) 设置** HyprMX 建议关闭 ATS 设置。为此，请在 Info.plist 中包含 app Transport Security 字典键，如下所示：

   ```xml
   <key>NSAppTransportSecurity</key>
   <dict>
       <key>NSAllowsArbitraryLoads</key>
       <true/>
   </dict>
   ```

   如果希望启用 ATS，请将以下键添加到播放器中：

   ```xml
   <dict>
       <key>NSAllowsArbitraryLoads</key>
       <true/>
       <key>NSAllowsArbitraryLoadsForMedia</key>
       <true/>
       <key>NSAllowsArbitraryLoadsInWebContent</key>
       <true/>
   </dict>
   ```

   提交申请时，必须说明这些 ATS 设置的理由。HyprMX 建议您注意，您的广告合作伙伴需要从各种来源加载 Web 内容，包括尚不支持 HTTPS 的来源。Apple 已在他们的文档中同意这是可接受的理由。
2. **plist** **声明**
   iOS 要求广告主在列表中声明使用某些功能，包括用户的摄像机、日历和照片库。将以下所有条目添加到app程序的 plist。

   ```xml
   <key>NSCameraUsageDescription</key>
       <string>${PRODUCT_NAME} 请求对摄像机的写入访问权限</string>
   <key>NSPhotoLibraryAddUsageDescription</key>
       <string>${PRODUCT_NAME} 请求对照片库的写入访问权限</string> 
   <key>NSUserTrackingUsageDescription</key>
       <string>${PRODUCT_NAME} 希望为您提供个性化广告服务</string>
   ```

## 步骤 4.HyprMX 其他设置##step-4.-hyprmx-additional-settings

### 年龄限制用户##age-restricted-users

Unity LevelPlay 聚合允许发布者将 HyprMX ageRestrictedUser 设置直接传达给 HyprMX 网络。此功能是使用 LevelPlay SDK 7.3.1+、HyprMX iOS 适配器 4.3.3+ 已启用的。应在初始化 LevelPlay SDK **之前**设置标志。

使用以语法 HyprMX 标志设置为 ageRestrictedUser 参数 true：

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"HyprMX_ageRestricted" value:@"YES"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("HyprMX_ageRestricted", value: "true")
   ```

使用以语法 HyprMX 标志与 ageRestrictedUser 参数 False 一起设置：

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"HyprMX_ageRestricted" value:@"NO"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("HyprMX_ageRestricted", value: "false")
   ```

## 评估广告网络集成##evaluate-your-ad-network-integration

* 验证您的广告网络与我们的 [Integration Helper](/grow/levelplay/sdk/ios/integration-helper.md) 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。
* 使用此布尔值管理集成的聚合广告网络的调试日志

  1. **Objective-C**

     ```objective-c
     [LevelPlay setAdaptersDebug:YES];
     ```

  2. **Swift**

     ```swift
     LevelPlay.setAdaptersDebug(true)
     ```

  设置为 YES 时，这行代码将启用调试日志，以帮助您解决所有聚合广告网络的问题。在 app 与我们的广告单位上线之前，请删除此代码！SDK 6.5.2 及更高版本支持。

现在可以在应用程序中交付 HyprMX。

## 后续步骤##next-steps

要通过 Unity LevelPlay Mediation 利用其他广告网络，请集成[适配器](/grow/levelplay/sdk/ios/mediation-networks.md)并按照我们的集成指南进行操作。