本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用 中介、 包括广告瀑布流集成其中介绍了如何将 i-mobile 添加到广告单元的 中介配置,以及如何将 i-mobile SDK 和适配器集成到 一款 Android 应用。
i-mobile 的信息中心界面使用日语文本作为标签, 按钮和说明本指南中的屏幕截图未经翻译。不过,在本指南的说明和说明中,标签和 相应按钮在翻译后会用英文括号括起来。
支持的集成和广告格式
i-mobile 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- Android API 级别 21 或更高级别
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 i-mobile 界面中设置配置
第 2 步:在界面中设置 i-mobile 需求 Ad Manager
第 3 步:导入 i-mobile SDK 和适配器
Android Studio 集成(推荐)
在项目级 settings.gradle.kts
文件中,添加以下代码
代码库:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
然后,在应用级 build.gradle.kts
文件中,添加以下代码
实现依赖项和配置使用最新版本的
i-mobile SDK 和适配器:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
手动集成
下载最新版本的 i-mobile SDK 提取
android-ad-sdk.aar
(位于sdk
文件夹下),并将其添加到您的项目。转到 i-mobile 适配器工件 。选择最新版本,下载 i-mobile 适配器的
.aar
文件,并将其添加到您的项目。
第 4 步:添加所需的代码
无需额外代码即可实现 i-mobile 集成。
第 5 步:测试实现效果
启用测试广告
请务必为 Ad Manager。 i-mobile 提供用于测试的测试 Spot ID、媒体 ID 和发布商 ID,您可以在此处找到它们。
验证测试广告
如需验证您收到的是来自i-mobile的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 i-mobile (Waterfall)
可选步骤
使用原生广告
广告呈现
i-mobile 适配器会填充以下内容
字段
针对
NativeAd
。
字段 | i-mobile 适配器始终包含素材资源 |
---|---|
标题 | |
映像 | |
正文 | |
应用图标 | 1 |
号召性用语 | |
星级 | |
商店 | |
价格 |
1 对于原生广告,i-mobile SDK 不提供应用图标素材资源。相反, i-mobile 适配器会使用透明图片填充应用图标。
错误代码
如果适配器无法接收来自 i-mobile 的广告,
发布商可以使用
ResponseInfo.getAdapterResponses()
分为以下类:
格式 | 类名称 |
---|---|
横幅 | 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 | 在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失/无效。 |
103 | 请求的广告尺寸与 i-mobile 支持的横幅尺寸不匹配。 |
104 | i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。 |
i-mobile Android 中介适配器更新日志
版本 2.3.2.0
- 已验证与 i-mobile SDK v2.3.2 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 23.1.0 版。
- IMobile SDK 2.3.2 版。
版本 2.3.1.2
- 将所需的最低 Google 移动广告 SDK 版本更新为 23.0.0。
- 已验证与 i-mobile SDK v2.3.1 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 版本 23.0.0。
- IMobile SDK 2.3.1 版。
版本 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
- 初始版本!
- 添加了对横幅广告、插页式广告和原生广告的支持。