本指南介绍了如何使用 Google 移动广告 SDK 通过中介功能加载和展示来自 i-mobile 的广告,其中包括广告瀑布流集成。文中介绍了如何将 i-mobile 添加到广告单元的中介配置中,以及如何将 i-mobile SDK 和适配器集成到 Android 应用中。
i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图尚未翻译。不过,在本指南的说明和说明中,标签和按钮在英语中进行了等效翻译(用括号表示)。
支持的集成和广告格式
AdMob i-mobile 中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布图 | |
表现形式 | |
横幅 | |
插页式广告 | |
已奖励 | |
原生 |
要求
- Android API 级别 19 或更高级别
- 最新版 Google 移动广告 SDK
第 1 步:设置 i-mobile
依次点击 SAıtos/アプבManagement(网站/应用管理)标签页并点击新Android アプכ(新 Android 应用) 按钮,将您的应用添加到 i-mobile 信息中心。
提供应用的名称(名称)和 Κーケト 网址(市场网址),以注册应用。 接着,在填写表单的其余部分后,点击新的规定登上(注册)按钮。
如需创建新的广告位置,请在 SAıtos/アプ Management(网站/应用管理)标签页下选择您的应用。
进入 🇪?🇸? 管理(广告插播位管理)标签页,然后点击新建关联广告支出回报率(新广告插播位)按钮。
接下来,请填写此表单,填写 🏿?เดลอีname(广告插播位名称)、🇨?安全的 (广告插播位尺寸)和其他详细信息。然后,点击 New 如需详细了解登陆(注册)按钮。
新的广告插播位已准备就绪。如需查看其集成详情,请点击 アプラーン订购(获取应用设置)按钮。
记下 🇨?🇦?🇨?🇦?🇦?ต 为了 ID(发布商 ID)、🇨?ア ID(媒体 ID)和 ID(Spot ID)。您稍后需要在 AdMob 界面中为中介配置 i-mobile 时需要使用这些参数。
第 2 步:为您的广告单元配置 AdMob 中介设置
现在,您需要将 i-mobile 添加到广告单元的中介配置中。为此,请先登录您的 AdMob 帐号。
接下来,请前往中介标签页。如果您有要修改的现有中介组,请点击该中介组的名称进行修改,然后直接跳至将 i-mobile 添加为广告来源。
要创建新的中介组,请选择创建中介组。
输入您的广告格式和平台,然后点击继续。

为中介组命名,然后选择要定位到的地理位置。接下来,将中介组状态设置为已启用。然后,点击添加广告单元。

将此中介组与您现有的 AdMob 广告单元相关联。然后,点击完成。

您现在应该可以看到“广告单元”卡片中填充了您选择的广告单元。

将 i-mobile 添加为广告来源
在广告来源卡片中,选择添加广告联盟。
选择 i-mobile 并启用优化功能。输入 i-mobile 帐号的登录名和 API 密码,为 i-mobile 设置广告来源优化。然后,为 i-mobile 输入 eCPM 值,并点击继续。
如果您已经有了 i-mobile 的映射,只需选择它即可。 否则,请点击添加映射。
接下来,输入在上一部分中获得的映射名称、发布商 ID、媒体 ID 和Spot ID。然后,点击完成。
第 3 步:导入 i-mobile SDK 和适配器
Android Studio 集成(推荐)
在应用级 build.gradle
文件中添加以下实现依赖项,以及最新版本的 i-mobile SDK 和适配器:
repositories { google() mavenCentral() maven { url "https://imobile.github.io/adnw-sdk-android" } } ... dependencies { implementation 'com.google.android.gms:play-services-ads:22.1.0' implementation 'com.google.ads.mediation:imobile:2.3.1.1' } ...
手动集成
下载最新版本的 i-mobile SDK,提取
sdk
文件夹下的android-ad-sdk.aar
,并将其添加到您的项目。导航到 Google 的 Maven 代码库中的 i-mobile 适配器工件。选择最新版本,下载 i-mobile 适配器的
.aar
文件,并将其添加到您的项目。
第 4 步:需要其他代码
i-mobile 集成无需其他代码。
第 5 步:测试您的实现效果
为了测试您的集成,i-mobile 针对所有广告格式提供了测试电视广告 ID、媒体 ID 和发布商 ID。您可以在此处找到它们。
可选步骤
使用原生广告
广告呈现
i-mobile 适配器会为
NativeAd
填充以下
原生广告高级字段说明
。
字段 | 始终由 i-mobile 适配器包含的素材资源 |
---|---|
标题 | |
图片 | |
正文 | |
应用图标 | 1 |
号召性用语 | |
星级 | |
商店 | |
价格 |
1对于原生广告,i-mobile SDK 不提供应用图标素材资源。相反,i-mobile 适配器会使用透明图片填充应用图标。
错误代码
如果适配器无法从 i-mobile 接收广告,发布商可以使用以下类下的
ResponseInfo.getAdapterResponse()
从广告响应中检查底层错误:
形式 | 类名称 |
---|---|
横幅 | com.google.ads.Mediation.imobile.IMobileAdapter |
插页式广告 | com.google.ads.Mediation.imobile.IMobileAdapter |
原生 | com.google.ads.Mediation.imobile.IMobileMediationAdapter |
如果广告加载失败,则 i-mobile 适配器会抛出以下代码和随附的消息:
错误代码 | 原因 |
---|---|
0-99 | i-mobile SDK 返回错误。如需了解详情,请参阅代码。 |
101 | i-mobile 需要 Activity 上下文才能加载广告。 |
102 | AdMob 界面中配置的 i-mobile 服务器参数缺失/无效。 |
103 | 请求的广告尺寸与支持移动设备的横幅广告尺寸不符。 |
104 | i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。 |
0-10 | i-mobile SDK 返回错误。如需了解详情,请参阅代码。 |
101 | AdMob 界面中配置的 i-mobile 服务器参数缺失/无效。 |
102 | 请求的广告尺寸与支持移动设备的横幅广告尺寸不符。 |
103 | i-mobile 未能展示广告。 |
104 | i-mobile 返回空的原生广告数组。 |
105 | i-mobile 未能下载原生广告素材资源。 |
106 | i-mobile 不支持请求使用同一 Spot ID 的多个插页式广告。 |
i-mobile Android 中介适配器更新日志
版本 2.3.1.1
- 将适配器更新为使用新的
VersionInfo
类。 - 将要求的最低 Google 移动广告 SDK 版本更新为 22.0.0。
构建和测试所需版本:
- Google 移动广告 SDK 22.0.0 版。
- IMobile SDK 版本 2.3.1。
版本 2.3.1.0
- 经验证可与 i-mobile SDK v2.3.1 兼容。
- 将要求的最低 Google 移动广告 SDK 版本更新为 21.5.0。
构建和测试所需版本:
- Google 移动广告 SDK 21.5.0 版。
- IMobile SDK 版本 2.3.1。
版本 2.3.0.0
- 经验证可与 i-mobile SDK v2.3.0 兼容。
- 要求的最低 Google 移动广告 SDK 版本已更新至 21.3.0。
构建和测试所需版本:
- Google 移动广告 SDK 21.3.0 版。
- IMobile SDK 版本 2.3.0。
版本 2.0.23.1
- 将
compileSdkVersion
和targetSdkVersion
更新为 API 31。 - 将要求的最低 Google 移动广告 SDK 版本更新为 21.0.0。
- 将最低的 Android API 级别更新为 19。
构建和测试所需版本:
- Google 移动广告 SDK 21.0.0 版。
- IMobile SDK 版本 2.0.23。
版本 2.0.23.0
- 经验证可与 i-mobile SDK v2.0.23 兼容。
- 将要求的最低 Google 移动广告 SDK 版本更新为 20.5.0。
构建和测试所需版本
- Google 移动广告 SDK 20.5.0 版。
- IMobile SDK 版本 2.0.23。
版本 2.0.22.2
- 添加了标准化的适配器错误代码和消息。
- 要求的最低 Google 移动广告 SDK 版本已更新至 20.1.0。
构建和测试所需版本
- Google 移动广告 SDK 20.1.0 版。
- IMobile SDK 版本 2.0.22。
版本 2.0.22.1
- 将要求的最低 Google 移动广告 SDK 版本更新为 20.0.0。
构建和测试所需版本
- Google 移动广告 SDK 20.0.0 版。
- IMobile SDK 版本 2.0.22。
版本 2.0.22.0
- 经验证可与 i-mobile SDK v2.0.22 兼容。
- 更新了适配器,以支持内嵌自适应横幅广告请求。
构建和测试所需版本
- Google 移动广告 SDK 19.1.0.
- IMobile SDK 版本 2.0.22。
版本 2.0.21.0
- 经验证可与 i-mobile SDK v2.0.21 兼容。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.1.0。
- 新增了对扩展自适应横幅广告的支持。
构建和测试所需版本
- Google 移动广告 SDK 19.1.0.
- IMobile SDK 版本 2.0.21。
版本 2.0.20.2
- 新增了对灵活横幅广告尺寸的支持。
- 将要求的最低 Google 移动广告 SDK 版本更新为 18.3.0。
构建和测试所需版本
- Google 移动广告 SDK 18.3.0 版。
- IMobile SDK 版本 2.0.20。
版本 2.0.20.1
- 适配器现在会返回非零
mediaContent
宽高比。
构建和测试所需版本
- Google 移动广告 SDK 18.2.0 版。
- IMobile SDK 版本 2.0.20。
版本 2.0.20.0
- 初始版本!
- 新增了对横幅广告、插页式广告和原生广告的支持。