短视频投流盈亏核算器

用确定性公式解决投流最核心的问题：这条计划到底是赚钱还是亏钱、ROI 到多少才不亏、出价和转化率的红线在哪。引擎区分"成交额口径 ROI"和"毛利口径盈亏"，避免被高成交额误导而实际亏本。

输入

{
  "product_price": 99,
  "product_cost": 49.5,
  "cvr": 0.3,
  "cpm": 60,
  "target_roi": 3,
  "commission_rate": 0,
  "budget": 600
}

字段含义：客单价（元）、商品成本（元，含发货；也可改用 gross_margin 毛利率%）、曝光→成交转化率（百分数数字，0.3 表示 0.3%）、千次曝光成本 CPM（元）、目标 ROI（倍数）、精选联盟/达人佣金率%（可选）、预算（元，可选）。

输出

1. 单次转化成本 CPA
2. 实际投产比 ROI（成交额 ÷ 消耗）
3. 净毛利率与盈亏平衡 ROI
4. 单件毛利、每千次曝光的成交/毛利/净盈亏
5. 阈值：可承受最高 CPM、最高 CPA、达目标 ROI 所需最高 CPM 与最低转化率
6. 跑正/跑亏、达标/未达标判定
7. 若给预算：曝光量、成交单数、成交额、净盈亏

使用方法

python scripts/ad_roi.py '{"product_price":99,"product_cost":49.5,"cvr":0.3,"cpm":60,"target_roi":3,"budget":600}'

计算规则（确定性）

• 单件毛利 = 客单价 ×（毛利率 − 佣金率）；毛利率由成本或 gross_margin 得到
• 千次成交单数 = 1000 × 转化率
• 千次成交额 = 千次单数 × 客单价
• CPA = CPM ÷ 千次单数
• 实际 ROI = 千次成交额 ÷ CPM
• 盈亏平衡 ROI = 客单价 ÷ 单件毛利 = 1 ÷ 净毛利率
• 千次净盈亏 = 千次单数 × 单件毛利 − CPM
• 可承受最高 CPM = 千次毛利；可承受最高 CPA = 单件毛利
• 判定：实际 ROI ≥ 目标 ROI 为达标；实际 ROI ≥ 盈亏平衡 ROI 为跑正

硬规则

1. 客单价、成本、CPM、转化率、佣金率以投放后台实际数据为准，脚本不编造。
2. 转化率为曝光→成交口径；若后台给的是点击→成交转化率，需先乘以点击率换算，口径不可混用。
3. 结果未计入自然流量协同、复购、退款与人工成本，冷启动期波动大，建议小预算多计划测试。
4. 当扣佣后单件毛利 ≤ 0 时直接提示无法靠投流盈利，优先优化定价/成本/佣金而非加价买量。

示例

输入（跑亏场景）：

{"product_price":69,"gross_margin":30,"cvr":0.3,"cpm":80,"target_roi":3}

输出要点：
- 单件毛利 20.7，盈亏平衡 ROI ≈ 3.33
- 实际 ROI ≈ 2.59 < 3.33，判定跑亏
- 千次净亏 17.9 元，需提高转化率或压低 CPM 至安全线内