미디에이션과 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 ID 和 API 密钥，才能为中介设置广告单元 ID。在“报告 API”页面中，记下 API ID 和 API 密钥。

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

광고 단위에 대한 미디에이션 설정 구성

Ad Manager 계정에 로그인합니다.

게재 > 수익 그룹으로 이동하여 새 수익 그룹 버튼을 클릭합니다.

수익 그룹의 고유한 이름을 입력하고 상태를 활성으로 설정한 후 광고 형식을 선택하고 인벤토리 유형을 모바일 앱으로 설정합니다. 타겟팅 > 인벤토리 섹션에서 미디에이션을 추가할 인벤토리 및 모바일 애플리케이션 아래의 광고 단위를 선택합니다.

그런 다음 수익 파트너 추가 버튼을 클릭합니다.

maio에 대한 수익 파트너가 이미 있는 경우 이를 선택할 수 있습니다. 그렇지 않은 경우 새 수익 파트너 만들기를 선택합니다.

maio을 광고 네트워크로 선택하고 고유한 이름을 입력한 다음 미디에이션을 사용 설정합니다.

자동 데이터 수집을 사용 설정하고 이전 섹션에서 확인한API ID and API KEY 을 입력합니다.

수익 파트너가 선택되면 모바일 SDK 미디에이션을 통합 유형으로, Android를 플랫폼으로, 활성을 상태로 선택합니다. 이전 섹션에서 가져온Media ID and Zone ID 를 입력합니다. 그런 다음 기본 CPM 값을 입력합니다.

완료되면 페이지 하단의 저장을 클릭합니다.

第 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

Google 모바일 광고 SDK 버전 11.6.0 이상을 사용하는 게시자는 요청을 할 때 테스트 기기로 등록된 스마트폰 및 태블릿에서 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

  • 将 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

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

版本 1.0.6.0

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