巨量千川投放节奏门禁

适用场景

当投手需要根据当天消耗、成交GMV、实际ROI、目标ROI和预算节奏判断是否继续、降预算或暂停时使用。

输入与输出

• - 输入：脱敏投放快照 JSON，包含计划引用、小时、消耗、成交GMV、订单数、实际ROI、目标ROI、日预算和退款观察标记。
• 输出：qianchuan_pacing_review.json，给出 CONTINUE_REVIEW、REDUCE_AND_REVIEW、HOLD_FOR_HUMAN_REVIEW 或 PAUSE_FOR_HUMAN_REVIEW，以及建议动作、证据和 external_change_executed=false。

安装与运行

无需联网。运行 python scripts/check_qianchuan_pacing.py snapshot.json --output qianchuan_pacing_review.json。

执行规则

先检查消耗是否超过日预算、实际ROI与目标ROI的差距、订单数是否足够、退款观察是否完成；数据不足或预算超限时优先 HOLD/PAUSE，避免只凭单小时波动直接调价。

错误恢复

字段缺失、消耗为负、GMV为负或ROI与消耗/GMV不一致时返回 HOLD_FOR_HUMAN_REVIEW 并列出差异。不会调用投放接口。

权限与隐私边界

不登录巨量千川、不修改ROI、不调整预算、不暂停计划、不读取账户余额或用户数据。任何预算和出价变化都由有权限的投手人工确认。

验收

用 examples/snapshot.json 运行后，应输出一个明确建议、证据字段、external_change_executed=false，并对退款观察和数据量提出人工复核要求。