本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用 投放来自 Line 的广告 AdMob 中介、 涵盖广告瀑布流集成其中介绍了如何向广告单元的 中介配置,以及如何将 Line SDK 和适配器集成到 一款 Android 应用。
Line 的信息中心界面使用日语文本作为标签, 按钮和说明本指南中的屏幕截图 。不过,在本指南的说明和说明中,标签和 相应按钮在翻译后会用英文括号括起来。
支持的集成和广告格式
Line 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | 1 |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
1 广告瀑布流集成目前处于公开 Beta 版阶段。
要求
- Android API 级别 21 或更高级别
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 Line 界面中设置配置
Connectez-vous à votre compte Line.
Ajouter une application
Cliquez sur 広告枠管理 (Gestion des espaces publicitaires) > NUMBEROFデテア (Médias). Ensuite, cliquez sur Define規作成 (Créer).
Remplissez le formulaire, puis cliquez sur 登録 (S'inscrire).
Notez l'ID de l'application.
Créer un emplacement d'annonce
Cliquez sur l'ID de l'application à laquelle vous souhaitez ajouter un emplacement d'annonce. Ensuite, sélectionnez 詳細 (Détails).
Cliquez sur 㿽加 (Ajouter un emplacement).
Remplissez le formulaire, puis cliquez sur (登録) S'inscrire.
Notez l'ID de l'emplacement.
第 2 步:在界面中设置 AdMob 订单项需求
Configurer les paramètres de médiation pour votre bloc d'annonces
Vous devez ajouter Line à la configuration de la médiation pour votre bloc d'annonces.
Connectez-vous à votre compte AdMob. Accédez ensuite à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour le modifier, puis passez à l'étape Ajouter Line comme source d'annonces.
Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.
Saisissez le format de votre annonce et votre plate-forme, puis cliquez sur Continuer.
Attribuez un nom à votre groupe de médiation, puis sélectionnez les zones géographiques à cibler. Définissez ensuite l'état du groupe de médiation sur Activé, puis cliquez sur Ajouter des blocs d'annonces.
Associez ce groupe de médiation à un ou plusieurs de vos blocs d'annoncesAdMob existants. Cliquez ensuite sur Done (OK).
Vous devriez maintenant voir la fiche des blocs d'annonces que vous avez sélectionnés:
Ajouter Line comme source d'annonces
Sous la fiche Waterfall (Cascade d'annonces) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces). Sélectionnez ensuite Line.
Sélectionnez Line. Ensuite, saisissez une valeur d'eCPM pour Line et cliquez sur Continuer.Si vous disposez déjà d'un mappage pour Line, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.
Saisissez ensuite les Application ID and Slot IDobtenus à la section précédente. Cliquez ensuite sur Done (OK).
第 3 步:导入 Line SDK 和适配器
Android Studio 集成(推荐)
在应用级 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")
}
手动集成
第 4 步:添加所需的代码
LINE 集成无需额外代码。
第 5 步:测试实现效果
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour AdMob.
Suivez les instructions dans Documentation de Line pour savoir comment activer les annonces de test de ligne.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests deLine, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de Line (Waterfall) sources d'annonces.
可选步骤
广告联盟专有参数
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
,取而代之的是FiveAdCustomLayoutEventListener
、FiveAdVideoRewardEventListener
、FiveAdInterstitialEventListener
和FiveAdNativeEventListener
。 - 已验证与 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。