Ad delivery diagnosis skill
Use when diagnosing advertising delivery problems involving requests, bids, wins, impressions, clicks, conversions, spend, pacing, DSP, SSP, ADX, or programmatic advertising funnels.From its SKILL.md
npx -y skills add zxxxly8/ad-delivery-diagnosis-skillAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
10.1 KB, ~3.7k tokens by cl100k_base, as published. Nobody here has run it
广告投放异常诊断
核心原则
沿计数漏斗从上游向下游检查,优先定位第一个有同口径基准支持的异常节点。将消耗、预算和 pacing 作为独立的商业结果分析,不把它们强行视为计数漏斗的末端。
不得用猜测补全缺失数据,不得在没有基准时引用行业均值或判断指标异常。
诊断前置确认
先收集并确认以下信息;无法确认的项目写入“缺失信息”:
- 投放目标:曝光、点击、转化、收入、消耗或预算进度,以及主要优化指标。
- 对比基准:同口径历史值、目标值、对照组或用户提供的外部来源。
- 数据口径:
- 时间范围一致;
- 时区一致;
- 广告层级一致,例如账户、计划、单元、创意;
- 流量范围一致,例如媒体、版位、设备、地域;
- 指标去重口径一致,并明确请求、曝光、点击、转化的去重键;
- 转化归因窗口、回传延迟和计费口径明确。
- 投放上下文:DSP、SSP、ADX、计费模式、预算类型、投放周期、暂停记录、分时策略及冷启动状态。
若跨环节数据口径不一致,先将其认定为数据质量问题,暂停使用这些数据进行跨环节比率计算和根因判断。
事件定义与漏斗
按以下计数漏斗检查:
总请求量
→ 有效请求量
→ 下发给 DSP 的请求量
→ DSP 参竞量
→ DSP 广告返回量
→ 竞价成功量
→ ADX 最终广告返回量
→ 曝光量
→ 点击量
→ 转化量
明确区分以下事件,不得互相替代或默认等价:
| 事件 | 含义 | 主要验证问题 |
|---|---|---|
| DSP 参竞量 | DSP 对收到的请求实际提交竞价响应的数量 | DSP 是否愿意且能够参与竞价 |
| DSP 广告返回量 | DSP 返回了可用广告或竞价响应的数量,具体以平台日志定义为准 | DSP 返回、素材资格和响应完整性 |
| 竞价成功量 | 在竞价中胜出的数量 | 出价竞争力、竞价规则和流量竞争 |
| ADX 最终广告返回量 | ADX 完成过滤、竞价及决策后最终向媒体侧返回广告的数量 | ADX 后置过滤和最终填充 |
| 曝光量 | 广告满足平台曝光记账或监测条件的数量 | 返回后的加载、渲染、可见或监测链路 |
若平台对“DSP 广告返回量”有不同定义,先记录该定义,再决定它能支持哪个指标。没有明确映射时,不用它替代竞价成功量或 ADX 最终广告返回量。
指标计算
仅当分子、分母均已提供、口径一致且分母大于 0 时计算。展示公式、代入值、结果和适当的四舍五入精度。分母为 0 时标记为“不可计算”,不得输出 0%、无穷大或 NaN 代替。
| 指标 | 公式 | 解释 |
|---|---|---|
| 有效率(可选) | 有效请求量 ÷ 总请求量 | 请求通过基础校验、风控或流量过滤的比例 |
| 下发率 | 下发请求量 ÷ 总请求量 | 总请求中被下发给 DSP 的比例;该口径会同时受到有效过滤和下发策略影响 |
| 有效请求下发率(可选) | 下发请求量 ÷ 有效请求量 | 有效请求中实际下发给 DSP 的比例 |
| 参竞率 | DSP 参竞量 ÷ 下发请求量 | DSP 对收到请求的参与程度 |
| 胜出率 | 竞价成功量 ÷ DSP 参竞量 | DSP 参与竞价后的胜出程度 |
| 曝光成功率 | 曝光量 ÷ ADX 最终广告返回量 | ADX 最终返回后形成曝光的比例 |
| CTR | 点击量 ÷ 曝光量 | 曝光转化为点击的比例 |
| CVR | 转化量 ÷ 点击量 | 点击转化为归因转化的比例 |
| CPC | 消耗 ÷ 点击量 | 平均每次点击成本 |
| CPM | 消耗 ÷ 曝光量 × 1000 | 平均千次曝光成本 |
| 预算完成率 | 当前消耗 ÷ 总预算 | 当前预算完成程度 |
| 时间进度 | 已投放时间 ÷ 总投放时间 | 当前计划周期完成程度 |
“曝光成功率”的默认分母是 ADX 最终广告返回量。只有当用户的平台明确把“广告返回量”定义为该事件时,才可以沿用“曝光量 ÷ 广告返回量”的简称;必须在输出中写明采用的事件定义。
未提供某环节的数据时:
- 不自行补全;
- 不计算依赖该数据的指标;
- 在“缺失信息”中列出;
- 说明该数据用于验证哪个漏斗问题或计算哪个指标。
异常判断规则
- 只有同口径历史值、目标值、对照组或用户提供的外部基准存在时,才使用“上升”“下降”“偏高”“偏低”或“异常”。
- 没有基准时,仅陈述当前值和可观察事实,并请求基准。不得自行引用行业均值。
- 按漏斗顺序比较当前值与基准,选择最早出现明确偏离的节点作为主要异常节点。
- 后续节点也偏离时保留这些现象,但先判断它们是否可能由上游流量损失传导造成。
- 不把同一上游异常导致的下游数量下降重复认定为多个独立根因。
- 处理最早异常后,用相同口径复测后续节点;只有后续指标仍独立偏离时,才升级为独立问题。
证据分级
严格使用以下分类:
- 已确认事实:由用户数据直接计算、日志直接证明或同口径对比明确支持的结论。
- 高概率原因:有多项相关证据支持,但尚缺少决定性日志或实验验证的原因。写明支持证据。
- 待验证原因:合理的排查方向,但当前证据不足。写明验证所需数据或动作。
- 缺失信息:当前没有提供且会影响计算、异常判断或根因验证的信息。
不要为了填满分类而虚构内容。没有足够证据时,“高概率原因”可以明确写“暂无”。
节点排查提示
以下内容是验证方向,不是默认根因:
| 最早异常节点 | 优先验证方向 |
|---|---|
| 总请求 → 有效请求 | 请求格式、必填字段、流量质量、反作弊、隐私或合规过滤、重复请求 |
| 有效请求 → DSP 下发 | 路由策略、流量分配、QPS 限制、黑白名单、协议兼容、超时预算 |
| DSP 下发 → DSP 参竞 | 账户或预算状态、DSP 过滤日志、定向交集、频控、QPS/超时、出价资格 |
| DSP 参竞 → DSP 返回 | 响应超时、素材或落地页资格、协议字段、返回解析、内部候选不足 |
| DSP 参竞 → 竞价成功 | 出价与底价、竞争强度、计价规则、质量分、交易类型 |
| 竞价成功 → ADX 最终返回 | ADX 后置审核、素材扫描、重复过滤、频控、策略冲突、响应丢弃 |
| ADX 最终返回 → 曝光 | SDK/页面加载、渲染失败、页面生命周期、素材资源、监测触发、去重或反作弊 |
| 曝光 → 点击 | 流量结构、版位、素材版本、频次、人群、设备、地域和交互埋点 |
| 点击 → 转化 | 落地页、转化链路、归因窗口、回传延迟、事件埋点、商品或表单体验 |
不得跳过验证直接把问题归因于素材、出价或人群定向。
消耗与 pacing
将消耗视为独立商业结果,结合以下信息解释:
- 计费模式:CPM、CPC、CPA 或其他方式;
- 预算目标:总预算、日预算、分时预算或非匀速预算曲线;
- 投放进度:预算完成率与时间进度;
- 投放状态:暂停、冷启动、审核、流量波动或策略变更。
预算完成率与时间进度的差异只构成初步 pacing 信号。分时投放、非匀速预算、暂停、冷启动、回传延迟和预算跨日规则都可能改变判断。在未确认这些因素前,不把进度差异直接认定为投放故障。
诊断流程
- 复述投放目标、主要优化指标和用户提供的基准。
- 校验五项数据口径;有冲突时先报告数据质量问题。
- 按公式计算全部可计算指标;对不可计算项说明原因。
- 按漏斗顺序与基准比较,定位最早明确异常节点。
- 把事实、原因假设和缺失信息分开。
- 按 P0、P1、P2 排列建议:
- P0:恢复数据可信度、确认投放状态或阻止持续损失;
- P1:验证最早异常节点的主要假设;
- P2:验证后续异常和低概率方向。
- 给出可立即执行且可回滚的短期止损动作,注明观察指标和复核时间窗。
- 给出减少复发的长期优化建议,例如监控、分层基线、日志和实验机制。
标准输出
严格按以下顺序输出全部章节。没有内容时写“暂无”或明确缺失原因,不删除章节。
## 诊断结论
[一句话说明最早异常节点、证据强度及业务影响;没有基准时明确无法判定异常。]
## 核心指标
| 指标 | 计算 | 当前值 | 对比基准 | 判断 |
| --- | --- | --- | --- | --- |
## 异常漏斗节点
[按漏斗顺序说明最早异常和后续现象;避免重复归因。]
## 已确认事实
- [仅列数据或日志直接支持的事实。]
## 高概率原因
- [原因、支持证据及尚缺的验证;证据不足时写“暂无”。]
## 建议排查顺序
1. **P0|待验证** — [原因假设、动作、所需数据、预期验证结果。]
2. **P1|待验证** — [原因假设、动作、所需数据、预期验证结果。]
3. **P2|待验证** — [原因假设、动作、所需数据、预期验证结果。]
## 短期处理动作
- [可回滚的止损动作、风险、观察指标和复核时间窗。]
## 长期优化建议
- [监控、日志、基线、实验或流程改进。]
## 缺失信息
- [缺失字段,以及它用于计算或验证什么。]
“待验证原因”不单独增加标准章节:将其放入“建议排查顺序”,明确标注为待验证,不得混入“已确认事实”。
示例与测试
所有示例数据均为模拟数据,不代表行业基准、真实客户表现或效果承诺。
What ships with it: 8 files
39.1 KB alongside SKILL.md
examples/
- low-bid-rate.md4.9 KB
- low-ctr.md5.1 KB
- low-impression-rate.md4.9 KB
tests/
- test-cases.md11.9 KB
- CONTRIBUTING.md2.5 KB
- .gitignore144 B
- LICENSE1.1 KB
- README.md8.6 KB