HyprMX 集成

先决条件

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

  Integration guides

  • 奖励广告服务
  • 插屏广告
  • 横幅广告
• 如果从较低的适配器版本升级到 4.1.2 以上版本，请确保在平台中将其 HyprMX 参数重新配置为新的参数。 为了获得 HyprMX 的新参数，您应该联系 integration@hyprmx.com。
• 在 iOS 12.0 或更高版本上编译 HyprMX SDK，并在 iOS 15.0 或更高版本上显示广告服务

步骤 1.创建 HyprMX 帐户

步骤 2.在 LevelPlay 网络设置模块中激活 HyprMX

将 HyprMX 的参数配置为 LevelPlay 帐户

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

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

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

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

步骤 3.将 HyprMX 适配器添加到构建中

将 HyprMX 适配器与 Cocoapods 集成

pod 'IronSourceHyprMXAdapter','5.2.0'

手动下载 HyprMX 适配器

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

XCode 项目设置

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

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

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

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

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

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

步骤 4.HyprMX 其他设置

年龄限制用户

[LevelPlay setMetaDataWithKey:@"HyprMX_ageRestricted" value:@"YES"];

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

[LevelPlay setMetaDataWithKey:@"HyprMX_ageRestricted" value:@"NO"];

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

评估广告网络集成

• 验证您的广告网络与我们的 Integration Helper 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。
• 使用此布尔值管理集成的聚合广告网络的调试日志
  Objective-CSwift

  [LevelPlay setAdaptersDebug:YES];

  LevelPlay.setAdaptersDebug(true)

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

后续步骤