
Actor 是托管的数据采集程序。Task 是已保存的输入预设。Actor 采集源数据行,分析由阅读者完成。
设置当前的公开 Task 与原生采集
YouTube Metrics 公开版本 1.1.2 在 `startUrls` 中接受已知视频 URL,并接受有限的 `maxItems`。把已保存的三条视频列表替换为一条预定的已知直接视频 URL,并将 `maxItems` 设为 1。不要用频道输入来暗示其全部上传历史都可用。
使用如下有效的输入 JSON:
JSON
{"startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"], "maxItems": 1}采集到的数据集字段为 `inputUrl`、`postId`、`postUrl`、`postType`、`isShort`、`publishedAt`、`channelId`、`channelUrl`、`views`、`postMetricStatus`、`status` 和 `scrapedAt`。`postMetricStatus` 是由 `metric`、`value`、`status` 和 `precision` 组成的数组。可用性状态为 present、unavailable 或 not_attempted,它与精度(`exact`、`display_rounded`、`likely_rounded`、`unavailable`、`unknown`)严格分开。公开计数可以是精确值,也可以是指标状态所报告的显示值或取整值;缺失值仍然未知,不得当作零。可选元数据并不保证每个来源都有。
`OUTPUT` 字段——`providedUrls`、`videoUrls`、`channelUrls`、`maxItems`、`resolvedUrls`、`metricRows`、`datasetRows`、`metadataOnlyRows`、`noPublicMetricRows`、`blockedRows`、`failedRows` 和 `statusCounts`——描述的是采集执行情况与指标可用性,而不是语义兼容性。当前这项对照检查使用两条已知视频,返回了相互匹配的源 ID、URL、频道身份、发布日期、公开计数和指标可用性。这证明的是范围有限的元数据与计数提取,而不是私密的 Studio 分析、各计一次的不同观看者、观看时长、受众重叠或历史同龄计数。所提供的一条 Shorts 路径指向一支更早的普通音乐视频;不要根据路径,或未经复核的 `postType` 或 `isShort` 值来认定内容格式;必须对照实际来源人工检查所需格式。
跨平台指标协调的八个步骤
- 先写明确切的分析问题,说明你比较的是播放开始、各计一次的不同的人,还是特定的观察窗口。
- 把单位定义为计数所计的对象,把粒度定义为一支视频、一条帖子、一个账号或一份报告,把窗口定义为时段或龄期边界。
- 把累计定义为截至观察时刻所累积的全部计数,把兼容性定义为满足同一已陈述的问题与语义规则。
- 为每项原生测量建立一条定义记录,包括平台、Actor、原生字段、第一手定义 URL、核对日期、已记录版本、原始值和精度。
- 把未知语义、未核实的源字段和未解决的定义与已知定义完全分开。
- 把 R 定义为由阅读者掌握的兼容性,要求每一对预定配对在定义、版本、单位、粒度、窗口、精度和范围上都匹配。
- 按 R 评估每一对,记录兼容、不兼容或未解决状态以及未通过的条件,避免跨越不同问题做传递性分组。
- 当底层指标不支持时,拒绝未核实的说法,例如各计一次的不同观看者、仅自然流量的表现、因果上的优越性,或通用互动率。
建立原生定义记录
先写明你的确切问题。例如,问哪一项到第 7 天有更多公开的播放开始事件,不同于问哪个平台触达了更多各计一次的不同的人。一个计数器可以支持前一个问题,而不支持关于各计一次受众的问题。
为每项原生测量建立一条定义记录。包括平台、Actor、原生字段、直接的第一手定义 URL、核对日期、已记录版本、被计数的事件或单位、条目或账号粒度、累计或固定窗口的基准、观察边界、精度,以及公开、自有或付费—自然范围。把未经改动的源数字放在其定义记录旁边。
在使用熟悉的标签之前,先阅读当前所对应的第一手定义。YouTube 当前的互动指标页面说,自 2026 年 8 月 24 日起,各格式的观看次数都在播放开始时计数 YouTube Metrics。其较早的 Shorts 页面记录了 2025 年 3 月 31 日 Shorts 开始播放与重播的变更 YouTube Shorts。不要把旧的格式对比当作今天的长视频规则。不要假定所有旧的累计计数都已在同一定义下重建。
X 当前的英文帮助页描述帖子总观看次数(包括重复观看),并说明它们并不都是各计一次的不同观看 X View Counts。这不是视频播放开始度量。保留确切的英文来源与版本,因为其他语言区域的页面可能不同。对于 TikTok 的一般公开观看字段,本次检查没有确立与之匹配的第一手公开帖子事件阈值。其值仍是一个已观察到的原生计数器,语义定义尚未解决。不要借用 Ads Manager 的观看阈值或 Creator Rewards 的合格观看规则。
用规则 R 评估兼容性
把 R 定义为由阅读者掌握的兼容性,针对已陈述的定义、版本、单位、粒度、窗口、精度和范围。两条定义记录对于所要求的事件和单位都必须已知且语义等价。它们已记录的版本必须兼容。它们的粒度、窗口、精度和范围必须支持所要求的计算。R 是阅读者的判定规则,不是 Actor 提供的证明。平台名称相同并不能使 R 为真,平台名称不同也不能使 R 为假。
评估每一对,并记录对该问题兼容、对该问题不兼容,或定义或范围未解决,同时记下未通过的条件。不能把未知的必要语义当作一条相等的已知定义。只有当每一个预定成员都满足该规则时,才形成允许的比较组。不要仅仅因为两条不兼容的记录在不同问题下都像第三条,就把它们连起来。
只做该组所允许的比较。兼容的公开事件计数之差,是这些已观察事件的差。它并不表示更多的人、仅自然流量的表现,或平台优越。公开计数器可以包含广告贡献。缺少付费与自然的拆分,就不能回答仅自然流量的问题。
原创虚构的完整兼容性矩阵
本节中的全部测量、日期和条目都是原创虚构。问题是:在当代政策(2026 年 8 月 24 日之后)下,对人工确认的条目,在龄期 7 天时的公开累计视频播放开始计数,且没有仅自然流量的限制。这些是阅读者创建的含义记录,不是 Actor 字段。
表 1:原生定义记录(原创虚构)
| 条目 ID | 平台 / Actor | 原生字段与来源 URL | 核对日期与版本 | 计数单位与粒度 | 窗口与边界 | 精度与范围 | 计数值与备注 |
|---|---|---|---|---|---|---|---|
| Y1 | YouTube / Metrics Scraper | `views`(YouTube Metrics) | 2026-10-13 / 2026 年 8 月 24 日之后的政策 | 播放开始 / 单支视频 | 龄期 7 天(发布于 2026-08-25) | 精确 / 公开 | 1000 |
| Y2 | YouTube / Metrics Scraper | `views`(YouTube Metrics) | 2026-10-13 / 2026 年 8 月 24 日之后的政策 | 播放开始 / 单支视频 | 龄期 7 天(发布于 2026-08-26) | 精确 / 公开 | 800 |
| X1 | X / Post Metrics | `views`(X Help) | 2026-10-13 / 当前英文 | 帖子观看 / 单条帖子 | 可比较龄期(7 天) | 显示值 / 公开 | 1000 |
| T1 | TikTok / TikTok Metrics | `views`(定义未解决) | 2026-10-13 / 未知版本 | 未核实的观看 / 单条帖子 | 可比较龄期(7 天) | 未知 / 公开 | 1000(语义未解决) |
| Y3 | YouTube / Metrics Scraper | `views`(YouTube Metrics) | 2026-10-13 / 跨越变更 | 播放开始 / 单支视频 | 累计历史跨越定义变更的版本边界 | 精确 / 公开 | 累计历史跨越定义变更的版本边界 |
| Y4 | YouTube / Metrics Scraper | `views`(YouTube Metrics) | 2026-10-13 / 2026 年 8 月 24 日之后的政策 | 播放开始 / 频道合计 | 频道总计粒度 | 精确 / 公开 | 频道合计总计 |
| Y5(报告) | YouTube / Studio(自有) | 各计一次的不同观看者报告 | 2026-10-13 / 自有报告 | 各计一次的不同的人 / 视频报告 | 龄期 7 天窗口 | 精确 / 自有 | 自有的各计一次观看者计数(单独的报告记录) |
表 2:对照规则 R 的配对判定矩阵
| 受测配对 | 已声明的问题与目标 | 兼容性状态与未通过条件 | 操作 / 允许的组备注 |
|---|---|---|---|
| {Y1, Y2} | 龄期 7 天的公开累计视频播放开始 | 兼容(全部条件满足) | 允许的组 `{Y1, Y2}`。差值:200 个已观察的播放开始事件(不是 200 个各计一次的不同的人)。注:若问题改为各计一次的不同的人,则 Y1 与 Y2 都不通过。 |
| {Y1, X1} | 龄期 7 天的公开累计视频播放开始 | 不兼容(单位不匹配:X 帖子观看与视频播放开始) | 保持分开;不要合并或直接比较。 |
| {Y1, T1} | 龄期 7 天的公开累计视频播放开始 | 定义或范围未解决(缺少已核对的公开事件定义) | 不能把未知的必要语义当作已知。 |
| {Y1, Y3} | 龄期 7 天的公开累计视频播放开始 | 版本/历史未解决(累计历史跨越定义变更) | 这是版本历史的不确定性,而不是不兼容。 |
| {Y1, Y4} | 龄期 7 天的公开累计视频播放开始 | 不兼容(粒度不匹配:单支视频与频道合计) | 单独的源记录;不是直接视频对照行。 |
| {Y1, Y5} | 龄期 7 天的公开累计视频播放开始 | 不兼容(单位与范围不匹配:播放开始与自有的各计一次观看者) | 单独的自有报告记录;范围不匹配。 |
来源和延伸阅读
作者 Chronometrica · 更新日期
返回顶部 ↑

