将 Maio 与中介集成

选择平台： Android（Beta 版） Android iOS Unity Flutter

本指南介绍了如何使用 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 账号。点击左侧边栏中的应用管理 按钮，然后点击新应用 。

选择与您偏好的广告类型 对应的标签页。

插页式广告

输入应用的名称 ，选择平台并提供应用网址 。选择视频插页式广告 作为广告类型 ，然后 点击更新 。

注意 ：maio 的插页式广告默认可跳过。

激励广告

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

注意 ：maio 的激励视频广告默认不可 跳过。

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

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

除了 Media ID 和 Zone ID 之外，您还需要 API ID 和 API KEY 才能为中介设置广告单元 ID。在 Reporting API 页面 中， 记下 API ID 和 API 密钥 。

注意 如果您是首次设置 maio 账号，可能 需要与 maio 的支持团队联系，以便他们向您发放 API ID 和 API 密钥。

第 2 步：在 Ad Manager 界面中设置 maio 需求

为广告单元配置中介设置

登录您的 Ad Manager 账号。

依次前往投放 > 收益组 ，然后点击新建收益组 按钮。

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

接下来，点击添加收益合作伙伴 按钮。

如果您已有 maio 的收益合作伙伴 ，可以选择该合作伙伴。否则，请选择创建新的收益合作伙伴 。

选择 maio 作为 广告联盟 ，输入唯一的名称 并启用中介 。

开启数据收集，然后输入在上一部分中获得的 API ID 和 API KEY 。

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

重要提示 ： Media ID 必须与目标应用相关联，就像在 maio 界面中一样。

完成后，点击页面底部的保存 。

**注意**： 自动数据收集需要几天时间来收集数据，然后才能 准确计算中介广告联盟的动态每千次展示费用值。一旦可以计算 eCPM，系统就会自动为您更新。

第 3 步：导入 maio SDK 和适配器

**注意**： 如果未能集成兼容的 maio 和 GMA Next-Gen 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 步：测试您的实现

启用测试广告

确保针对 Ad Manager 注册测试设备。

如果发布商使用的是 GMA Next-Gen SDK 11.6.0 或更高版本，则在发出请求时，系统会自动在注册为 测试设备 的手机和平板电脑上展示来自 maio 的测试广告。

**重要提示**： 在发布应用之前，请针对 Ad Manager 和 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` 实例。