将 i-mobile 与中介集成

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

i-mobile 的控制台界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图未经翻译。不过，本指南的说明和说明中，标签和按钮均已翻译，并在括号中注明了英语对等字词。

支持的集成和广告格式

适用于 i-mobile 的 Ad Manager 中介适配器具有以下功能：

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

要求

  • Unity 5.6 或更高版本
  • 最新版 Google 移动广告 SDK
  • 如需在 Android 上部署，请执行以下操作：
    • Android API 级别 21 或更高级别
  • 要在 iOS 上部署，需具备以下条件：
    • iOS 部署目标为 12.0 或更高版本
  • 使用 Google 移动广告 SDK 配置的有效 Unity 项目。如需了解详情，请参阅开始使用。
  • 完成中介入门指南

第 1 步：在 i-mobile 界面中设置配置

注册或登录您的 i-mobile 账号。

依次点击 サイト／アプリ管理 (Site/Application Management) 标签页和应用所属平台的按钮，将您的应用添加到 i-mobile 信息中心。

Android

iOS

填写表单，然后点击 新規登録 (Sign up) 按钮。

Android

iOS

如需创建新的广告展示位置，请在 サイト／アプリ管理 (Site/Application Management) 标签页下选择您的应用。

Android

iOS

前往 広告スポット管理 (Ad Spot Management) 标签页，然后点击 新規広告スポット (New Ad Spot) 按钮。

create_ad_spot

接下来，填写表单，提供広告スポット名 (Ad Spot name)、広告スポットサイズ (Ad Spot size) 和其他详细信息。然后，点击 新規登録 (Sign up) 按钮。

new_ad_spot_form

您的新广告展示位置已准备就绪。如需查看其集成详情，请点击 アプリ設定取得 (Get App settings) 按钮。

ad_spot_list

记下 パブリッシャー ID (Publisher ID)、メディア ID (Media ID) 和 スポット ID (Spot ID)。稍后，当您在 Ad Manager 界面中将 i-mobile 配置为中介时，需要使用这些参数。

Android

iOS

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

为广告单元配置中介设置

Android

如需查看相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需了解相关说明，请参阅 iOS 指南中的第 2 步。

第 3 步：导入 i-mobile SDK 和适配器

OpenUPM-CLI

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

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

OpenUPM

在 Unity 项目编辑器中，依次选择 Edit（修改）> Project Settings（项目设置）> Package Manager（软件包管理器），以打开 Unity Package Manager Settings（Unity Package Manager 设置）。

在受限注册库标签页下，将 OpenUPM 添加为受限注册库，并提供以下详细信息：

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

OpenUPM 详情

然后，依次前往 Window > Package Manager 以打开 Unity Package Manager，然后从下拉菜单中选择 My Registries。

Unity 注册表

选择 Google 移动广告 i-mobile 中介软件包，然后点击 Install。

通过 OpenUPM 安装

Unity 软件包

从更新日志中的下载链接下载适用于 i-mobile 的最新版 Google 移动广告中介插件，然后从 ZIP 文件中提取 GoogleMobileAdsIMobileMediation.unitypackage。

在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsIMobileMediation.unitypackage 文件。确保选择所有文件，然后点击 Import（导入）。

从 Unity 导入

然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

强制解析

第 4 步：需要额外的代码

Android

无需额外代码即可实现 i-mobile 集成。

iOS

SKAdNetwork 集成

按照 i-mobile 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步：测试您的实现

启用测试广告

请务必为 Ad Manager 注册测试设备。 i-mobile 提供测试广告素材 ID、媒体 ID 和发布商 ID，您可以在此处找到它们。

验证测试广告

如需验证您是否在接收来自 i-mobile 的测试广告，请在广告检查器中使用 i-mobile（广告瀑布流）广告来源启用单一广告来源测试。

错误代码

如果适配器未能从 i-mobile 收到广告，发布商可以使用以下类下的 ResponseInfo 检查广告响应的根本错误：

Android

格式 类名称
横幅 com.google.ads.mediation.imobile.IMobileAdapter
插页式广告 com.google.ads.mediation.imobile.IMobileAdapter
原生 com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

格式 类名称
横幅 IMobileAdapter
插页式广告 IMobileAdapter
原生 GADMediationAdapterIMobile

以下是 i-mobile 适配器在广告加载失败时抛出的代码和随附消息：

Android

错误代码 原因
0-99 i-mobile SDK 返回了错误。如需了解详情，请参阅代码。
101 i-mobile 需要 Activity 上下文才能加载广告。
102 在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失或无效。
103 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
104 i-mobile 的原生广告加载成功回调返回了空的原生广告列表。

iOS

错误代码 原因
0-10 i-mobile SDK 返回了错误。如需了解详情，请参阅代码。
101 在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失或无效。
102 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
103 i-mobile 未能展示广告。
104 i-mobile 返回了一个空的原生广告数组。
105 i-mobile 未能下载原生广告素材资源。
106 i-mobile 不支持使用同一广告展示位置 ID 请求多个插页式广告。

i-mobile Unity 中介插件更新日志

版本 1.3.6

版本 1.3.5

版本 1.3.4

版本 1.3.3

1.3.2 版

版本 1.3.1

版本 1.3.0

版本 1.2.2

版本 1.2.1

版本 1.2.0

版本 1.1.0

版本 1.0.2

版本 1.0.1

版本 1.0.0