本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 来自 maio 的广告(使用 中介、 包括广告瀑布流集成其中介绍了如何向广告单元的 中介配置,以及如何将 maio SDK 和适配器集成到 Android 应用。
maio 的信息中心界面使用日语文本作为其标签、按钮 且本指南中的屏幕截图尚未翻译。 不过,在本指南的说明和说明中,标签和按钮 。“网址 查看和管理例如 是“网址架构”。
支持的集成和广告格式
适用于 maio 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- Android API 级别 21 或更高级别
- maio SDK 1.0.7 或更高版本
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 maio 界面中设置配置
首先,注册或登录您的 maio 帐号。点击左侧边栏中的应用管理按钮,然后点击新建应用。
选择与首选广告类型对应的标签。
插页式广告
输入应用的名称,选择平台并提供应用网址。选择视频插页式广告作为广告类型,然后点击更新。
已奖励
输入应用的名称,选择平台并提供应用网址。选择视频奖励作为广告类型,然后点击更新。
在应用管理页面中,记下媒体 ID。在下一部分设置广告单元时,需要用到该标识符。 Ad Manager
在 Zone Management(区域管理)页面中,记下 Zone ID(区域 ID)。在下一部分中设置广告单元时, Ad Manager 也需要使用它。
第 2 步:在界面中设置 maio 需求 Ad Manager
为广告单元配置中介设置
登录您的 Ad Manager 帐号。
依次转到投放 > 收益组,然后点击新建收益组按钮。
为您的收益组输入一个独一无二的名称,将状态设为有效,选择广告格式,然后将广告资源类型设为移动应用。在定位 > 广告资源部分下,选择广告资源和移动应用(您要向其中添加中介)下方的广告单元。
接下来,点击添加收益合作伙伴按钮。
如果您已有maio的收益合作伙伴,可以选择它。否则,请选择创建新的收益合作伙伴。
选择 maio 作为广告联盟,输入一个具有唯一性的名称并启用中介。
开启自动收集数据,然后输入在上一部分中获取的API ID and API KEY 。
选择收益合作伙伴后,选择移动 SDK 中介作为集成类型,选择 Android 作为平台,选择有效作为状态。输入在上一部分获得的Media ID and Zone ID 。然后,输入默认每千次展示费用值。
完成后,点击页面底部的保存。
第 3 步:导入 maio SDK 和适配器
Android Studio 集成(推荐)
在项目级 settings.gradle.kts
文件中,添加以下代码
代码库:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
然后,在应用级 build.gradle.kts
文件中,添加以下代码
实现依赖项和配置使用最新版本的
maio SDK 和适配器:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
手动集成
- 下载最新版本的 maio Android SDK 并添加 添加到您的项目中
- 转到 Google 的 Maven 制品库中的 maio 适配器工件。选择最新版本,下载 maio 适配器的 `.aar'文件,并将其添加到您的项目。
第 4 步:添加所需的代码
maio Android 集成不需要其他代码。
第 5 步:测试实现效果
启用测试广告
请务必为 Ad Manager。
使用 11.6.0 或更高版本 Google 移动广告 SDK 的发布商会在发出请求时,自动在已注册为测试设备的手机和平板电脑上接收 maio 的测试广告。
验证测试广告
如需验证您收到的是来自maio的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 maio (Waterfall)
错误代码
如果适配器无法从 maio 收到广告,
发布商可以使用
ResponseInfo.getAdapterResponses()
分为以下类:
格式 | 类名称 |
---|---|
插页式广告 | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
激励广告 | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
当广告加载失败时,maio 适配器会抛出以下代码和随附的消息:
错误代码 | 原因 |
---|---|
0-10 | maio 返回了与 SDK 相关的错误。请参阅代码 以及 maio 的文档 了解详情。 |
101 | Maio 没有可投放的广告。 |
102 | 服务器参数无效(例如,缺少展示位置 ID)。 |
103 | 用于加载广告的上下文不是 `Activity` 实例。 |
maio Android 中介适配器更新日志
版本 1.1.16.3
- 将所需的最低 Google 移动广告 SDK 版本更新为 23.0.0。
- 已验证与 maio SDK 版本 1.1.16 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 版本 23.0.0。
- Maio SDK 版本 1.1.16。
版本 1.1.16.2
- 更新了适配器,以使用新的
VersionInfo
类。 - 将所需的最低 Google 移动广告 SDK 版本更新为 22.0.0。
构建和测试时所用平台:
- Google 移动广告 SDK 22.0.0 版。
- Maio SDK 版本 1.1.16。
版本 1.1.16.1
- 将
compileSdkVersion
和targetSdkVersion
更新到了 API 31。 - 将所需的最低 Google 移动广告 SDK 版本更新为 21.0.0。
- 将所需的最低 Android API 级别更新为 19。
构建和测试时所用平台:
- Google 移动广告 SDK 21.0.0 版。
- Maio SDK 版本 1.1.16。
版本 1.1.16.0
- 更新了错误代码,以捕获其他 maio 错误。
- 已验证与 maio SDK 版本 1.1.16 的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.4.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.4.0 版。
- Maio SDK 版本 1.1.16。
版本 1.1.15.0
- 已验证与 maio SDK 版本 1.1.15 的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.0.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.0.0 版。
- Maio SDK 版本 1.1.15。
版本 1.1.14.0
- 添加了标准化的适配器错误代码和消息。
- 已验证与 maio SDK 版本 1.1.14 的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.8.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.8.0 版。
- Maio SDK 版本 1.1.14。
版本 1.1.13.0
- 已验证与 maio SDK 版本 1.1.13 的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.5.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.5.0 版。
- Maio SDK 版本 1.1.13。
版本 1.1.12.0
- 将所需的最低 Google 移动广告 SDK 版本更新为 19.4.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.4.0 版。
- Maio SDK 版本 1.1.12。
版本 1.1.11.1
- 现在,如果 maio 没有广告可以展示,广告请求将立即失败,以限制超时。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.1.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.1.0 版。
- Maio SDK 版本 1.1.11。
版本 1.1.11.0
- 已验证与 maio SDK 版本 1.1.11 的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 18.3.0。
构建和测试时所用平台:
- Google 移动广告 SDK 18.3.0 版。
- Maio SDK 版本 1.1.11。
版本 1.1.10.0
- 已验证与 maio SDK 版本 1.1.10 的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 18.2.0。
版本 1.1.8.0
- 已验证与 maio SDK 版本 1.1.8 的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 18.1.0。
版本 1.1.7.0
- 修正了一些错误。
- 已验证与 maio SDK 版本 1.1.7 的兼容性。
版本 1.1.6.1
- 更新了适配器,以支持新的激励广告 API。
- 将所需的最低 Google 移动广告 SDK 版本更新为 17.2.0。
版本 1.1.6.0
- 已验证与 maio SDK 版本 1.1.6 的兼容性。
版本 1.1.5.0
- 已验证与 maio SDK 版本 1.1.5 的兼容性。
版本 1.1.4.0
- 已验证与 maio SDK 版本 1.1.4 的兼容性。
版本 1.1.3.1
- 更新了适配器,以便与实例类(而不是单例)配合使用。
版本 1.1.3.0
- 已验证与 maio SDK 版本 1.1.3 的兼容性。
版本 1.1.2.1
- 使用更新后的初始化函数更新了适配器。
版本 1.1.2.0
- 已验证与 maio SDK 版本 1.1.2 的兼容性。
版本 1.1.1.1
- 更新了适配器,以调用
onRewardedVideoComplete()
广告事件。
版本 1.1.1.0
- 已验证与 maio SDK 1.1.1 版兼容。
版本 1.1.0.0
- 已验证与 maio SDK 版本 1.1.0 的兼容性。
版本 1.0.8.0
- 已验证与 maio SDK 版本 1.0.8 的兼容性。
版本 1.0.7.1
- 修复了可能导致在广告失败时引发 NullPointerException 的问题 等待加载。
版本 1.0.7.0
- 添加了通过将测试设备 ID 添加到
AdRequest
来启用测试模式的功能。 - 已验证与 maio SDK 版本 1.0.7 的兼容性。
版本 1.0.6.0
- 第一个版本!
- 新增了对插页式广告和激励视频广告的支持。