将 LINE Ads Network 与中介集成(Beta 版)

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

LINE Ads Network 的控制台界面中的标签、按钮和说明均使用日语文本。本指南中的屏幕截图未经翻译。不过,本指南中的说明和说明中,标签和按钮均已翻译,并在括号中注明了其英语等效项。

支持的集成和广告格式

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

集成
出价  1
瀑布  2
表现形式
横幅  3
插页式广告  3
激励广告
原生
1 出价集成功能目前处于封闭式 Beta 版阶段,请与您的客户经理联系,请求访问权限。

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

3 此格式仅在广告瀑布流集成中受支持。

要求

  • iOS 部署目标为 12.0 或更高版本

  • 最新版 Google 移动广告 SDK

  • 完成中介入门指南

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

登录您的 LINE Ads Network 账号。

添加新应用

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

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

记下应用 ID。

创建广告展示位置

您可以按照相同的步骤为出价和广告瀑布流集成创建广告展示位置。每个广告展示位置都可以用于这两种类型的广告。

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

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

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

记下槽 ID。

第 2 步:在 Ad Manager 界面中设置 LINE Ads Network 需求

登录您的 Ad Manager 账号

在公司中添加 LINE Ads Network

出价

出价集成不需要执行此步骤。

瀑布

依次前往管理 > 公司,然后点击所有公司标签页中的新建公司按钮。选择广告网络

选择 LINE Ads Network 作为广告网络,输入唯一的名称,然后启用中介

您无需输入用户名密码。完成后,点击保存

启用安全信号共享

出价

依次前往管理 > 全局设置。前往 Ad Exchange 账号设置标签页,查看并开启安全信号共享。点击保存

瀑布

广告瀑布流集成不需要执行此步骤。

配置 LINE Ads Network 出价

出价

依次前往投放 > 出价方,然后点击 SDK 出价标签页下的新出价方

选择 LINE Ads Network 作为出价方。

将此出价方的信号库添加到允许的信号列表中允许与此出价方共享信号开关切换到开启状态。然后,点击继续

点击继续

点击完成

瀑布

广告瀑布流集成不需要执行此步骤。

配置广告单元映射

出价

依次前往投放 > 出价方,然后在 SDK 出价标签页下选择 LINE Ads Network 对应的公司。

前往广告单元映射标签页,然后点击新建广告单元映射

选择特定广告单元。选择广告单元和格式,移动应用作为广告资源类型,然后选择您的移动应用。然后,输入上一部分中获取的应用 ID槽 ID。最后,点击保存

瀑布

依次前往投放 > 收益组,然后点击新建收益组按钮。选择您的移动应用

向下滚动,然后点击添加收益合作伙伴

选择您在前面部分为 LINE Ads Network 创建的公司。选择移动 SDK 中介作为集成类型iOS 作为平台有效作为状态

输入上一部分中获取的应用 ID广告位 ID,以及默认每千次展示费用值。点击保存

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

将以下行添加到项目的 Podfile 中:

pod 'GoogleMobileAdsMediationLine'

在命令行中运行以下命令:

pod install --repo-update

手动集成

  • 下载最新版本的 LINE Ads Network SDK,并在项目中关联 FiveAd.framework
  • 从更新日志中的下载链接下载最新版本的 LINE Ads Network 适配器,并在项目中关联 LineAdapter.framework

第 4 步:添加所需代码

SKAdNetwork 集成

按照 LINE Ads Network 文档中的说明,将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步:测试您的实现

启用测试广告

请务必为 Ad Manager 注册测试设备

验证测试广告

如需验证您是否在接收来自 LINE Ads Network 的测试广告,请使用 LINE Ads Network(广告瀑布流)广告来源在广告检查器中启用单一广告来源测试

可选步骤

特定于广告联盟的参数

LINE Ads Network 适配器支持一个额外的请求参数,可使用 GADMediationAdapterLineExtras 类传递给适配器。此类包含以下属性:

adAudio
指定横幅广告、插页式广告和激励广告的默认声音启动状态。

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

Swift

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

使用原生广告

广告呈现

LINE Ads Network 适配器会为 GADNativeAd 填充以下字段

字段 LINE Ads Network 适配器始终包含的素材资源
标题
Image
正文
应用图标 1
号召性用语
星级
商店
价格

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

错误代码

如果适配器未能从 LINE Ads Network 收到广告,您可以使用以下类下的 GADResponseInfo.adNetworkInfoArray 检查广告响应的根本错误:

GADMediationAdapterLine

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

错误代码 网域 原因
1-10 由 LINE Ads Network SDK 发送 LINE Ads Network SDK 返回了 SDK 专用错误。如需了解详情,请参阅 LINE Ads Network 的文档
101 com.google.ads.mediation.line 服务器参数无效(例如缺少应用 ID 或广告位 ID)。
102 com.google.ads.mediation.line 请求的广告尺寸与 LINE Ads Network 支持的横幅广告尺寸不符。
103 com.google.ads.mediation.line 未能在原生广告中加载信息图标图片素材资源。

LINE iOS 中介适配器变更日志

下一版本

  • 移除了用于检查 FAD SDK 是否已在适配器设置中注册的逻辑。
  • 使用新的“showWithViewController:”API 更新了插页式广告和激励广告的“show”API。
  • 移除了下载原生广告素材资源之前的原生广告状态检查,因为该检查已废弃且没有替代项。

版本 2.9.20241106.1

  • 更新了适配器,以便使用最新的广告加载 API 出价横幅广告。
  • 修复了导致广告事件无法正确转发以针对插页式广告出价的问题。

构建和测试所需版本:

  • Google 移动广告 SDK 11.12.0 版。
  • FiveAd SDK 版本 2.9.20241106。

版本 2.9.20241106.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.12.0 版。
  • FiveAd SDK 版本 2.9.20241106。

版本 2.8.20240827.1

  • 更新了 CFBundleShortVersionString,使其包含三个组件,而不是四个。

构建和测试所需版本:

  • Google 移动广告 SDK 版本 11.10.0。
  • FiveAd SDK 版本 2.8.20240827。

版本 2.8.20240827.0

  • 已验证与 FiveAd SDK 版本 2.8.20240827 的兼容性。
  • 添加了对横幅广告、插页式广告、激励广告和原生广告格式的出价支持。

构建和测试所需版本:

  • Google 移动广告 SDK 11.8.0 版。
  • FiveAd SDK 版本 2.8.20240827。

版本 2.8.20240612.0

  • 通过 GADVideoOptions 添加了对原生广告的音频控制。
  • 已验证与 FiveAd SDK 版本 2.8.20240612 的兼容性。

构建和测试所需版本:

  • Google 移动广告 SDK 11.5.0 版。
  • FiveAd SDK 版本 2.8.20240612。

版本 2.7.20240411.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.3.0 版。
  • FiveAd SDK 版本 2.7.20240411。

版本 2.7.20240318.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 11.2.0 版。
  • FiveAd SDK 版本 2.7.20240318。

版本 2.7.20240214.1

  • 现在,最低 iOS 版本要求为 12.0。
  • 现在需要 Google 移动广告 SDK 11.0 或更高版本。
  • LineAdapter.xcframework 中的框架中添加了 Info.plist

构建和测试所需版本:

  • Google 移动广告 SDK 版本 11.0.1。
  • FiveAd SDK 版本 2.7.20240214。

版本 2.7.20240214.0

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

构建和测试所需版本:

  • Google 移动广告 SDK 版本 11.0.1。
  • FiveAd SDK 版本 2.7.20240214。

版本 2.7.20240126.0

  • 已验证与 FiveAd SDK 版本 2.7.20240126 的兼容性。
  • 使用 FiveAd SDK 的新代理协议更新了适配器实现。

构建和测试所需版本:

  • Google 移动广告 SDK 10.14.0 版。
  • FiveAd SDK 版本 2.7.20240126。

版本 2.7.20231115.0

  • 已验证与 FiveAd SDK 版本 2.7.20231115 的兼容性。
  • 在 modulemap 中添加了 GADMediationAdapterLineExtras 标头。

构建和测试所需版本:

  • Google 移动广告 SDK 10.14.0 版。
  • FiveAd SDK 版本 2.7.20231115。

版本 2.6.20230609.1

  • 添加了 GADMediationAdapterLineAudioState,以管理横幅广告、插页式广告和激励广告在首次展示时的初始音频状态。

构建和测试所需版本:

  • Google 移动广告 SDK 10.14.0 版。
  • FiveAd SDK 版本 2.6.20230609。

版本 2.6.20230609.0

  • 初始版本!
  • 添加了对横幅广告、插页式广告、激励广告和原生广告格式的瀑布流支持。
  • 已验证与 FiveAd SDK 版本 2.6.20230609 的兼容性。

构建和测试所需版本:

  • Google 移动广告 SDK 10.9.0 版。
  • FiveAd SDK 版本 2.6.20230609。