将 Line 与中介集成

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

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

LINE Ads Network 的信息中心界面使用日文文本作为标签、按钮和说明。本指南中的屏幕截图尚未翻译。不过，在本指南的说明和说明中，标签和按钮会翻译成英文，并在括号中注明。

支持的集成和广告格式

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

要求

• Android API 级别 24 或更高级别

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

• 最新版 GMA Next-Gen SDK

• 完成中介入门指南

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

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

添加新应用

前往アプリ (App) 标签页，然后点击 新規登録 (New Registration) 按钮。

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

记下アプリ ID (App ID) 。

创建广告位

在アプリ (App) 标签页上，选择您的应用以查看应用详情。在スロット (Slot) 部分下，点击追加 (Add) 。

填写表单，详细说明广告位。对于Bidding Type，选择 Standard可将此广告位配置为（广告）瀑布流中介（服务/模式），选择 Google SDK Bidding可将此广告位配置为 SDK 出价。填写完表单后，点击作成 (Create) 。

记下スロット ID (Slot ID) 。

更新 app-ads.txt

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

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

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

为广告单元配置中介设置

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

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

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

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

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

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

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

将 LINE Ads Network 添加为广告来源

出价

在广告来源 部分的出价 卡片下，选择添加广告来源 。然后选择 LINE Ads Network 。

点击 如何签署合作伙伴协议 ，然后 与 LINE Ads Network 建立出价合作伙伴关系。



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



如果您已为 LINE Ads Network 创建映射， 可以选择该映射。否则，请点击添加映射 。



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

瀑布流

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

选择 LINE Ads Network ，然后启用优化 开关。输入在上一部分获得的登录名 和密码 ，以便为 LINE Ads Network 设置广告来源优化。 然后，输入 LINE Ads Network 的 eCPM 值 ，并点击继续 。



如果您已为 LINE Ads Network 创建映射，可以选择该映射。 否则，请点击添加映射 。

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

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

Android Studio 集成（推荐）

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

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

手动集成

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

2. 前往 Google 的 Maven 代码库中的 LINE Ads Network 适配器 工件 。选择最新版本，下载 LINE Ads Network 适配器的 .aar 文件，并将其添加到您的项目中。

第 4 步：添加必需的代码

LINE Ads Network 集成不需要其他代码。

第 5 步：测试您的实现

启用测试广告

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

LINE Ads Network 适配器包含一个帮助程序方法，用于为 LINE Ads Network 启用测试模式。您必须先设置此选项，然后才能 初始化 GMA Next-Gen SDK ，以确保它们正确转发到 LINE Ads Network SDK。

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

验证测试广告

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

可选步骤

广告资源网专用参数

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

enableAdSound

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

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

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

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

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

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

使用原生广告

广告呈现

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

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

错误代码

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

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

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