本指南介绍了如何使用 Google 移动广告 SDK 使用 AdMob 中介加载和展示来自 Line 的广告,并涵盖广告瀑布流集成。其中介绍了如何将 Line 添加到广告单元的中介配置,以及如何将 Line SDK 和适配器集成到 iOS 应用中。
LINE Ads Network 的控制台界面中的标签、按钮和说明均使用日语文本。本指南中的屏幕截图未经翻译。不过,本指南的说明和说明中,标签和按钮均已翻译,并在括号中注明了英语对等字词。
支持的集成和广告格式
LINE Ads Network 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | 1 |
瀑布 | 2 |
表现形式 | |
横幅 | 3 |
插页式广告 | 3 |
激励广告 | |
原生 |
2 广告瀑布流集成目前处于 Beta 版公开测试阶段。
3 此格式仅在广告瀑布流集成中受支持。
要求
iOS 部署目标为 12.0 或更高版本
[出价]:如需在出价中集成所有受支持的广告格式,请使用 LINE Ads Network 适配器 2.8.20240827.0 或更高版本(建议使用最新版本)
最新版 Google 移动广告 SDK
完成中介入门指南
第 1 步:在 LINE Ads Network 界面中设置配置
登录您的 LINE Ads Network 账号。
添加新应用
依次点击 広告枠管理 (Ad Slot Management) > メディア (Media)。然后,点击 新規作成 (Create New)。
填写表单,然后点击 登録 (Register)。
记下应用 ID。
创建广告展示位置
请按照相同的步骤为出价和广告瀑布流集成创建广告展示位置。每个广告展示位置都可以用于这两种类型的广告。点击您要为其添加广告展示位置的应用的 ID。然后,选择詳細 (Detail)。
点击 スロット 追加 (Add Slot)。
填写表单,然后点击 (登録) 注册。
记下槽 ID。
第 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 广告联盟输入有效每千次展示费用值,然后点击继续。
如果您已为 LINE Ads Network 创建映射,可以选择该映射。否则,请点击添加映射。
接下来,输入在上一部分中获取的应用 ID 和槽 ID。然后,点击完成。
第 3 步:导入 LINE Ads Network SDK 和适配器
使用 CocoaPods(推荐)
将以下代码行添加到项目的 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 步:测试您的实现
启用测试广告
请务必为 AdMob 注册测试设备。
验证测试广告
如需验证您是否在接收来自 LINE Ads Network 的测试广告,请在广告检查器中使用 LINE Ads Network(广告瀑布流)广告来源启用单个广告来源测试。
可选步骤
特定于广告联盟的参数
LINE Ads Network 适配器支持一个额外的请求参数,可使用 GADMediationAdapterLineExtras
类传递给适配器。此类包含以下属性:
adAudio
- 指定横幅广告、插页式广告和激励广告的默认音频启动状态。
以下代码示例展示了如何创建用于设置这些参数的广告请求:
Swift
import LineAdapter
// ...
let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GADRequest *request = [GADRequest 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 是否已在适配器设置中注册的逻辑。
版本 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。