将 LINE Ads Network 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示来自 LINE Ads Network 的广告，其中涵盖了瀑布流集成。本指南还介绍了如何将 LINE Ads Network 添加到广告单元的中介配置中，以及如何将 LINE Ads Network SDK 和适配器集成到 Android 应用中。

LINE 广告网络的界面使用日语文字作为标签、按钮和说明。本指南中的屏幕截图尚未翻译。不过，在本指南的说明和操作指南中，标签和按钮都翻译成了英语，并用英文等效项括起来。

支持的集成和广告格式

LINE Ads Network 的中介适配器具有以下功能：

¹ 原生广告（用于出价）目前处于封闭式 Beta 版阶段，请与您的客户经理联系以申请访问权限。

要求

• Android API 级别 23 或更高级别

• 最新版 Google 移动广告 SDK

• 完成中介入门指南阅读。

第 1 步：在 LINE Ads Network 界面中设置配置

注册并登录您的 LINE Ads Network 账号。

添加新应用

依次点击広告枠管理 (Ad Slot Management) > メディア (Media)。然后，点击新規作成。

填写表单，然后点击登録（注册）。

记下应用 ID。

创建广告展示位置

点击要添加广告展示位置的应用的 ID。然后，选择詳細 (Detail)。

点击スロット 追加 (Add Slot)。

填写表单，详细说明广告资源。对于出价类型，请选择标准，以将此广告资源块配置为使用广告瀑布流中介；或者选择 Google SDK 出价，以将此广告资源块配置为使用出价。 填写完表单后，点击登録（注册）。

记下插槽 ID。

更新 app-ads.txt

应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。 如果您尚未完成此项操作，请为 Ad Manager 创建 app-ads.txt 文件。

如需为 LINE Ads Network 实现 app-ads.txt，请参阅 app-ads.txt 简介。

第 2 步：在 Ad Manager 界面中设置 LINE Ads Network 需求

登录您的 Ad Manager 账号。

在“公司”中添加 LINE Ads Network

启用安全信号共享

在出价请求中共享安全信号

允许出于 SDK 出价目的共享安全信号

配置 LINE Ads Network 出价

配置广告单元映射

第 3 步：导入 LINE Ads Network SDK 和适配器

Android Studio 集成（推荐）

在应用级 build.gradle.kts 文件中，添加以下实现依赖项和配置。使用最新版本的 LINE Ads Network SDK 和适配器：

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:line:2.9.20250718.0")
}

手动集成

1. 下载最新版本的 LINE 广告网络 SDK 的 .aar 文件，并将其添加到您的项目中。

2. 前往 Google 的 Maven 代码库，找到 LINE 广告网路适配器制品。选择最新版本，下载 LINE Ads Network 适配器的 .aar 文件，然后将其添加到您的项目中。

第 4 步：添加必需的代码

集成 LINE 广告资源网不需要其他代码。

第 5 步：测试您的实现

启用测试广告

确保针对 Ad Manager 注册测试设备。

验证测试广告

若要验证您是否能收到来自 LINE Ads Network 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 LINE Ads Network (Waterfall)（LINE Ads Network [瀑布流]）作为广告来源。

可选步骤

广告资源网专用参数

LINE Ads Network 适配器支持一个额外的请求参数，该参数可以使用 LineExtras 类传递给适配器。此类构造函数包含以下参数：

enableAdSound

用于指定横幅广告、插页式广告和激励广告的默认声音开始状态的 boolean。

以下代码示例展示了如何创建设置了这些参数的广告请求：

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

使用原生广告

广告呈现

LINE Ads Network 适配器会为 NativeAd 填充以下字段。

¹ 对于原生广告，LINE Ads Network SDK 不提供应用图标素材资源。LINE Ads Network 适配器会使用透明图片填充应用图标。

错误代码

如果适配器未能收到来自 LINE Ads Network 的广告，您可以使用 ResponseInfo.getAdapterResponses() 来检查广告响应中归属于以下类的底层错误：

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

以下是当广告加载失败时，LINE Ads Network 适配器会抛出的代码和随附的消息：

LINE Android 中介适配器变更日志

版本 2.9.20250718.0

• 已验证与 FiveAd SDK 2.9.20250718 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 24.3.0 版。
• FiveAd SDK 版本 2.9.20250718.0。

版本 2.9.20250519.0

• 已验证与 FiveAd SDK 2.9.20250519 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 24.3.0 版。
• FiveAd SDK 版本 2.9.20250519.0。

版本 2.9.20250317.1

• 使用新的 FiveAd API 修复了出价广告的横幅加载维度

构建和测试所需版本：

• Google 移动广告 SDK 24.1.0 版。
• FiveAd SDK 版本 2.9.20250317.0

版本 2.9.20250317.0

• 已验证与 FiveAd SDK 2.9.20250317 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 24.1.0 版。
• FiveAd SDK 版本 2.9.20250317.0

版本 2.9.20250110.1

• 将最低必需的 Android API 级别更新为 23。
• 将最低必需的 Google 移动广告 SDK 版本更新为 24.0.0。

构建和测试所需版本：

• Google 移动广告 SDK 24.0.0 版。
• FiveAd SDK 版本 2.9.20250110.0

版本 2.9.20250110.0

• 移除了已弃用的 UnifiedNativeAdMapper 类，取而代之的是 NativeAdMapper
• 修复了信号收集流程。
• 修复了瀑布流插页式广告和激励广告格式的固定初始化流程。
• 已验证与 FiveAd SDK 2.9.20250110 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 23.6.0 版。
• FiveAd SDK 版本 2.9.20250110.0

版本 2.9.20241129.0

• 为横幅广告、插页式广告、激励广告和原生广告格式添加了出价支持。
• 已验证与 FiveAd SDK 2.9.20241129 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 23.5.0 版。
• FiveAd SDK 版本 2.9.20241129.0

版本 2.8.20240827.0

• 已验证与 FiveAd SDK 2.8.20240827 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 23.3.0 版。
• FiveAd SDK 版本 2.8.20240827.0

版本 2.8.20240808.0

• 已验证与 FiveAd SDK 2.8.20240808 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 23.2.0 版。
• FiveAd SDK 版本 2.8.20240808.0

版本 2.8.20240722.0

• 已验证与 FiveAd SDK 2.8.20240722 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 23.2.0 版。
• FiveAd SDK 版本 2.8.20240722.0

版本 2.7.20240515.0

• 已验证与 FiveAd SDK 2.7.20240515 版的兼容性。

构建和测试所需版本：

• 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 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 23.0.0 版。
• FiveAd SDK 版本 2.7.20240214.0。

版本 2.7.20240214.0

• 已验证与 FiveAd SDK 2.7.20240214 版的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 22.6.0 版。
• FiveAd SDK 版本 2.7.20240214.0。

版本 2.7.20240126.0

• 已验证与 FiveAd SDK 2.7.20240126 版的兼容性。

构建和测试所需版本：

• 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。