26 lines
3.7 KiB
Markdown
26 lines
3.7 KiB
Markdown
# SW Ads Campaign 预警
|
|
|
|
在 Agent 顶部点击「SW Ads 预警」，立即检查全部可访问的 TikTok 账户。每次重新发现账户，按账户时区和币种判断，支持账户筛选。当前规则仅评估 commerce_shop Campaign，非电商记录显示排除数量，不代表正常。
|
|
|
|
读取各账户时逐页显式指定并校验账户，结束后恢复原账户。与本 Agent 任务互斥；外部 SW Ads 页面同时切换账户仍可能使检查失败，请等待完成。单个账户失败独立展示，不冒用旧结果。
|
|
|
|
- 按每个 Campaign 的 commerce_summary.target_roi 判断，不使用统一 2.5。
|
|
- 读取账户时区下最近两个完整业务日；ROI 为 gross_revenue / spend，不等于净利润。没有毛利、退款等成本数据时不判断真实亏损。
|
|
- 默认最低消耗 100（账户币种）、5 单、CTR 比较最低 1000 曝光、同步有效期 12 小时；这是可配置的保守启发式，不是平台官方规则。
|
|
- 新建不足 72 小时、样本不足、目标缺失、同步过期、报表缺失或有待发布配置时不建议调预算。
|
|
- 连续达标且最新 ROI 超目标 20% 列为高潜候选；低于目标 80% 列为不达标；另检查无订单、CTR 下滑、CPA 上升。预算、暂停、目标复核和素材建议全部需要人工判断。
|
|
- 每小时自动检查默认关闭，在页面勾选并保存后启用，后端必须持续运行。页面每 30 秒刷新显示；没有邮件或飞书推送。
|
|
- 结果、设置、已处理状态保存在 workspace/monitoring/state.json（不入 Git）。重启后恢复；同日同 Campaign/目标/类型不重复计为新增。
|
|
- Agent 可通过只读 swads_alerts 工具解释最近一次检查，不能据此执行真实投放操作。工具不主动刷新，使用前应在预警中心检查最新数据。
|
|
|
|
当前为本机单进程、同一授权身份下多账户版本，不是多租户生产服务。不要未经鉴权与访问控制直接公开接口。没有分布式调度、不可变审计历史或外部通知；本次没有改变既有沙盒能力。
|
|
# 素材疲劳预警
|
|
|
|
预警中心的“素材疲劳预警”页和 Agent 的 `swads_alerts` 工具共用持久化结果。只读检查所有可访问 TikTok 账户中的电商视频/帖子，按账户、Campaign、素材 ID、身份和投放口径隔离，不混入商品卡。
|
|
|
|
按账户业务日期：最近 3 个完整日对比此前 7 日。CTR 用窗口总商品点击 / 总商品曝光重算。近期要求 3 个有曝光日、基线至少 3 日，两窗口均达到曝光门槛，基线至少 30 点击。CTR 相对下降至少 25% 提示“素材衰退”；同时 6 秒观看率（6秒观看数 / 播放数）下降至少 20% 才提示“疑似疲劳”。这些是可配置初始启发式阈值，不是官方标准或因果证明。
|
|
|
|
观看数据缺失或播放量为零不能当作观看率为零。缺少准确频次，因此频次不参与判断。GMV Max 的 ADS_AND_ORGANIC 包含自然流量，不能当作纯广告效果；新素材、覆盖不足、同步过期、未发布修改不能触发疲劳判定。未自动排除受众、预算、目标、价格、库存及归因变化，必须人工核实。基线只要求样本量，不表示它历史上已盈利。
|
|
|
|
逐日读取10个完整业务日，避免整个窗口触及行数上限。单日截断（含达到 5000 行上限）、重复行、错账户、错误日期或字段会明确报素材检查失败；不影响已成功读取的 Campaign 结果，但整体不能显示全部成功。没有 Campaign 关联的素材库视频计入排除数，不当作投放视频评估。结果和已处理状态保存在原监控状态文件；旧设置自动补齐新阈值。没有任何自动暂停、调预算或替换素材操作。
|