商品全域预算ROI调控

在真实毛利底线、样本量和单次调幅内优化商品全域计划；不要把旧标准计划出价接口用于商品全域。

工作流

1. 对齐单一 advertiser_id、计划ID、归因窗口、目标ROI、保本ROI、订单样本和当前预算。
2. 运行 scripts/allocate_budget.py，严格保持推荐预算合计等于总预算。
3. 把商品全域预算更新映射到 update_budget_infos，把控成本计划支付ROI映射到 update_roi2_infos。
4. 对低样本、退款异常、归因延迟和直播异常计划保持观察，不强行调控。
5. 先预览官方请求；实际写入时显式允许预算或ROI动作，并核验账户ID。
6. 写后重新获取计划详情，记录前值、后值、时间和平台回执。

python scripts/allocate_budget.py --input plans.csv --total-budget 10000 --max-change-pct 0.2 --out-dir output
python scripts/official_api_client.py --request output/action_manifest.json --out output/api-preview.json

字段、官方端点和执行命令见 references/method.md。

质量门槛

• 保本ROI优先于平台表面ROI；缺少成本口径时不声称盈利。
• 默认预算调幅不超过20%，支付ROI调幅不超过5%。
• 不自动保存密钥，不把建议描述为已执行。