将 Maio 与中介集成

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

本指南介绍了如何使用 GMA Next-Gen SDK 通过中介加载和展示来自 maio 的广告，其中涵盖了瀑布流集成。如何将 maio 添加到广告单元的中介配置，以及如何将 maio SDK 和适配器集成到 Android 应用中。

maio 的信息中心界面使用日语文本作为标签、按钮和说明，本指南中的屏幕截图尚未翻译。不过，在本指南的说明和操作说明中，标签和按钮均以其英文等效项表示。“网址 スキーム”（例如）是“网址 方案”。

支持的集成和广告格式

maio 的中介适配器具有以下功能：

要求

• Android API 级别 24 或更高级别

• maio SDK 1.0.7 或更高版本

• “GMA Next-Gen SDK”的最新视频。

• 完成中介入门指南。

第 1 步：在 maio 界面中设置配置

首先，注册或登录您的 maio 账号。点击左侧边栏中的应用管理按钮，然后点击新应用。

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

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

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

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

为广告单元配置中介设置

登录您的 Ad Manager 账号。

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

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

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

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

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

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

选择收益合作伙伴后，选择移动 SDK 中介作为集成类型，Android 作为平台，有效作为状态。输入您在上一部分中获得的媒体资源 ID 和广告资源 ID。然后，输入默认每千次展示费用值。

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

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

Android Studio 集成（推荐）

在项目级 settings.gradle.kts 文件中，添加以下代码库：

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

在应用级 Gradle 文件中，添加以下实现依赖项和配置：

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

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 的测试广告。

验证测试广告

若要验证您是否能收到来自 maio 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 maio (Waterfall)（maio [瀑布流]）作为广告来源。

错误代码

如果适配器未能收到来自 maio 的广告，发布商可以使用 ResponseInfo.getAdSourceResponses() 来检查广告响应中归属于以下类的底层错误：

以下是当广告加载失败时，Maio 适配器会抛出的代码和随附的消息：