Integrare Line con la mediazione (beta)

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

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

支持的集成和广告格式

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

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

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

要求

  • iOS 部署目标为 12.0 或更高版本
  • 最新版 Google 移动广告 SDK

  • 完成中介流程 入门指南

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

登录您的 Line 帐号。

添加新应用

依次点击 KML 通知枠管理 (Ad Slot Management) > 高速 叙述(媒体)。然后,点击 新制定(新建)

填写相应表单,然后点击登仍可以(注册)

记下应用 ID。

创建广告展示位置

点击您要添加广告展示位置的应用的 ID。然后,选择详情(详情)

点击 ⍛ト 附加(添加槽)

填写表单,完成后,点击(登仍可以)注册

记下广告位 ID。

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere Line alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi Line come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.

A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:

Aggiungi Line come origine annuncio

Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Line.

Seleziona Line. Inserisci un valore eCPM perLine e fai clic su Continua.

Se hai già una mappatura per Line, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Quindi, inserisci l' Application ID and Slot ID ottenuto nella sezione precedente. Poi, fai clic su Fine.

第 3 步:导入 Line SDK 和适配器

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

手动集成

  • 下载最新版 Line SDK 和关联 FiveAd.framework
  • 从以下位置的下载链接下载最新版本的线路适配器: 更新日志和 关联项目中的 LineAdapter.framework

第 4 步:添加所需的代码

SKAdNetwork 集成

按照 Line 的文档操作 将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步:测试实现效果

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob

Segui le istruzioni riportate nella Documentazione di Line su come attivare gli annunci di prova di Line.

Verifica annunci di prova

Per verificare di ricevere annunci di prova daLine, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Line (Waterfall) origini annuncio.

可选步骤

广告联盟专有参数

Line 适配器支持附加请求参数,该参数可以传递 适配器使用 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 适配器会填充以下内容 原生高级广告字段说明 针对 GADNativeAd

字段 素材资源始终包含在 Line Adapter 中
标题
映像
正文
应用图标 1
号召性用语
星级
商店
价格

1 对于原生广告,Line SDK 不提供应用图标资源。相反,Line 适配器会填充应用, 图标和透明图片

错误代码

如果适配器无法接收来自 Line 的广告,您可以检查 使用 GADResponseInfo.adNetworkInfoArray 分为以下类:

GADMediationAdapterLine

以下是 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 由于缺少素材资源,无法加载原生广告。
1-10 由 Line SDK 发送 Line SDK 返回了与 SDK 相关的错误。请参阅 行的文档 了解详情。
101 com.google.ads.mediation.line 服务器参数无效(例如,缺少应用 ID 或插槽 ID)。
102 com.google.ads.mediation.line 请求的广告尺寸与 Line 支持的横幅广告尺寸不匹配。
103 com.google.ads.mediation.line 未能在原生广告中加载信息图标图片素材资源。

LINE iOS 中介适配器更新日志

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