Actor 是託管的數據收集程式。任務是已儲存的輸入預設設定。首次使用 YouTube Metrics build 1.1.2 工具直接檢查影片時，請將 `startUrls` 中整份預設的 3 部影片範例清單，替換為你打算檢查的單一已知影片網址，並將 `maxItems` 設為 1。不要使用整個頻道作為輸入，因為這會不當地暗示可以取得完整的上載紀錄。
原生輸出欄位包括 `inputUrl`、`postId`、`postUrl`、`postType`、`isShort`、`publishedAt`、`channelId`、`channelUrl`、`views`、`postMetricStatus`、`status` 及 `scrapedAt`。`postMetricStatus` 欄位的原生格式是物件陣列，每個物件包含 `metric`、`value`、`status` 及 `precision` 屬性，而不是以物件作為對應表；數值是否可取得與其精確程度仍須分開處理，缺失值仍然是未知，而不是零。
`OUTPUT` 的收集摘要包括 `providedUrls`、`videoUrls`、`inputUrls`、`resolvedUrls`、`metricRows`、`datasetRows`、`noPublicMetricRows`、`blockedRows`、`failedRows` 及 `statusCounts`。實際已檢查的對照執行使用了 2 個已知輸入，傳回的 `resolvedUrls` 為 2、`metricRows` 為 2、`datasetRows` 為 2，`statusCounts` 為 `{"ok": 2}`，而 `blockedRows`、`failedRows` 及 `noPublicMetricRows` 均為零。這證明可以擷取這些輸入的公開中繼資料及目前計數，但不保證每次檢查都會傳回 2 列，也不代表可以取得 Studio 的私人分析數據、不重複觀眾人數、觀看時長、觀眾重疊情況，或影片發佈後相同時間點的歷史計數。此外，透過 `/shorts/` 路徑存取的較舊影片，實際上可能是標準長片；路徑名稱或未經覆核的原生標記，都不能證明內容的實際形式。
界定你的參照母體
- 收集數字前，先界定參照母體：在收集表現指標前，清楚說明你打算比較哪一組影片，以免產生選擇偏差。
- 選定明確的分析單位及結果指標：將個別影片的累計觀看次數與頻道層面的總數分開處理。公開數據快照不會顯示非公開的曝光次數、觀看時間或流量來源。選擇範圍較窄、可以觀察的問題，例如比較發佈後經過時間在指定範圍內的某一類影片。
- 預先列明配對因素及納入規則：查看計數前，先寫下有關題材、經人手核實的影片形式、上載後經過時間範圍、觀察界限，以及頻道自述發展階段的規則。訂閱人數及頻道建立日期，不能證明創作者的經驗相若。
- 根據已核實的公開證據收集候選影片：使用已知的直接網址建立候選清單。有日期的公開聲明如提及開始製作某個系列，只能支持 `claimed_stage` 因素，不能證明已核實的經驗。如果某項必要因素缺乏證據，請將候選影片標記為 `unresolved_factor_evidence`，不要將其歸入某個類別。
- 收集原生觀察數據，並保留其精確程度：保留 `postId`、`channelId`、發佈日期、觀察時間、觀看次數及精確程度狀態。如果 `publishedAt` 只有日期標籤，不要將其轉換為精確的時間戳記。目前的累計計數不能還原發佈後第 7 天的歷史觀看次數。
- 建立配對及支持證據表：以你的目標影片為基準評估候選影片。將狀態記錄為 `eligible`、`excluded_factor_mismatch` 或 `unresolved_factor_evidence`，並明確註明任何不符合的因素。看到候選影片的觀看次數後，不要放寬配對規則，除非另行記錄新的設計及其理由。
- 決定比較時機：判斷能否立即比較、在發佈後經過時間大致相若的範圍內比較，或等候日後按計劃擷取數據後再比較。不要將歷來累計觀看次數除以發佈後的總時間，來補算缺失的第 7 天歷史觀看次數。如果沒有符合配對條件的比較組別，請報告無法比較的結果。
- 列出有支持證據及沒有支持證據的比較組別：呈現已界定的參照母體、規則、證據，以及有證據支持的比較組別。少量選定的同類影片只構成範圍有限的參照組，不能作為業界正常表現的基準。不要套用中位數或離群值公式、製作贊助商媒體資料套件，或預測頻道的成功率。
以下配對紀錄及表格均為原創虛構內容，用以示範評估流程。對於 `publishedAt` 只有日期的候選影片（目標影片 F1、候選影片 B、候選影片 C 及候選影片 D），本教學範例中精確的發佈後經過時間，來自假設的精確虛構時間戳記，並非將原生的純日期標籤轉換為已核實的小時數。根據 YouTube 官方文件，適用於所有影片形式、以開始播放計算觀看次數的定義於 2026 年 8 月 24 日生效；比較觀看次數時，請留意這個版本分界。
主要比較表（目標影片 F1）
| 候選影片 | 題材／主題 | 經人手核實的形式 | 發佈及觀察時間 | 假設的發佈後經過時間 | 附有日期的自述發展階段證據 | 規則判定狀態 | 原因 |
|---|---|---|---|---|---|---|---|
| 目標影片 F1 | 懸疑遊戲 | 長片 | 發佈：2026-10-01<br>觀察：2026-10-08 | 7 天 | 2026-10-01 的帖文：「開始製作我的首個懸疑系列」 | 目標 | 作為比較目標的單位 |
| 候選影片 B | 懸疑遊戲 | 長片 | 發佈：2026-10-02<br>觀察：2026-10-09 | 7 天 | 2026-10-02 的帖文：「我的新懸疑頻道第 1 集」 | 符合資格 | 符合所有已列明的規則（`claimed_stage`） |
| 候選影片 C | 懸疑遊戲 | 長片 | 發佈：2024-10-08<br>觀察：2026-10-08 | 730 天 | 個人檔案簡介：「自 2024 年起製作遊戲影片」 | 已排除 | 發佈後經過時間不符（730 天，相對於 7 天） |
| 候選影片 D | 懸疑遊戲 | 短片 | 發佈：2026-10-01<br>觀察：2026-10-08 | 7 天 | 2026-10-01 的帖文：「新頻道啟動短片」 | 已排除 | 形式不符（短片，相對於長片） |
| 候選影片 E | 懸疑遊戲 | 長片 | 發佈：2026-10-08T01:00Z<br>觀察：2026-10-08T13:00Z | 12 小時 | 影片開場：「歡迎來到我的全新頻道」 | 已排除 | 發佈後經過時間不符（12 小時，相對於 7 天） |
| 候選影片 F | 懸疑遊戲 | 長片 | 發佈：只有日期標籤<br>觀察：2026-10-08 | 未知 | 未找到關於發展階段的公開聲明 | 未確定 | 缺乏精確發佈時間及發展階段證據 |
次要比較紀錄
- 目標形式 F2（發佈後第 14 天的懸疑遊戲短片）：按這個比較組別專屬的規則評估，要求影片是懸疑遊戲短片，並處於上載後第 14 天的時間界限。候選影片 D 的形式、題材及發展階段均相符，但不符合 F2 的發佈後經過時間界限（7 天，相對於規定的 14 天）。候選影片 B、C、E 及 F 不符合形式或發佈後經過時間的條件。結果：所提供的候選影片中，沒有符合資格的參照影片；報告為無法比較的組別（沒有證據支持的基準）。
- 計劃擷取紀錄：候選影片 E 已安排於日後的 2026-10-15T01:00Z 進行觀察，以符合 F1 的發佈後 7 天規則。狀態：`planned_capture`（與 `observed_reference` 嚴格分開；無法事後重建過去第 7 天的觀看次數）。
來源與延伸閱讀
作者 Chronometrica · 更新日期
返回頂端 ↑
