将 Maio 与中介集成

本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用中介功能从 maio 投放广告， 包括广告瀑布流集成其中介绍了如何向广告单元的 中介配置，以及如何将 maio SDK 和适配器集成到 Unity 应用。

maio 的信息中心界面使用日语文本作为其标签、按钮 且本指南中的屏幕截图尚未翻译。 然而，在这里的说明和说明中，标签和按钮 。“网址 查看和管理例如 “网址架构”依此类推。

支持的集成和广告格式

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

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

要求

  • Unity 4 或更高版本
  • 最新版 Google 移动广告 SDK
  • 在 Android 上部署 <ph type="x-smartling-placeholder">
      </ph>
    • Android API 级别 21 或更高级别
  • 在 iOS 上部署 <ph type="x-smartling-placeholder">
      </ph>
    • iOS 部署目标为 12.0 或更高版本
  • 使用 Google 移动广告 SDK 配置的有效 Unity 项目。请参阅 如需了解详情，请开始使用。
  • 完成中介流程 入门指南

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

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

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

插页式广告

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

Android

iOS

已奖励

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

Android

iOS

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

Android

iOS

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

Android

iOS

（仅限广告瀑布流） 除了媒体 ID 和区域 ID 之外，您还需要 API ID 和 API 密钥，才能为中介设置广告单元 ID。在“报告 API”页面中，记下 API ID 和 API 密钥。

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

为广告单元配置中介设置

Android

如需了解相关说明，请参阅 Android。

iOS

如需了解相关说明，请参阅 iOS 版。

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

OpenUPM-CLI

如果您有 OpenUPM-CLI 您就可以安装 Google 移动广告 maio 运行以下命令，将适用于 Unity 的中介插件添加到您的项目中 从项目的根目录：

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

在 Unity 项目编辑器中，选择 Edit（修改）>项目设置 > Package Manager 打开 Unity Package Manager 设置。

在 Scoped Registries 标签页下，将 OpenUPM 添加为作用域注册表，并执行以下操作： 以下详细信息：

  • 名称：OpenUPM
  • URL：https://package.openupm.com
  • 范围：com.google

OpenUPM 详细信息

然后，依次转到窗口 >Package Manager 打开 Unity Package Manager 和 从下拉菜单中选择 My Registries。

Unity 注册表

选择 Google 移动广告 maio Mediation 软件包，然后 点击安装。

从 OpenUPM 安装

Unity 软件包

下载针对以下指标的最新版 Google 移动广告中介插件： 下载链接中的 maio 更新日志 并提取 邮编中的 GoogleMobileAdsMaioMediation.unitypackage 文件。

在 Unity 项目编辑器中，选择 Assets >导入软件包 > 自定义软件包，然后找到 GoogleMobileAdsMaioMediation.unitypackage 文件。确保已选择所有文件，然后点击 导入。

从 Unity 导入

然后，选择资产 >Play Services 解析器 > Android 解析器 >Force Resolve。Unity Play Services Resolver 库将从头开始执行依赖项解析，并将 声明的依赖项的 Assets/Plugins/Android 目录 Unity 应用。

强制解决

第 4 步：添加所需的代码

Android

无需其他代码即可进行 maio 集成。

iOS

SKAdNetwork 集成

按照 maio 文档中的说明操作 将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步：测试实现效果

启用测试广告

请务必为 Ad Manager。

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

验证测试广告

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

错误代码

如果适配器未收到来自 maio 的广告，发布商可以检查 使用 ResponseInfo（位于 以下类：

Android

格式 类名称
插页式广告 jp.maio.sdk.android.mediation.admob.adapter.Interstitial
激励广告 jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

格式 类名称
插页式广告 GADMMaioInterstitialAdapter
激励广告 GADMMaioRewardedAdapter

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

Android

错误代码 原因
0-10 maio 返回了与 SDK 相关的错误。请参阅代码 以及 maio 的文档 了解详情。
101 Maio 没有可投放的广告。
102 服务器参数无效（例如，缺少展示位置 ID）。
103 用于加载广告的上下文不是 `Activity` 实例。

iOS

错误代码 原因
0-10 maio 返回了与 SDK 相关的错误。请参阅 maio 的代码 了解详情。
101 maio 还没有可投放的广告。
102 服务器参数无效（例如，缺少展示位置 ID）。
103 maio 适配器不支持所请求的广告格式。
104 已加载此广告联盟配置的广告。

maio Unity 中介插件更新日志

版本 2.0.3

版本 2.0.2

版本 2.0.1

版本 2.0.0

版本 1.4.3

版本 1.4.2

版本 1.4.1

版本 1.4.0

版本 1.3.6

版本 1.3.5

版本 1.3.4

版本 1.3.3

版本 1.3.2

版本 1.3.1

版本 1.3.0

版本 1.2.3

  • 更新了插件以支持新的激励广告 API。
  • 支持 maio Android 适配器版本 1.1.7.0。
  • 支持 maio iOS 适配器版本 1.4.6.0。

版本 1.2.2

  • 支持 maio Android 适配器版本 1.1.6.0。
  • 支持 maio iOS 适配器版本 1.4.2.0。

版本 1.2.1

  • 支持 maio Android 适配器版本 1.1.6.0。
  • 支持 maio iOS 适配器版本 1.4.1.0。

版本 1.2.0

  • 支持 maio Android 适配器版本 1.1.4.1。
  • 支持 maio iOS 适配器版本 1.4.0.0。

版本 1.1.3

  • 支持 maio Android 适配器版本 1.1.3.1。
  • 支持 maio iOS 适配器版本 1.3.2.0。

版本 1.1.2

  • 支持 maio Android 适配器版本 1.1.3.0。
  • 支持 maio iOS 适配器版本 1.3.2.0。

版本 1.1.1

  • 支持 maio Android 适配器版本 1.1.1.0。
  • 支持 maio iOS 适配器版本 1.3.1.1。

版本 1.1.0

  • 支持 maio Android 适配器版本 1.1.0.0。
  • 支持 maio iOS 适配器版本 1.3.0.0。

版本 1.0.2

  • 支持 maio Android SDK 1.0.8 版。
  • 支持 maio iOS SDK 1.2.19 版。

版本 1.0.1

  • 支持 maio Android SDK 1.0.7 版。
  • 支持 maio iOS SDK 1.2.19 版。

版本 1.0.0

  • 第一个版本！
  • 支持 maio Android SDK 1.0.6 版。
  • 支持 maio iOS SDK 1.2.18 版。