agentsclimarketplace

Ad delivery diagnosis skill

Skill zxxxly8/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

Install
npx -y skills add zxxxly8/ad-delivery-diagnosis-skill

Assembled 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 作为独立的商业结果分析,不把它们强行视为计数漏斗的末端。

不得用猜测补全缺失数据,不得在没有基准时引用行业均值或判断指标异常。

诊断前置确认

先收集并确认以下信息;无法确认的项目写入“缺失信息”:

  1. 投放目标:曝光、点击、转化、收入、消耗或预算进度,以及主要优化指标。
  2. 对比基准:同口径历史值、目标值、对照组或用户提供的外部来源。
  3. 数据口径:
    • 时间范围一致;
    • 时区一致;
    • 广告层级一致,例如账户、计划、单元、创意;
    • 流量范围一致,例如媒体、版位、设备、地域;
    • 指标去重口径一致,并明确请求、曝光、点击、转化的去重键;
    • 转化归因窗口、回传延迟和计费口径明确。
  4. 投放上下文: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 最终广告返回量。只有当用户的平台明确把“广告返回量”定义为该事件时,才可以沿用“曝光量 ÷ 广告返回量”的简称;必须在输出中写明采用的事件定义。

未提供某环节的数据时:

  • 不自行补全;
  • 不计算依赖该数据的指标;
  • 在“缺失信息”中列出;
  • 说明该数据用于验证哪个漏斗问题或计算哪个指标。

异常判断规则

  1. 只有同口径历史值、目标值、对照组或用户提供的外部基准存在时,才使用“上升”“下降”“偏高”“偏低”或“异常”。
  2. 没有基准时,仅陈述当前值和可观察事实,并请求基准。不得自行引用行业均值。
  3. 按漏斗顺序比较当前值与基准,选择最早出现明确偏离的节点作为主要异常节点。
  4. 后续节点也偏离时保留这些现象,但先判断它们是否可能由上游流量损失传导造成。
  5. 不把同一上游异常导致的下游数量下降重复认定为多个独立根因。
  6. 处理最早异常后,用相同口径复测后续节点;只有后续指标仍独立偏离时,才升级为独立问题。

证据分级

严格使用以下分类:

  • 已确认事实:由用户数据直接计算、日志直接证明或同口径对比明确支持的结论。
  • 高概率原因:有多项相关证据支持,但尚缺少决定性日志或实验验证的原因。写明支持证据。
  • 待验证原因:合理的排查方向,但当前证据不足。写明验证所需数据或动作。
  • 缺失信息:当前没有提供且会影响计算、异常判断或根因验证的信息。

不要为了填满分类而虚构内容。没有足够证据时,“高概率原因”可以明确写“暂无”。

节点排查提示

以下内容是验证方向,不是默认根因:

最早异常节点优先验证方向
总请求 → 有效请求请求格式、必填字段、流量质量、反作弊、隐私或合规过滤、重复请求
有效请求 → DSP 下发路由策略、流量分配、QPS 限制、黑白名单、协议兼容、超时预算
DSP 下发 → DSP 参竞账户或预算状态、DSP 过滤日志、定向交集、频控、QPS/超时、出价资格
DSP 参竞 → DSP 返回响应超时、素材或落地页资格、协议字段、返回解析、内部候选不足
DSP 参竞 → 竞价成功出价与底价、竞争强度、计价规则、质量分、交易类型
竞价成功 → ADX 最终返回ADX 后置审核、素材扫描、重复过滤、频控、策略冲突、响应丢弃
ADX 最终返回 → 曝光SDK/页面加载、渲染失败、页面生命周期、素材资源、监测触发、去重或反作弊
曝光 → 点击流量结构、版位、素材版本、频次、人群、设备、地域和交互埋点
点击 → 转化落地页、转化链路、归因窗口、回传延迟、事件埋点、商品或表单体验

不得跳过验证直接把问题归因于素材、出价或人群定向。

消耗与 pacing

将消耗视为独立商业结果,结合以下信息解释:

  • 计费模式:CPM、CPC、CPA 或其他方式;
  • 预算目标:总预算、日预算、分时预算或非匀速预算曲线;
  • 投放进度:预算完成率与时间进度;
  • 投放状态:暂停、冷启动、审核、流量波动或策略变更。

预算完成率与时间进度的差异只构成初步 pacing 信号。分时投放、非匀速预算、暂停、冷启动、回传延迟和预算跨日规则都可能改变判断。在未确认这些因素前,不把进度差异直接认定为投放故障。

诊断流程

  1. 复述投放目标、主要优化指标和用户提供的基准。
  2. 校验五项数据口径;有冲突时先报告数据质量问题。
  3. 按公式计算全部可计算指标;对不可计算项说明原因。
  4. 按漏斗顺序与基准比较,定位最早明确异常节点。
  5. 把事实、原因假设和缺失信息分开。
  6. 按 P0、P1、P2 排列建议:
    • P0:恢复数据可信度、确认投放状态或阻止持续损失;
    • P1:验证最早异常节点的主要假设;
    • P2:验证后续异常和低概率方向。
  7. 给出可立即执行且可回滚的短期止损动作,注明观察指标和复核时间窗。
  8. 给出减少复发的长期优化建议,例如监控、分层基线、日志和实验机制。

标准输出

严格按以下顺序输出全部章节。没有内容时写“暂无”或明确缺失原因,不删除章节。

## 诊断结论

[一句话说明最早异常节点、证据强度及业务影响;没有基准时明确无法判定异常。]

## 核心指标

| 指标 | 计算 | 当前值 | 对比基准 | 判断 |
| --- | --- | --- | --- | --- |

## 异常漏斗节点

[按漏斗顺序说明最早异常和后续现象;避免重复归因。]

## 已确认事实

- [仅列数据或日志直接支持的事实。]

## 高概率原因

- [原因、支持证据及尚缺的验证;证据不足时写“暂无”。]

## 建议排查顺序

1. **P0|待验证** — [原因假设、动作、所需数据、预期验证结果。]
2. **P1|待验证** — [原因假设、动作、所需数据、预期验证结果。]
3. **P2|待验证** — [原因假设、动作、所需数据、预期验证结果。]

## 短期处理动作

- [可回滚的止损动作、风险、观察指标和复核时间窗。]

## 长期优化建议

- [监控、日志、基线、实验或流程改进。]

## 缺失信息

- [缺失字段,以及它用于计算或验证什么。]

“待验证原因”不单独增加标准章节:将其放入“建议排查顺序”,明确标注为待验证,不得混入“已确认事实”。

示例与测试

所有示例数据均为模拟数据,不代表行业基准、真实客户表现或效果承诺。

What ships with it: 8 files

39.1 KB alongside SKILL.md

tests/

Keep looking

Skills are one crate of 326,144. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.