Questa pagina è stata tradotta dall'API Cloud Translation.

Integra maio con la mediazione

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

maio 的信息中心界面使用日语文本作为其标签、按钮和说明，本指南中的屏幕截图尚未翻译。然而，在本指南的说明和说明中，标签和按钮具有其英语等效项。例如，“网址 샠”是“网址 Scheme”等。

支持的集成和广告格式

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

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

要求

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

最新版 Google 移动广告 SDK
通读中介入门指南

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

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

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

插页式广告

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

已奖励

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

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

在 Zone Management（区域管理）页面中，记下 Zone ID（区域 ID）。在下一部分中设置广告单元 AdMob 时，您也需要使用它。

除了媒体 ID 和区域 ID 之外，您还需要有 API ID 和 API 密钥才能设置用于中介的 Android 广告单元 ID。

在“报告 API”页面中，记下 API ID 和 API 密钥。

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

您需要将 maio 添加到广告单元的中介配置中。首先，登录您的 AdMob 帐号。

转到中介标签页。如果您想要修改现有的中介组，请点击该中介组的名称以进行修改，然后直接跳至将 maio 添加为广告来源。

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

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

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

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

现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元，如下所示：

将 maio 添加为广告来源

在“广告来源”卡片中，选择添加广告联盟。选择 maio 作为广告联盟，然后输入在上一部分中获取的 API ID 和 API 密钥，为 maio 设置广告来源优化。然后，输入 maio 的 eCPM 值，并点击继续。

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

接下来，输入在上一部分中获取的媒体 ID 和区域 ID。然后，点击完成。

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

Android Studio 集成（推荐）

在应用级 build.gradle 文件中，添加以下 maio Maven 制品库和实现依赖项，以及最新版本的 maio SDK：

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

...
dependencies {
   implementation 'com.google.android.gms:play-services-ads:22.5.0'
   implementation 'com.google.ads.mediation:maio:1.1.16.2'
}
...

手动集成

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

第 4 步：添加所需的代码

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

第 5 步：测试您的实现

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob.

I publisher che utilizzano la versione 11.6.0 o successive dell'SDK Google Mobile Ads riceveranno automaticamente gli annunci di prova da maio su telefoni e tablet registrati come dispositivi di test quando effettuano richieste.

Verifica annunci di prova

Per verificare di ricevere annunci di prova damaio, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le maio (Waterfall) origini annuncio.

错误代码

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

形式	类名称
插页式广告	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
已奖励	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

以下是广告加载失败时 maio 适配器抛出的代码和附带消息：

错误代码	原因
0-10	maio 返回了与特定 SDK 相关的错误。如需了解详情，请参阅 code 和 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

将 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

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

版本 1.0.7.0

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

版本 1.0.6.0

第一个版本！
新增了对插页式广告和激励视频广告的支持。