本指南将向您介绍如何使用 Google 移动广告 SDK 通过 中介、(涵盖广告瀑布流集成)加载和展示来自 i-mobile 的广告。其中介绍了如何将 i-mobile 添加到广告单元的中介配置中,以及如何将 i-mobile SDK 和适配器集成到 应用中。
i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图尚未翻译。不过,在本指南的说明和说明中,标签和按钮在翻译后会用英文括号括起来。
支持的集成和广告格式
i-mobile 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
已奖励 | |
原生 |
要求
- iOS 部署目标为 12.0 或更高版本
最新版 Google 移动广告 SDK
看完中介服务入门指南
第 1 步:在 i-mobile 界面中设置配置
点击 ika イト/affiliate Management(网站/应用管理)标签页和应用平台对应的按钮,将您的应用添加到 i-mobile 信息中心。
Android
iOS
填写表单,然后点击新规定登录按钮。
Android
iOS
要创建新的广告插播位,请在 {5}对该/企业管理(网站/应用管理)标签页下选择您的应用。
Android
iOS
进入支持 Clickserver 管理(广告插播位管理)标签页,然后点击新规范编写 ット (New Ad Spot) 按钮。
接下来,填写以下表单:提供支持 プット名(广告插播位名称)、提供有关某个广告 的小程序 (广告 Spot 尺寸) 和其他详细信息。然后,点击 新式登榜(注册)按钮。
您的新广告插播位已准备就绪。如需查看其集成详情,请点击 Action to Settings Get (Get App settings) 按钮。
请记下小吃日本 ID(发布商 ID)、手机 ID(媒体 ID)和彷设有 ID (Spot ID)。您稍后在 Ad Manager 界面中为中介配置 i-mobile 时,将会用到这些参数。
Android
iOS
第 2 步:在界面中设置 i-mobile 需求 Ad Manager
Vermittlungseinstellungen für Anzeigenblöcke konfigurieren
Android
Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.
iOS
Eine Anleitung dazu finden Sie in Schritt 2 der Anleitung für iOS.
第 3 步:导入 i-mobile SDK 和适配器
使用 CocoaPods(推荐)
将以下代码行添加到项目的 Podfile 中:
pod 'GoogleMobileAdsMediationIMobile'
在命令行中运行以下命令:
pod install --repo-update
手动集成
- 下载最新版本的 i-mobile SDK,并在项目中关联
ImobileSdkAds.framework
。 - 通过更新日志中的下载链接下载最新版本的 i-mobile 适配器,并在项目中关联
IMobileAdapter.framework
。
第 4 步:添加所需的代码
SKAdNetwork 集成
按照 i-mobile 的文档中的说明,将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 5 步:测试实现效果
启用测试广告
请务必为 Ad Manager。 i-mobile 提供用于测试的测试 Spot ID、媒体 ID 和发布商 ID,您可以在此处找到它们。
验证测试广告
如需验证您收到的是来自i-mobile的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 i-mobile (Waterfall)
可选步骤
使用原生广告
广告呈现
i-mobile 适配器会填充
GADNativeAd
。
字段 | i-mobile 适配器始终包含素材资源 |
---|---|
标题 | |
映像 | |
正文 | |
应用图标 | 1 |
号召性用语 | |
星级 | |
商店 | |
价格 |
1 对于原生广告,i-mobile SDK 不提供应用图标素材资源。相反,i-mobile 适配器会使用透明图片填充应用图标。
错误代码
如果适配器未能接收来自 i-mobile 的广告,发布商可以使用
GADResponseInfo.adNetworkInfoArray
,位于以下类下:
格式 | 类名称 |
---|---|
横幅 | IMobileAdapter |
插页式广告 | IMobileAdapter |
原生 | GADMediationAdapterIMobile |
当广告加载失败时,i-mobile 适配器会抛出以下代码和随附的消息:
错误代码 | 原因 |
---|---|
0-99 | i-mobile SDK 返回了错误。如需了解详情,请参阅代码。 |
101 | i-mobile 需要 Activity 上下文才能加载广告。 |
102 | 界面中配置的 i-mobile 服务器参数缺失/无效。 Ad Manager |
103 | 请求的广告尺寸与 i-mobile 支持的横幅尺寸不匹配。 |
104 | i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。 |
0-10 | i-mobile SDK 返回了错误。如需了解详情,请参阅代码。 |
101 | 界面中配置的 i-mobile 服务器参数缺失/无效。 Ad Manager |
102 | 请求的广告尺寸与 i-mobile 支持的横幅尺寸不匹配。 |
103 | i-mobile 无法展示广告。 |
104 | i-mobile 返回了一个空的原生广告数组。 |
105 | i-mobile 未能下载原生广告素材资源。 |
106 | i-mobile 不支持使用同一 Spot ID 请求多个插页式广告。 |
i-mobile iOS 中介适配器更新日志
版本 2.3.4.0
- 已验证与 i-mobile SDK 2.3.4 的兼容性。
- 在
adSDKVersion
中添加了对返回 i-mobile SDK 版本的支持。
构建和测试时所用平台:
- Google 移动广告 SDK 11.2.0 版。
- i-mobile SDK 2.3.4 版。
版本 2.3.3.0
- 已验证与 i-mobile SDK 2.3.3 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 11.1.0 版。
- i-mobile SDK 2.3.3 版。
版本 2.3.2.1
- 从横幅广告、插页式广告和原生广告的植入方式中移除了已废弃的
willBackgroundApplication
委托方法。 - 现在要求最低 iOS 版本为 12.0。
- 现在需要 Google 移动广告 SDK 11.0 或更高版本。
- 在
IMobileAdapter.xcframework
的框架中添加了Info.plist
。
构建和测试时所用平台:
- Google 移动广告 SDK 11.0.1 版。
- i-mobile SDK 2.3.2 版。
版本 2.3.2.0
- 已验证与 i-mobile SDK 2.3.2 的兼容性。
- 移除了对
armv7
架构的支持。 - 现在要求最低 iOS 版本为 11.0。
- 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 10.4.0 版。
- i-mobile SDK 2.3.2 版。
版本 2.3.1.0
- 已验证与 i-mobile SDK 2.3.1 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 10.3.0 版。
- i-mobile SDK 2.3.1 版。
版本 2.3.0.1
- 现在需要 Google 移动广告 SDK 10.0.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 10.0.0 版。
- i-mobile SDK 2.3.0 版。
版本 2.3.0.0
- 已验证与 i-mobile SDK 2.3.0 的兼容性。
- 现在需要 Google 移动广告 SDK 9.8.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 9.13.0 版。
- i-mobile SDK 2.3.0 版。
版本 2.2.0.1
- 现在需要 Google 移动广告 SDK 9.0.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 9.0.0 版。
- i-mobile SDK 2.2.0 版。
版本 2.2.0.0
- 已验证与 i-mobile SDK 2.2.0 版的兼容性。
构建和测试所用的
- Google 移动广告 SDK 8.13.0 版。
- i-mobile SDK 2.2.0 版。
版本 2.1.0.1
- 放宽了对 Google 移动广告 SDK 8.0.0 或更高版本的依赖。
构建和测试所用的
- Google 移动广告 SDK 8.4.0 版。
- i-mobile SDK 2.1.0 版。
版本 2.1.0.0
- 已验证与 i-mobile SDK 2.1.0 版的兼容性。
- 现在需要 Google 移动广告 SDK 8.1.0 或更高版本。
- 将适配器更新为使用
.xcframework
格式。
构建和测试所用的
- Google 移动广告 SDK 8.1.0 版。
- i-mobile SDK 2.1.0 版。
版本 2.0.33.1
- 添加了标准化的适配器错误代码和消息。
- 适配器现在会限制请求使用相同 i-mobile Spot ID 的多个插页式广告。
- 现在,适配器会在点按原生广告时转发
-nativeAdWillLeaveApplication:
回调。 - 现在需要 Google 移动广告 SDK 7.68.0 或更高版本。
构建和测试所用的
- Google 移动广告 SDK 7.68.0 版。
- i-mobile SDK 2.0.33 版。
版本 2.0.33.0
- 已验证与 i-mobile SDK 2.0.33 版的兼容性。
- 现在需要 Google 移动广告 SDK 7.65.0 或更高版本。
- 现在要求 iOS 最低版本为 9.0。
构建和测试所用的
- Google 移动广告 SDK 7.65.0 版。
- i-mobile SDK 2.0.33 版。
版本 2.0.32.0
- 已验证与 i-mobile SDK 2.0.32 版兼容。
- 现在需要 Google 移动广告 SDK 7.60.0 或更高版本。
- 添加了对缩放 320x50 和 320x100 广告的支持,以更好地适应自适应横幅广告请求尺寸。
- 取消了对 i386 架构的支持。
构建和测试所用的
- Google 移动广告 SDK 7.60.0 版。
- i-mobile SDK 2.0.32 版。
版本 2.0.31.0
- 已验证与 i-mobile SDK 2.0.31 版兼容。
构建和测试所用的
- Google 移动广告 SDK 7.53.1 版。
- i-mobile SDK 2.0.31 版。
版本 2.0.29.0
- 初始版本!
- 新增了对横幅广告、插页式广告和原生广告的支持。
构建和测试所用的
- Google 移动广告 SDK 7.52.0 版。
- i-mobile SDK 2.0.29 版。