本指南介绍了如何使用 Google 移动广告 SDK 使用 中介加载和展示来自 maio 的广告，涵盖广告瀑布流集成。其中介绍了如何将 maio 添加到广告单元的中介配置，以及如何将 maio SDK 和适配器集成到iOS 应用中。
maio 的信息中心界面的标签、按钮和说明使用日语文本，本指南中的屏幕截图尚未翻译。不过，在本指南的说明和说明中，标签和按钮均使用其英语等效项进行引用。例如，“网址 スキーム”是“网址 Scheme”。
支持的集成和广告格式
maio 的中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | |
| 瀑布 | |
| 表现形式 | |
| 横幅 | |
| 插页式广告 | |
| 激励广告 | |
| 原生 | |
要求
- iOS 部署目标为 12.0 或更高版本
最新版 Google 移动广告 SDK
完成中介入门指南
第 1 步：在 maio 界面中设置配置
首先，注册或登录您的 Maio 账号。点击左侧边栏中的应用管理按钮，然后点击新建应用。
选择与您偏好的广告类型对应的标签页。
插页式广告
输入应用的名称，选择平台，然后提供应用网址。选择视频插页式广告作为广告类型，然后点击更新。
激励广告
输入应用的名称，选择平台，然后提供应用网址。选择视频奖励作为广告类型，然后点击更新。
在应用管理页面中，记下媒体 ID。您需要在下一部分中设置 Ad Manager 广告单元，因此请记下此 ID。
在可用区管理页面上，记下可用区 ID。您还需要在下一部分中设置 Ad Manager 广告单元。
第 2 步：在界面中设置 Maio 需求 Ad Manager
为广告单元配置中介设置
登录您的 Ad Manager 账号。
依次前往投放 > 收益组，然后点击新建收益组按钮。
为收益组输入唯一的名称，将状态设为有效，选择广告格式，并将广告资源类型设为移动应用。在定位 > 广告资源部分下，选择您要为其添加中介的广告资源和移动应用下的广告单元。
接下来，点击添加收益合作伙伴按钮。
如果您已经有 maiio 的收益合作伙伴，可以选择该合作伙伴。否则，请选择创建新的收益合作伙伴。
选择 maio 作为广告联盟，输入唯一的名称，然后启用中介。
开启自动收集数据，然后输入您在上一部分中获取的 API ID 和 API KEY。
选择收益合作伙伴后，选择移动 SDK 中介作为集成类型，选择 iOS 作为平台，并选择有效作为状态。输入您在上一部分中获取的媒体 ID 和区域 ID。然后，输入默认每千次展示定价值。
完成后，点击页面底部的保存。
第 3 步：导入 maio SDK 和适配器
使用 CocoaPods（推荐）
将以下代码行添加到项目的 Podfile 中：
pod 'GoogleMobileAdsMediationMaio'在命令行中运行以下命令：
pod install --repo-update
手动集成
第 4 步：添加所需代码
SKAdNetwork 集成
按照 maio 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 5 步：测试您的实现
启用测试广告
请务必为 Ad Manager 注册测试设备。
如果发布商使用的是 Google 移动广告 SDK 7.26.0 或更高版本，则在发出请求时，注册为测试设备的手机和平板电脑会自动从 maio 接收测试广告。
验证测试广告
如需验证您是否在接收来自 maiio 的测试广告，请在广告检查器中使用 maio（广告瀑布流）广告来源启用单一广告来源测试。
错误代码
如果适配器未能从 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
- 更新了适配器以使用
didRewardUserAPI。 - 现在需要 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
- 首次发布！
- 新增了对插页式广告和激励视频广告的支持。