淘宝投放数据分析 — 淘宝广告投放数据分析

投放数据分析技能 技能概述

基于《数据分析基础概念和逻辑v3.md》文档开发的标准化投放数据分析技能，用于处理超级直播、淘宝直播和财务报表数据。

适用场景 万相台投放数据统计分析 直播数据多维度分析 财务数据与业务数据关联分析 ROI优化和成本分析 ClawHub使用

通过环境变量配置：

# 设置环境变量 TOUFANG_DATE_RANGE="2026-01-01:2026-01-31"

# 运行技能 python3 ClawHub_mAIn.py

# 或者一次性设置 TOUFANG_DATE_RANGE="2026-01-01:2026-01-31" python3 ClawHub_mAIn.py

输入要求 时间范围：YYYY-MM-DD格式的日期范围 数据文件：自动识别三类数据文件 超级直播数据（包含"超级直播"关键词） 淘宝直播数据（包含"淘宝直播"关键词） 财务数据（包含"财务"关键词） 输出内容 HTML汇总报表（桌面保存） 数据质量检查报告 关键指标计算 优化建议 核心功能

• 数据自动识别

# 自动识别数据文件 def auto_检测_files(data_dir): """自动识别三类数据文件""" super_files = find_files(data_dir, "超级直播") taobao_files = find_files(data_dir, "淘宝直播") financial_files = find_files(data_dir, "财务") return super_files, taobao_files, financial_files

• 编码自动处理

# 自动检测和处理编码 def auto_检测_encoding(file_path): """自动检测文件编码格式""" # 支持GBK、UTF-8等常见编码 # 自动转换和统一处理

• 字段映射计算

基于文档中的字段定义和计算公式：

超级直播关键计算：

ROI = 总成交金额 / 花费 观看成本 = 花费 / 观看次数 订单成本 = 花费 / 总成交笔数 加购成本 = 花费 / (总收藏数 + 总购物车数)

淘宝直播关键计算：

成交转化率 = 成交人数 / 商品点击人数 客单价 = 成交金额 / 成交人数 笔单价 = 成交金额 / 成交笔数

财务报表关键计算：

业务口径收入 = 品牌费 + 切片 + 保量佣金 + 预估结算机构佣金 + 预估结算线下佣金 财务口径收入 = 业务口径收入 / 1.06 毛利率 = 毛利 / 财务口径收入

• 跨报表关联分析

# 跨报表数据关联 def cross_报告_analysis(super_df, taobao_df, financial_df): """基于文档的跨报表关联分析""" # 超级直播去退ROI参考值 roi_adjusted = (super_df['总成交金额'] (1 - taobao_df['退货率'])) / super_df['花费'] # 推广投入回报率 promotion_roi = (financial_df[['保量佣金','预估结算线下佣金','预估结算机构佣金']].sum() (super_df['总成交笔数'] / taobao_df['成交笔数'])) / super_df['花费'] return roi_adjusted, promotion_roi

使用示例 基本使用 # 调用投放数据分析技能 投放数据分析 --date-range "2026-01-01:2026-01-31" --data-dir "/Users/zhouhao/Documents/投放数据"

高级使用 # 包含特定指标计算 投放数据分析 --date-range "2026-01-01:2026-01-31" \ --指标 "ROI,观看成本,订单成本" \ --输出-格式化 "html,csv"

文件结构 投放数据分析技能/ ├── 技能.md # 技能说明文档 ├── requirements.txt # Python依赖 ├── mAIn.py # 主程序 ├── data_处理器.py # 数据处理模块 ├── calculator.py # 指标计算模块 ├── 报告er.py # 报表生成模块 └── config.py # 配置文件

依赖要求 pandas >= 1.5.0 numpy >= 1.21.0 chardet >= 5.0.0 输出示例

技能执行后会生成：

YYYY-MM-DD_投放数据分析报告.html - 完整HTML报表 YYYY-MM-DD_数据质量检查.csv - 数据质量报告 YYYY-MM-DD_关键指标汇总.csv - 指标计算结果 错误处理 自动处理文件编码问题 字段缺失时的智能处理 数据质量异常预警 版本历史 v1.0.0: 初始版本，基于数据分析基础概念和逻辑v3.md 作者

江风 - 交个朋友直播间