本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用中介功能从 i-mobile 中投放的广告, 包括广告瀑布流集成其中介绍了如何将 i-mobile 添加到广告单元的 中介配置,以及如何将 i-mobile SDK 和适配器集成到 一个 Unity 应用。
i-mobile 的控制台界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图 。不过,本指南的说明和说明中,标签和按钮均已翻译,并在括号中注明了英语对等字词。
支持的集成和广告格式
i-mobile 的 AdMob 中介适配器 以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 |
要求
- Unity 5.6 或更高版本
- 最新版 Google 移动广告 SDK
- 在 Android 上部署
- Android API 级别 21 或更高级别
- 在 iOS 上部署
- iOS 部署目标为 12.0 或更高版本
- 使用 Google 移动广告 SDK 配置的有效 Unity 项目。如需了解详情,请参阅开始使用。
- 完成中介流程 入门指南
第 1 步:在 i-mobile 界面中设置配置
第 2 步:在界面中设置 i-mobile 需求 AdMob
为广告单元配置中介设置
第 3 步:导入 i-mobile SDK 和适配器
OpenUPM-CLI
如果您有 OpenUPM-CLI 您就可以安装 Google 移动广告 i-mobile 运行以下命令,将适用于 Unity 的中介插件添加到您的项目中 从项目的根目录:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
在 Unity 项目编辑器中,选择 Edit(修改)>项目设置 > Package Manager 打开 Unity Package Manager 设置。
在受限注册库标签页下,将 OpenUPM 添加为受限注册库,并提供以下详细信息:
- 名称:
OpenUPM
- URL:
https://package.openupm.com
- 范围:
com.google
然后,依次转到窗口 >Package Manager 打开 Unity Package Manager 和 从下拉菜单中选择 My Registries。
选择 Google 移动广告 i-mobile 中介软件包,然后 点击安装。
Unity 软件包
从更新日志中的下载链接下载适用于 i-mobile 的最新版 Google 移动广告中介插件,然后从 ZIP 文件中提取 GoogleMobileAdsIMobileMediation.unitypackage
。
在 Unity 项目编辑器中,选择 Assets >导入软件包 >
自定义软件包,然后找到
GoogleMobileAdsIMobileMediation.unitypackage
文件。确保已选择所有文件,然后点击
导入。
然后,选择资产 >Play Services 解析器 >
Android 解析器 >Force Resolve。Unity Play 服务解析器库将从头开始执行依赖项解析,并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android
目录中。
第 4 步:需要其他代码
Android
i-mobile 集成无需额外代码。
iOS
SKAdNetwork 集成
按照 i-mobile 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 5 步:测试您的实现
启用测试广告
请务必为 AdMob。 i-mobile 提供用于测试的测试 Spot ID、媒体 ID 和发布商 ID,您可以在此处找到它们。
验证测试广告
如需验证您收到的是来自i-mobile的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 i-mobile (Waterfall)
错误代码
如果适配器无法接收来自 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 | 界面中配置的 i-mobile 服务器参数缺失/无效。 AdMob |
103 | 请求的广告尺寸与 i-mobile 支持的横幅尺寸不匹配。 |
104 | i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。 |
iOS
错误代码 | 原因 |
---|---|
0-10 | i-mobile SDK 返回了错误。如需了解详情,请参阅代码。 |
101 | 界面中配置的 i-mobile 服务器参数缺失/无效。 AdMob |
102 | 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。 |
103 | i-mobile 无法展示广告。 |
104 | i-mobile 返回了一个空的原生广告数组。 |
105 | i-mobile 未能下载原生广告素材资源。 |
106 | i-mobile 不支持使用同一 Spot ID 请求多个插页式广告。 |
i-mobile Unity 中介插件更新日志
版本 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。