本指南介绍了如何使用 Google 移动广告 SDK 通过中介从 maio 加载和展示广告,其中包括广告瀑布流集成。它介绍了如何将 maio 添加到广告单元的中介配置,以及如何将 maio SDK 和适配器集成到 应用中。
Maio 的信息中心界面使用日语文本作为标签、按钮和说明,本指南中的屏幕截图未翻译。不过,在本指南的说明和说明中,标签和按钮有其对应的英语版本。例如,“网址 すーム”是“网址 Scheme”等。
支持的集成和广告格式
适用于 maio 的 Ad Manager 中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
已奖励 | |
原生 |
要求
- iOS 部署目标为 12.0 或更高版本
最新版 Google 移动广告 SDK
完成中介 入门指南
第 1 步:在 Maio 界面中设置配置
首先,注册或登录您的 maio 帐号。点击左侧边栏中的应用管理按钮,然后点击新建应用。
选择与首选广告类型对应的标签。
插页式广告
输入应用的名称,选择平台并提供应用网址。选择视频插页式广告作为广告类型,然后点击更新。
Android
iOS
已奖励
输入应用的名称,选择平台并提供应用网址。选择视频奖励作为广告类型,然后点击更新。
Android
iOS
在应用管理页面中,记下媒体 ID。在下一部分设置广告单元时,需要用到该标识符。 Ad Manager
Android
iOS
在 Zone Management(区域管理)页面中,记下 Zone ID(区域 ID)。在下一部分中设置广告单元时, Ad Manager 也需要使用它。
Android
iOS
第 2 步:在界面中设置 Ad Manager 需求
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
第 3 步:导入 maio SDK 和适配器
使用 CocoaPods(推荐)
将以下代码行添加到项目的 Podfile 中:
pod 'GoogleMobileAdsMediationMaio'
在命令行中运行以下命令:
pod install --repo-update
手动集成
第 4 步:添加所需的代码
SKAdNetwork 集成
按照 maio 的文档操作,将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 5 步:测试您的实现
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager
בעלי אפליקציות שמשתמשים בגרסה 7.26.0 ואילך של Google Mobile Ads SDK יקבלו באופן אוטומטי מודעות בדיקה מ-maio בטלפונים ובטאבלטים שרשומים כמכשירי בדיקה בזמן שליחת בקשות.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-maio, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות maio (Waterfall) מקורות המודעות.
错误代码
如果适配器未能收到来自 maio 的广告,发布商可以通过以下类下的
GADResponseInfo.adNetworkInfoArray
的类:
形式 | 类名称 |
---|---|
插页式广告 | GADMMaioInterstitialAdapter |
已奖励 | GADMMaioRewardedAdapter |
以下是广告加载失败时 maio 适配器抛出的代码及附带消息:
错误代码 | 原因 |
---|---|
0-10 | maio 返回了特定于 SDK 的错误。如需了解详情,请参阅代码和 maio 的文档。 |
101 | Maio 没有广告。 |
102 | 服务器参数无效(例如缺少展示位置 ID)。 |
103 | 用于加载广告的上下文不是“Activity”实例。 |
0-10 | maio 返回了特定于 SDK 的错误。如需了解详情,请参阅 maio 的代码。 |
101 | maio 目前还没有广告。 |
102 | 服务器参数无效(例如缺少展示位置 ID)。 |
103 | Maio 适配器不支持所请求的广告格式。 |
104 | 已针对此网络配置加载了一个广告。 |
maio iOS 中介适配器更新日志
版本 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 广告 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
- 首个版本!
- 添加了对插页式广告和激励视频广告的支持。