本指南介绍了如何使用 GMA Next-Gen SDK 通过 中介加载和展示来自 maio 的 广告,其中涵盖了瀑布流集成。本指南还介绍了如何将 maio 添加到广告单元的中介配置中,以及如何将 maio SDK 和适配器集成到 Android 应用中。
maio 的信息中心界面使用日文文本作为标签、按钮和说明,本指南中的屏幕截图未经过翻译。不过,在本指南的说明和说明中,标签和按钮均使用其英文等效项进行引用。例如,“网址 スキーム”是“网址 Scheme”。
支持的集成和广告格式
maio 的中介适配器具有以下功能:
| 集成 | |
|---|---|
| 出价 | |
| 瀑布流 | |
| 格式 | |
| 横幅 | |
| 插页式广告 | |
| 激励广告 | |
| 原生 | |
要求
- Android API 级别 24 或更高级别
- maio SDK 1.0.7 或更高版本
最新版 GMA Next-Gen SDK。
通读中介 入门指南。
第 1 步:在 maio 界面中设置配置
首先,注册 或登录您的 maio 账号。点击左侧边栏中的应用管理 按钮,然后点击新应用 。

选择与您偏好的广告类型 对应的标签页。
插页式广告
输入应用的名称 ,选择平台并提供应用网址 。选择视频插页式广告 作为广告类型 ,然后 点击更新 。

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

在应用管理 页面中,记下 媒体 ID 。您需要在下一部分中设置 Ad Manager 广告单元。

在区域管理 页面中,记下 Zone ID 。您还需要在下一部分中设置 Ad Manager 广告单元。


第 2 步:在 Ad Manager 界面中设置 maio 需求
为广告单元配置中介设置
登录您的 Ad Manager 账号。
依次前往投放 > 收益组 ,然后点击新建收益组 按钮。

为收益组输入唯一的名称,将状态设置为有效, 选择广告格式,并将广告资源类型设置为移动应用。 在定位条件 > 广告资源部分下,选择要添加中介的 广告资源和移动应用下的广告单元。
接下来,点击添加收益合作伙伴 按钮。

如果您已有 maio 的收益合作伙伴 ,可以选择该合作伙伴。否则,请选择创建新的收益合作伙伴 。
选择 maio 作为 广告联盟 ,输入唯一的名称 并启用中介 。
开启数据收集,然后输入在上一部分中获得的 API ID 和 API KEY 。

选择收益合作伙伴 后,选择移动 SDK 中介 作为集成类型,Android 作为 平台,有效作为状态。输入在上一部分中获得的 Media ID 和 Zone ID 。然后,输入默认 CPM 值。

完成后,点击页面底部的保存 。
第 3 步:导入 maio SDK 和适配器
Android Studio 集成(推荐)
在项目级 settings.gradle.kts 文件中,添加以下代码库:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
在应用级 Gradle 文件中,添加以下实现依赖项和配置:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:maio:2.0.8.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:maio:2.0.8.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
手动集成
- 下载最新版本的 maio Android SDK 并将 其添加到您的项目中。
- 前往 Google 的 Maven 制品库中的 maio 适配器工件。选择最新版本,下载 maio 适配器的 `.aar' 文件,并将其添加到您的项目中。
第 4 步:添加必需的代码
maio Android 集成不需要其他代码。
第 5 步:测试您的实现
启用测试广告
如果发布商使用的是 GMA Next-Gen SDK 11.6.0 或更高版本,则在发出请求时,系统会自动在注册为 测试设备 的手机和平板电脑上展示来自 maio 的测试广告。
验证测试广告
若要验证您是否能收到来自 maio 的测试广告,请在广告检查器中启用 single ad source testing (单个广告来源测试),并选择 maio (Waterfall)(maio [瀑布流])作为广告来源。
错误代码
如果适配器未能收到来自 maio 的广告,
发布商可以使用
ResponseInfo.getAdSourceResponses()
来检查广告响应中的底层错误:
| 格式 | 类名称 |
|---|---|
| 插页式广告 | 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` 实例。 |