将 maio 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 使用 中介加载和展示来自 maio 的广告，涵盖广告瀑布流集成。其中介绍了如何将 maio 添加到广告单元的中介配置，以及如何将 maio SDK 和适配器集成到iOS 应用中。

maio 的信息中心界面使用日语文本作为标签、按钮和说明，本指南中的屏幕截图尚未翻译。不过，在本指南的说明和说明中，标签和按钮均使用其英语等效项进行引用。例如，“URL スキーム”是“网址架构”。

支持的集成和广告格式

maio 的中介适配器具有以下功能：

集成
出价
瀑布
表现形式
横幅
插页式广告
激励广告
原生

要求

  • iOS 部署目标为 12.0 或更高版本

第 1 步：在 maio 界面中设置配置

首先，注册或登录您的 Maio 账号。点击左侧边栏中的应用管理按钮，然后点击新建应用。

选择与所需广告类型对应的标签页。

插页式广告

输入应用的名称，选择平台，然后提供应用网址。选择视频插页式广告作为广告类型，然后点击更新。

激励广告

输入应用的名称，选择平台，然后提供应用网址。选择视频奖励作为广告类型，然后点击更新。

在应用管理页面中，记下媒体 ID。您需要在下一部分中设置 AdMob 广告单元，因此请记下此 ID。

在可用区管理页面上，记下可用区 ID。您还需要在下一部分中设置 AdMob 广告单元。

（仅限广告瀑布流）除了媒体 ID 和区域 ID 之外，您还需要 API ID 和 API 密钥，才能设置广告单元 ID 以进行中介。在 Reporting API 页面中，记下 API ID 和 API 密钥。

第 2 步：在界面中设置 Maio 需求 Ad Manager

第 3 步：导入 maio SDK 和适配器

  • 将以下代码行添加到项目的 Podfile 中：

    pod 'GoogleMobileAdsMediationMaio'

  • 在命令行中运行以下命令：

    pod install --repo-update

手动集成

  • 下载最新版本的 maio SDK。
  • 通过更新日志中的下载链接下载最新版本的 maio 适配器，然后在项目中关联 maioAdapter.framework。

第 4 步：添加所需的代码

SKAdNetwork 集成

按照 maio 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步：测试您的实现

错误代码

如果适配器未能从 maio 收到广告，发布商可以使用以下类下的GADResponseInfo.adNetworkInfoArray：

格式 类名称
插页式广告 GADMMaioInterstitialAdapter
激励广告 GADMMaioRewardedAdapter

以下是 Maio 适配器在广告加载失败时抛出的代码和随附消息：

错误代码 原因
0-10 maio 返回了特定于 SDK 的错误。如需了解详情，请参阅 maio 的代码。
101 maio 尚无广告。
102 服务器参数无效（例如缺少展示位置 ID）。
103 Maio 适配器不支持请求的广告格式。
104 系统已为此广告联盟配置加载广告。

maio iOS 中介适配器变更日志

版本 2.1.5.1

  • 更新了 CFBundleShortVersionString，使其包含三个组件，而不是四个。

构建和测试所需系统：

  • Google 移动广告 SDK 版本 11.10.0。
  • Maio SDK 版本 2.1.5。

版本 2.1.5.0

  • 已验证与 maio SDK 版本 2.1.5 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.6.0 版。
  • Maio SDK 版本 2.1.5。

版本 2.1.4.0

  • 已验证与 maio SDK 版本 2.1.4 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.2.0 版。
  • Maio SDK 版本 2.1.4。

版本 2.1.3.0

  • 已验证与 maio SDK 版本 2.1.3 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 11.1.0 版。
  • Maio SDK 2.1.3 版。

版本 2.1.2.1

  • 现在需要 Google 移动广告 SDK 11.0 或更高版本。
  • 在 MaioAdapter.xcframework 中的框架中添加了 Info.plist。

构建和测试所需版本：

  • Google 移动广告 SDK 版本 11.0.1。
  • Maio SDK 版本 2.1.2。

版本 2.1.2.0

  • 已验证与 maio SDK 版本 2.1.2 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 10.14.0 版。
  • Maio SDK 版本 2.1.2。

版本 2.1.1.0

  • 已验证与 maio SDK 版本 2.1.1 的兼容性。

构建和测试所需系统：

  • Google 移动广告 SDK 10.12.0 版。
  • Maio SDK 版本 2.1.1。

版本 2.0.0.0

  • 已验证与 maio SDK 版本 2.0.0 的兼容性。
  • 移除了对 MaioOB SDK 的依赖项。
  • 移除了对 armv7 架构的支持。
  • 现在，最低 iOS 版本要求为 12.0。
  • 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。

构建和测试所需系统：

  • Google 移动广告 SDK 10.10.0 版。
  • Maio SDK 版本 2.0.0。

版本 1.6.3.1

  • 现在需要 Google 移动广告 SDK 10.0.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 10.0.0 版。
  • Maio SDK 1.6.3 版。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.6.3.0

  • 更新了适配器以使用 didRewardUser API。
  • 现在需要 Google 移动广告 SDK 9.8.0 或更高版本。
  • 已验证与 maio SDK 版本 1.6.3 和 maioOB SDK 版本 2.0.0-alpha 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.12.0 版。
  • Maio SDK 版本 1.6.3。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.6.2.0

  • 已验证与 maio SDK 版本 1.6.2 和 maioOB SDK 版本 2.0.0-alpha 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 9.5.0 版。
  • Maio SDK 1.6.2 版。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.6.1.0

  • 已验证与 maio SDK 版本 1.6.1 和 maioOB SDK 版本 2.0.0-alpha 的兼容性。

构建和测试所需系统：

  • Google 移动广告 SDK 9.2.0 版。
  • Maio SDK 版本 1.6.1。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.6.0.1

  • 已经验证与 Google 移动广告 SDK 9.0.0 版本兼容。
  • 现在需要 Google 移动广告 SDK 9.0.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 9.0.0 版。
  • Maio SDK 版本 1.6.0。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.6.0.0

  • 已验证与 maio SDK 版本 1.6.0 和 maioOB SDK 版本 2.0.0-alpha 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 8.13.0 版。
  • 现在，最低 iOS 版本要求为 10.0。
  • Maio SDK 版本 1.6.0。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.5.8.0

  • 已验证与 maio SDK 版本 1.5.8 和 maioOB SDK 版本 2.0.0-alpha 的兼容性。
  • 为插页式广告和激励广告格式的适配器添加了出价功能。
  • 放宽了对 Google 移动广告 SDK 8.0.0 或更高版本的依赖。

构建和测试所需版本：

  • Google 移动广告 SDK 8.7.0 版。
  • Maio SDK 版本 1.5.8。
  • MaioOB SDK 版本 2.0.0-alpha。

版本 1.5.6.1

  • 添加了标准化的适配器错误代码和消息。
  • 更新了适配器以使用 .xcframework 格式。
  • 修复了激励广告事件有时不转发的 bug。
  • 现在需要 Google 移动广告 SDK 8.3.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 8.3.0 版。
  • Maio SDK 版本 1.5.6。

版本 1.5.6.0

  • 已验证与 maio SDK 版本 1.5.6 的兼容性。
  • 现在需要 Google 移动广告 SDK 7.68.0 或更高版本。

构建和测试所需系统：

  • Google 移动广告 SDK 7.68.0 版。
  • Maio SDK 版本 1.5.6。

版本 1.5.5.0

  • 已验证与 maio SDK 版本 1.5.5 的兼容性。
  • 现在需要 Google 移动广告 SDK 7.64.0 或更高版本。

构建和测试所需系统：

  • Google 移动广告 SDK 7.64.0 版。
  • Maio SDK 1.5.5 版。

版本 1.5.4.0

  • 已验证与 maio SDK 版本 1.5.4 的兼容性。
  • 现在需要 Google 移动广告 SDK 7.60.0 或更高版本。

构建和测试所需版本：

  • Google 移动广告 SDK 7.60.0 版。
  • Maio SDK 1.5.4 版。

版本 1.5.3.1

  • 为了限制超时，现在，如果 maio 没有可供展示的广告，广告请求将立即失败。
  • 取消了对 i386 架构的支持。

构建和测试所需版本：

  • Google 移动广告 SDK 7.58.0 版。
  • Maio SDK 1.5.3 版。

版本 1.5.3.0

  • 已验证与 maio SDK 版本 1.5.3 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 版本 7.55.1。
  • Maio SDK 1.5.3 版。

版本 1.5.2.1

  • 修复了适配器未调用 -rewardedAdDidPresent: 回调的问题。

构建和测试所需版本：

  • Google 移动广告 SDK 7.53.1 版。
  • Maio SDK 1.5.2 版。

版本 1.5.2.0

  • 已验证与 maio SDK 版本 1.5.2 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 7.53.1 版。
  • Maio SDK 版本 1.5.2。

版本 1.5.1.0

  • 已验证与 maio SDK 版本 1.5.1 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 7.52.0 版。
  • Maio SDK 版本 1.5.1。

版本 1.5.0.0

  • 已验证与 maio SDK 版本 1.5.0 的兼容性。

构建和测试所用的

  • Google 移动广告 SDK 7.51.0 版。
  • Maio Ads SDK 版本 1.5.0。

版本 1.4.8.0

  • 已验证与 maio SDK 版本 1.4.8 的兼容性。

版本 1.4.6.0

  • 已验证与 maio SDK 版本 1.4.6 的兼容性。
  • 更新了适配器以使用新的激励广告 API。
  • 现在需要 Google 移动广告 SDK 7.42.2 或更高版本。

版本 1.4.2.0

  • 已验证与 maio SDK 版本 1.4.2 的兼容性。

版本 1.4.1.0

  • 已验证与 maio SDK 版本 1.4.1 的兼容性。
  • 修复了以下问题：如果从 AdMob 提供了多个 MediaId，maio 适配器可能会失败。

版本 1.4.0.0

  • 已验证与 maio SDK 版本 1.4.0 的兼容性。

版本 1.3.2.0

  • 已验证与 maio SDK 版本 1.3.2 的兼容性。

版本 1.3.1.1

  • 向适配器添加了 adapterDidCompletePlayingRewardBasedVideoAd: 回调。

版本 1.3.1.0

  • 已验证与 maio SDK 版本 1.3.1 的兼容性。

版本 1.3.0.0

  • 已验证与 maio SDK 版本 1.3.0 的兼容性。

版本 1.2.19.0

  • 已验证与 maio SDK 版本 1.2.19 的兼容性。

版本 1.2.18.0

  • 首次发布！
  • 添加了对插页式广告和激励视频广告的支持。