将 maio 与中介集成

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

Maio 的信息中心界面使用日语文本作为标签、按钮和说明,本指南中的屏幕截图未翻译。不过,在本指南的说明和说明中,标签和按钮有其对应的英语版本。例如,“网址 すーム”是“网址 Scheme”等。

支持的集成和广告格式

适用于 maio 的 Ad Manager 中介适配器具有以下功能:

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

要求

  • Android API 级别 19 或更高级别
  • maio SDK 1.0.7 或更高版本
  • 最新版 Google 移动广告 SDK

  • 完成中介 入门指南

第 1 步:在 Maio 界面中设置配置

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

选择与首选广告类型对应的标签。

插页式广告

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

已奖励

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

应用管理页面中,记下媒体 ID。在下一部分设置广告单元时,需要用到该标识符。 Ad Manager

Zone Management(区域管理)页面中,记下 Zone ID(区域 ID)。在下一部分中设置广告单元时, Ad Manager 也需要使用它。

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

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

为广告单元配置中介设置

登录您的 Ad Manager 帐号

依次转到投放 > 收益组,然后点击新建收益组按钮。

为您的收益组输入一个独一无二的名称,将状态设为有效,选择广告格式,然后将广告资源类型设为移动应用。在定位 > 广告资源部分下,选择广告资源移动应用(您要向其中添加中介)下方的广告单元。

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

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

选择 maio 作为广告联盟,输入一个具有唯一性的名称并启用中介

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

选择收益合作伙伴后,选择移动 SDK 中介作为集成类型,选择 Android 作为平台,选择有效作为状态。输入在上一部分获得的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.0.0")
    implementation("com.google.ads.mediation:maio:1.1.16.2")
}

手动集成

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

第 4 步:添加所需的代码

进行 maio Android 集成不需要额外的代码。

第 5 步:测试您的实现

启用测试广告

请务必为 Ad Manager。

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

验证测试广告

如需验证您收到的是来自maio的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试maio (Waterfall)

错误代码

如果适配器未能收到来自 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”实例。
0-10 maio 返回了特定于 SDK 的错误。如需了解详情,请参阅 maio 的代码
101 maio 目前还没有广告。
102 服务器参数无效(例如缺少展示位置 ID)。
103 Maio 适配器不支持所请求的广告格式。
104 已针对此网络配置加载了一个广告。

maio Android Mediation Adapter 更新日志

下一版本

  • 将 Google 移动广告 SDK 的最低版本更新为 22.4.0。

版本 1.1.16.2

  • 更新了适配器以使用新的 VersionInfo 类。
  • 将 Google 移动广告 SDK 最低版本更新到了 22.0.0。

构建和测试方式:

  • Google 移动广告 SDK 22.0.0 版
  • Maio SDK 版本 1.1.16。

版本 1.1.16.1

  • compileSdkVersiontargetSdkVersion 更新为了 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

  • 修复了可能导致广告加载失败时出现 NullPointerExceptions 的问题。

版本 1.0.7.0

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

版本 1.0.6.0

  • 首个版本!
  • 添加了对插页式广告和激励视频广告的支持。