将 maio 与中介集成

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

maio 的信息中心界面使用日语标签、按钮和说明，并且本指南中的屏幕截图尚未翻译。不过，在本指南的说明和说明中，标签和按钮均使用其英语等效项进行引用。例如，“URL スキーム”是“网址架构”。

支持的集成和广告格式

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

集成
出价
瀑布
表现形式
横幅
插页式广告
激励广告
原生

要求

  • Android API 级别 21 或更高级别
  • maio SDK 1.0.7 或更高版本

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

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

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

插页式广告

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

激励广告

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

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

在可用区管理页面上，记下可用区 ID。您还需要在下一部分中设置 AdMob 广告单元。

除了媒体 ID 和区域 ID 之外，您还需要 API ID 和 API 密钥，才能设置广告单元 ID 以进行中介。在“报告 API”页面中，记下 API ID 和 API 密钥。

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

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

在项目级 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.5.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

手动集成

  • 下载最新版本的 maio Android SDK，并将其添加到您的项目中。
  • 转到 Google 的 Maven 制品库中的 maio 适配器工件。选择最新版本，下载 maio 适配器的 `.aar' 文件并将其添加到您的项目。

第 4 步：添加所需代码

maio Android 集成不需要其他代码。

第 5 步：测试您的实现

启用测试广告

请务必为 AdMob 注册测试设备。

使用 11.6.0 或更高版本 Google 移动广告 SDK 的发布商在发出请求时，会自动在已注册为测试设备的手机和平板电脑上收到 maio 发送的测试广告。

验证测试广告

如需验证您是否收到了来自 maio 的测试广告，请使用 maio（瀑布流）广告来源在广告检查器中启用单一广告来源测试。

错误代码

如果适配器未能从 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

  • 首次发布！
  • 新增了对插页式广告和激励视频广告的支持。