广告管理 Item 维度报表产品 PRD
产品 PRD 版本：1.1
当前变更：CR-20260820-001
状态：ready-for-prototype
适用平台：Shopee、TikTok
背景与目标
现有广告管理以广告活动为主要分析对象，但商品运营者更常问的是“哪个 Item 在消耗预算、带来订单，哪个 Item 需要进一步排查”。如果为 Item 单独增加菜单和报表页面，会复制平台、店铺、时间与搜索条件，也会切断用户从商品表现回到关联广告的上下文。
本次采用同页聚合维度切换：在现有广告管理页内增加“广告视图 / Item 视图”，共享平台和筛选上下文，只切换下方分析结果的聚合对象。目标是让用户在不离开当前工作流的情况下完成 Item 表现判断、异常定位和关联广告下钻。
本次原型不宣称已连接平台接口。用户已提供并确认的字段和公式作为业务口径；接口端点、统计日期字段、汇率来源及生产权限仍需研发联调。
实际系统基线（2026-08-20 只读走查）
本轮以用户当前已登录的 ERP 页面为视觉和信息架构基线，实际查看路径为 /yh-advertisemen/adShopee 与 /yh-advertisemen/adTiktok。走查只完成页面导航、滚动和截图，没有点击广告创建、状态、预算、ROAS/ROI、编辑、开关或提交控件，也没有读取或保存账号凭据。
已确认的页面骨架：深色顶栏（首页、工作管理、图片工坊、店铺运营管理、平台入口）、深色左侧一级导航（广告、刊登、基础、AI）、浅灰页面背景、白色圆角内容卡片。广告页从上到下为平台标题、筛选区、数据趋势对比卡（趋势标题、横向指标卡、趋势图）、广告数据表格。
筛选区的实际顺序为：日/周/月维度、日期范围、标准对比模式/自定义对比、店铺、广告活动名称、关键字搜索、平台状态；Shopee 另有竞价类型和广告类型。趋势区包含“数据点 / 环比 / 同比”、对比趋势图、人民币切换和自定义指标入口。Shopee 指标卡包含花费（含税）、ROAS（含税）、曝光量、点击量、点击率、订单量、转化率、销量、销售额、ACoS；TikTok 指标卡包含花费、ROI、订单量、销售额、平均下单成本、净成本。
广告表格也按平台保留原生列：Shopee 为诊断建议、广告类型、每日预算、花费（含税）、目标 ROAS、ROAS（含税）、曝光量、点击量、点击率、订单量、转化率、销量、销售额、ACoS、操作；TikTok 为诊断建议、开/关、每日预算、花费、目标 ROI、ROI、订单量、销售额、平均下单成本、净成本、ROI 保护、操作。广告行展示图片、广告名称、广告 ID、开始时间/无结束时间、状态、余额和店铺站点。
Item 视图仍是同一页内的本地分析维度切换，不新增菜单或路由；它复用真实页面的筛选、趋势和指标卡，把下方结果聚合到 Item，并仅提供查看详情和关联广告入口。原型中的“新增广告 / 更改状态 / 更改预算 / 更改 ROAS 或 ROI / 导出”等外观控件均为只读提示，不调用真实广告操作。
广告详情与预算编辑入口
真实页面点击广告行“详情”后打开右侧“广告详情”抽屉，而不是离开广告管理页。详情结构包括广告身份（图片、名称、广告 ID、期间）、操作历史入口、预算、自定义 ROAS/ROI、投放状态和暂停/删除入口；下方继续复用日期范围、趋势线开关、指标卡、趋势图，并展示“产品与创意素材”下的产品列表及产品状态。
预算旁的编辑图标会打开“广告预算编辑”浮层，显示带币种的预算输入框和“取消 / 确认”按钮。只读走查实际打开过该浮层并点击“取消”，未修改输入、未点击确认；本地原型保留这一交互，但确认按钮只显示只读提示并关闭浮层，不提交数据。
横向字段展示
指标卡超过首屏宽度时，使用左右箭头和横向滚动保留更多指标；广告表格和 Item 表格使用横向滚动，固定 Item/广告主列与操作列，并在表头上方显示“左右滑动查看更多字段”。Item 视图不显示新增、状态、预算或 ROAS/ROI 等广告写操作，只保留导出、查看详情和指标字段浏览。
Item 视图的 Shopee 字段按以下顺序展示：花费（含税）、ROAS（含税）、曝光量、点击量、点击率、订单量、转化率、销量、销售额、ACoS、每次转化成本、直接转化订单数、每次直接转化成本、直接转化率、直接 ACoS、直接 ROAS、直接销售金额、直接已售商品。TikTok Item 字段为：花费、ROI、订单量、销售额、平均下单成本、净成本。
用户与场景
| 用户 | 主要问题 | 典型动作 |
|---|---|---|
| 广告优化师 | 哪些 Item 花费高但回报差 | 切到 Item 视图，筛异常，查看关联广告 |
| 店铺运营 | 哪些商品正在获得有效广告订单 | 按店铺和日期筛选，对比订单、销售额与效率 |
| 运营负责人 | 当前平台 Item 广告表现是否健康 | 查看汇总指标、趋势和异常数量 |
典型路径：选择平台与店铺 → 保留日期和搜索条件 → 切换 Item 视图 → 查看汇总与趋势 → 选择异常诊断 → 打开 Item 详情 → 查看关联广告。
产品方案
采用“一个页面、两个聚合维度、同一筛选上下文”的方案：
- 平台页签仍是一级业务边界，Shopee 与 TikTok 不混算。
- “广告视图 / Item 视图”是分析对象切换，不新增导航和路由。
- 共享筛选区不因视图切换清空；下方指标卡、趋势、异常诊断和表格同时切换口径。
- Item 详情以抽屉下钻，展示该 Item 的趋势与关联广告；预算、目标 ROAS 等广告级配置仍回到广告对象操作。
- 指标设置只控制表格可见列，不改变汇总和计算口径。
该方案遵循第一性原理：用户真正需要的是在同一数据范围内切换观察对象；遵循奥卡姆剃刀：不新增一个重复筛选、重复指标、重复详情的独立报表页面。
功能范围
| 范围 | 本次实现 | 不在本次范围 |
|---|---|---|
| 页面结构 | 原广告管理页增加分析维度切换 | 新增侧边栏菜单、独立 Item 报表路由 |
| 平台 | Shopee、TikTok 分平台展示 | 跨平台合并汇总 |
| 筛选 | 店铺、状态、广告类型/投放类型、日周月、日期、商品搜索、报表币种 | 新建复杂筛选器 |
| 分析 | 汇总指标、趋势、异常诊断、Item 表格、详情抽屉 | 自动优化、自动调价、自动停投 |
| 操作 | 指标列设置、导出反馈、查看关联广告 | 在 Item 行直接改预算或目标回报 |
| 数据 | 已确认字段与公式的 Mock 原型 | 声称实时 API 已接入 |
功能设计与业务规则
1. 平台与分析维度
- 平台页签决定数据源和原生指标名称；切换平台后不混用 Shopee ROAS 与 TikTok ROI。
- 默认进入“广告视图”，保持原系统心智；用户主动切到“Item 视图”。
- 同平台内切换分析维度时，保留店铺、日期粒度、日期范围、关键词、币种和可兼容的筛选条件。
- 平台专属且不兼容的筛选项切换平台后回到该平台默认值，并给出轻提示。
2. Item 主键与聚合
- Shopee Item 的建议唯一键为
platform + store + site + platform_item_id；SellerSKU 仅作为搜索和展示字段，不作为跨店唯一键。 - TikTok Item 的建议唯一键为
platform + store + account + platform_item_id。 - 一个 Item 可关联多个广告活动；表格展示“关联广告数 / 投放中数”。
- 加和类字段先在当前筛选范围内求和；比率类指标使用汇总后的分子和分母重新计算，禁止平均行级比率。
- 分母为 0 时显示
—；接口明确返回 0 显示0，未返回或字段缺失显示—并保留缺失状态。
3. 指标卡、趋势与异常诊断
- Shopee Item 默认汇总：花费（含税）、销售额、订单量、销量、ROAS（含税）、ACoS。
- TikTok Item 默认汇总：花费、净成本、销售额、订单量、ROI、平均下单成本。
- 趋势按报表统计日期展示，不使用 Shopee
date字段；date已确认为广告开始时间。 - 异常诊断是可点击的快捷筛选，不执行自动处置。诊断必须同时显示文字和状态色，不能只靠颜色表达。
- 推荐诊断：Shopee 的高曝光低点击、高点击无订单、ROAS 未达标、ACoS 过高、库存风险；TikTok 的高花费无订单、ROI 偏低、平均下单成本偏高、净成本异常。
- 具体阈值未由用户提供，本次原型使用演示阈值并标注“示例规则”，生产接入前由业务配置或后端契约确定。
4. Item 表格与详情
- 商品主列同时展示商品图、商品名、Item ID 和 SellerSKU；平台、店铺和状态信息紧邻商品主列。
- Shopee 默认展示曝光、点击、点击率、订单、销量、销售额、花费、ROAS、ACoS；其他已确认指标放入指标设置。
- TikTok 默认展示订单、销售额、花费、净成本、平均下单成本、ROI。
- 点击“查看详情”打开抽屉，包含 Item 概览、趋势、关联广告及当前异常；关闭抽屉后保留列表筛选和滚动上下文。
- Item 行不直接提供预算、目标 ROAS、启停等广告级操作；关联广告行可返回广告视图并定位对应广告。
5. 导出
- 导出范围等于当前平台、筛选条件、分析维度和可见指标列。
- 原型点击后给出“导出任务已创建”的反馈；异步任务中心和下载文件由既有系统能力承接，不在本次新建任务中心。
数据与口径
Shopee Item 指标
| UI 指标 | 字段 / 公式 | 聚合规则 |
|---|---|---|
| 花费（含税） | expense | Σexpense |
| 销售额 | broad_gmv | Σbroad_gmv |
| 曝光量 | impression | Σimpression |
| 点击量 | click | Σclick |
| 点击率 | 点击量 / 曝光量 | Σclick / Σimpression |
| 订单量（转化订单数） | broad_order | Σbroad_order |
| 转化率 | 转化订单数 / 点击次数 | Σbroad_order / Σclick |
| 销量 | broad_order_amount | Σbroad_order_amount |
| ROAS（含税） | 广告销售额 / 广告花费 | Σbroad_gmv / Σexpense |
| ACoS | 花费 / 广告销售额 | Σexpense / Σbroad_gmv |
| 每次转化成本 | 花费 / 转化订单数 | Σexpense / Σbroad_order |
| 平均每次点击成本 | 花费 / 点击量 | Σexpense / Σclick |
| 直接转化订单数 | direct_order | Σdirect_order |
| 每次直接转化成本 | 花费 / 直接转化订单数 | Σexpense / Σdirect_order |
| 直接转化率 | 直接转化订单数 / 点击次数 | Σdirect_order / Σclick |
| 直接销售金额 | direct_gmv | Σdirect_gmv |
| 直接已售商品 | direct_order_amount | Σdirect_order_amount |
| 直接 ACoS | 花费 / 直接销售金额 | Σexpense / Σdirect_gmv |
| 直接 ROAS（含税） | 直接销售金额 / 花费 | Σdirect_gmv / Σexpense |
| 开始时间 | date | 广告对象属性，不参与 Item 汇总或趋势日期计算 |
TikTok Item 指标
| UI 指标 | 字段 / 公式 | 聚合规则 |
|---|---|---|
| 花费 | Cost | ΣCost |
| 订单量 | SKU orders | ΣSKU orders |
| 净成本 | Net Cost，不包含广告赠款和优惠券广告花费 | ΣNet Cost |
| 销售额 | Gross revenue | ΣGross revenue |
| ROI | 广告销售额 / 广告花费 | ΣGross revenue / ΣCost |
| 平均下单成本 | 总花费 / 订单量 | ΣCost / ΣSKU orders |
金额与日期边界
- 继承原系统报表币种选择；原型仅演示 CNY 报表视图，汇率来源、换算时点与精度由既有系统契约承接。
- 平台原始币种及原值不得因报表换算丢失，但原币明细不是本次新增功能。
- 趋势所需报表统计日期字段尚未提供；原型使用演示日期序列，生产接入前必须补充字段级契约。
权限、状态与异常
| 场景 | 页面行为 |
|---|---|
| 有查看权限 | 可筛选、切换视图、查看详情 |
| 有导出权限 | 可创建当前视图导出任务 |
| 无导出权限 | 隐藏或禁用导出，并显示权限说明 |
| 加载中 | 指标、趋势和表格使用 Skeleton / loading 状态 |
| 无数据 | 保留当前筛选条件，显示清空或调整条件入口 |
| 部分字段缺失 | 对应值显示 —，不与平台返回 0 混淆 |
| 平台接口错误 | 显示平台级错误，不用另一平台或缓存结果替代 |
| 分母为 0 | 比率和成本指标显示 — |
| Item 关联多广告 | 详情中逐条展示，不在 Item 行提供广告级编辑 |
前端功能限制
- 原型使用 Mock 数据，不调用 Shopee 或 TikTok 真实 API。
- 不增加独立 Item 报表路由、侧边菜单或跨平台总览。
- 不实现预算、目标回报、启停、创建广告等写操作。
- 不在没有阈值契约的情况下把示例异常诊断描述为正式规则。
- 不把 Shopee
date误用为报表统计日期。 - 不平均 ROAS、ROI、ACoS、点击率、转化率或平均下单成本。
业务验收标准
- 在 Shopee、TikTok 平台内均可切换“广告视图 / Item 视图”，无需跳转新页面。
- 同平台切换视图后，店铺、日期、搜索、币种等共享条件保持不变。
- Shopee 与 TikTok 的指标名称、字段和公式分别符合本 PRD 数据口径。
- TikTok 平均下单成本由汇总总花费除以汇总订单量计算。
- Shopee
date在广告对象中显示为开始时间，不作为趋势日期。 - 诊断标签可筛选 Item 列表，指标设置可控制可见列。
- Item 详情可查看关联广告；Item 行不直接编辑广告级预算、目标回报或状态。
- 分母为 0、字段缺失、无数据和平台错误有可区分的呈现。
- 关键筛选、平台页签、视图切换、诊断、指标设置、详情与导出反馈在原型中可交互。
风险与未决问题
- 生产接入前需后端补充报表统计日期字段、接口端点、分页能力、最大日期范围和数据延迟。
- 币种换算来源、换算时点与精度沿用原系统，但当前未提供字段级证明，研发不得从原型反推。
- 异常诊断阈值是原型示例规则，正式默认值和是否支持账号级配置仍需业务确认。
- TikTok Item 主键中的广告账号/店铺层级需按实际 API 标识核定。
- “订单量”和“转化订单数”是否在 Shopee 最终 UI 统一命名为“订单量”，可在视觉验收时收口；字段仍为
broad_order。