Chronometrica 与 Streamers 对比：带精度标记的 YouTube 指标

选择符合报告需求的采集数据规范

Actor 是托管的数据采集程序。其输出规范说明它会返回哪些数据，以及如何解读这些数据。对比报告需要关注这份规范，因为仅有一个数字，可能无法判断它是否可用。

假设你的报告只接受完整的公开计数，用于计算点赞数与播放次数之比。你需要知道每个必需计数是否可用。你还需要知道来源显示的是完整数值，还是经过舍入的标签。按照这条规则，数值 100,000 和显示标签 100K 可能需要不同的处理方式。播放次数还必须大于 0，才能用于计算比率。

这些适用需求依据产品文档确定，并非对比运行的结果。请参阅 Chronometrica 文档和 Streamers 文档。

Chronometrica 文档说明，输出采用扁平行结构：每条记录包含帖子信息、各项计数和采集时间字段。相关字段包括 `inputUrl`、`postUrl`、`postId`、`title`、`publishedAt`、`views`、`likes`、`comments`、`channelSubscribersCount` 和 `scrapedAt`。其中，`postMetricStatus` 和 `channelMetricStatus` 结构说明指标的可用性和精度。缺失计数仍保留为缺失。这份明确的规范，是在报告有严格计数规则时选择它的原因。Chronometrica 输出规范

Streamers 文档列出了直接 URL 输入、关键词搜索，以及针对普通视频、Shorts 和直播分别设置的结果数量上限。这些控制项可以支持范围更广的采集工作。Streamers 输入结构

因此，决定是否改用另一工具的主要条件很实际：选择其文档所述输出和采集模式符合整项工作需求的采集工具。本指南没有证明竞争产品的计数有误，也没有证明它完全缺少数据质量信息。

计算前先查看可用性和精度

可用性说明某项指标是否存在。Chronometrica 文档列出了 `present`、`unavailable` 和 `not_attempted` 等状态。计数不可用，与尚未尝试采集该计数，是两种不同情况。审核结果时应保留这一区别。Chronometrica 指标状态规范

精度说明公开来源对计数的表述有多完整。文档列出的标签包括 `exact`、`display_rounded` 和 `likely_rounded`。舍入后的显示值比完整计数提供的细节更少。应将精度标签保留在数值旁，避免后续计算掩盖来源的限制。Chronometrica 精度规范

这里的“精确”指公开显示的计数。它并不证明平台底层记录的准确性。它也不会把公开播放次数变成独立观看人数、观看时长、观众留存率或销量。

报告需要先确定规则，再确定公式。例如：“只有公开点赞数存在且精确，同时公开播放次数存在、精确且大于 0 时，才将视频纳入精确计数比率计算。”存在是指数值没有缺失，也不是 `null`。符合这条规则的记录具备纳入资格。不符合规则的记录仍可保留在来源表中，但应明确注明原因。

0 是已知值，但除以 0 没有定义。应将播放次数为 0 的记录保留在来源表中，并从比率覆盖范围中排除。不要将其比率报告为 0。

将来源数值、可用性和精度放在一起。如果只把数字复制到另一张表，后续读者可能会在不知道来源已舍入的情况下使用它。

虚构示例：3 个视频，只有 1 个比率符合纳入规则

本节的 3 条记录均为虚构的读者数据。它们不是当前运行、产品测试或客户报告的输出。

读者想要计算基于精确计数的公开点赞数与播放次数之比。这个比率表示每 100 次公开播放对应的点赞数。点赞数是分子，即分数线上方的数。播放次数是分母，即分数线下方的数。乘以 100 后得到百分比：

`public like-to-view ratio = public likes / public views × 100`

要让比率符合纳入规则，点赞数必须存在且精确。播放次数必须存在、精确且大于 0。

视频 A 有 100,000 次精确的公开播放和 2,000 个精确的公开点赞。两项计数均符合规则，且播放次数大于 0：

`2,000 / 100,000 × 100 = 2.00%`

视频 A 符合精确计数对比的纳入规则。其结果说明了两项公开计数之间的关系。它并不表示有多少比例的独立观众为视频点了赞。

视频 B 显示的播放次数标签为 100K，另有 2,100 个精确的公开点赞。若用 100,000 计算，结果约为 2.10%。但播放次数输入值经过了舍入。按照已声明的规则，视频 B 应从精确计数集合和比率覆盖范围中排除。读者可以将估算结果放入单独的分组，并明确标记其舍入后的输入值。该估算结果不符合比率的纳入规则。

视频 C 有 300 个公开点赞，但没有公开播放次数。其比率未知。读者不得用 0 替换缺失的播放次数。0 是一个数值；缺失则表示所需数值未知。已知播放次数为 0 时也无法做除法，但原因不同：除以 0 没有定义。

提供的 3 个视频中，只有 1 个符合精确计数规则，包括播放次数大于 0 这一要求：

`1 / 3 × 100 = 33.33% eligible coverage`

合格覆盖率是指提供的记录中，符合报告规则的记录所占比例。它不是采集工具的成功率。视频 B 因播放次数经过舍入而被排除。视频 C 因播放次数缺失而被排除。这些原因应写在对应记录旁。任何播放次数为 0 的记录也应从比率覆盖范围中排除，并单独注明原因。

本示例只支持计算 1 个精确比率。它不足以支持对 A 和 B 的表现进行精确排名。要扩大符合纳入规则的对比范围，读者需要适用的精确计数，其中播放次数必须大于 0。明确标记的估算结果可以单独保留。每条记录都必须应用同一条纳入规则。

使用小规模、可重复的对比方法

1. 确定问题和提供的视频列表

采集前，先写下要比较什么。“提供的视频中，哪些视频的公开点赞数与播放次数之比最高？”是这个方法可以回答的问题。“哪张缩略图促使更多人观看？”则需要不同的证据。

根据问题的要求，尽量保持主题、形式、视频发布后经过的时间和观察时间相近。不要在看到比率后增删视频而不说明原因。若需要帮助来选择视频列表，请参阅 YouTube 参照样本设计指南。本对比方法从选定列表后开始。

2. 明确所需计数和规则

列出计算需要的每项计数。公开点赞数与播放次数之比需要点赞数和播放次数。公开播放总次数对比只需要播放次数。频道订阅人数可以提供背景，但并不意味着它应纳入上述任一公式。

计算前，先说明分子、分母和单位。然后用通俗语言说明纳入规则。对于精确计数比率，要求点赞数存在且精确，同时播放次数存在、精确且大于 0。将存在缺失计数、舍入计数或播放次数为 0 的记录排除在比率覆盖范围之外。

如果估算结果有用，应将其与符合纳入规则的比率结果分开。已知为 0 的播放总次数可以保留在计数对比中，但不能作为比率的分母。在查看哪些记录符合条件之前，先制定这些规则。

3. 按已确定的小规模视频列表采集数据

从提供的视频 URL 开始，以便对照请求采集的列表与返回的记录。保留帖子标识和采集时间。在 Chronometrica 输出中，`postId` 和 `postUrl` 有助于识别视频，`scrapedAt` 则记录采集时间。Chronometrica 输出字段

已知列表也能为覆盖率提供明确的初始总数。审核时应保留这份原始列表以供查阅。不要让返回记录的集合在未作说明的情况下，变成你原本打算采集的范围。

4. 查看全部 3 处结果

Chronometrica 只将 `ok` 记录发送到默认的付费数据集。数据集是存储在一起的一组记录。其他结果会进入单独的不计费结果数据集，使用相同的记录字段。`OUTPUT` 报告 `datasetRows`、`unbilledRows`、各状态的数量和指标覆盖情况。Chronometrica 结果规范

查看全部 3 处结果。将尚未解析成功的输入，与已解析成功但缺少必需指标的记录分开。一次处理运行成功，并不意味着每个输入都生成了符合纳入规则的记录。`ok` 记录也不意味着每项请求的指标都存在或精确。应按照报告规则，检查指标状态字段和必需数值。

5. 对每项必需指标应用规则

对于每条已解析成功的记录，检查公式所用的每项计数。先确认可用性，再检查精度。计算比率时，还要确认精确播放次数大于 0。即使点赞数完整，也不能让经过舍入、缺失或为 0 的播放次数符合纳入规则。

将符合纳入规则的精确计数结果、基于舍入值的估算结果，以及未知结果分开。将播放次数为 0 的比率标记为“未定义”，并将其排除在比率覆盖范围之外。不要把它放入播放次数未知的分组，因为其播放次数是已知的。

排除记录时，应补充简短原因。“播放次数已舍入”“播放次数不可用”和“播放次数为 0；比率未定义”说明的是不同限制。保留原始状态信息，让后续审核者无需重新采集，就能检查你的判断。

6. 以提供的列表为基准报告覆盖率

统计符合完整规则的记录数。对于这个比率，点赞数必须精确且存在，播放次数必须精确、存在且大于 0。用符合纳入规则的记录数除以原始列表中的记录数，再乘以 100。同时报告分数和百分比。

播放次数为 0 的记录仍计入原始列表总数，但不计入符合纳入规则的记录数。计算覆盖率时，对播放次数缺失或经过舍入的记录也采用同样的处理方式，但要分别保留排除原因。

这一步说明原定对比范围还剩多少。如果较大列表中只有 1 个视频符合纳入规则，报告的适用范围就不同于所有视频都符合规则的报告。应在结果旁说明排除情况。不要将该覆盖率称为采集准确性、产品可靠性或成功率。

7. 只计算和描述已声明的衡量指标

对每条纳入的记录使用相同的公式和纳入规则。只有确认播放次数精确、存在且大于 0 后，才能计算符合纳入规则的比率。在结果旁保留来源链接。应让估算结果在显示上保持独立，避免表格排序时，在没有说明的情况下将其混入符合纳入规则的精确计数结果中。

公开计数的差异或比率可以描述观察到的记录。但仅凭这些数据，无法解释为什么某个视频获得了更多关注。标题、缩略图、发布时间、频道规模和其他差异仍可能产生影响。主题相同并不能消除所有这些差异，也不能构成因果实验。

8. 回到来源核查重要结果

当某个结果将影响决策时，应打开公开来源页面。检查视频标识、计数显示和观察时间。公开计数会变化，因此稍后查看的页面可能与已保存的记录不同。

当问题需要观众留存率或观看时长等非公开指标时，应使用你自己的 YouTube Studio 数据。如果将这些指标与同类视频的公开计数并列使用，应清楚注明指标名称。对于无法查看的其他频道非公开指标，不要用公开比率作为替代。

让首次采集便于检查

公开的 YouTube Video Performance Tracker Task 可以作为起点。Task 是保存好的输入预设。

以下输入已按当前公开输入结构核查，但没有实际运行。该 URL 是输入结构示例，并不是已经核查的实时指标结果。请将它替换为一个相关的公开对比视频：

{
  "startUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "maxItems": 1
}

上述字段符合 Chronometrica 输入结构。`maxItems` 是保存记录总数的上限。它并不能证明来源已被完整覆盖。只输入一个视频的直接链接，可以让首次检查集中在你提供的那条记录上。

扩大列表前，先确认你能找到视频标识、采集时间、所需计数及其状态信息。然后检查记录出现在哪个位置，并阅读运行摘要。计算比率时，应确认精确播放次数存在且大于 0。这项小规模检查说明了如何建立对比表，而不预设返回的记录可直接用于所有计算。