如何为 TikTok UGC 协议建立播放量证据回执

公开指标约定与设置

TikTok Metrics scraper 构建版本 0.1.36 接受模式 `auto`、`knownUrls` 和 `profileUrls`。它接受参数 `startUrls`、可选的 `maxItems`、`includeProfileMetrics`、`requestTimeoutSecs`、`maxConcurrency` 和 `failOnNoMetrics`。对于此试点方法，选择 `knownUrls`，使用一个预定的公开视频 URL，并将 `maxItems` 设为 1。不要把主页发现预设当作完整历史的承诺来使用。将 `includeProfileMetrics` 设为 true 会追加尽力获取的当前公开主页事实，而不是关注者身份或私有分析数据。

数据集中的一行代表一次已尝试或已解析的视频结果。在把指标计为有用之前，始终检查行状态和 `statusReason`。此处使用的原生数据集字段为：`inputUrl`、`postUrl`、`postId`、`profileId`、`profileHandle`、`profileUrl`、`publishedAt`、`videoDurationSeconds`、`views`、`likes`、`comments`、`shares`、`saves`、`reposts`、`profileFollowersCount`、`postMetricStatus`、`profileMetricStatus` 和 `scrapedAt`。缺失的指标返回为 `null`，而不是零。指标精度标记包括 `exact`、`display_rounded`、`likely_rounded` 和 `unavailable`。一个精确的公开整数仍然是该平台的公开计数，而不是经过验证的、按人不重复计算的度量。该 Actor 不输出派生比率。

在评估数据集行之前，检查最终运行摘要中的 providedUrls、contentUrls、inputUrls、resolvedUrls、metricRows、noPublicMetricRows、blockedRows、failedRows 和 statusCounts 计数，以确认处理结果。成功的运行摘要中，metricRows 显示已解析数据，即确认计数器已被提取；而出现在 noPublicMetricRows、blockedRows 或 failedRows 中的目标，表明源失败或指标不可用。这些值必须保留为缺失或未知，绝不能按零次播放来计数。

一次单视频对照测试核验了相匹配的帖子 ID 与主页 ID、公开计数器、主页关注者数和精度标记。若干计数为 `likely_rounded`，而收藏和转发为 `exact`。这确认了对公开计数器和身份的支持。它不能证明留存、完播、私有触达、点击、销售、广告欺诈或不重复观看者。

将 Task 预设中的所有示例目标 URL 替换为你已知的那一条公开视频链接。

分步交付回执方法

1. 在检查帖子之前，先记录所有已约定的交付规则。写下预期的创作者用户名、要求的视频内容、帖子身份、截止时间和时区。列出 UGC 合同中承诺的具体指标。不要估算报酬费率，也不要预测未来收入。
2. 对你的视频 URL 运行数据采集程序。将模式设为 `knownUrls`，并将 `maxItems` 设为 1。如果需要主页身份事实，将 `includeProfileMetrics` 设为 true。用你的目标 URL 替换示例 URL。检查 `postId` 和 `profileHandle` 是否与你的记录一致。
3. 人工观看已发布的视频。确认视频展示了正确的产品、创作者、场景和信息。用你的人工复核时间戳记录一条简短的通过或未通过备注。公开播放计数器不能核验视频场景、许可权利或恰当的广告披露。
4. 保存原始播放指标和状态标记。将 `views` 计数与 `postMetricStatus`、`profileMetricStatus` 和 `scrapedAt` 一并检查。当前平台约定将精度报告为 `exact`、`display_rounded`、`likely_rounded` 或 `unavailable`。不要把取整后的数字改成精确计数。不要把点赞、分享或收藏加进播放量。
5. 将实际观察时间与约定的截止时间比较。在截止时间之后取得的播放量快照，不能表明截止当时的计数是多少。将过晚的读数分开保存。不要用编造的每日比率来计算缺失的播放量。
6. 为证据行指定明确的复核状态。仅当身份、人工检查、截止时间和指标精度全部符合合同条款时，才使用 `checked_public_count_for_review`。当检查未通过时，使用 `delivery_gap`、`timing_gap`、`precision_gap`、`source_unavailable` 或 `private_metric_required`。
7. 汇编最终的播放量回执。合并合同引用、目标 URL、人工检查结果、观察时间戳、公开播放量、精度标记和复核状态。将较早与较晚的播放量快照分开保存。
8. 将证据回执提交给你的品牌合作方或复核流程。此回执记录的是公开平台指标。它不开具发票，不处理付款，也不保证投放结果。

虚构回执示例

以下示例使用原创虚构数据，说明不同帖子结果如何对应到复核状态。目标规则要求：对约定帖子，在 10 月 10 日 12:00 UTC 取得精确的公开播放量，并且人工场景检查为通过。

• 候选 V1（虚构）：创作者用户名和产品匹配。人工场景检查通过。于 12:00 UTC 采集的快照显示 40,000 次播放，精度为精确。状态：`checked_public_count_for_review`。
• 候选 V2（虚构）：内容和截止时间匹配。计数器显示 1.2M 次播放，精度为 `likely_rounded`。精确播放量仍然未知。任何一个 1,200,000 的数字都是由展示值推导的估计，而不是经认证的精确计数。状态：`precision_gap`。
• 候选 V3（虚构）：场景检查通过，50,000 次播放的精度为精确。快照取于 12:07 UTC，晚了 7 分钟。状态：`timing_gap`。
• 候选 V4（虚构）：快照取于 12:00 UTC，精确计数为 20,000 次播放。人工检查发现该视频展示了错误的产品。状态：`delivery_gap`。
• 候选 V5（虚构）：由于源错误，抓取程序未返回公开指标。播放量是缺失（null），而不是零。状态：`source_unavailable`。
• 候选 V6（虚构）：合同要求经核验的美国播放量。公开计数器不按观看者所在地拆分。状态：`private_metric_required`。

六行中有一行产生了可供复核的有效公开播放量记录。其余五行标出了需要人工解决的具体缺口。