Dimensions

このドキュメントでは、YouTube Reporting API がサポートするディメンションについて説明します。この API は、チャンネルまたはコンテンツ所有者の YouTube アナリティクス データを含む一括レポートを取得します。

ディメンションは、ユーザー アクティビティが発生した日付やユーザーが所在する国など、データを集計するために使用される一般的な条件です。

各一括レポートは、事前定義されたディメンションのリストをサポートしています。レポートでは、各データ行にディメンション値の一意の組み合わせが含まれています。そのため、各行のディメンション値の組み合わせは、その行の主キーとして機能します。レポートに含めるディメンションを指定する必要も、指定するオプションもありません。

主要なディメンション

YouTube Reporting API は 利用規約で定義されている非推奨ポリシーの対象となりますが、コア以外のディメンション（およびコア以外の指標）はポリシーの対象外です。このページの定義では、コア ディメンションであるディメンションはすべて明示的に識別されます。

API のコア ディメンションは次のとおりです。これらはすべて YouTube Analytics API のコア ディメンションでもあります。

詳しくは、非推奨ポリシーが適用される YouTube API のリストをご覧ください。

サイズ

以降のセクションでは、YouTube Reporting API の一括レポートで使用されるディメンションについて説明します。特に記載のない限り、これらのディメンションはチャンネル レポートとコンテンツ所有者レポートの両方で使用されます。

リソース

これらのディメンションは、チャンネルとコンテンツ所有者が YouTube で管理するリソースに対応しています。

video_id （コア ディメンション）
YouTube 動画の ID。YouTube Data API では、これは video リソースの id プロパティの値です。This is a core dimension and is subject to the Deprecation Policy.
playlist_id
YouTube 再生リストの ID。YouTube Data API では、これは playlist リソースの id プロパティの値です。
channel_id （コア ディメンション）
YouTube チャンネルの ID。YouTube Data API では、これは channel リソースの id プロパティの値です。This is a core dimension and is subject to the Deprecation Policy.
asset_id （コンテンツ所有者レポートでのみ使用）
YouTube の Content ID システムで管理されているアセットの ID。アセットは、そのシステムにおける知的財産を表します。YouTube ウェブサイトでは、YouTube コンテンツ マネージャでアセット ID を確認できます。YouTube Content ID API を使用して取得することもできます。

地域

これらのディメンションは、ユーザー アクティビティ、広告のパフォーマンス、推定収益の指標に関連付けられた地域を特定します。

country_code （コア ディメンション）
レポートの行の指標に関連付けられている国。ディメンション値は、US、CN（中国）、FR（フランス）などの 2 文字の ISO-3166-1 国コードです。国コード ZZ は、YouTube が関連する国を特定できなかった指標をレポートするために使用されます。This is a core dimension and is subject to the Deprecation Policy.
province_code
レポートの行の指標に関連付けられている米国の州または海外領土。ディメンション値は、米国の州またはコロンビア特別区を識別する ISO 3166-2 コードです（US-MI（ミシガン州）、US-TX（テキサス州）など）。州コード US-ZZ は、YouTube が関連する米国の州を特定できなかった指標をレポートするために使用されます。

注: 米国の海外領土には独自の ISO 3166-1 国コードもあるため、このディメンションでは、米国の海外領土を識別する ISO 3166-2 値はサポートされていません。また、米国以外の国の地域区分もサポートされていません。

期間

date （コア ディメンション）
このディメンションは、レポートの各行の指標に関連付けられている日付を示します。一括レポートでは、日付は指定された日、月、年の太平洋時間の午前 0 時から午後 11 時 59 分までの期間を指します。太平洋時間は、季節によって UTC-7 または UTC-8 になります。

通常、日付は 24 時間の期間を表しますが、夏時間のために時計が進められた日付は 23 時間の期間を表し、時計が戻された日付は 25 時間の期間を表します。This is a core dimension and is subject to the Deprecation Policy.

再生場所

これらのディメンションでは、ユーザー アクティビティが発生したページやアプリに関する分析情報を確認できます。

playback_location_type
このディメンションは、ユーザー アクティビティが発生したページまたはアプリの種類を識別します。次の表に、ディメンション値を示します。
値
0 このデータは、動画の YouTube 動画再生ページまたは YouTube Android アプリなどの公式 YouTube アプリケーションで行われたアクティビティに関連しています。
1 このデータは、<iframe> または <object> の埋め込みを使用して動画が埋め込まれた別のウェブサイトまたはアプリで発生したアクティビティに関連しています。
2 このデータは、YouTube チャンネル ページで発生したアクティビティに関するものです。
5 データは、他のロケーション タイプに分類できない指標に関連しています。
7 このデータは、YouTube のトップページやホーム画面、ユーザーの [登録チャンネル] フィード、その他の YouTube のブラウジング機能で発生した視聴回数に関連しています。
8 このデータは、YouTube の検索結果ページで直接行われた視聴回数に関するものです。
10 このデータは、YouTube ショート フィードで発生した視聴回数に関するものです。
playback_location_detail
このディメンションは、再生が行われた URL またはアプリを指定します。このディメンションは、埋め込みプレーヤーで発生した視聴でのみサポートされています。つまり、ディメンションの値が 1 の行でのみ、ディメンション値が入力されます。他の行では、このディメンションの値は空になります。

再生の詳細

live_or_on_demand
このディメンションは、データ行のユーザー アクティビティ指標がライブブロードキャストの視聴に関連付けられているかどうかを示します。このディメンションのデータは、2014 年 4 月 1 日以降の日付で利用できます。

次の表に、ディメンションの値を示します。
値
live 行のデータは、ライブ配信中に発生したユーザー アクティビティを表します。
onDemand 行のデータは、ライブ放送中に発生しなかったユーザー アクティビティを表します。
subscribed_status
このディメンションは、データ行のユーザー アクティビティ指標が、動画または再生リストのチャンネルを登録している視聴者に関連付けられているかどうかを示します。有効な値は subscribed と unsubscribed です。

ディメンション値は、ユーザー アクティビティが発生した時点での値です。たとえば、ユーザーがチャンネルに登録せずにそのチャンネルの動画を 1 つ視聴し、その日のうちにチャンネルに登録して別の動画を視聴したとします。チャネルのレポートには、1 つのビューの subscribed_status の値が subscribed で、もう 1 つのビューの subscribed_status の値が unsubscribed であることが示されています。

トラフィック ソース

traffic_source_type
このディメンションは、ユーザー アクティビティ指標に関連付けられているリファラー タイプを識別します。リファラー タイプは、レポートのデータ行に関連付けられている動画またはチャンネルにユーザーがアクセスした方法を示します。次の表に、ディメンション値を示します。
値
0 直接、または不明
この値には、ページへの直接トラフィックと、リファラーが不明なページが含まれます。クエリ レポートでは、このトラフィック ソースタイプは NO_LINK_OTHER または UNKNOWN_MOBILE_OR_DIRECT として識別されます。
1 YouTube 広告
広告から動画にアクセスした視聴者。トラフィック ソース レポートで、このディメンションの値が 1 の場合、traffic_source_detail ディメンションは視聴者に表示された広告の種類を特定します。クエリ レポートでは、このトラフィック ソースタイプは ADVERTISING として識別されます。使用できる値は次のとおりです。
値
ctp_engagement_ad Click-to-play エンゲージメント広告
engagement_ad エンゲージメント促進広告
googlemediaads Google 検索広告
insearch_display TrueView インサーチとインディスプレイ
instream TrueView インストリーム
instream-select 予約済みのスキップ可能なインストリーム
unknown 該当カテゴリのない YouTube 広告
video_wall サムネイル表示
yva トップページ YVA
3 ブラウジング機能
動画やチャンネルにつながる YouTube ページから視聴者がアクセスしました。トラフィック ソース レポートで、このディメンションの値が 3 の場合、traffic_source_detail ディメンションはトラフィックの参照元となった機能を特定します。クエリ レポートでは、このトラフィック ソースタイプは SUBSCRIBER として識別されます。使用できる値は次のとおりです。
値
explore 子ども: 探す
learning 子ども: 学習
music 音楽フィード
my-history 再生履歴
my-subscriptions 登録チャンネル
my-uploads マイ アップロード
podcasts ポッドキャストのリンク先ページ
shows 子供向け: 番組
watch-later 後で見る
what-to-watch あなたへのおすすめ
4 YouTube チャンネル
視聴者が YouTube チャンネル ページからアクセスした。トラフィック ソース レポートで、このディメンションの値が 4 の場合、traffic_source_detail ディメンションはそのチャネルのチャネル ID を指定します。クエリ レポートでは、このトラフィック ソースタイプは YT_CHANNEL として識別されます。
5 YouTube 検索
YouTube 検索結果から視聴者がアクセスしました。トラフィック ソース レポートで、このディメンションの値が 5 の場合、関連付けられた検索語句は traffic_source_detail ディメンションで指定されます。クエリ レポートでは、このトラフィック ソースタイプは YT_SEARCH として識別されます。
7 関連動画
別の動画の再生ページの関連動画リストから視聴者が誘導されました。トラフィック ソース レポートで、このディメンションの値が 7 の場合、traffic_source_detail ディメンションはその動画の動画 ID を識別します。クエリ レポートでは、このトラフィック ソースタイプは RELATED_VIDEO または YT_RELATED として識別されます。
8 その他の YouTube 機能
視聴者が、他のトラフィック ソース タイプに分類されない YouTube ページからアクセスした。トラフィック ソース レポートで、このディメンションの値が 8 の場合、traffic_source_detail ディメンションはページ URL を識別します。クエリ レポートでは、このトラフィック ソースタイプは YT_OTHER_PAGE として識別されます。使用できる値は次のとおりです。
値
g-crec おすすめのチャンネル
offline オフライン
promotion パートナー プロモーション
unknown 不明
widget Android ホーム画面ウィジェット
youtu.be youtu.be
ytremote YouTube リモコン
9 外部
別のウェブサイトのリンクから視聴者がアクセスしました。このトラフィック ソースには、Google 検索結果からのリファラーが含まれます。トラフィック ソース レポートで、このディメンションの値が 9 の場合、traffic_source_detail ディメンションは外部ウェブページを識別します。クエリ レポートでは、このトラフィック ソースタイプは EXT_URL として識別されます。
11 動画カードとアノテーション
別の動画のアノテーションまたはカードをクリックした視聴者が参照した。クエリ レポートでは、このトラフィック ソースタイプは ANNOTATION として識別されます。
14 再生リスト
再生リストの一部として動画が再生されたときの視聴回数。クエリ レポートでは、このトラフィック ソースの種類は PLAYLIST として識別されます。

このトラフィック ソースは、ソースタイプ 18 とは異なります。ソースタイプ 18 は、再生リスト内のすべての動画を一覧表示するページから視聴が発生したことを示します。
17 通知
視聴者が YouTube からのメールまたは通知からアクセスしました。クエリ レポートでは、このトラフィック ソースタイプは NOTIFICATION として識別されます。使用できる値は次のとおりです。
値
inbox
push
sdig チャンネル登録者向けダイジェストに含まれる通知から発生した視聴回数
uploaded_other 動画がアップロードされたときにチャンネル登録者に送信された、メールや受信トレイの通知などのプッシュ通知以外の通知からの視聴回数
uploaded_push 動画がアップロードされたときにチャンネル登録者に送信されたプッシュ通知からの視聴回数
18 再生リスト ページ
再生リスト内のすべての動画が一覧表示されるページから発生した視聴回数。クエリ レポートでは、このトラフィック ソースの種類は YT_PLAYLIST_PAGE として識別されます。

このトラフィック ソースは、ソースタイプ 14 とは異なります。ソースタイプ 14 は、動画が再生リストの一部として再生されているときに視聴が発生したことを示します。
19 申し立てが行われたコンテンツからのプログラミング
コンテンツ所有者が視聴されたコンテンツの宣伝に使用した、申し立てが行われたユーザー アップロード動画から発生した視聴回数。クエリ レポートでは、このトラフィック ソースは CAMPAIGN_CARD として識別されます。このトラフィック ソースは、コンテンツ所有者レポートでのみサポートされています。
20 インタラクティブな動画の終了画面
別の動画の終了画面から発生した視聴回数。クエリ レポートでは、このトラフィック ソースタイプは END_SCREEN として識別されます。
23 ストーリー
ストーリーの視聴画面で前の動画から縦方向にスワイプして視聴者が参照した。
24 ショート動画
ショート動画の視聴画面で前の動画から縦方向にスワイプして視聴者がアクセスした。
25 商品ページ
商品ページの動画から別のチャンネルに視聴者が移動しました。
26 ハッシュタグ ページ
VOD ハッシュタグ ページまたはショート動画ハッシュタグ ピボット ページから発生した視聴回数。
27 サウンドページ
ショート動画のサウンド ピボット ページからの視聴回数。
28 ライブ リダイレクト
ライブ リダイレクトから発生した視聴回数。
29 ポッドキャスト
YouTube ポッドキャスト ページから発生した視聴回数。
30 リミックスされた動画
YouTube ショート プレーヤーのリミックスされた動画のリンクから発生した視聴回数。
31 縦型ライブ配信フィード
縦型ライブ配信フィードから発生した視聴回数。
32 関連動画
YouTube ショート プレーヤーの関連動画リンクから発生した視聴回数。
traffic_source_detail
このディメンションは、行の traffic_source_type ディメンション値のトラフィック ソースに関する追加の詳細を提供します。このディメンション値は、次の traffic_source_type ディメンション値に対して入力されます。
  • 1 - ディメンション値は、視聴者に表示された広告のタイプを示します。有効な値の一覧については、traffic_source_type の定義をご覧ください。
  • 3 - ディメンション値は、参照元トラフィックにつながった YouTube の機能を識別します。有効な値の一覧については、traffic_source_type の定義をご覧ください。
  • 4 - ディメンション値は、視聴者が参照したチャンネル ID を指定します。
  • 5 - ディメンション値は、リファラー トラフィックにつながった検索語句を指定します。
  • 7 - ディメンション値は、視聴者が参照した動画を識別します。
  • 8 - ディメンション値は、参照元トラフィックにつながった YouTube ページのタイプを識別します。有効な値の一覧については、traffic_source_type の定義をご覧ください。
  • 9 - ディメンション値は、トラフィックの参照元となった外部ページを識別します。
  • 17 - ディメンション値は、参照元トラフィックにつながった通知のタイプを識別します。有効な値の一覧については、traffic_source_type の定義をご覧ください。
  • 19 - ディメンション値は、視聴者が参照した動画を識別します。
  • 20 - ディメンション値は、視聴者が参照した動画を識別します。
  • 25 - ディメンション値は、Google ナレッジグラフ ID である商品 ID を識別します。
  • 26 - ディメンション値は、参照トラフィックにつながったハッシュタグを識別します。
  • 27 - ディメンション値は、視聴者が参照した動画を識別します。
  • 28 - ディメンション値は、視聴者がライブ リダイレクト経由で参照したチャンネル ID を指定します。
  • 30 - ディメンション値は、視聴者が参照した動画を指定します。

デバイス

device_type
このディメンションは、視聴が発生したデバイスの物理的なフォーム ファクタを識別します。次の表に、有効なディメンション値を示します。
値
100 不明
101 パソコン
102 テレビ
103 ゲーム機
104 携帯電話
105 タブレット
operating_system
このディメンションは、視聴が発生したデバイスのソフトウェア システムを識別します。次の表に、有効なディメンション値を示します。
値
1 その他
2 Windows
3 Windows Mobile
4 Android
5 iOS
6 Symbian
7 Blackberry
9 Macintosh
10 PlayStation
11 Bada
12 WebOS
13 Linux
14 Hiptop
15 MeeGo
16 Wii
17 Xbox
18 PlayStation Vita
19 スマートテレビ
20 ニンテンドー 3DS
21 Chromecast
22 Tizen
23 Firefox
24 RealMedia
25 KaiOS
26 Roku
27 Nintendo Switch
28 Apple tvOS
29 Fire OS
30 ChromeOS
31 Vidaa
32 VegaOS

ユーザー属性

ユーザー属性ディメンションを使用すると、視聴者の年齢層と性別の分布を把握できます。YouTube ヘルプセンターには、YouTube Analytics レポートのユーザー属性データに関する詳細情報が記載されています。

age_group （コア ディメンション）
このディメンションは、レポートデータに関連付けられているログイン ユーザーの年齢層を識別します。API では次の年齢グループが使用されます。
  • AGE_13_17
  • AGE_18_24
  • AGE_25_34
  • AGE_35_44
  • AGE_45_54
  • AGE_55_64
  • AGE_65_
This is a core dimension and is subject to the Deprecation Policy.
gender （コア ディメンション）
このディメンションは、レポートデータに関連付けられているログイン ユーザーの性別を識別します。有効な値は FEMALE、MALE、GENDER_OTHER です。This is a core dimension and is subject to the Deprecation Policy.

エンゲージメントとコンテンツの共有

sharing_service （コア ディメンション）
このディメンションは、動画の共有に使用されたサービスを識別します。YouTube（または YouTube プレーヤー）で [共有] ボタンを使用して、動画を共有することができます。This is a core dimension and is subject to the Deprecation Policy.

次の表に、有効なディメンション値を示します。
値
0 不明
1 Digg
4 Google.com
5 StumbleUpon
6 mixi
7 Yahoo! 日本
8 goo
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti
20 menéame
21 Wykop
22 Skyrock
25 Fotka
28 hi5
31 Twitter
32 Cyworld
34 Blogger
36 VKontakte（ВКонтакте）
37 楽天（楽天市場）
38 LiveJournal
39 Odnoklassniki（Одноклассники）
40 tumblr.
42 LinkedIn
43 Google+
44 Weibo
45 Pinterest
46 メール
47 Facebook Messenger
49 WhatsApp
50 ハングアウト
51 Gmail
52 Kakao（Kakao Talk）
53 その他
55 クリップボードにコピー
59 定着
60 テキスト メッセージ
61 Android メッセージ
62 Verizon メッセージ
63 HTC のテキスト メッセージ
64 Sony Conversations
65 Go SMS
66 LGE メール
67 線
68 Viber
69 Kik
70 Skype
71 Blackberry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 Facebook ページ
77 GroupMe
78 Android メール
79 Motorola Messaging
80 ニアバイシェア
81 Naver
82 iOS システム アクティビティ ダイアログ
83 Google Inbox
84 Android Messenger
85 YouTube Music
86 YouTube Gaming
87 YouTube Kids
88 YouTube TV

詳細については、ヘルプ ドキュメントをご覧ください。

アノテーション

annotation_type
このディメンションは、動画の再生中にアノテーションが表示される方法を識別します。次の表に、ディメンションの可能な値を示します。
値
0 不明
1 注
3 スポットライト
4 タイトル
8 吹き出し
9 ラベル
10 画像・ロゴの透かし
11 おすすめ動画
12 おすすめの再生リスト
30 Call-to-Action
さまざまな種類のアノテーションと、動画にアノテーションを追加する手順について詳しくは、YouTube ヘルプセンターをご覧ください。
annotation_id
YouTube がアノテーションを一意に識別するために使用する ID。

カード

card_type
このディメンションは、ユーザーに表示されたカードの種類を特定します。次の表に、ディメンションの可能な値を示します。
値
0 不明
60 リンク
61 資金調達
62 動画
63 再生リスト
65 視聴者ファンディング
66 グッズ紹介
68 関連付けられているウェブサイト
69 チャンネル
さまざまな種類のカードと、動画にカードを追加する手順について詳しくは、YouTube ヘルプセンターをご覧ください。
card_id
YouTube がカードを一意に識別するために使用する ID。

終了画面

end_screen_element_type
このディメンションは、ユーザーに表示された終了画面要素のタイプを識別します。次の表に、終了画面要素のタイプとその値を示します。
値
501 動画 - 別の YouTube 動画を宣伝する要素です。
502 プレイリスト - YouTube のプレイリストを宣伝する要素。
503 ウェブサイト - 関連付けられたウェブサイトにリンクします。
504 Channel - 要素は別のチャンネルにリンクします。
505 チャンネル登録 - チャンネル登録を促す要素です。
506 関連付け
507 クラウドファンディング - 承認済みのクラウドファンディング ウェブサイトにリンクします。
508 グッズ - 承認済みの販売者ウェブサイトにリンクする要素。
509 最近のアップロード - 要素は、チャンネルの最新のアップロード動画にリンクします。
510 視聴者に適したコンテンツ
end_screen_element_id
YouTube がエンドスクリーン要素を一意に識別するために使用する ID。

字幕

subtitle_language
このディメンションは、視聴中に最も長く使用されたクローズド キャプションの言語を特定します。字幕がほとんどオフになっている視聴回数はカウントされません。このディメンションを含むレポートについて詳しくは、チャンネル レポートまたはコンテンツ所有者レポートのドキュメントをご覧ください。
subtitle_language_autotranslated
このディメンションは、視聴中に最も長く使用された自動翻訳のクローズド キャプションの言語を特定します。字幕がほとんどオフになっている視聴回数はカウントされません。このディメンションを含むレポートについて詳しくは、チャンネル レポートまたはコンテンツ所有者レポートのドキュメントをご覧ください。

広告の掲載結果

ad_type
ad_type ディメンションは広告のパフォーマンス レポートで使用され、動画の再生中に実行された広告のタイプに基づいてリクエストされた指標を集計します。次の表に、使用可能なディメンション値を示します。YouTube の広告フォーマットについて詳しくは、YouTube ヘルプセンターをご覧ください。
値 説明 クエリレポートの値
1 スキップ可能な動画広告（オークション） auctionTrueviewInstream
2 ディスプレイ広告（オークション） auctionDisplay
3 スキップ不可の動画広告（オークション） auctionInstream
5 ディスプレイ広告（純広告） reservedDisplay
6 スキップ不可の動画広告（純広告） reservedInstream
13 不明 unknown
15 スキップ可能な動画広告（純広告） reservedInstreamSelect
19 バンパー広告（オークション） auctionBumperInstream
20 バンパー広告（純広告） reservedBumperInstream

注: クエリ レポートには、YouTube で以前に使用されていた一部の追加の広告タイプの結果が返される場合があります。

コンテンツ所有者ディメンション

次のディメンションは、コンテンツ所有者のレポートでのみ使用されます。

claimed_status （コンテンツ所有者レポートでのみ使用）
このディメンションは、データ行に申し立てられたコンテンツの指標のみが含まれていることを示します。このディメンションで有効な値は claimed のみです。uploader_type ディメンションの定義の表には、このディメンションの使用方法の詳細が記載されています。
uploader_type （コア ディメンション） （コンテンツ所有者レポートでのみ使用）
このディメンションは、指定されたコンテンツ所有者がアップロードしたコンテンツと、ユーザーがアップロードした動画などの第三者がアップロードしたコンテンツの指標がデータ行に含まれているかどうかを示します。有効な値は self と thirdParty です。これはコア ディメンションであり、非推奨ポリシーの対象となります。

次の表に、claimed_status ディメンションと uploader_type ディメンションでサポートされている組み合わせを示します。

claimed_status 値 uploader_type 値 説明
[未設定] self この行には、コンテンツ所有者がアップロードした申し立て済みコンテンツと申し立てなしコンテンツの YouTube アナリティクス データが含まれます。
申し立て済み self この行には、コンテンツ所有者がアップロードした申し立てを受けたコンテンツのデータが含まれます。
申し立て済み thirdParty この行には、第三者によってアップロードされた申し立て済みのコンテンツのデータが含まれます。