Launcher信息与广告位配置

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

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

• 一级配置 (基础信息)：管理 Launcher 应用的包名、版本号等基础属性。
• 二级配置 (广告位管理)：在特定 Launcher 版本下定义广告位（如开屏、首页），支持分组管理。
• 三级配置 (策略与资源)：针对具体广告位，绑定素材资源并设置投放策略（MAC/渠道/地区限制）。

---

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

一级配置：Launcher基础信息

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

页面概览

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

列表字段说明

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

新增 Launcher 基础信息

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

表单字段：

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

编辑 Launcher 基础信息

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

草稿机制

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

更多操作

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

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

---

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

二级配置：广告位管理

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

列表字段说明

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

核心概念

归属关系

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

分组管理

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

广告位定义与扩展

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

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

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

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

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

新增广告位

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

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

编辑广告位

点击列表中的 编辑 按钮，可进入三级配置页面，进行详细的资源配置和策略限制。

启用/停用广告位

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

审批提醒

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

更多操作

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

---

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

三级配置入口

在Launcher信息管理的三级配置入口中，在二级广告位列表中点击 编辑，将弹出一个综合配置窗口。这就是 三级配置页面。

在此页面中，您可以：

1. 绑定资源：上传图片、视频、字幕等素材（详情请跳转 三级配置：资源与策略）。
2. 设置限制：配置广告投放的 MAC、渠道、地区限制（详情请跳转 三级配置：资源与策略）。

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

---

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

审批与状态说明

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

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

业务审批状态

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

业务模块信息变更状态

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

---

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

机顶盒请求广告配置流程

当机顶盒设备启动 Launcher 应用时，会自动向服务器请求广告配置。以下是完整的业务流程：

流程概览

Mermaid Diagram Code:

sequenceDiagram
    participant Device as "终端设备 (Launcher)"
    participant Server as "云端服务器"

    Device->>Server: "1. 启动/请求广告配置"
    Server->>Server: "2. 识别Launcher版本"
    Server->>Server: "3. 匹配广告位策略 (地区/渠道)"
    Server-->>Device: "4. 返回广告位及素材内容"
    Device->>Device: "5. 展示广告"
    Device->>Server: "6. 上报播放/点击数据 (异步)"

详细步骤说明

1. 设备请求

机顶盒启动 Launcher 时，携带以下信息请求服务器：

• 包名：Launcher 应用的包名
• 版本号：Launcher 版本号
• 设备标识：MAC 地址、CPU 序列号

2. 版本识别

服务器根据包名和版本号，查找对应的 Launcher 基础信息（一级配置）。

3. 广告位遍历与策略匹配

系统遍历该 Launcher 下所有已启用的广告位，逐一进行策略匹配：

策略类型	匹配逻辑
渠道限制	设备所属渠道是否在允许列表中
MAC限制	设备MAC是否在白名单中
地区限制	设备所在地区是否在允许列表中
规则引擎	根据设备画像进行复杂规则匹配（预留功能）

4. 资源互斥

同一广告位下，如果配置了多个资源，系统按以下规则选择：

• 优先使用规则引擎命中的资源
• 若无规则命中，使用无限制的默认资源
• 同一时间只返回一个资源

5. 数据下发

服务器返回 JSON 格式的广告配置，包含：

• 广告位ID
• 素材资源地址（图片/视频URL）
• 跳转动作配置
• 应用安装包信息（如有）

6. 数据上报

设备在广告播放完成后，会异步上报播放数据，用于统计分析。

相关文档

• 广告播放数据统计：广告播放数据分析
• 执行记录查看：广告资源下载安装执行明细