Chronometrica 与 Fortuitous Pirate：如何检查 Google Ads 空结果

选择符合工作需要的结果约定

主要选择取决于你的流程是否要求程序明确提供每个目标的检查结果。这里的“结果约定”，指程序文档承诺提供哪些信息，用来说明检查过程中发生了什么。

Chronometrica 的文档说明了 `targetOutcomes`，并将 `no_results` 与公开数据源不可用的情况区分开来。文档还说明了已保存的有效广告素材、因重复或无法使用而跳过的广告素材，以及最终停止原因。如果复核 0 行结果时必须有这些记录，可以选择它。这项建议基于其文档所述的结果约定。Chronometrica Actor

如果 Fortuitous Pirate 的单查询输入、`advertiserId` 和 `proxyConfiguration` 控制项已满足你的工作流程，可以继续使用。经检查，其输入架构接受此前的德国查询，也接受平台和格式均为空的值。在决定是否更换工具前，请检查它当前实际运行的日志和输出。其 README 较短，并不能据此认定它没有日志或目标结果记录。Fortuitous Pirate Actor

这些是选择规则，并非实测性能结果。现有证据不能证明任何一方在速度、价格、准确性、覆盖范围或可靠性上有优势。

区分已保存的数据行数与数据源状态

空数据集只回答一个有限的问题：保存了多少行广告素材数据？数据源状态回答的是另一个问题：程序能访问和使用什么？

复核时，要区分以下 3 种可能的解释。

第一种情况是，检查成功访问了公开数据源，但没有找到符合目标和筛选条件的有效结果。下一步应检查目标身份和搜索范围。域名、广告主、地区或日期不匹配，都可能改变你预期能找到的内容。在证据支持某个原因之前，不要认定该原因。

第二种情况是，检查无法使用公开数据源。此时，0 行数据集不能说明广告主的广告投放情况。在对搜索范围下结论之前，先检查数据源访问情况。

第三种情况是，广告素材页面可见，但其公开资源无法用于采集。按照 Chronometrica 的结果规则，缺少可用公开媒体或预览的广告素材可能会被跳过。因此，可见页面与已保存的广告素材数据行不一定一一对应。Chronometrica Actor

这种区分也会影响你如何报告结果。如果已知情况仅限于此，就写“在这些设置下保存了 0 行有效数据”。不要简化为“该广告主没有广告”。后者省略了筛选条件、数据源条件和资源限制，而这些因素决定了结果的含义。

设置的数量上限也是一个独立事实。请求最多返回 1 行，并不保证会返回 1 行。它只设置了最大值。如果检查保存了 0 行，仅提高上限并不能解释之前的结果。

运行前准备好德国查询的输入

Task 是为 Actor 保存的输入预设。链接中的地区研究 Task 标题为 Canada。可以用它作为起点，然后检查其中实际保存的输入。经检查，其公开页面可以访问，但这次页面检查并未核实已保存的字段值。地区研究 Task

针对支持问题中的德国案例，请使用以下输入：

{
  "targets": [
    "ritzenberger.de"
  ],
  "region": "DE",
  "platform": "ALL",
  "adFormat": "ALL",
  "includeDeliveryDetails": false,
  "maxItems": 1
}

这份输入已通过所保存的公开 JSON Schema 检查。JSON Schema 定义允许的输入字段、类型和值。上面列出的所有字段都存在于经检查的架构中。这只能确认输入结构正确，不能确认实际的数据源访问情况，也不保证会有结果。Chronometrica Actor 输入

进行小规模检查前，请按以下步骤操作：

1. 原样保留报告中的域名。如果另有已知的广告主身份信息，将其保存在复核笔记中。
2. 打开 Task 输入，将地区改为 `DE`。不要依赖 Task 标题，也不要假定其中已保存的地区符合要求。
3. 本次检查将 `platform` 和 `adFormat` 都设为 `ALL`。
4. 检查每个已保存的字段。在将输出与浏览器中看到的内容进行比较之前，先确认所有筛选条件。
5. 对于这里展示的首次检查，将 `maxItems` 保持为 `1`。

记录与公开数据源进行比较时使用的日期范围。如果你查看的证据中没有显示 Actor 使用的日期范围，将其标为未知。不要添加未经架构核实的输入字段。

经检查，架构允许 `targets` 包含 1–100 个条目，`maxItems` 为 1–5,000 的整数。如果你原本要求单次运行配置为返回超过 5,000 条结果，这款 Actor 无法满足该要求。一次较小规模的检查，不能满足更大规模的全部结果请求。Chronometrica Actor 输入

结合数据集复核结果记录

完成计划中的小规模检查后，结合已保存的数据行与结果记录进行复核。先看目标，再检查筛选条件、数据源状态、跳过的广告素材和停止原因。Chronometrica 的文档通过目标上下文和结果统计说明这些信息。Chronometrica Actor

使用一份简短的复核记录。这里的“复核记录”，指针对 1 个目标写下的证据记录。

1. 解析后的目标：记录检查解析出的广告主身份。如果与预期广告主不同，要明确保留这项差异。
2. 请求的筛选条件：记录地区、平台、格式、已知的日期范围，以及请求的数量上限。
3. 数据源状态：记录结果证据支持的是没有有效结果，还是公开数据源不可用。
4. 有效数据行：记录实际保存的数量。只有在输出报告或证实数量为 0 时，才填写 0。
5. 跳过的广告素材：按输出提供的信息，记录重复素材和无法使用的素材数量。保留未知或缺失值。
6. 最终停止原因：记录检查为何结束。不要仅凭数据集大小推断原因。
7. 尚未查明的原因：说明现有证据仍无法解释哪些问题。

每份复核记录应对应 1 个目标和 1 组设置。否则，后续更改筛选条件后，先前的结果可能显得前后不一致，尽管 2 次检查回答的其实是不同问题。

解读跳过数量时要谨慎。因重复而跳过与因资源无法使用而跳过，支持的解释不同。前者涉及重复内容。后者涉及广告素材能否成为有效的已保存数据行。只使用输出实际提供的细节。如果输出只给出合计数量，不要自行编造分类数量。

如果某个值缺失，就写“未知”。缺少数据源状态证据，不等于已确认数据源故障。缺少跳过数量，也不等于已确认跳过数量为 0。这样记录，才能为后续复核提供帮助。

虚构示例：数据行数相同，后续步骤不同

以下示例为虚构内容。它不是 Actor 测试、实际采集的数据集或客户结果。

一名分析人员对同一个目标进行了 2 次检查。2 次检查都保存了 0 行广告素材数据。

检查 A 成功访问了公开数据源。其结果报告，在声明的筛选条件下没有有效结果。分析人员的下一步，是将解析出的广告主和筛选条件，与此前让自己预期存在广告的公开页面视图进行比较。分析人员检查地区、平台、格式、日期，以及查看数据源的时间。

检查 B 无法使用公开数据源。分析人员先检查数据源访问情况。由于无法使用数据源，这次检查不足以支持对该广告主的广告作出结论。

计算很简单：检查 A 保存了 0 行，检查 B 也保存了 0 行。两者的数据行数相同。但数据源状态不同，因此后续步骤也不同。

2 次检查都使用了 1 行的上限。这个上限并不要求任何一次检查必须返回 1 行。它限制的是最大结果数，并不保证有结果。

这 2 种结果都不能证明该广告主没有广告。检查 A 仍受目标、筛选条件和有效结果规则的限制。检查 B 仍受数据源访问情况的限制。这个示例支持的是一种复核方法，不能用于估算费用或证明可靠性。

通过小规模验收检查作出决定

验收检查是预先写明通过条件的小规模测试。这里的目的是判断输出能否回答你对空结果的疑问。

运行前先设定通过条件：“对于这个目标，我能确定解析出的广告主、请求的筛选条件、数据源状态、已保存的数据行、跳过的广告素材，以及最终停止原因。”通过这项检查并不要求数据行数为正。得到解释的空结果也可以是有用的证据。

请按以下方法操作：

1. 写下你预期的公开证据。记录域名或广告主、地区、可见广告素材的参考信息，以及观察时间。在笔记中原样保留最初的输入。
2. 验证输入结构。对照 Actor 当前的架构，检查允许的字段和值。要区分输入架构错误，与查询有效但未产生有效数据行这 2 种情况。
3. 运行计划中的小规模检查。使用你已复核的明确设置。不要仅为了使结果数量为正而更改多个筛选条件。
4. 完成复核记录。结合数据集阅读结果证据。将每个尚未确定的值标为未知。
5. 选择下一步操作。没有有效结果时，检查身份和筛选条件；数据源不可用时，检查数据源访问情况；广告素材无法使用时，检查资源限制。

如果需要进一步检查，每次只更改 1 项相关设置，并记录原因。这样更容易解读新结果。更大的数据集不一定能提供更好的解释。

对于尚未解决的问题，准备一份支持报告，包含已脱敏的输入、预期的公开证据、观察到的结果，以及仍待回答的问题。脱敏是指移除私人或敏感信息。不要包含代理凭据或其他秘密信息。

这个流程也能为是否保留现有工具提供公平的判断依据。判断其实际证据是否满足你的验收条件。仅凭一份过去的支持报告，无法替当前运行作出判断。

解决空结果问题后，可使用地区广告素材比较指南来比较不同地区已保存的广告素材集合。这属于另一项分析。在将空结果用作地区差异的证据之前，先确定这次空结果检查的含义。