미디에이션과 라인 통합 (베타)

本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用 中介、 包括广告瀑布流集成其中介绍了如何向广告单元的 中介配置,以及如何将 Line SDK 和适配器集成到 一款 Android 应用。

Line 的信息中心界面使用日语文本作为标签, 按钮和说明本指南中的屏幕截图 。不过,在本指南的说明和说明中,标签和 相应按钮在翻译后会用英文括号括起来。

支持的集成和广告格式

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

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

1 已集成瀑布流 封闭式 Beta 版,请联系您的客户经理以申请访问权限。

要求

  • Android API 级别 21 或更高级别
  • 最新版 Google 移动广告 SDK

  • 完成中介流程 入门指南

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

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

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

在应用级 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")
}

手动集成

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

  2. 前往线路适配器工件 。选择最新版本,下载 Line 适配器的 .aar 文件,并将其添加到您的项目。

第 4 步:添加所需的代码

LINE 集成无需额外代码。

第 5 步:测试实现效果

테스트 광고 사용 설정

Ad Manager

라인 테스트 광고를 사용 설정하는 방법은 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 中
标题
映像
正文
应用图标 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,取而代之的是 FiveAdCustomLayoutEventListenerFiveAdVideoRewardEventListenerFiveAdInterstitialEventListenerFiveAdNativeEventListener
  • 已验证与 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。