TikTok Shop视频指标归一化

适用场景

当运营从 Seller Center 导出视频表现，需要统一 GMV、SKU 订单、买家、视频观看、商品展示、商品点击和点击后订单率等字段时使用。

输入与输出

• - 输入：脱敏 CSV，至少包含 video_id、date、video_views、product_impressions、product_clicks；可选 sku_orders、buyers、gmv、gpm、attribution_window、currency。
• 输出：JSON 与 Markdown 归一化报告，包含商品点击率、点击后订单率、GPM、归因窗口、数据质量标记和稳定 row_hash。

执行规则

规范列名和数字后按分母存在性计算 product_ctr=product_clicks/product_impressions、ctor=sku_orders/product_clicks；不把不同 Seller Center 与 Ads Manager 口径混算，缺失归因窗口、币种或分母进入 REVIEW_REQUIRED。

安装与执行

仅需 Python 3.9+ 标准库：python scripts/normalize_video_metrics.py examples/input.csv --output normalized.json --markdown normalized.md。

错误恢复

补齐必需列、拆分不同归因窗口或统一币种后重跑。若字段名称来自自定义报表，先在 Seller Center 中确认列定义，再建立别名。

权限与隐私

只处理买家提供的脱敏报表，不读取 Seller Center、Cookie、客户资料、创作者资料或视频文件；预算、投放、商品关联和发布必须由有权限人员执行。

验收

示例应生成非空 JSON/Markdown，正确计算 2 条有效记录并对缺少归因窗口或零分母行标记 REVIEW_REQUIRED；固定 seller_center_api_called=false 与 platform_change_executed=false。