将 maio 与中介集成

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

maio 的信息中心界面的标签、按钮和说明使用日语文本，本指南中的屏幕截图尚未翻译。不过，在本指南的说明和说明中，我们会使用英语标签和按钮来引用标签和按钮。例如，“网址 スキーム”是“网址架构”。

支持的集成和广告格式

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

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

要求

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

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

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

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

插页式广告

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

激励广告

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

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

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

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

第 2 步：在 Ad Manager 界面中设置 Maio 需求来源

为广告单元配置中介设置

登录您的 Ad Manager 账号。

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

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

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

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

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

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

选择收益合作伙伴后，选择移动 SDK 中介作为集成类型，选择 Android 作为平台，并选择有效作为状态。输入您在上一部分中获取的媒体 ID 和区域 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.6.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

手动集成

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

第 4 步：添加所需代码

无需额外代码即可实现 maio Android 集成。

第 5 步：测试您的实现

启用测试广告

请务必为 Ad Manager 注册测试设备。

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

验证测试广告

如需验证您是否在接收来自 maiio 的测试广告，请在广告检查器中使用 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

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