Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

将 LY 与中介集成

请选择平台： Android iOS Unity Flutter Android（旧版）

本指南介绍了如何使用 GMA Next-Gen SDK 通过 AdMob 中介加载和展示来自 LY 广告联盟的广告，其中涵盖了瀑布流集成。其中介绍了如何将 LY 广告联盟添加到广告单元的中介配置，以及如何将 LY 广告联盟 SDK 和适配器集成到 Android 应用中。

支持的集成和广告格式

LY 广告联盟的中介适配器具有以下功能：

集成
出价
瀑布流
表现形式
横幅
插页式广告
已获得奖励
原生

前提条件

在继续操作之前，请验证以下事项：

Android API 级别 24 或更高级别。
[对于出价]：如需在出价中集成所有受支持的广告格式，请使用 LY Ads Network 适配器 2.9.20241129.0 或更高版本（建议使用最新版本）。

最新 GMA Next-Gen SDK 版本。
设置 AdMob 中介。

第 1 步：在 LY 广告联盟界面中设置配置

注册并登录您的 LY 广告联盟账号。

添加新应用

前往应用标签页，然后点击新注册按钮。

新注册

填写表单，然后点击注册。

新注册表单

记下应用 ID。

注册详细信息

创建广告位

在应用标签页中，选择您的应用以查看其详细信息。在槽部分下，点击添加。

添加广告位

填写表单，了解有关该时段的详细信息。对于出价类型，选择标准可为此广告位配置瀑布流中介，选择 Google SDK 出价可为此广告位配置出价。填写完表单后，点击创建。

添加槽表单

记下槽位 ID。

广告位详情

创建第一个广告位后，请在应用详情页面上点击审核，以获得 LY 广告联盟的批准。这可能需要一些时间。如有任何疑问，请与您的 LY Ads Network 代表联系。

申请审核

创建 Reporting API 密钥

前往管理报告 API 密钥标签页，然后点击创建 API 密钥按钮。

Reporting API Key Tab

填写表单并点击保存。

Reporting API 密钥表单

记下您的 API 密钥 ID 和 API 密钥 Secret。

Reporting API 密钥表单

更新 app-ads.txt

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

如需为 LY 广告联盟植入 app-ads.txt，请参阅 app-ads.txt 简介。

第 2 步：在 AdMob 界面中设置 LY Ads Network 需求

为广告单元配置中介设置

您需要将 LY Ads Network 添加到广告单元的中介配置。

首先，登录您的 AdMob 账号。接下来，前往中介标签页。如果您要修改某个现有中介组，请点击该中介组的名称进行修改，然后跳至将 LY Ads Network 添加为广告联盟。

若要创建新中介组，请选择创建中介组。

输入广告格式和平台，然后点击继续。

为中介组命名，然后选择要定位到的地理位置。接下来，将中介组状态设置为已启用，然后点击添加广告单元。

将此中介组与您的一个或多个现有 AdMob 广告单元相关联。然后，点击完成。

现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元：

将 LY Ads Network 添加为广告联盟

出价

在广告来源部分，找到出价卡片，然后选择添加广告来源。然后选择乐游广告联盟。

点击如何签署合作伙伴协议，然后与 LY 广告联盟建立出价合作伙伴关系。

点击确认并同意，然后点击继续。

如果您已为 LY 广告联盟创建映射，可以选择该映射。否则，请点击添加映射。

接下来，输入在上一部分获得的应用 ID和广告位 ID。然后点击完成。

瀑布

在瀑布流卡片的广告来源部分，选择添加广告来源。

选择 LY 广告联盟，然后启用优化开关。输入在上一部分中获得的 API 密钥 ID 和 API 密钥，为 LY Ads Network 设置广告来源优化。然后，为 LY Ads Network 输入有效每千次展示费用值，并点击继续。

如果您已为 LY 广告联盟创建映射，可以选择该映射。否则，请点击添加映射。

接下来，输入在上一部分获得的应用 ID 和广告位 ID。然后，点击完成。

注意：广告来源优化功能需要几天时间来收集足够的数据，以便准确计算中介广告联盟的有效每千次展示费用。在此期间，广告来源优化状态为PENDING，因此您必须手动为该广告联盟设置有效每千次展示费用值。一旦可以计算 eCPM，广告来源就会自动开始代表您更新 eCPM。

第 3 步：导入 LY 广告联盟 SDK 和适配器

Android Studio 集成（推荐）

在应用级 gradle 文件中，添加以下实现依赖项和配置：

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手动集成

下载最新版本 LY 广告联盟 SDK 的 .aar 文件，并将其添加到您的项目中。
前往 Google 的 Maven 制品库中的 LY 广告联盟适配器工件。选择最新版本，下载 LY Ads Network 适配器的 .aar 文件，然后将其添加到您的项目中。

第 4 步：添加必需的代码

LY Ads Network 集成不需要额外的代码。

第 5 步：测试您的实现

启用测试广告

确保针对 AdMob 注册测试设备。

LY Ads 广告联盟适配器包含一个辅助方法，可为 LY Ads 广告联盟启用测试模式。您必须在初始化 GMA Next-Gen SDK 之前设置此选项，以确保这些信息正确转发到 LY 广告联盟 SDK。

Java

LineMediationAdapter.Companion.setTestMode(true);LineMediationSnippets.java

Kotlin

LineMediationAdapter.setTestMode(true)LineMediationSnippets.kt

验证测试广告

若要验证您是否能收到来自 LY Ads Network 广告联盟的测试广告，请在广告检查器中启用单个广告来源测试，并选择 LY Ads Network 作为广告来源。

可选步骤

广告资源网专用参数

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

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

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

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();LineMediationSnippets.java

Kotlin

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

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()LineMediationSnippets.kt

使用原生广告

广告呈现

LY Ads 广告联盟适配器会为 NativeAd 填充以下原生高级广告字段说明。

字段	LY 广告联盟适配器始终包含的素材资源
标题
映像
正文
应用图标	¹
号召性用语
星级
商店
价格

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

错误代码

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

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

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

错误代码	网域	原因
1-10	com.five_corp.ad	LY 广告联盟 SDK 返回了 SDK 专属错误。如需了解详情，请参阅 LY Ads Network 的文档。
101	com.google.ads.mediation.line	应用 ID 缺失或无效。
102	com.google.ads.mediation.line	槽位 ID 缺失或无效。
103	com.google.ads.mediation.line	请求的广告尺寸与 LY Ads Network 支持的横幅广告尺寸不匹配。
104	com.google.ads.mediation.line	由于缺少 activity 上下文，未能加载插页式广告或激励广告。
105	com.google.ads.mediation.line	LY 广告联盟 SDK 未能展示插页式广告或激励广告。
106	com.google.ads.mediation.line	由于缺少素材资源，未能加载原生广告。
107	com.google.ads.mediation.line	FiveAd SDK 返回了 null 广告加载器。

LINE Android 中介适配器变更日志

版本 3.1.1.2

将适配器的 Kotlin 依赖项固定到 1.9.0（GMA 新一代 SDK 支持的最低 Kotlin 版本）。

构建和测试所需版本：

Google 移动广告 SDK 25.4.0 版。
Google 移动广告新一代 SDK 1.4.0 版。
FiveAd SDK 3.1.1.1 版。

版本 3.1.1.1

映射到 Line 的 ChildDirectedTreatment API。AgeRestrictedTreatment

构建和测试所需版本：

Google 移动广告 SDK 25.4.0 版。
Google 移动广告新一代 SDK 1.2.1 版。
FiveAd SDK 3.1.1.1 版。

版本 3.1.1.0

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

构建和测试所需版本：

Google 移动广告 SDK 25.2.0 版。
Google 移动广告新一代 SDK 1.2.1 版。
FiveAd SDK 3.1.1.0 版。

版本 3.1.0.0

添加了属性，以便使用 GMA 新一代 SDK 依赖项构建适配器。
已验证与 FiveAd SDK 3.1.0.0 版的兼容性。

构建和测试所需版本：

Google 移动广告 SDK 25.1.0 版。
Google 移动广告新一代 SDK 0.25.0-beta01 版。
FiveAd SDK 3.1.0.0 版。

版本 3.0.1.2

构建和测试所需版本：

Google 移动广告 SDK 25.1.0 版。
FiveAd SDK 3.0.1.2 版。

版本 3.0.1.1

现在，使用 Google 移动广告 SDK v24.4.0 或更高版本时，原生广告展示会被 FiveAd SDK 覆盖。

构建和测试所需版本：

Google 移动广告 SDK 24.9.0 版。
FiveAd SDK 3.0.1.1 版。

版本 3.0.1.0

添加了对将 tagForUnderAgeOfConsent Google 移动广告 SDK 参数转发到 FiveAd SDK 的支持。
已验证与 FiveAd SDK 3.0.1.0 版的兼容性。

构建和测试所需版本：

Google 移动广告 SDK 24.9.0 版。
FiveAd SDK 3.0.1.0 版。

版本 3.0.0.0

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

构建和测试所需版本：

Google 移动广告 SDK 24.9.0 版。
FiveAd SDK 3.0.0.0 版。

版本 2.9.20251028.0

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

构建和测试所需版本：

Google 移动广告 SDK 24.7.0 版。
FiveAd SDK 版本 2.9.20251028.0

版本 2.9.20250924.1

移除了对 Context 的类级引用。有助于减少内存泄漏问题。

构建和测试所需版本：

Google 移动广告 SDK 24.7.0 版。
FiveAd SDK 2.9.20250924.1 版。

版本 2.9.20250924.0

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

构建和测试所需版本：

Google 移动广告 SDK 24.6.0 版。
FiveAd SDK 版本 2.9.20250924.0

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

将 LY 与中介集成 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

支持的集成和广告格式

前提条件

第 1 步：在 LY 广告联盟界面中设置配置

添加新应用

创建广告位

创建 Reporting API 密钥

更新 app-ads.txt

第 2 步：在 AdMob 界面中设置 LY Ads Network 需求

为广告单元配置中介设置

将 LY Ads Network 添加为广告联盟

出价

瀑布

第 3 步：导入 LY 广告联盟 SDK 和适配器

Android Studio 集成（推荐）

Kotlin

Groovy

手动集成

第 4 步：添加必需的代码

第 5 步：测试您的实现

启用测试广告

Java

Kotlin

验证测试广告

可选步骤

广告资源网专用参数

Java

Kotlin

使用原生广告

广告呈现

错误代码

LINE Android 中介适配器变更日志

版本 3.1.1.2

版本 3.1.1.1

版本 3.1.1.0

版本 3.1.0.0

版本 3.0.1.2

版本 3.0.1.1

版本 3.0.1.0

版本 3.0.0.0

版本 2.9.20251028.0

版本 2.9.20250924.1

版本 2.9.20250924.0

版本 2.9.20250718.0

版本 2.9.20250519.0

版本 2.9.20250317.1

版本 2.9.20250317.0

版本 2.9.20250110.1

版本 2.9.20250110.0

版本 2.9.20241129.0

版本 2.8.20240827.0

版本 2.8.20240808.0

版本 2.8.20240722.0

版本 2.7.20240515.0

版本 2.7.20240214.1

版本 2.7.20240214.0

版本 2.7.20240126.0

版本 2.7.20240112.0

版本 2.6.20230607.1

版本 2.6.20230607.0

将 LY 与中介集成