本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 来自 maio 的广告(使用 ) AdMob 中介、 涵盖广告瀑布流集成其中介绍了如何向广告单元的 中介配置,以及如何将 maio SDK 和适配器集成到 iOS 应用。
maio 的信息中心界面使用日语文本作为其标签、按钮 和说明,并且本指南中的屏幕截图尚未翻译。 不过,在本指南的说明和说明中,标签和按钮 。“网址 안ーム”例如 是“网址架构”。
支持的集成和广告格式
适用于 maio 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- iOS 部署目标为 12.0 或更高版本
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 maio 界面中设置配置
首先,注册或登录您的 maio 帐号。点击左侧边栏中的应用管理按钮,然后点击新建应用。
选择与首选广告类型对应的标签。
插页式广告
输入应用的名称,选择平台并提供应用网址。选择视频插页式广告作为广告类型,然后点击更新。
已奖励
输入应用的名称,选择平台并提供应用网址。选择视频奖励作为广告类型,然后点击更新。
在应用管理页面中,记下媒体 ID。在下一部分设置广告单元时,需要用到该标识符。 AdMob
在 Zone Management(区域管理)页面中,记下 Zone ID(区域 ID)。在下一部分中设置广告单元时, AdMob 也需要使用它。
第 2 步:在界面中设置 maio 需求 AdMob
为广告单元配置中介设置
您需要将 maio 添加到广告单元的中介配置。
首先,登录您的 AdMob 帐号。接下来,前往中介标签页。如果您想修改现有的中介组,请点击该中介组的名称进行修改,然后直接跳转到添加 maio 作为广告来源。
要创建新的中介组,请选择创建中介组。
输入您的广告格式和平台,然后点击继续。
为中介组命名,然后选择要定位到的地理位置。接下来,将中介组的状态设置为已启用,然后点击添加广告单元。
将此中介组与您的一个或多个现有AdMob 广告单元相关联。接着,点击完成。
现在,您应该会看到广告单元卡片内填充了您选择的广告单元:
添加为广告来源 maio
在广告来源部分的广告瀑布流卡片下,选择添加广告来源。然后选择 maio。
选择 maio 并启用优化开关。输入在上一部分获得的 API ID and API KEY,为maio设置广告来源优化。 然后,为maio 输入有效每千次展示费用值,并点击继续。如果您已有 maio的映射,则可以选择它。否则,请点击添加映射。
接下来,输入在上一部分中获取的 Media ID and Zone ID。接着,点击完成。
第 3 步:导入 maio SDK 和适配器
使用 CocoaPods(推荐)
将以下代码行添加到项目的 Podfile 中:
pod 'GoogleMobileAdsMediationMaio'
在命令行中运行以下命令:
pod install --repo-update
手动集成
第 4 步:添加所需的代码
SKAdNetwork 集成
按照 maio 文档中的说明操作
将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 5 步:测试实现效果
启用测试广告
请务必为 AdMob。
使用 Google 移动广告 SDK 7.26.0 或更高版本的发布商会在发出请求时,自动在已注册为测试设备的手机和平板电脑上接收 maio 的测试广告。
验证测试广告
如需验证您收到的是来自maio的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 maio (Waterfall)
错误代码
如果适配器无法从 maio 收到广告,
发布商可以使用
GADResponseInfo.adNetworkInfoArray
分为以下类:
格式 | 类名称 |
---|---|
插页式广告 | GADMMaioInterstitialAdapter |
激励广告 | GADMMaioRewardedAdapter |
当广告加载失败时,maio 适配器会抛出以下代码和随附的消息:
错误代码 | 原因 |
---|---|
0-10 | maio 返回了与 SDK 相关的错误。请参阅 maio 的代码 了解详情。 |
101 | maio 还没有可投放的广告。 |
102 | 服务器参数无效(例如,缺少展示位置 ID)。 |
103 | maio 适配器不支持所请求的广告格式。 |
104 | 已加载此广告联盟配置的广告。 |
maio iOS 中介适配器更新日志
版本 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
- 第一个版本!
- 添加了对插页式广告和激励视频广告的支持。