将 Line 与中介（Beta 版）集成

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

Line 的信息中心界面使用日语文本显示标签、按钮和说明。本指南中的屏幕截图未经翻译。不过，本指南的说明和说明中，标签和按钮均已翻译，并在括号中注明了英语对等字词。

支持的集成和广告格式

Line 的中介适配器具有以下功能：

集成
出价
瀑布  1
表现形式
横幅
插页式广告
激励广告
原生

1 каскадная интеграция находится в закрытой бета-версии, обратитесь к своему менеджеру по работе с клиентами, чтобы получить доступ.

要求

  • Android API 级别 21 或更高级别

第 1 步：在 Line 界面中设置配置

登录您的 Line 账号。

添加新应用

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

填写相应表单，然后点击 登 monthly (Register)。

记下应用 ID。

创建广告展示位置

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

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

填写表单，然后点击 (登録) 注册。

记下槽 ID。

第 2 步：在界面中设置 Ad Manager 订单项需求

第 3 步：导入 Line SDK 和适配器

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

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

手动集成

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

  2. 前往 Google 的 Maven 制品库中的线条适配器工件。选择最新版本，下载 Line 适配器的 .aar 文件并将其添加到您的项目。

第 4 步：添加所需代码

无需额外代码即可实现 Line 集成。

第 5 步：测试您的实现

启用测试广告

请务必为 AdMob 注册测试设备。

请按照 Line 文档中关于如何启用 Line 测试广告的说明操作。

验证测试广告

如需验证您是否收到了来自 Line 的测试广告，请在广告检查器中使用 Line (Waterfall) 广告来源启用单一广告来源测试。

可选步骤

网络专用参数

Line 适配器支持额外的请求参数，可使用 LineExtras 类将其传递给适配器。此类构造函数包含以下参数：

enableAdSound
一个 boolean，用于指定横幅广告、插页式广告和激励广告的默认音效启动状态。

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

Java

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

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

Kotlin 

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

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

使用原生广告

广告呈现

Line 适配器会为NativeAd 填充以下字段。

字段 素材资源始终包含在 Line Adapter 中
标题
Image
正文
应用图标 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 专用错误。如需了解详情，请参阅 Line 的文档。
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 由于缺少 activity 上下文，未能加载插页式广告或激励广告。
105 com.google.ads.mediation.line Line SDK 未能展示插页式广告或激励广告。
106 com.google.ads.mediation.line 由于缺少素材资源，未能加载原生广告。

LINE Android 中介适配器变更日志

下一版本

  • 实现了 AdLoader，以便为横幅广告启用实时出价。
  • 实现了 AdLoader，以便为插页式广告启用 RTB。
  • 实现了 AdLoader，以便为激励广告启用 RTB。
  • 实现了 AdLoader，以便为原生广告启用 RTB。

版本 2.8.20240827.0

  • 已验证与 FiveAd SDK 版本 2.8.20240827.0 的兼容性

构建和测试所需版本：

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

版本 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。