Integracja linii z zapośredniczeniem (beta)

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

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

支持的集成和广告格式

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

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

1 广告瀑布流集成目前处于公开 Beta 版阶段。

要求

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

  • 完成中介流程 入门指南

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

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać Line do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Line jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj Line jako źródło reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Line.

Kliknij Line. Następnie wpisz wartość eCPM dlaLine i kliknij Dalej.

Jeśli masz już mapowanie Line, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Application ID and Slot IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

第 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 步:测试实现效果

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob.

Aby dowiedzieć się, jak włączyć reklamy testowe, postępuj zgodnie z instrukcjami podanymi w dokumentacji linii

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyLine, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Line (Waterfall) źródeł reklam.

可选步骤

广告联盟专有参数

Line 适配器支持附加请求参数,该参数可以传递 适配器使用 LineExtras 类。此类构造函数包括 以下参数:

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

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

Java

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

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

Kotlin

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

val request = AdRequest.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。