YouTube Shopping联盟指标归一化

适用场景

当商家或创作者从 YouTube Analytics/Shopping 报告导出内容、商品和创作者数据，需要统一销售、佣金、点击、订单、观看和退货净额口径时使用。

输入与输出

• - 输入：脱敏 CSV，至少包含 period、product_id、gross_sales、net_sales、commissions、clicks、orders；可选 creator_id、video_id、views、impressions、currency、privacy_suppressed。
• 输出：JSON 与 Markdown 归一化报告，包含订单转化率、佣金率、退货调整额、隐私状态、数据质量标记和稳定 row_hash。

执行规则

先规范列名和数字，再按分母存在性计算 order_rate=orders/clicks 与 commission_rate=commissions/gross_sales；净销售额不得高于总销售额，隐私隐藏的点击/观看不反推，缺失维度、币种、窗口或分母进入 REVIEW_REQUIRED。

安装与执行

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

错误恢复

补齐期间、商品、总销售、净销售、佣金、点击和订单字段；拆分不同币种、来源或归因窗口后重跑。被平台聚合或隐藏的字段保持为空。

权限与隐私

只处理买家提供的脱敏报表，不读取 YouTube Studio、Google Merchant Center、Cookie、观众或创作者个人资料；佣金、商品、标签和结算调整必须由有权限人员确认。

验收

示例应生成非空 JSON/Markdown，正确计算有效行并标记隐私隐藏、零分母和净额异常；固定 youtube_api_called=false 与 platform_change_executed=false。