本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用 中介、 包括广告瀑布流集成其中介绍了如何将 i-mobile 添加到广告单元的 中介配置,以及如何将 i-mobile SDK 和适配器集成到 一款 Android 应用。
i-mobile 的信息中心界面使用日语文本作为标签, 按钮和说明本指南中的屏幕截图 。不过,在本指南的说明和说明中,标签和 相应按钮在翻译后会用英文括号括起来。
支持的集成和广告格式
i-mobile 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- Android API 级别 21 或更高级别
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 i-mobile 界面中设置配置
点击 ika イト/affiliate Management(网站/应用管理)标签页和应用平台对应的按钮,将您的应用添加到 i-mobile 信息中心。
![](https://developers.google.cn/admob/images/mediation/imobile/select_platform_Android.png?authuser=7&hl=th)
填写表单,然后点击新规定登录按钮。
![](https://developers.google.cn/admob/images/mediation/imobile/add_app_name_Android.png?authuser=7&hl=th)
要创建新的广告插播位,请在 {5}对该/企业管理(网站/应用管理)标签页下选择您的应用。
![](https://developers.google.cn/admob/images/mediation/imobile/app_list_Android.png?authuser=7&hl=th)
进入支持 Clickserver 管理(广告插播位管理)标签页,然后点击新规范编写 ット (New Ad Spot) 按钮。
接下来,填写以下表单:提供支持 プット名(广告插播位名称)、提供有关某个广告 的小程序 (广告 Spot 尺寸) 和其他详细信息。然后,点击 新式登榜(注册)按钮。
您的新广告插播位已准备就绪。如需查看其集成详情,请点击 Action to Settings Get (Get App settings) 按钮。
请记下小吃日本 ID(发布商 ID)、手机 ID(媒体 ID)和彷设有 ID (Spot ID)。您稍后在 Ad Manager 界面中为中介配置 i-mobile 时,将会用到这些参数。
![](https://developers.google.cn/admob/images/mediation/imobile/ad_spot_details_Android.png?authuser=7&hl=th)
第 2 步:在界面中设置 i-mobile 需求 Ad Manager
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำสำหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาภายใต้พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง
จากนั้น คลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับi-mobileอยู่แล้ว คุณก็เลือกได้ มิเช่นนั้น ให้เลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก i-mobile เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำ และเปิดใช้สื่อกลาง
เปิดการรวบรวมข้อมูลอัตโนมัติ แล้วป้อนLogin name and API Password
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนPublisher ID, Media ID and Spot ID ที่ได้รับในส่วนก่อนหน้านี้ จากนั้นป้อนค่า CPM เริ่มต้น
คลิกบันทึกที่ด้านล่างของหน้าเมื่อทำเสร็จแล้ว
第 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, รหัสสื่อ และ รหัสผู้เผยแพร่โฆษณา สำหรับการทดสอบไว้ทดสอบ ซึ่งคุณจะดูได้ที่นี่
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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 | 界面中配置的 i-mobile 服务器参数缺失/无效。 Ad Manager |
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
- 初始版本!
- 新增了对横幅广告、插页式广告和原生广告的支持。