将 Maio 与中介集成

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

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

支持的集成和广告格式

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

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

要求

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

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

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

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

插页式广告

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

激励广告

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

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

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

除了媒体 ID 和区域 ID 之外，在设置中介的广告单元 ID 时，您还需要 API ID 和 API 密钥。在 Reporting API 页面中，记下 API ID 和 API 密钥。

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

为广告单元配置中介设置

您需要将 maio 添加到广告单元的中介配置。

首先，登录您的 AdMob 帐号。接下来，前往中介标签页。如果您想修改现有的中介组，请点击该中介组的名称进行修改，然后直接跳转到添加 maio 作为广告来源。

要创建新的中介组，请选择创建中介组。

输入您的广告格式和平台，然后点击继续。

为中介组命名，然后选择要定位到的地理位置。接下来，将中介组的状态设置为已启用，然后点击添加广告单元。

将此中介组与您的一个或多个现有AdMob 广告单元相关联。接着，点击完成。

现在，您应该会看到广告单元卡片内填充了您选择的广告单元：

添加为广告来源 maio

在广告来源部分的广告瀑布流卡片下，选择添加广告来源。然后选择 maio。

选择 maio 并启用优化开关。输入在上一部分获得的 API ID and API KEY，为maio设置广告来源优化。 然后，为maio 输入有效每千次展示费用值，并点击继续。

如果您已有 maio的映射，则可以选择它。否则，请点击添加映射。

接下来，输入在上一部分中获取的 Media ID and Zone ID。接着，点击完成。

第 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 注册测试设备。

如果发布商使用的是 Google 移动广告 SDK 11.6.0 或更高版本，则在发出请求时，注册为测试设备的手机和平板电脑会自动收到来自 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` 实例。

5 月 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

  • 添加了通过向 AdRequest 添加测试设备 ID 来启用测试模式的功能。
  • 已验证与 maio SDK 版本 1.0.7 的兼容性。

版本 1.0.6.0

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