巨量千川保本 ROI 计算

适用场景

当抖音电商商家想在千川投放前知道商品能承受的广告成本，以及如何留出退款、平台费和履约缓冲时使用。

输入与输出

• - 输入：脱敏商品 JSON，包含成交价、优惠、平台/支付费率、达人或服务费、商品成本、履约成本、退款准备金、目标利润率和安全系数。
• 输出：qianchuan_roi_plan.json，包含净收入、可承受广告成本、保本 ROI、安全 ROI、预算上限、公式和 plan_created=false。

安装与运行

无需联网。运行 python scripts/calc_qianchuan_roi.py product.json --output qianchuan_roi_plan.json。

执行规则

先计算扣除优惠、平台/支付费、达人或服务费后的净收入，再扣商品、履约和退款准备金；用保本贡献与安全系数输出保本 ROI 和安全 ROI。缺少成本或费率时拒绝给出数值。

错误恢复

字段缺失、费率不在 0 到 1、金额为负或净收入不为正时返回非零状态并列出原因。不会写入投放后台。

权限与隐私边界

不登录巨量千川、不读取账户余额、计划、素材、客户数据或Token，不创建、修改、暂停和删除广告计划。

验收

用 examples/product.json 运行后，应生成保本 ROI、安全 ROI、预算上限以及 plan_created=false，金额使用脱敏示例。