Dimensions

このドキュメントでは、YouTube Analytics API でサポートされているディメンションを定義します。この API は、リアルタイムのターゲット クエリに対応し、カスタムの YouTube アナリティクス レポートを生成できます。

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

各クエリレポートは、サポートするディメンションを識別します。たとえば、ユーザー アクティビティを時間別に取得する場合は、データが報告される期間（日または月）を選択します。どのレポートでも、各データ行にはディメンション値の一意の組み合わせがあります。

クエリレポートを取得するには、YouTube Analytics API の reports.query メソッドを呼び出します。リクエストで dimensions パラメータを使用して、レポートの計算指標値を計算するために YouTube が使用するディメンションを指定します。

主要なディメンション

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

次のリストは、API のコア ディメンションを示しています。

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

フィルタ

すべてのクエリレポートでフィルタがサポートされています。フィルタは、取得されたデータセットに存在する必要があるディメンション値を識別します。そのため、API レスポンスを、特定の値または値のセットに一致するデータのみを含むように制限します。たとえば、すべての国のユーザー アクティビティ指標を取得する代わりに、フィルタを使用して特定の国のデータのみを取得できます。

クエリレポートを取得するリクエストでは、オプションの filters リクエスト パラメータで、データをフィルタするディメンション値を指定します。たとえば、ヨーロッパのユーザー アクティビティ指標を取得するには、filters パラメータ値を continent==150 に設定します。

重要: コンテンツ所有者レポートを取得する API リクエストでは、レポート エンティティ ディメンションのいずれかを使用するか、claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせを使用して、データをフィルタする必要があります。

サイズ

以下のセクションでは、YouTube Analytics API のクエリ レポートで使用されるディメンションを定義します。特に明記されていない限り、これらのディメンションはチャンネル レポートとコンテンツ所有者レポートの両方で使用されます。フィルタとしてのみ使用できるディメンションも識別されます。

リソース

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

注: API では、video、playlist、channel ディメンションをフィルタとして使用する場合、複数の値を指定できます。これを行うには、filters パラメータ値を、API レスポンスをフィルタする動画、再生リスト、チャンネル ID のカンマ区切りのリストに設定します。パラメータ値には最大 500 個の ID を指定できます。

video （コア ディメンション）
YouTube 動画の ID。YouTube Data API では、これは video リソースの id プロパティの値です。This is a core dimension and is subject to the Deprecation Policy.
playlist
YouTube 再生リストの ID。YouTube Data API では、これは playlist リソースの id プロパティの値です。
channel （主要なディメンション）（コンテンツ所有者レポートでのみ使用）
YouTube チャンネルの ID。YouTube Data API では、これは channel リソースの id プロパティの値です。This is a core dimension and is subject to the Deprecation Policy.

channel ディメンションは、コンテンツ所有者レポートでよく使用されます。これは、これらのレポートが通常、複数のチャンネルのデータを集計するためです。
group （フィルタのみ）
YouTube アナリティクス グループの ID。この値は、YouTube Analytics API の groups.list メソッドを使用して取得できます。group フィルタを使用すると、API レスポンスには、そのグループ内のすべての動画、再生リスト、チャンネルのデータが含まれます。

例

次のサンプル リクエストでは、レポート エンティティのディメンションまたはフィルタを使用しています。

  • チャンネルの例

    • 基本的なデータ
      • トップ 10 – チャンネル内で最も視聴された動画
      • 上位 10 件 - チャンネルで最も視聴された動画のアノテーションのクリック率
      • 特定の再生リストの統計情報
      • 上位 10 件 - チャンネルで最も視聴された再生リスト
    • 地域
      • トップ 10 – 特定の国における再生回数が多い動画
      • トップ 10 - ヨーロッパで最も視聴された動画

  • コンテンツ所有者の例

    • 基本的なデータ
      • 上位 10 件 - コンテンツ所有者の最も視聴された動画
      • 上位 10 件 - コンテンツ所有者の最も視聴された動画
      • 上位 10 件 - コンテンツ所有者のチャンネルで最も視聴された動画
      • 上位 10 件 - チャンネルで最も視聴された動画のアノテーションのクリック率
      • 上位 10 件 - コンテンツ所有者の最も視聴された再生リスト
    • 地域
      • 上位 10 件 - ヨーロッパで最も視聴されたコンテンツ所有者の動画
      • 上位 10 件 - 米国で最も再生されたプレイリスト

地理的エリア

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

country（コア ディメンション）
レポートの行の指標に関連付けられている国。ディメンション値は、US、CN（中国）、FR（フランス）などの 2 文字の ISO-3166-1 国コードです。国コード ZZ は、YouTube が関連する国を特定できなかったレポート指標をレポートするために使用されます。This is a core dimension and is subject to the Deprecation Policy.
province
レポート行の指標に関連付けられた米国の州または準州。ディメンション値は、米国の州またはコロンビア特別区を識別する ISO 3166-2 コード（US-MI（ミシガン州）や US-TX（テキサス州）など）です。州コード US-ZZ は、YouTube が関連する米国の州を特定できなかったレポート指標をレポートするために使用されます。API リクエストの dimensions パラメータ値に province が含まれている場合、リクエストの filters パラメータ値に country==US を含めて、データを米国に制限する必要があります。

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

dma
データ行に記載されている視聴イベントに関連付けられた指定マーケット エリア（DMA）を識別するために Nielsen が使用する 3 桁の識別子。
city
レポートの行の指標に関連付けられている推定都市。このディメンションのデータは、2022 年 1 月 1 日以降の期間について使用できます。
continent （フィルタのみ）
国連（UN）の統計地域コード。この API では、次の値がサポートされています。
値 説明
002 アフリカ
019 南北アメリカ（北米、ラテンアメリカ、南米、カリブ海地域）
142 アジア
150 ヨーロッパ
009 オセアニア
このディメンションは、データのフィルタリングにのみ使用できます。このディメンションを使用するには、filters パラメータの値を continent==REGION_CODE に設定し、表の REGION_CODE 値を指定します。
subContinent （フィルタのみ）
地理的サブリージョンを識別する国連統計リージョン コード。国連統計部には、サブリージョンと、各リージョンに関連付けられている国が記載されています。

このディメンションは、データのフィルタリングにのみ使用できます。このディメンションを使用するには、filters パラメータの値を subContinent==REGION_CODE に設定し、UN リストから REGION_CODE 値を指定します。

例

次のサンプル リクエストでは、地理ディメンションまたはフィルタを使用しています。

  • チャンネルの例

    • 基本統計情報: チャンネルの国別の視聴回数など
    • 地域
      • チャンネルの動画の国別再生時間の指標
      • チャンネルの動画のアノテーションに関する国別の指標
      • 米国の州とワシントン D.C. の州固有の指標
      • チャンネルの再生リストの国別の総再生時間の指標
      • 上位 10 件 - 米国で最も再生されたプレイリスト
    • 再生場所: さまざまな再生場所での 1 日あたりの視聴回数と総再生時間
    • トラフィック ソース: 国別のさまざまなトラフィック ソースからの視聴回数と総再生時間
    • ユーザー属性: カリフォルニア州の視聴者のユーザー属性（年齢層と性別）
    • 上位の動画
      • トップ 10 – 特定の国における再生回数が多い動画
      • トップ 10 - ヨーロッパで最も視聴された動画

  • コンテンツ所有者の例

    • 基本データ: 自分でアップロードしたすべての動画の国別の視聴回数（など）
    • 地域
      • 自身がアップロードしたコンテンツの国別再生時間の指標
      • 自身がアップロードしたコンテンツのアノテーションに関する国別の指標
      • 米国の州とワシントン D.C. の州固有の指標
      • コンテンツ所有者の再生リストの国別の総再生時間指標
      • 上位 10 件 - 米国で最も再生されたプレイリスト
    • 再生場所: さまざまな再生場所での 1 日あたりの視聴回数と総再生時間
    • ユーザー属性: カリフォルニア州の視聴者のユーザー属性（年齢層と性別）
    • 人気の動画: 上位 10 件 - ヨーロッパで最も視聴されたコンテンツ所有者の動画
    • 収益 / 広告のパフォーマンス: 国別の収益と広告のパフォーマンス指標

期間

これらのディメンションは、レポートで日、週、月などの期間に基づいてデータを集計する必要があることを示します。startDate と endDate のリクエスト パラメータは、レポートに含めるデータの期間を指定します。なお、レポートでは、クエリの実行時にリクエストで指定されたすべての指標が利用可能な最終日までのデータが返されます。レポートでは、日付は YYYY-MM-DD 形式で表示されます。

重要: すべての日付は、指定された日の午前 12 時（太平洋時間、UTC-7 または UTC-8）から午後 11 時 59 分（太平洋時間）までの期間を指します。

月ディメンションは、指定した年月の 1 日の午前 12 時（太平洋時間、UTC-7 または UTC-8）に始まる期間を指します。

day （主要なディメンション）
このディメンションを使用すると、レポートのデータは日単位で集計され、各行には 1 日分のデータが含まれます。他のディメンションを使用して、データをさらに細かく分類することもできます。たとえば、トラフィック ソース レポートでは、ユーザーが動画にアクセスした方法に基づいて、1 日あたりの視聴統計を集計できます。This is a core dimension and is subject to the Deprecation Policy.
month （主要なディメンション）
レポートのデータは暦月ごとに集計されます。日次レポートと同様、他のフィルタを使用してデータをさらに細かく分類することができます。レポートでは、日付は YYYY-MM 形式で表示されます。

注: API クエリで month ディメンションを使用する場合は、start-date パラメータと end-date パラメータの両方を月の初日に設定する必要があります。This is a core dimension and is subject to the Deprecation Policy.

例

次のサンプル リクエストでは、時間ディメンションまたはフィルタを使用しています。

  • チャンネルの例

    • 時間ベース
      • チャンネルの動画の日別再生時間の指標
      • チャンネルの動画のアノテーションに関する日別の指標
      • チャンネルの 1 日あたりの再生リストの視聴回数
    • 再生場所: さまざまな再生場所での 1 日あたりの視聴回数と総再生時間
    • トラフィック ソース: さまざまなトラフィック ソースからの 1 日あたりの視聴回数と総再生時間
    • デバイス / OS
      • Android オペレーティング システムの端末のタイプに関する日別の指標
      • 携帯端末のオペレーティング システムに関する日別の指標
      • オペレーティング システムと端末のタイプに関する日別の指標

  • コンテンツ所有者の例

    • 時間ベース
      • 自身がアップロードしたコンテンツの日別再生時間の指標
      • 申し立てが行われたコンテンツのアノテーションに関する指標
      • コンテンツ所有者の 1 日あたりの再生リストの視聴回数
    • 再生場所: さまざまな再生場所での 1 日あたりの視聴回数と総再生時間
    • トラフィック ソース: さまざまなトラフィック ソースからの 1 日あたりの視聴回数と総再生時間
    • デバイス / OS
      • 申し立てが行われた動画の端末のタイプに関する日別の指標
      • 申し立てが行われた動画が携帯端末で再生されたときのオペレーティング システムに関する日別の指標
      • オペレーティング システムと端末のタイプに関する日別の指標
    • 収益 / 広告のパフォーマンス: 1 日あたりの収益と広告のパフォーマンス指標

再生場所

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

insightPlaybackLocationType
レポートのデータは、動画が再生されたページまたはアプリケーションの種類に基づいて集計されます。このディメンションに指定できる値は次のとおりです。

  • BROWSE - YouTube のホームページやホーム画面、ユーザーの登録チャンネル フィード、その他の YouTube ブラウジング機能で発生した視聴に関するデータ。

  • CHANNEL - チャンネル ページで発生した視聴に関するデータ。

  • EMBEDDED - <iframe> または <object> の埋め込みを使用して動画が埋め込まれた別のウェブサイトまたはアプリケーションで発生した視聴に関するデータ。

  • EXTERNAL_APP - <iframe> または <object> の埋め込み以外の方法で動画が再生されたサードパーティ アプリケーションで発生した視聴回数。たとえば、YouTube Android Player API を使用するアプリでの再生は、この値を使用して分類されます。

  • IMMERSIVE_LIVE_FEED - 縦型ライブ配信フィードで発生した視聴回数を示すデータ。

  • MOBILE - YouTube のモバイルサイト、または承認済みの YouTube API クライアント（モバイル デバイスを含む）で発生した視聴に関するデータ。

    2013 年 9 月 10 日以降、YouTube アナリティクスのレポートでは、再生回数が MOBILE 再生回数として分類されなくなりました。以前のデータがそのカテゴリに該当するため、レポートに値が残る場合があります。ただし、それ以降は、モバイルでの再生は、再生が発生したアプリの種類に応じて、WATCH、EMBEDDED、EXTERNAL_APP のいずれかに分類されます。

  • SEARCH - YouTube の検索結果ページで直接視聴された回数を示すデータです。

  • SHORTS_FEED - YouTube ショート フィードで発生した視聴回数を示すデータ。

  • WATCH - 動画の YouTube 動画再生ページまたは公式 YouTube アプリ（YouTube Android アプリなど）で発生した視聴に関するデータ。

  • YT_OTHER - 他に分類されていないビューを記述するデータ。

insightPlaybackLocationDetail
データは、プレーヤーが配置されているページに基づいて集計されます。このレポートは埋め込みプレーヤーで発生した再生回数のみに対応しており、指定した動画が最も多く再生された埋め込みプレーヤーを識別します。このため、上位の埋め込みプレーヤーに関連付けられた URL またはアプリケーションを識別することにより、再生場所レポートよりもきめ細かいビューが提供されます。

例

以下のサンプル リクエストでは、再生場所ディメンションを使用しています。

  • チャンネルの例

    • 再生場所
      • 各再生場所における再生回数と再生時間
      • さまざまな再生場所での 1 日あたりの視聴回数と総再生時間
      • トップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
      • さまざまな再生場所での再生リストの視聴回数と総再生時間
      • さまざまな再生場所での再生リストの日別の視聴回数と総再生時間

  • コンテンツ所有者の例

    • 再生場所
      • 各再生場所における再生回数と再生時間
      • さまざまな再生場所での 1 日あたりの視聴回数と総再生時間
      • トップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
      • さまざまな再生場所での再生リストの視聴回数と総再生時間
      • さまざまな再生場所での再生リストの日別の視聴回数と総再生時間

再生の詳細

creatorContentType
このディメンションは、データ行のユーザー アクティビティ指標に関連付けられたコンテンツのタイプを示します。このディメンションのデータは、2019 年 1 月 1 日以降の日付で利用できます。

次の表に、ディメンションの値を示します。
値 説明
LIVE_STREAM 視聴されたコンテンツが YouTube のライブ配信だった。
SHORTS 視聴されたコンテンツが YouTube ショートである。
STORY 視聴されたコンテンツが YouTube ストーリーだった。
VIDEO_ON_DEMAND 視聴されたコンテンツが、他のディメンション値のいずれにも該当しない YouTube 動画であった。
UNSPECIFIED 閲覧されたコンテンツのコンテンツ タイプが不明です。
liveOrOnDemand
このディメンションは、データ行のユーザー アクティビティ指標がライブ配信の視聴に関連付けられているかどうかを示します。このディメンションのデータは、2014 年 4 月 1 日以降の期間で利用できます。

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

ディメンションの値は、ユーザーのアクションが発生した時点の正確な値です。たとえば、あるユーザーがチャンネルに登録せずにそのチャンネルの動画を視聴し、その後、同日にチャンネルに登録して別の動画を視聴したとします。チャンネルのレポートには、1 つのビューの subscribedStatus 値が SUBSCRIBED で、1 つのビューの subscribedStatus 値が UNSUBSCRIBED であることが示されています。
youtubeProduct
このディメンションは、ユーザー アクティビティが発生した YouTube サービスを識別します。このディメンションのデータは、2015 年 7 月 18 日以降のものが対象となります。

次の表に、ディメンションの値を示します。
値 説明
CORE YouTube の専門アプリ（YouTube Gaming、YouTube Kids、YouTube Music）以外で行われたユーザー アクティビティ。例外: 2021 年 3 月 1 日より前に YouTube Music で発生したユーザー アクティビティは CORE に含まれます。
GAMING ユーザー アクティビティが YouTube Gaming で発生した。
KIDS ユーザー アクティビティが YouTube Kids で発生した。
MUSIC ユーザー アクティビティが 2021 年 3 月 1 日以降に YouTube Music で発生した。2021 年 3 月 1 日より前のデータは CORE に含まれています。リアルタイム データは記録されません。
UNKNOWN ユーザー アクティビティが 2015 年 7 月 18 日より前に発生した。

トラフィック ソース

insightTrafficSourceType
レポートのデータは、ユーザーが動画にアクセスした方法を示す参照元タイプに基づいて集計されます。このディメンションの値は次のとおりです。
  • ADVERTISING - 視聴者が広告から動画にアクセスした。このトラフィック ソースに基づいてフィルタすると、insightTrafficSourceDetail フィールドで広告の種類が識別されます。
  • ANNOTATION - 視聴者が別の動画のアノテーションをクリックして、この動画にアクセスしました。
  • CAMPAIGN_CARD - 申し立てを受けたユーザー アップロード動画からの視聴回数。コンテンツ所有者が、視聴されたコンテンツを宣伝するために使用した動画です。このトラフィック ソースは、コンテンツ所有者レポートでのみサポートされています。
  • END_SCREEN - 別の動画の終了画面から参照された視聴回数。
  • EXT_URL - 動画の視聴回数が、別のウェブサイトのリンクから参照されたことを示します。このトラフィック ソースに基づいてフィルタすると、insightTrafficSourceDetail フィールドでウェブページが識別されます。このトラフィック ソースには、Google 検索の検索結果からの参照が含まれます。
  • HASHTAGS - VOD のハッシュタグ ページまたはショート動画のハッシュタグ ピボット ページからの視聴回数。
  • LIVE_REDIRECT - ライブ リダイレクトから参照された動画の視聴回数。
  • NO_LINK_EMBEDDED - 動画が別のウェブサイトに埋め込まれた状態で視聴された。
  • NO_LINK_OTHER - YouTube でトラフィックの参照元が特定されませんでした。このカテゴリには動画への直接トラフィック（ノーリファラー）とモバイル アプリのトラフィックが含まれます。
  • NOTIFICATION - YouTube からのメールまたは通知から動画が視聴された。
  • PLAYLIST - 再生リストの一部として動画が再生された際の視聴回数。再生リストのページからのトラフィックも含まれます。
  • PRODUCT_PAGE - 商品ページから参照された動画の視聴回数。
  • PROMOTED - YouTube の「注目の動画」ページなど、YouTube の無料プロモーションから参照された動画の視聴回数。
  • RELATED_VIDEO - 別の動画再生ページの関連動画リストから参照された動画の視聴回数。このトラフィック ソースに基づいてフィルタすると、insightTrafficSourceDetail フィールドにその動画の動画 ID が指定されます。
  • SHORTS - 視聴者がショート動画の視聴画面で前の動画から縦方向にスワイプして参照した。
  • SOUND_PAGE - ショート動画のサウンド ピボットページからの視聴回数。
  • SUBSCRIBER - YouTube のトップページのフィードまたは YouTube の登録チャンネル機能から参照された動画の視聴回数。このトラフィック ソースに基づいてフィルタすると、insightTrafficSourceDetail フィールドには、視聴回数の参照元となったホームページ フィード アイテムまたはその他のページが指定されます。
  • YT_CHANNEL - チャンネル ページで動画が視聴された。このトラフィック ソースに基づいてフィルタすると、insightTrafficSourceDetail フィールドにそのチャンネルのチャンネル ID が指定されます。
  • YT_OTHER_PAGE - YouTube ページに表示された検索結果や関連動画のリンク以外のリンクから参照された動画の視聴回数。このトラフィック ソースに基づいてフィルタすると、insightTrafficSourceDetail フィールドでページが識別されます。
  • YT_SEARCH - YouTube 検索結果から動画が視聴された。このトラフィック ソースに基づいてフィルタする場合、insightTrafficSourceDetail フィールドで検索キーワードを指定します。
  • VIDEO_REMIXES - 動画の視聴回数が、YouTube ショート プレーヤーのリミックス動画リンクから参照されたことを示します。このトラフィック ソースに基づいてフィルタする場合、insightTrafficSourceDetail フィールドには、視聴者が参照した動画が指定されます。
  • WATCH_WITH - 動画の視聴回数が、クリエイターの解説 / 「一緒に視聴」ストリームから参照された。このトラフィック ソースに基づいてフィルタする場合、insightTrafficSourceDetail フィールドには、視聴者が参照した動画が指定されます。
insightTrafficSourceDetail
レポートのデータは、指定された動画と指定されたトラフィック ソースの種類で最も多くの視聴回数を生み出した参照元に基づいて集計されます。このレポートを使用できるトラフィック ソースは次のとおりです。各トラフィック ソースについて、insightTrafficSourceDetail ディメンションが提供する情報がリストに示されています。
  • ADVERTISING - 視聴につながった広告の種類。表示される値は次のとおりです。
    • Click-to-Play エンゲージメント広告
    • エンゲージメント促進広告
    • Google 検索広告
    • トップページ YVA
    • 予約済みのスキップ可能なインストリーム
    • TrueView インサーチ、TrueView インディスプレイ
    • TrueView インストリーム
    • 該当カテゴリのない YouTube 広告
    • サムネイル表示
  • CAMPAIGN_CARD - 視聴者をレポートで特定された動画に誘導した、申し立てを受けた動画。
  • END_SCREEN - 視聴者がレポートで特定された動画にアクセスするきっかけとなった動画。
  • EXT_URL - 視聴者を動画に誘導したウェブサイト。
  • HASHTAGS - 視聴につながったハッシュタグ。
  • NOTIFICATION - トラフィックを誘導したメールまたは通知。
  • RELATED_VIDEO - 視聴者がレポート対象の動画にアクセスするきっかけとなった関連動画。
  • SOUND_PAGE - 視聴につながった動画。
  • SUBSCRIBER - 視聴者がレポート対象の動画にアクセスするきっかけとなった、ホームページ フィードのアイテムまたは YouTube の登録チャンネル機能。指定できる値は次のとおりです。
    • activity - トップページの登録チャンネル フィードに表示された動画のうち、アップロードやソーシャル チャンネル以外の動画（高評価、お気に入り、お知らせメッセージの投稿、再生リストへの追加などによって表示された動画）からの視聴回数です。
    • blogged - 人気のブログからのリンクによりトップページの登録チャンネル フィードに表示された動画からの視聴回数です。
    • mychannel - トップページに表示される他のフィード（[高評価]、[再生履歴]、[後で見る] など）の動画からの視聴回数。
    • podcasts - ポッドキャストのリンク先ページのアイテムからの視聴回数。
    • sdig - チャンネル登録の更新メールからの視聴回数。
    • uploaded - トップページの登録チャンネル フィードに表示された uploaded 動画からの再生回数です。
    • / - YouTube のトップページからのその他の視聴回数。
    • /my_subscriptions - YouTube の [登録チャンネル] ページからの視聴回数。
  • YT_CHANNEL - 視聴者が動画を視聴したチャンネル ページ。
  • YT_OTHER_PAGE - 視聴者が動画にアクセスした YouTube ページ。
  • YT_SEARCH - 視聴者を動画に誘導した検索キーワード。
  • VIDEO_REMIXES - 視聴につながった動画。
  • WATCH_WITH - 視聴につながった動画。

例

以下のサンプル リクエストでは、トラフィック ソース ディメンションを使用しています。

  • チャンネルの例

    • トラフィック ソース
      • 特定の国におけるトラフィック ソース別の再生回数および再生時間
      • さまざまなトラフィック ソースからの 1 日あたりの視聴回数と総再生時間
      • トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
      • 上位 10 件 - 動画へのトラフィックが最も多い Google 検索キーワード
      • 国別のさまざまなトラフィック ソースからの再生リストの視聴回数と総再生時間
      • さまざまなトラフィック ソースからの 1 日あたりの再生リストの視聴回数と総再生時間

  • コンテンツ所有者の例

    • トラフィック ソース
      • トラフィック ソース別の再生回数と再生時間
      • さまざまなトラフィック ソースからの 1 日あたりの視聴回数と総再生時間
      • トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
      • 上位 10 件 - 動画へのトラフィックが最も多い Google 検索キーワード
      • 国別のさまざまなトラフィック ソースからの再生リストの視聴回数と総再生時間
      • さまざまなトラフィック ソースからの 1 日あたりの再生リストの視聴回数と総再生時間

デバイス

deviceType
このディメンションは、視聴が発生したデバイスの物理的なフォーム ファクタを識別します。 次のリストは、API がデータを返すデバイスタイプを示しています。deviceType ディメンションをフィルタとして使用して、オペレーティング システム レポートに特定の種類のデバイスのデータのみが含まれるように制限することもできます。
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
このディメンションは、視聴が行われたデバイスのソフトウェア システムを識別します。 次のリストは、API がデータを返すオペレーティング システムを示しています。operatingSystem をフィルタとして使用して、特定のオペレーティング システムのデータのみを含むようにデバイスタイプ レポートを制限することもできます。
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

例

以下のサンプル リクエストでは、端末ディメンションを使用しています。

  • チャンネルの例

    • デバイス / OS
      • Android オペレーティング システムの端末のタイプに関する日別の指標
      • 携帯端末のオペレーティング システムに関する日別の指標
      • オペレーティング システムと端末のタイプに関する日別の指標
      • Android オペレーティング システムでの再生リストの視聴回数に関するデバイスタイプ別の 1 日の指標
      • モバイル デバイスでの再生リストの視聴回数に関するオペレーティング システムの日別指標

  • コンテンツ所有者の例

    • デバイス / OS
      • 申し立てが行われた動画の端末のタイプに関する日別の指標
      • 申し立てが行われた動画が携帯端末で再生されたときのオペレーティング システムに関する日別の指標
      • オペレーティング システムと端末のタイプに関する日別の指標
      • Android オペレーティング システムでの再生リストの視聴回数に関するデバイスタイプ別の 1 日の指標
      • モバイル デバイスでの再生リストの視聴回数に関するオペレーティング システムの日別指標

ユーザー属性

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

ageGroup（コア ディメンション）
このディメンションは、レポートデータに関連付けられているログイン ユーザーの年齢層を識別します。これには、YouTube が 18 歳未満と推定したユーザーも含まれます。API では、次の年齢層が使用されます。
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender （コア ディメンション）
このディメンションは、レポートデータに関連付けられたログイン ユーザーの性別を示します。 有効な値は female、male、user_specified です。This is a core dimension and is subject to the Deprecation Policy.

例

以下のサンプル リクエストでは、ユーザー属性ディメンションを使用しています。

  • チャンネルの例

    • ユーザー属性
      • カリフォルニア州の視聴者のユーザー属性（年齢層と性別）
      • カリフォルニア州の再生リストの視聴者のユーザー属性（年齢層と性別）

  • コンテンツ所有者の例

    • ユーザー属性
      • カリフォルニア州の視聴者のユーザー属性（年齢層と性別）
      • カリフォルニア州の再生リストの視聴者のユーザー属性（年齢層と性別）

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

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

次の表に、有効なディメンション値を示します。
共有サービス API 値
Allo ALLO
Ameba AMEBA
Android メール ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android メッセージ ANDROID_MMS
Android システムの共有ダイアログ ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
リアクションをリクエスト BLIND_REACT
Blogger BLOGGER
クリップボードにコピー COPY_PASTE
Cyworld CYWORLD
Digg DIGG
直接システム アクティビティ ダイアログ DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
表示された QR コード DISPLAYED_QR_CODE
Dropbox DROPBOX
定着 EMBED
メール MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Facebook ページ FACEBOOK_PAGES
Facebook グループに共有 FACEBOOK_SHARE_TO_GROUP
Facebook ストーリーズ FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google アプリ GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
ハングアウト HANGOUTS
hi5 HI5
HTC テキスト メッセージ HTC_MMS
IMO IMO
Instagram INSTAGRAM
Instagram Stories INSTAGRAM_STORIES
招待リンク（Android） INVITE_LINK_ANDROID
招待リンク（iOS） INVITE_LINK_IOS
プレイリストの共同編集者を招待する INVITE_PLAYLIST_COLLABORATORS
iOS システム アクティビティ ダイアログ IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao（Kakao Talk） KAKAO
KaiOS メッセージ KAIOS_MESSAGES
Kik KIK
LGE のメール LGE_EMAIL
行 LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
マップのコピー / 貼り付け MAPS_COPY_PASTE
Meet のライブ共有 MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
ニアバイシェア NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki（Одноклассники） ODNOKLASSNIKI
その他 OTHER
Pinterest PINTEREST
Quick Share QUICK_SHARE
Quick Share（Samsung） QUICK_SHARE_SAMSUNG
楽天市場 RAKUTEN
Google.com REDDIT
リミックス REMIX
Samsung メッセージ SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
デバイス内の写真に保存する SAVE_TO_DEVICE_PHOTOS
広告なしで共有 SHARE_AD_FREE
Snapchat カメラに共有 SHARE_TO_SNAPCHAT_CAMERA
子どもと共有する SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Sony との会話 SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
テキスト メッセージ TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
不明 UNKNOWN
Verizon メッセージ VERIZON_MMS
Viber VIBER
VKontakte（ВКонтакте） VKONTAKTE
ウェブシステム アクティビティ ダイアログ WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! 日本 YAHOO
YouTube コミュニティ投稿 YOUTUBE_COMMUNITY_POST
YouTube コミュニティの再投稿 YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
Snapchat プレビューで YouTube Music を共有 YTM_SHARE_TO_SNAPCHAT_PREVIEW
YouTube ショートのグリーン スクリーン YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
YouTube の「友だちと一緒に視聴」 YOUTUBE_WATCH_WITH_FRIENDS

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

例

以下のサンプル リクエストでは、ソーシャル ディメンションを使用しています。

  • チャンネルの例

    • ソーシャル: 共有に関する指標。動画が共有されたサービス別に集計されます。

  • コンテンツ所有者の例

    • ソーシャル: 共有に関する指標。動画が共有されたサービス別に集計されます。

視聴者維持率

elapsedVideoTimeRatio
このディメンションは、動画の長さに対する動画の経過部分の割合を指定します。維持率のディメンションと指標は、時間の経過に伴う視聴者維持率を測定するために使用されます。elapsedVideoTimeRatio ディメンションは時間の測定値です。たとえば、値が 0.4 の場合、対応するレポートデータには、動画の 40% が経過した後の維持率データが表示されます。

この API は、各動画について 100 個のデータポイントを返します。比率の値は 0.01 から 1.0 の範囲です。動画の再生中にデータが測定される時間は、動画ごとに等間隔です。つまり、2 分間の動画の場合、データポイント間の間隔は 1.2 秒になります。ただし、2 時間の動画の場合、データポイント間の間隔は 72 秒です。ディメンションの値は、間隔の終了日時（この日時を含まない）を示します。
audienceType （フィルタのみ）
ディメンション値は、レポートデータに関連付けられたトラフィックのタイプを識別します。 サポートされている値は ORGANIC、AD_INSTREAM、AD_INDISPLAY です。これらのトラフィック ソースの種類については、YouTube ヘルプセンターをご覧ください。

audienceType フィルタのデータは、2013 年 9 月 25 日以降のものが利用可能です。この API は、フィルタを使用して以前の日付のデータを取得しようとするクエリに対してデータを返しません。フィルタを使用しないクエリは、2008 年 7 月 1 日以降のすべての日付で機能します。

例

次のサンプル リクエストでは、視聴者維持率の項目を使用しています。

ライブ配信

livestreamPosition
このディメンションは、ライブ動画ストリーム中の特定の分を指定します。レポートの指標は、その時点でライブ配信を視聴していたユーザー数を示します。

メンバーシップの解約

membershipsCancellationSurveyReason
レポート対象期間中に、指定されたチャンネルのメンバーシップを解約した YouTube ユーザーが完了したアンケートの数。次の表に、有効なディメンション値を示します。
API 値 説明
UNKNOWN ユーザーがアンケートを完了しなかった。
DISLIKE_PERKS お客様がメンバーシップの特典を気に入らなかった。
PERKS_NOT_DELIVERED お客様から、約束されたメンバーシップ特典が提供されなかったという申し立てがあった。
CANNOT_ACCESS_PERKS お客様が特典にアクセスできなかった。
NO_LONGER_INTERESTED ユーザーがチャンネル メンバーシップに興味を失った。
FEEL_UNAPPRECIATED ユーザーがチャンネル メンバーとして評価されていないと感じた。
FINANCIAL_REASONS お客様が金銭的な理由で解約した。
JOIN_LIMITED_TIME もとから短期間のつもりだった。
OTHER お客様が解約した別の理由があった。

広告の掲載結果

adType
adType ディメンションは、広告のパフォーマンス レポートで使用され、動画の再生中に表示された広告の種類に基づいて、リクエストされた指標を集計します。 次のリストに、使用可能なディメンション値を示します。YouTube 広告フォーマットについて詳しくは、YouTube ヘルプセンターをご覧ください。

  • auctionBumperInstream - オークション経由で配置される、最長 6 秒のスキップ不可の動画広告。最後まで見ないと動画を視聴できません。

  • auctionDisplay - リッチメディア広告またはイメージ広告。動画プレーヤーの下部にオーバーレイとして表示されるか、動画再生ページに 300x250 の広告ユニットとして表示されるか、またはその両方の組み合わせとして表示されます。オーバーレイの実行時に、一定時間表示された後に自動的に閉じますが、ユーザーが手動で閉じることもできます。オーバーレイとバナーが同時に表示された場合、各広告は個別のインプレッションとしてカウントされます。

  • auctionInstream - スキップ不可の動画広告。動画本編の前、途中、または後に再生されます。

  • auctionTrueviewInslate – 視聴者は、動画の前に表示される複数の選択肢から動画広告を 1 つ選択します。See the TrueView documentation for more information.

  • auctionTrueviewInstream - メイン動画の前または途中に再生される、スキップ可能な動画広告。 詳しくは、TrueView のドキュメントをご覧ください。

  • auctionUnknown - AdWords オークションで購入された広告のうち、他の広告タイプに分類されていない広告。

  • reservedBumperInstream - 純広告として販売される、最長 6 秒のスキップ不可の動画広告。最後まで見ないと動画を視聴できません。

  • reservedClickToPlay - ユーザーがクリックして再生を開始する必要がある動画広告。広告のインプレッションは、ユーザーが再生を開始するかどうかに関係なく、Click-to-Play 広告が表示されるたびに記録されます。これらの広告は予約ベースで販売されます。

  • reservedDisplay - リッチメディア広告またはイメージ広告。動画プレーヤーの下部にオーバーレイとして表示されるか、動画再生ページに 300x250 の広告ユニットとして表示されるか、またはその両方の組み合わせとして表示されます。オーバーレイの実行時に、一定時間表示された後に自動的に閉じますが、ユーザーが手動で閉じることもできます。オーバーレイとバナーが同時に表示された場合、各広告は個別のインプレッションとしてカウントされます。

  • reservedInstream - 動画本編の前、途中、または後に挿入されるスキップ不可の動画広告。

  • reservedInstreamSelect

  • reservedMasthead - トップページに表示される、動画やグラフィック要素を含むことができる大型の広告。

  • reservedUnknown - 予約制で販売された広告のうち、他の広告タイプに分類できなかった広告。

  • unknown - YouTube でこの広告の種類を判別できませんでした。

例

次のサンプル レポートでは、広告のパフォーマンスまたは収益の指標を取得します。

  • チャンネルの例

    • 収益 / 広告
      • チャンネルの収益と広告のパフォーマンスに関する指標
      • 1 日の収益と広告のパフォーマンス指標
      • 国別の収益と広告のパフォーマンス指標
      • 上位 10 件 - 収益が最も高い動画
      • 広告タイプ別の広告の掲載結果の指標

  • コンテンツ所有者の例

    • 収益 / 広告
      • 申し立てを行ったコンテンツの収益と広告のパフォーマンス指標
      • 1 日の収益と広告のパフォーマンス指標
      • 国別の収益と広告のパフォーマンス指標
      • 上位 10 件 - 収益が最も高い動画
      • 広告タイプ別の広告の掲載結果の指標

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

以下のディメンションは、コンテンツ所有者レポートでのみサポートされています。

重要: コンテンツ所有者レポートを取得する API リクエストでは、次のいずれかのディメンションを使用してデータをフィルタする必要があります。
  • video
  • channel
  • 以下で定義されている claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせ。
claimedStatus（コンテンツ所有者レポートでのみ使用）
このディメンションを使用すると、API レスポンスに申し立てを行ったコンテンツの指標のみを含めるように指定できます。このディメンションで有効な値は claimed のみです。filters パラメータでクエリを claimedStatus==claimed に制限すると、API は申し立てを行ったコンテンツのデータのみを取得します。uploaderType ディメンションの定義の表に、このディメンションの使用方法の詳細が記載されています。
uploaderType（コア ディメンション）（コンテンツ所有者レポートでのみ使用）
このディメンションを使用すると、指定したコンテンツ所有者がアップロードしたコンテンツの指標、第三者がアップロードしたコンテンツ（ユーザーがアップロードした動画など）の指標、またはその両方を API レスポンスに含めるかどうかを指定できます。有効な値は self と thirdParty です。これはコア ディメンションであり、非推奨ポリシーの対象となります。

次の表に、filters パラメータで使用される claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせを示します。

claimedStatus 値 uploaderType 値 説明
[未設定] self コンテンツ所有者がアップロードした、申し立て済みおよび未申し立てのコンテンツの YouTube アナリティクス データを取得します。
申し立て済み [未設定] コンテンツ所有者または第三者によってアップロードされた申し立て対象のコンテンツのデータを取得します。
申し立て済み self コンテンツ所有者がアップロードした申し立て済みコンテンツのデータを取得します。
申し立て済み thirdParty 第三者によってアップロードされた申し立て済みコンテンツのデータを取得します。

例

コンテンツ所有者レポートのサンプル API リクエストの多くは、claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせを使用してデータをフィルタします。