本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用 投放来自 Line 的广告 AdMob 中介、 包括广告瀑布流集成其中介绍了如何向广告单元的 中介配置,以及如何将 Line SDK 和适配器集成到 一款 Android 应用。
Line 的信息中心界面使用日语文本作为标签, 按钮和说明本指南中的屏幕截图 。不过,在本指南的说明和说明中,标签和 相应按钮在翻译后会用英文括号括起来。
支持的集成和广告格式
Line 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | 1 |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
1 广告瀑布流集成目前处于公开 Beta 版阶段。
要求
- Android API 级别 21 或更高级别
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 Line 界面中设置配置
第 2 步:在界面中设置 AdMob 订单项需求
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać Line do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Line jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.
Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj Line jako źródło reklam
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Line.
Kliknij Line. Następnie wpisz wartość eCPM dlaLine i kliknij Dalej.Jeśli masz już mapowanie Line, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane Application ID and Slot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
第 3 步:导入 Line SDK 和适配器
Android Studio 集成(推荐)
在应用级 build.gradle.kts
文件中,添加以下实现
依赖项和配置使用最新版本的 Line SDK
和适配器:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:line:2.8.20240808.0")
}
手动集成
第 4 步:添加所需的代码
LINE 集成无需额外代码。
第 5 步:测试实现效果
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob.
Aby dowiedzieć się, jak włączyć reklamy testowe, postępuj zgodnie z instrukcjami podanymi w dokumentacji linii
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyLine, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Line (Waterfall) źródeł reklam.
可选步骤
广告联盟专有参数
Line 适配器支持附加请求参数,该参数可以传递
适配器使用 LineExtras
类。此类构造函数包括
以下参数:
enableAdSound
- 一个
boolean
,用于指定横幅的默认声音启动状态; 插页式广告和激励广告
以下示例代码展示了如何创建可设置这些参数的广告请求:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
使用原生广告
广告呈现
Line 适配器会填充以下内容
原生高级广告字段说明
针对
NativeAd
。
字段 | 素材资源始终包含在 Line Adapter 中 |
---|---|
标题 | |
映像 | |
正文 | |
应用图标 | 1 |
号召性用语 | |
星级 | |
商店 | |
价格 |
1 对于原生广告,Line SDK 不提供应用图标资源。相反,Line 适配器会填充应用, 图标和透明图片
错误代码
如果适配器无法接收来自 Line 的广告,您可以检查
使用
ResponseInfo.getAdapterResponses()
分为以下类:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
以下是 Line 适配器在以下情况下抛出的代码及其附带消息: 广告加载失败:
错误代码 | 网域 | 原因 |
---|---|---|
1-10 | com.five_corp.ad | Line SDK 返回了与 SDK 相关的错误。请参阅 行的文档 了解详情。 |
101 | com.google.ads.mediation.line | 应用 ID 缺失或无效。 |
102 | com.google.ads.mediation.line | 广告位 ID 缺失或无效。 |
103 | com.google.ads.mediation.line | 请求的广告尺寸与 Line 支持的横幅广告尺寸不匹配。 |
104 | com.google.ads.mediation.line | 由于缺少活动上下文,未能加载插页式广告或激励广告。 |
105 | com.google.ads.mediation.line | Line SDK 无法展示插页式广告或激励广告。 |
106 | com.google.ads.mediation.line | 由于缺少素材资源,无法加载原生广告。 |
LINE Android 中介适配器更新日志
版本 2.8.20240808.0
- 已验证与 FiveAd SDK 版本 2.8.20240808.0 的兼容性
构建和测试时所用平台:
- Google 移动广告 SDK 23.2.0 版。
- FiveAd SDK 版本 2.8.20240808.0
版本 2.8.20240722.0
- 已验证与 FiveAd SDK 版本 2.8.20240722.0 的兼容性
构建和测试时所用平台:
- Google 移动广告 SDK 23.2.0 版。
- FiveAd SDK 版本 2.8.20240722.0
版本 2.7.20240515.0
- 已验证与 FiveAd SDK 版本 2.7.20240515.0 的兼容性
构建和测试时所用平台:
- Google 移动广告 SDK 23.1.0 版。
- FiveAd SDK 版本 2.7.20240515.0
版本 2.7.20240214.1
- 将所需的最低 Google 移动广告 SDK 版本更新为 23.0.0。
- 已验证与 FiveAd SDK 版本 2.7.20240214.0 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 版本 23.0.0。
- FiveAd SDK 版本 2.7.20240214.0。
版本 2.7.20240214.0
- 已验证与 FiveAd SDK 版本 2.7.20240214.0 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.6.0 版。
- FiveAd SDK 版本 2.7.20240214.0。
版本 2.7.20240126.0
- 已验证与 FiveAd SDK 版本 2.7.20240126.0 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.6.0 版。
- FiveAd SDK 版本 2.7.20240126.0。
版本 2.7.20240112.0
- 移除了已弃用的
FiveAdViewEventListener
,取而代之的是FiveAdCustomLayoutEventListener
、FiveAdVideoRewardEventListener
、FiveAdInterstitialEventListener
和FiveAdNativeEventListener
。 - 已验证与 FiveAd SDK 版本 2.7.20240112 的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 22.6.0。
构建和测试时所用平台:
- Google 移动广告 SDK 22.6.0 版。
- FiveAd SDK 版本 2.7.20240112。
版本 2.6.20230607.1
- 为发布商添加了
LineExtras
类,以便为其定义默认声音设置 横幅广告、插页式广告和激励广告格式。 - 将所需的最低 Google 移动广告 SDK 版本更新为 22.4.0。
构建和测试时所用平台:
- Google 移动广告 SDK 22.4.0 版。
- FiveAd SDK 版本 2.6.20230607。
版本 2.6.20230607.0
- 初始版本。
- 添加对横幅广告、插页式广告、激励广告和原生广告格式的支持。
- 已验证与 FiveAd SDK 版本 2.6.20230607 的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.1.0 版。
- FiveAd SDK 版本 2.6.20230607。