---
AIGC:
    Label: "1"
    ContentProducer: 001191440300708461136T1XGW3
    ProduceID: dd5b28b722ee4bbdb49f51b430d8b21d_ea61f0a2d85411f19232525400248c00
    ReservedCode1: UjMDe5iwAfI14JMMMJQXMUbFB1eWrx6NUKfWcBMbDpcR1IJJF3gDaNWqyVY+A6iCkTzvr54X3OjT/S2b2h1QygmyUiUCGuDeZSJFaE0e8co8vDD9x+q2aefOBc29CNuidycybRTBmCr6URQJRLss9Kb4lG+hqh7Nb3mCuV7/M4ZBKax42/tcyroQ2XI=
    ContentPropagator: 001191440300708461136T1XGW3
    PropagateID: dd5b28b722ee4bbdb49f51b430d8b21d_ea61f0a2d85411f19232525400248c00
    ReservedCode2: UjMDe5iwAfI14JMMMJQXMUbFB1eWrx6NUKfWcBMbDpcR1IJJF3gDaNWqyVY+A6iCkTzvr54X3OjT/S2b2h1QygmyUiUCGuDeZSJFaE0e8co8vDD9x+q2aefOBc29CNuidycybRTBmCr6URQJRLss9Kb4lG+hqh7Nb3mCuV7/M4ZBKax42/tcyroQ2XI=
---

# data 数据投放说明

本目录是 TikTok 电商竞品分析工作台的数据投放区。`../index.html` 为纯离线骨架版，页面内所有数值均为灰色占位符（标注「示例数据 / 待导入」）。把第三方工具导出的原始文件按下表放进对应子目录，即可按统一字段口径回填。

字段定义与清洗口径见同级目录的 `字段字典与导出模板.xlsx`，本文件只约定「放哪里、怎么命名、什么格式」。

---

## 一、子目录用途

| 子目录 | 存放内容 | 对应字段表（sheet） | 典型文件 |
| --- | --- | --- | --- |
| `01_store/` | 店铺维度导出：店铺榜、店铺详情、店铺经营结构 | `store` | 店铺榜单 CSV、店铺明细表 |
| `02_product/` | 商品维度导出：商品榜、价格带、销量与 GMV | `product` | 商品榜 CSV、SKU 明细表 |
| `03_listing/` | Listing 结构化记录：主图张数、卖点序列、评分、合规词 | `listing` | 人工打分表、合规检查表 |
| `04_account/` | 竞品账号维度：粉丝、更新频次、互动率、内容结构 | `account` | 达人榜 CSV、账号明细表 |
| `05_video/` | 短视频维度：播放/点赞/评论/分享、选题、钩子、CTA | `video` | 爆款视频榜 CSV、视频明细表 |
| `06_assets/images/` | 商品主图与首图截图 | —（对应 `listing` 的图片类证据） | 单商品主图序列 |
| `06_assets/screenshots/` | 详情页长图、评论区首屏、直播页截屏 | — | 页面截屏 |

> `06_assets/` 下已预置 `images/` 与 `screenshots/` 两个子目录，请勿改名或再嵌套新层级。

---

## 二、命名规范

统一格式：

```
YYYYMMDD_<来源工具>_<数据域>[_<范围/备注>].<扩展名>
```

示例：

```
20261104_kalodata_store_export.csv
20261104_kalodata_product_top500.xlsx
20261104_fastmoss_account_my.csv
20261104_kalodata_video_last30d.csv
20261104_商品ID_主图01.jpg
20261104_商品ID_详情页.png
```

命名规则：

1. **日期前缀**固定为导出当天，格式 `YYYYMMDD`，同一批次所有文件保持同一前缀，便于按批次回溯。
2. 全部使用**小写英文 + 下划线**，不使用空格、中文、括号、`#` 等特殊字符（图片中以 `商品ID` 代替标题的例外仅限 `06_assets/`）。
3. 数据域取值固定为：`store` / `product` / `listing` / `account` / `video` / `assets`。
4. 同一天同一数据域重复导出时，在末尾追加 `_v2`、`_v3`，**不要覆盖**旧文件。
5. 图片命名中商品/视频 ID 必须与对应表格中的 ID 完全一致，否则无法匹配。

---

## 三、支持格式

| 类型 | 支持扩展名 | 要求 |
| --- | --- | --- |
| 表格 | `.csv` / `.xlsx` | CSV 用 UTF-8 编码，首行必须是表头；xlsx 首行表头需与 `字段字典与导出模板.xlsx` 的字段名一致 |
| 图片 | `.png` / `.jpg` | 单张建议 ≤ 5MB；详情页长图可用 jpg 压缩；截图保留原始分辨率，不要二次裁切 |

不支持的格式（如 `.pdf`、`.et`、`.numbers`）请先在源工具内另存为上述格式再投放。

---

## 四、投放注意事项

1. **字段名对齐**：导出文件的列名请尽量对齐字段表中的「字段名」；第三方工具原始列名可保留在「对应第三方工具字段」中登记，由后续版本做映射。
2. **缺失值留空**：无数据来源的字段请留空，**不要填 0**，避免污染均值与占比计算。
3. **口径一致**：GMV、销量、客单价必须来自同一时间窗（日/周/月），跨窗口混用会导致 P1 指标卡失真。
4. **当前为骨架版**：本版本未内置解析脚本，投放文件不会即时改变页面数值，页面仍显示占位符；回填渲染在后续版本接入。
5. **不要放入凭据**：本目录禁止存放账号密码、API Key、Cookie、Token 等敏感信息。
6. **不要改动目录名**：子目录名称与页面中的投放路径一一对应，改名会导致路径失效。
*（内容由AI生成，仅供参考）*