本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过 中介加载和展示来自 i-mobile 的 广告,其中涵盖了瀑布流集成。本指南还介绍了如何将 i-mobile 添加到广告单元的中介配置中,以及如何将 i-mobile SDK 和适配器集成到 Unity 应用中。
i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图未经过翻译。不过,在本指南的说明和说明中,标签和按钮都附有英文翻译(以英文翻译的形式显示在括号中)。
支持的集成和广告格式
i-mobile 的 AdMob 中介适配器具有以下功能:
| 集成 | |
|---|---|
| 出价 | |
| 瀑布流 | |
| 表现形式 | |
| 横幅 | |
| 插页式广告 | |
| 激励广告 | |
要求
- 最新版 Google Mobile Ads Unity Plugin
- Unity 5.6 或更高版本
- 如需在 Android 上部署,则要求:
- Android API 级别 23 或更高
- 如需在 iOS 上部署,则要求:
- iOS 部署目标版本为 13.3 或更高版本
- 一个正常运行的 Unity 项目,且已配置 Google Mobile Ads Unity Plugin。如需了解详情,请参阅 设置 Google Mobile Ads Unity Plugin。
- 设置 AdMob 中介。
第 1 步:在 i-mobile 界面中设置配置
依次点击サイト/アプリ管理(网站/应用管理) 标签页和应用平台的按钮,将应用添加到 i-mobile 信息中心。
Android

iOS

填写表单,然后点击新規登録(注册) 按钮。
Android

iOS

如需创建新的广告位,请在サイト/アプリ管理(网站/应用管理) 标签页下选择您的应用。
Android

iOS

前往広告スポット管理(广告位管理) 标签页,然后点击新規広告スポット(新建广告位) 按钮。
接下来,填写表单,提供広告スポット名(广告位名称)、 広告スポットサイズ(广告位尺寸)和其他详细信息。然后,点击新規登録(注册) 按钮。
新的广告插播位 已准备就绪。如需查看其集成详细信息,请点击アプリ設定取得(获取应用设置) 按钮。
记下パブリッシャー ID(发布商 ID)、メディア ID(媒体 ID)、 和スポット ID(广告位 ID)。稍后在 AdMob 界面中配置 i-mobile 以进行中介时,您将需要这些参数。
Android

iOS

更新 app-ads.txt
应用授权卖方 app-ads.txt 是一项 IAB Tech Lab 计划,有助于确保只通过您认定的授权渠道销售您的
应用广告资源。为避免损失大量广告收入,您需要实现
app-ads.txt 文件。
如果您尚未为应用设置 app-ads.txt 文件,请立即设置。
set up an app-ads.txt file for your app.
如需为 i-mobile 实现 app-ads.txt,请参阅其
常见问题解答。
第 2 步:在 AdMob 界面中设置 i-mobile 需求
为广告单元配置中介设置
第 3 步:导入 i-mobile SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI ,则可以通过从项目的根目录运行以下命令,将 Google 移动广告 i-mobile 中介插件 for Unity 安装到项目中:
openupm add com.google.ads.mobile.mediation.imobileOpenUPM
在 Unity 项目编辑器中,依次选择 Edit (修改)> Project Settings (项目设置)> Package Manager (软件包管理器),打开 Unity Package Manager Settings(Unity 软件包管理器设置)。
在 Scoped Registries (限定范围的注册表)标签页下,将 OpenUPM 添加为限定范围的注册表,并提供以下详细信息:
- 名称:
OpenUPM - 网址:
https://package.openupm.com - 范围:
com.google
然后,依次选择 Window (窗口)> Package Manager (软件包管理器),打开 Unity 软件包管理器,并从下拉菜单中选择 My Registries (我的注册表)。
选择 Google Mobile Ads IMobile Mediation 软件包,然后点击 Install (安装)。
Unity 软件包
在 Unity 项目编辑器中,依次选择 Assets (资源)> Import Package (导入软件包)> Custom Package (自定义软件包),然后找到您下载的
GoogleMobileAdsIMobileMediation.unitypackage 文件。确保选择所有文件,然后点击 Import (导入)。
然后,依次选择 Assets (资源)> External Dependency Manager (外部依赖项管理器)> Android Resolver (Android 解析器)> Force Resolve (强制解析)。外部依赖项管理器库将从头开始执行依赖项解析,并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。
第 4 步:其他必需的代码
Android
i-mobile 集成不需要其他代码。
iOS
SKAdNetwork 集成
按照 i-mobile 的文档
,将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 5 步:测试您的实现
启用测试广告
确保针对 AdMob 注册测试设备。i-mobile 提供测试广告位 ID、媒体 ID、 和 发布商 ID,您可以在 此处找到它们。
验证测试广告
若要验证您是否能收到来自 i-mobile 的测试广告,请在广告检查器中启用 single ad source testing (单个广告来源测试),并选择 i-mobile (Waterfall)(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 | AdMob 界面中配置的 i-mobile 服务器参数缺失或无效。 |
| 103 | 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。 |
| 104 | i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。 |
iOS
| 错误代码 | 原因 |
|---|---|
| 0-10 | i-mobile SDK 返回了错误。如需了解详情,请参阅代码。 |
| 101 | AdMob 界面中配置的 i-mobile 服务器参数缺失或无效。 |
| 102 | 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。 |
| 103 | i-mobile 未能展示广告。 |
| 104 | i-mobile 返回了一个空的原生广告数组。 |
| 105 | i-mobile 未能下载原生广告资源。 |
| 106 | i-mobile 不支持使用同一广告位 ID 请求多个插页式广告。 |
i-mobile Unity 中介插件变更日志
版本 1.3.12
- 支持 i-mobile Android 适配器版本 2.3.2.3。
- 支持 i-mobile iOS 适配器版本 2.3.4.7。
- 使用 Google 移动广告 Unity 插件版本 11.1.0 构建和测试。
版本 1.3.11
- 支持 i-mobile Android 适配器版本 2.3.2.3。
- 支持 i-mobile iOS 适配器版本 2.3.4.6。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 1.3.10
- 支持 i-mobile Android 适配器版本 2.3.2.2。
- 支持 i-mobile iOS 适配器版本 2.3.4.5。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 1.3.9
- 支持 i-mobile Android 适配器版本 2.3.2.1。
- 支持 i-mobile iOS 适配器版本 2.3.4.5。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 1.3.8
- 支持 i-mobile Android 适配器版本 2.3.2.1。
- 支持 i-mobile iOS 适配器版本 2.3.4.3。
- 使用 Google 移动广告 Unity 插件版本 10.6.0 构建和测试。
版本 1.3.7
- 支持 i-mobile Android 适配器版本 2.3.2.1。
- 支持 i-mobile iOS 适配器版本 2.3.4.2。
- 使用 Google 移动广告 Unity 插件版本 10.0.0 构建和测试。
版本 1.3.6
- 支持 i-mobile Android 适配器版本 2.3.2.0。
- 支持 i-mobile iOS 适配器版本 2.3.4.1。
- 使用 Google 移动广告 Unity 插件版本 9.3.0 构建和测试。
版本 1.3.5
- 支持 i-mobile Android 适配器版本 2.3.2.0。
- 支持 i-mobile iOS 适配器版本 2.3.4.0。
- 使用 Google 移动广告 Unity 插件版本 9.1.0 构建和测试。
版本 1.3.4
- 支持 i-mobile Android 适配器版本 2.3.1.2。
- 支持 i-mobile iOS 适配器版本 2.3.4.0。
- 使用 Google 移动广告 Unity 插件版本 9.0.0 构建和测试。
版本 1.3.3
- 支持 i-mobile Android 适配器版本 2.3.1.1。
- 支持 i-mobile iOS 适配器版本 2.3.3.0。
- 使用 Google 移动广告 Unity 插件版本 9.0.0 构建和测试。
版本 1.3.2
- 已将适配器内容移至
GoogleMobileAds/Mediation/IMobile/。 - 支持 i-mobile Android 适配器版本 2.3.1.1。
- 支持 i-mobile iOS 适配器版本 2.3.2.0。
- 使用 Google 移动广告 Unity 插件版本 8.1.0 构建和测试。
版本 1.3.1
- 支持 i-mobile Android 适配器版本 2.3.0.0。
- 支持 i-mobile iOS 适配器版本 2.3.0.1。
- 使用 Google 移动广告 Unity 插件版本 7.4.1 构建和测试。
版本 1.3.0
- 支持 i-mobile Android 适配器版本 2.3.0.0。
- 支持 i-mobile iOS 适配器版本 2.3.0.0。
- 使用 Google 移动广告 Unity 插件版本 7.3.1 构建和测试。
版本 1.2.2
- 支持 i-mobile Android 适配器版本 2.0.23.1。
- 支持 i-mobile iOS 适配器版本 2.2.0.1。
- 使用 Google 移动广告 Unity 插件版本 7.0.2 构建和测试。
版本 1.2.1
- 支持 i-mobile Android 适配器版本 2.0.23.0。
- 支持 i-mobile iOS 适配器版本 2.2.0.1。
- 使用 Google 移动广告 Unity 插件版本 7.0.0 构建和测试。
版本 1.2.0
版本 1.1.0
版本 1.0.2
版本 1.0.1
版本 1.0.0
- 首次发布!
- 支持 i-mobile Android 适配器版本 2.0.20.1。
- 支持 i-mobile iOS 适配器版本 2.0.29.0。