
Actorは、ホスティング環境で動くデータ収集プログラムです。Taskは、保存済みの入力設定です。Actorがソースからデータ行を収集し、読者が分析を行います。
現行の公開Taskとソース本来の指標の収集を設定する
YouTube Metricsの公開ビルド1.1.2では、既知の動画URLを`startUrls`に指定し、有限の値を`maxItems`に設定できます。保存済みの3本の動画リストを、収集対象として意図した既知の動画の直接URL 1件に置き換え、`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`が示すのは、収集の実行状況と指標の取得可否であり、意味の上で比較可能かどうかではありません。今回の既知の動画2本を使った対照確認では、ソースと一致するID、URL、チャンネルの識別情報、公開日、公開カウント、指標の取得可否が返されました。これが実証するのは、範囲を限定したメタデータとカウントの抽出です。非公開のStudioアナリティクス、重複を除いた視聴者数、視聴時間、視聴者の重複、公開後の同じ経過時点における過去のカウントを実証するものではありません。指定されたShorts形式のURLの1件は、以前に公開された通常の音楽動画を指していました。URLの形式や、未確認の`postType`または`isShort`の値からコンテンツ形式を確定しないでください。必要な形式に該当するかは、実際のソースを手動で確認します。
プラットフォーム間で指標を整合させる8つの手順
- まず、分析で答えたい問いを正確に示します。再生開始回数、重複を除いた人数、特定の観測期間のどれを比較するのかを明記してください。
- 計数単位は何を数えるか、集計粒度は動画、投稿、アカウント、レポートのどれを1単位とするか、測定期間は対象期間または公開後の経過時間の区切り、と定義します。
- 累積は観測時点までに蓄積されたすべてのカウント、比較可能性は明示した同じ問いと意味上のルールを満たすこと、と定義します。
- 各ソース本来の測定値について定義レコードを作成します。プラットフォーム、Actor、ソース本来のフィールド、定義の一次資料URL、確認日、文書化されたバージョン、生の値、精度を含めます。
- 意味が不明なもの、未検証のソースフィールド、未解決の定義は、既知の定義から完全に分けておきます。
- Rを、読者の責任で判定する比較可能性のルールと定義します。比較を意図するすべての組み合わせで、定義、バージョン、計数単位、集計粒度、測定期間、精度、対象範囲が一致することを条件とします。
- 各組み合わせをRに照らして評価し、比較可能、比較不可、未解決の判定と、満たさなかった条件を記録します。異なる問いで成立する関係を連鎖させてグループ化しないでください。
- 元の指標が裏付けていない場合、重複を除いた視聴者数、オーガニックのみの成果、因果関係に基づく優位性、あらゆる指標に共通するエンゲージメント率などの未検証の主張は採用しないでください。
ソース本来の指標の定義レコードを作成する
まず、答えたい問いを正確に示します。例えば、公開後7日目までの公開再生開始イベント数が多いのはどのコンテンツか、という問いと、重複を除いてより多くの人に届いたのはどのプラットフォームか、という問いは異なります。あるカウンターは前者の問いに答えられても、重複を除いた視聴者に関する問いには答えられない場合があります。
各ソース本来の測定値について定義レコードを作成します。プラットフォーム、Actor、ソース本来のフィールド、定義の一次資料への直接URL、確認日、文書化されたバージョン、数えるイベントまたは計数単位、コンテンツ単位かアカウント単位かという集計粒度、累積か固定期間かという集計基準、観測の境界、精度を含めます。また、公開データか所有者向けデータか、有料・オーガニックをどこまで含むかも記録します。加工していないソースの数値を、その定義レコードの横に保持してください。
見慣れた指標名を使う前に、その指標に対応する現行の定義を一次資料で読んでください。YouTubeの現行のエンゲージメント指標ページでは、2026年8月24日から、すべての形式で再生開始時に視聴回数を計上すると説明されています。YouTubeの指標。以前のShortsページには、2025年3月31日にShortsの再生開始とリプレイの計上方法が変更されたことが記載されています。YouTube Shorts。以前の形式間の違いを、現在の長尺動画のルールとして使わないでください。過去の累積カウントがすべて1つの定義で再計算されたとも考えないでください。
Xの現行の英語版ヘルプページは、繰り返しの閲覧を含む投稿の合計表示回数を説明し、そのすべてが重複を除いた閲覧ではないと明記しています。Xの表示回数。これは動画の再生開始を測る指標ではありません。他の言語・地域向けページとは内容が異なる場合があるため、参照した英語版ソースとそのバージョンを正確に保存してください。TikTokの一般公開のviewsフィールドについては、今回の確認では、公開投稿のイベントをカウントするための対応する基準を一次資料で確定できませんでした。その値は、観測されたソース本来のカウンターのままで、意味上の定義は未解決です。Ads Managerの視聴回数の計上基準や、Creator Rewardsの有効視聴回数のルールを流用しないでください。
ルールRで比較可能性を評価する
Rを、明示した定義、バージョン、計数単位、集計粒度、測定期間、精度、対象範囲について、読者の責任で比較可能性を判定するルールと定義します。両方の定義レコードが既知であり、求めるイベントと計数単位について意味が同等である必要があります。文書化されたバージョン同士も比較可能でなければなりません。集計粒度、測定期間、精度、対象範囲は、求める計算に適している必要があります。Rは読者が使う判定ルールであり、Actorが提供する証明ではありません。プラットフォーム名が同じだからといってRを満たすわけではなく、異なるからといってRを満たさないわけでもありません。
各組み合わせを評価し、その問いに対して比較可能、その問いに対して比較不可、定義または対象範囲が未解決のいずれかを、満たさなかった条件とともに記録します。必要な意味が不明なものを、同等の既知の定義として扱うことはできません。比較対象にするすべてのメンバーがルールを満たす場合にのみ、比較を認めるグループを作成してください。異なる問いのもとでそれぞれが3つ目のレコードに似ているという理由だけで、比較不可の2つのレコードを結び付けないでください。
そのグループで認められる比較だけを行ってください。比較可能な公開イベント数の差は、観測されたそれらのイベント数の差です。人数の多さ、オーガニックのみの成果、プラットフォームの優位性を意味するものではありません。公開カウンターには広告による増加分が含まれる場合があります。有料とオーガニックの内訳がなければ、オーガニックのみを対象とする問いには答えられません。
独自に作成した架空の完全な比較可能性マトリックス
この節にある測定値、日付、コンテンツは、すべて独自に作成した架空のものです。問いは、当時の方針(2026年8月24日以降)のもとで、手動確認済みのコンテンツについて、公開後7日が経過した時点の公開動画再生開始回数の累積値を比較することです。オーガニックのみに限定する条件はありません。これらは読者が作成する意味の記録であり、Actorのフィールドではありません。
表1:ソース本来の指標の定義レコード(独自に作成した架空の例)
| 項目ID | プラットフォーム/Actor | ソース本来のフィールドとソースURL | 確認日とバージョン | 計数単位と集計粒度 | 測定期間と境界 | 精度と対象範囲 | カウント値と注記 |
|---|---|---|---|---|---|---|---|
| Y1 | YouTube / Metrics Scraper | `views`(YouTubeの指標) | 2026-10-13/2026年8月24日以降の方針 | 再生開始回数/単一の動画 | 公開後7日経過時点(公開日2026-08-25) | 正確な値/公開データ | 1000 |
| Y2 | YouTube / Metrics Scraper | `views`(YouTubeの指標) | 2026-10-13/2026年8月24日以降の方針 | 再生開始回数/単一の動画 | 公開後7日経過時点(公開日2026-08-26) | 正確な値/公開データ | 800 |
| X1 | X / Post Metrics | `views`(Xヘルプ) | 2026-10-13/現行の英語版 | 投稿の表示回数/単一の投稿 | 比較可能な公開後の経過時間(7日) | 表示値/公開データ | 1000 |
| T1 | TikTok / TikTok Metrics | `views`(定義は未解決) | 2026-10-13/バージョン不明 | 未検証の視聴回数/単一の投稿 | 比較可能な公開後の経過時間(7日) | 不明/公開データ | 1000(意味は未解決) |
| Y3 | YouTube / Metrics Scraper | `views`(YouTubeの指標) | 2026-10-13/変更の前後にまたがる | 再生開始回数/単一の動画 | 累積履歴が定義のバージョン変更の境界をまたぐ | 正確な値/公開データ | 累積履歴が定義のバージョン変更の境界をまたぐ |
| Y4 | YouTube / Metrics Scraper | `views`(YouTubeの指標) | 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日経過時点の公開動画再生開始回数の累積値 | 比較不可(集計粒度が不一致:単一の動画とチャンネル全体の集計) | 別のソースレコードとして扱います。動画の直接URLを使った対照確認の行ではありません。 |
| {Y1, Y5} | 公開後7日経過時点の公開動画再生開始回数の累積値 | 比較不可(計数単位と対象範囲が不一致:再生開始回数と所有者向けのユニーク視聴者数) | 別の所有者向けレポートレコードとして扱います。対象範囲が一致しません。 |
出典と参考資料
著者 Chronometrica · 更新日
ページの先頭へ ↑

