Launcher信息与广告位配置

核心概念：桌面管理 | Launcher信息与广告位配置 | 概览

本模块是广告推送配置的核心入口，采用清晰的 三级配置架构，帮助您从整体到局部精确控制广告投放。

• 一级配置 (基础信息)：管理 Launcher 应用的包名、版本号等基础属性。
• 二级配置 (广告位管理)：在特定 Launcher 版本下定义广告位（如开屏、首页），支持分组管理。
• 三级配置 (策略与资源)：针对具体广告位绑定素材资源，并通过规则配置确定目标设备。旧渠道、MAC、地区入口只用于历史数据排查。

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 配置层级和终端取数过程

配置层级和终端取数过程

Launcher配置分三层：一级是Launcher基础信息，用包名和版本号定位一类Launcher客户端；二级是该Launcher下的广告位索引；三级是广告位下可投放的具体资源。只有把这三层关系配置完整，终端才能按自己的包名、版本和设备规则取得资源。

终端请求新版配置时，系统先根据设备规则判断它可以看到哪些广告位，再根据 Launcher 包名和版本号找到相应配置，最后返回已启用的资源。规则中的设备范围只决定广告位是否对该设备可见，不代表 Launcher 已安装，也不代表广告资源已经执行成功。

新增、修改、删除和审批会改变草稿或正式生效的配置。审批中的修改不会立即替代当前生效内容；“已生效且做修改/移除标记”表示终端仍可能取得原配置，直到审批完成。

包名和版本为什么重要

包名用于找到对应的 Launcher，版本号用于选择该版本适用的广告位。同名 Launcher 的版本配置错误时，即使设备符合规则也可能拿不到广告位；排查时应同时核对设备上报的包名、版本号、广告位启用状态和审批状态。

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 一级配置：Launcher基础信息

一级配置：Launcher基础信息

在Launcher信息管理的一级配置页面中，主要用于管理 Launcher 应用本身的身份信息。系统允许存在多条相同的包名或版本号记录，以便支持不同的业务场景或测试需求。

页面概览

页面上方列表展示了所有已登记的 Launcher 基础信息。

查询条件只属于 Launcher 基础信息列表：名称、包名、版本号和变更状态。其中变更状态使用数据字典 bpm_valid，其余为手动输入。导出会沿用当前查询条件。

列表字段说明

字段名称	说明
ID	Launcher 基础信息唯一标识
名称	Launcher 应用的显示名称，便于识别
包名	Launcher 应用的包名，如 com.example.launcher
版本号	Launcher 应用的版本号
备注	备注信息
变更状态	数据的审批/生效状态，详见审批与状态说明
流程状态	审批流程当前状态
创建时间	记录创建时间

新增 Launcher 基础信息

点击 新增 按钮，打开新增表单：

表单字段：

字段名称	是否必填	说明
名称	是	Launcher 应用的显示名称
包名	是	Launcher 应用的包名标识
版本号	是	Launcher 版本号，支持多个版本号（英文逗号分隔）
广告位	否	新增时可选择预置广告位，系统将自动创建对应的广告位配置
备注	否	备注说明

编辑 Launcher 基础信息

点击列表中的 编辑 按钮，可修改已有配置。

草稿机制

当编辑已生效的数据时，系统会生成草稿记录。编辑完成后可切换编辑 草稿数据 或 原有数据。

更多操作

在列表右侧的 更多 下拉菜单中，提供以下操作：

操作	说明	适用条件
草稿	查看当前数据的草稿内容	存在草稿数据时
取消数据变更（当前数据）	仅取消当前记录的变更	变更状态非未生效/已生效
取消数据变更（包含广告位配置数据）	取消当前记录及其下所有广告位配置的变更	变更状态非未生效/已生效
提交审批	将变更提交审批	流程状态为审批不通过/已取消/未开始
取消审批	撤销已提交的审批申请	流程状态为审批中
查看审批	跳转至审批详情页	存在审批流程实例

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 二级配置：广告位管理

二级配置：广告位管理

在Launcher信息管理的二级配置页面中，点击一级列表中的任意一行，页面下方将展开该 Launcher 对应的 广告位配置列表。 此处定义了该 Launcher 版本下包含哪些具体的广告展示位置（Ad Slot）。

广告位列表可按当前 Launcher ID、广告位、广告位版本号、是否开启、变更状态和分组查询。Launcher ID 由选中的一级记录自动带入；广告位、是否开启和变更状态分别使用 launcher_ad_index、enable、bpm_valid；分组选项来自当前 Launcher 已有分组，不是数据字典。

列表字段说明

字段名称	说明
ID	广告位配置唯一标识
广告位	广告位名称，如开屏广告、首页Banner等
分组	广告位所属分组
版本号	广告位配置版本号
是否开启	广告位启用状态开关
变更状态	数据的审批/生效状态
备注	备注信息
创建时间	记录创建时间

核心概念

归属关系

广告位严格属于某一个一级 Launcher 信息。

分组管理

• 为了便于管理大量广告位，系统引入了 分组 概念。
• 在创建广告位时，您可以选择放入 已存在的分组 或 手动输入新分组。
• 唯一性约束：同一分组下的广告位名称不能重复。

广告位定义与扩展

随着业务发展，“广告位”的概念在系统中经历了泛化。它不仅指代物理存在的展示位，还涵盖了各类统计埋点状态。

• 配置类广告位：指实际存在的、可配置资源的广告位。

  • 例如：1-14号广告位、Banner 广告位、开屏广告。
  • 操作：您可以在此页面进行新增、编辑和资源配置。

• 统计类广告位 (虚拟)：指代三方广告的执行状态，仅用于数据上报与统计分析，无需也无法在此处配置。

  • 涵盖类型：三方请求素材失败、三方播放完成、三方播放错误、三方播放跳过、三方播放跳转、三方 APP 打开、三方获取素材成功、三方 APP 打开(艾科统计)。
  • 注意：这些“广告位”由设备端直接上报，您在后台只能在 广告播放数据分析 中看到相关数据。

新增广告位

点击 新增 按钮，打开新增表单：

字段名称	是否必填	说明
广告位	是	选择预置的广告位类型
是否开启	是	启用/禁用该广告位
分组	是	选择已有分组或输入新分组名称
备注	否	备注说明

广告位和分组只在新增时选择，编辑时不可修改；如归属或分组建错，应评估下级资源和审批状态后重新建立。广告位版本号显示在列表中，但当前新增、编辑表单没有可填写的版本号字段，不应把它写成用户输入项。

编辑广告位

点击列表中的 编辑 按钮，会先打开广告位编辑窗口。窗口上方可以查看或修改当前允许调整的广告位基础信息，下方提供规则配置和资源配置等标签；这组标签共同构成该广告位的三级配置入口。

启用/停用广告位

在广告位列表中，通过 是否开启 列的开关可直接启用或停用广告位。

审批提醒

非管理员的启用/停用操作需要经过审批流程才能生效。

更多操作

操作	说明
草稿	查看当前数据的草稿内容
取消数据变更（当前数据）	仅取消当前广告位的变更
取消数据变更（包含广告位配置数据）	取消当前广告位及其下所有配置（渠道/MAC/地区/资源）的变更

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 三级配置入口

三级配置入口

在二级广告位列表中点击 编辑，会打开当前广告位的综合配置窗口。广告位、启用状态、分组和备注属于广告位基础信息；规则配置和资源配置属于下一级业务配置，不应把窗口内的所有字段混成一张资源字段表。

在此页面中，您可以：

1. 绑定资源：上传图片、视频、字幕等素材（详情请跳转 三级配置：资源与策略）。
2. 设置规则：通过规则引擎配置目标设备（详情请跳转 三级配置：资源与策略）。

注意：三级配置遵循 “单资源互斥” 原则。同一个广告位下可以配置多个资源备选，但同一时间只能 启用 一个。启用 B 资源会自动禁用 A 和 C 资源。

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 审批与状态说明

审批与状态说明

关于Launcher信息管理的审批与状态说明：

由于本模块涉及系统核心配置，非管理员的修改需要经过审批流程。您可以在 审批中心 查看您的申请进度。

业务审批状态

• 未开始(草稿)：数据已保存但未提交审批。
• 审批中：数据已提交，正在等待管理员审核。
• 审批通过：审核通过，数据已生效。
• 审批不通过：审核被拒绝，需重新修改或取消。
• 已取消：申请被主动取消。

业务模块信息变更状态

• 未生效：新建数据，尚未生效。
• 已生效：数据已审核通过并生效。
• 已生效且做修改标记：在已生效数据基础上进行了修改，正在审批中。
• 已生效且做移除标记：申请删除已生效数据，正在审批中。
• 已生效且修改状态为启用：申请启用该配置，正在审批中。
• 已生效且修改状态为禁用：申请禁用该配置，正在审批中。

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 机顶盒请求广告配置流程

机顶盒获取广告配置

设备启动 Launcher 后，系统根据包名和版本识别 Launcher 配置，再按广告位绑定的规则匹配设备并返回当前启用资源。设备完成播放、跳转、下载或安装后，相关结果会进入播放统计或执行明细。

Mermaid Diagram Code:

sequenceDiagram
    participant D as 终端 Launcher
    participant S as 广告配置服务
    participant R as 规则引擎
    participant F as 资源/文件管理
    D->>S: 包名、版本号和设备标识
    S->>S: 定位 Launcher 一级配置
    S->>R: 遍历已启用广告位并匹配设备规则
    R-->>S: 设备可见的广告位/资源候选项
    S->>F: 按单资源互斥取得当前启用资源
    F-->>S: 素材URL、跳转动作和APK信息
    S-->>D: 广告位及资源配置
    D->>S: 异步上报播放/下载/安装结果

排查时按层级核对：

1. 设备上报的 Launcher 包名和版本号是否能找到一级配置。
2. 广告位是否启用、审批生效，且设备是否命中其绑定规则。
3. 资源是否启用，文件是否存在，互斥选择后是否仍有可返回资源。
4. 播放结果查看广告播放数据分析，下载或安装结果查看广告资源执行明细。

规则配置见规则中心：业务侧集成，资源互斥、APK 任务绑定和设备执行记录见资源与策略管理。

历史配置

旧版渠道、MAC、地区匹配基本不再使用，仅用于历史数据或问题排查，见Launcher旧版匹配逻辑。

---

核心概念：桌面管理 | Launcher信息与广告位配置 | 数据字典

数据字典

以下字典数据截至 2026-08-27 17:48:07（UTC+8），所列字典项当前均为启用状态。

• “是否开启”（enable）：0 否、1 是。
• “bpm流程审批状态”（bpm_inst_status）：-2 系统错误、-1 未开始(草稿)、1 审批中、2 审批通过、3 审批不通过、4 已取消。
• “bpm生效检测”（bpm_valid）：0 未生效、1 已生效、2 已生效且做修改标记、3 已生效且做移除标记、4 已生效且修改状态为启用、5 已生效且修改状态为禁用。
• 广告位使用数据字典“launcher广告位”（launcher_ad_index），当前值如下：

取值	显示名称	取值	显示名称
0	1号广告位	1	2号广告位
2	3号广告位	3	4号广告位
4	5号广告位	5	6号广告位
6	7号广告位	7	8号广告位
8	9号广告位	9	10号广告位
10	11号广告位	11	12号广告位
12	13号广告位(收藏)	13	14号广告位(字幕)
98	98号屏保广告	99	banner广告位
100	开屏广告	10001	三方请求素材失败
10002	三方播放完成	10003	三方播放错误
10004	三方播放跳过	10005	三方播放跳转
10007	三方APP打开	10008	三方获取素材成功
10009	三方APP打开(艾科统计)	10100	WhaleTV广告创建成功
10101	WhaleTV获得广告填充	10102	WhaleTV加载成功(视频开始播放)
10103	WhaleTV广告加载失败	10104	WhaleTV广告播放完毕
10105	WhaleTV广告日活