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 を指定できます。

動画 （コア ディメンション）
YouTube 動画の ID。YouTube Data API の場合、これは video の値です。 リソースの id プロパティを設定します。This is a core dimension and is subject to the Deprecation Policy.
再生リスト
YouTube 再生リストの ID。YouTube Data API では、これは playlist リソースの id プロパティの値です。
チャンネル（コア ディメンション）（コンテンツ所有者レポートでのみ使用）
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 レスポンスにはそのグループ内のすべての動画、再生リスト、チャンネルのデータが含まれます。

例

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

  • チャンネルの例

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

  • コンテンツ所有者の例

    • 基本データ <ph type="x-smartling-placeholder">
        </ph>
      • トップ 10 - コンテンツ所有者の再生回数の多い動画
      • トップ 10 - コンテンツ所有者の視聴回数が特に多い動画
      • トップ 10 - コンテンツ所有者のチャンネルで再生回数の多い動画
      • トップ 10 – チャンネルで最も視聴回数が多い動画のアノテーションのクリック率
      • トップ 10 - コンテンツ所有者が最も視聴している再生リスト
    • 地域 <ph type="x-smartling-placeholder">
        </ph>
      • トップ 10 - コンテンツ所有者のヨーロッパで最も視聴された動画
      • トップ 10 – 米国で最も再生されたプレイリスト

地理的エリア

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

country（コア ディメンション）
レポート行の指標に関連付けられた国。ディメンション値は 2 文字の ISO-3166-1 国コードです（例: US、CN（中国）、FR（フランス））。国コード 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-1 国コードもあるため、このディメンションは ISO 3166-2 値には対応していません。また、米国以外の国の下位区分もサポートされていません。

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

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

例

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

  • チャンネルの例

    • 基本データ: チャンネルの国別の視聴回数など
    • 地域 <ph type="x-smartling-placeholder">
        </ph>
      • チャンネルの動画の国別再生時間の指標
      • チャンネルの動画のアノテーションに関する国別の指標
      • 米国の州とワシントン D.C. の州固有の指標
      • チャンネルの再生リストの国別の総再生時間の指標
      • トップ 10 – 米国で最も再生されたプレイリスト
    • 再生場所: 各再生場所での 1 日の視聴回数と総再生時間
    • トラフィック ソース: 各国のトラフィック ソースの視聴回数と総再生時間です。
    • ユーザー属性: カリフォルニアの視聴者のユーザー属性（年齢層と性別）
    • 人気の動画 <ph type="x-smartling-placeholder">
        </ph>
      • トップ 10 – 特定の国における再生回数が多い動画
      • トップ 10 – ヨーロッパで最も視聴回数が多い動画

  • コンテンツ所有者の例

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

期間

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

重要: すべての日付は、太平洋時間（UTC-7 または UTC-8）の午前 0 時から始まり、指定された日、月、年の午後 11 時 59 分（太平洋時間）で終わる期間を指します。そのため、夏時間に合わせて前方の時計が調整された日付は 23 時間の期間を表し、時計を後方調整した日付は 25 時間を表します。

[月] の 1 か月目と UTC-7 の時刻（UTC-7:0）は、1 か月目または UTC-2 太平洋標準時で始まります。

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

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

例

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

  • チャンネルの例

    • 時間ベース <ph type="x-smartling-placeholder">
        </ph>
      • チャンネルの動画の日別再生時間の指標
      • チャンネルの動画のアノテーションに関する日別の指標
      • チャンネルの 1 日の再生リスト視聴回数
    • 再生場所: 再生場所ごとの 1 日の視聴回数と総再生時間
    • トラフィック ソース: 各トラフィック ソースの 1 日の視聴回数と総再生時間
    • デバイス/OS <ph type="x-smartling-placeholder">
        </ph>
      • Android オペレーティング システムの端末のタイプに関する日別の指標
      • 携帯端末のオペレーティング システムに関する日別の指標
      • オペレーティング システムと端末のタイプに関する日別の指標

  • コンテンツ所有者の例

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

再生場所

これらのディメンションから、ユーザー アクションが発生したページまたはアプリケーションに関する分析情報が得られます。

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

  • BROWSE – このデータは、YouTube のホームページやホーム画面、ユーザーの登録チャンネル フィード、その他の YouTube ブラウジング機能で行われた視聴回数を表します。

  • CHANNEL – データはチャンネル ページで発生した視聴回数を表します。

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

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

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

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

  • SEARCH – このデータは、YouTube 検索結果ページで直接行われた視聴回数を表します。

  • WATCH – このデータは、動画の YouTube 動画再生ページまたは公式の YouTube アプリ（Android 向け YouTube アプリなど）で発生した視聴回数を表します。

  • YT_OTHER – データは特に分類されないビューを表します。

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

例

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

  • チャンネルの例

    • 再生場所 <ph type="x-smartling-placeholder">
        </ph>
      • 各再生場所における再生回数と再生時間
      • 視聴場所ごとの 1 日の視聴回数と総再生時間
      • トップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
      • 再生場所ごとの再生リストの視聴回数と総再生時間
      • 各再生場所からの再生リストの視聴回数と総再生時間（日別）

  • コンテンツ所有者の例

    • 再生場所 <ph type="x-smartling-placeholder">
        </ph>
      • 各再生場所における再生回数と再生時間
      • 視聴場所ごとの 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
このレポートのデータは、参照 URL タイプに基づいて集計されます。参照 URL は、ユーザーが動画にアクセスした方法を表します。このディメンションの有効な値は次のとおりです。
  • 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 フィールドには視聴者の参照元の動画が示されます。
insightTrafficSourceDetail
このレポートのデータは、指定した動画と指定したトラフィック ソース タイプで最も多くの視聴回数を獲得した参照元に基づいて集計されます。このレポートを使用できるトラフィック ソースは次のとおりです。このリストには、insightTrafficSourceDetail ディメンションで示される情報がトラフィック ソースごとに示されます。
  • ADVERTISING – 視聴につながった広告のタイプ。有効な値は次のとおりです。
    • Click-to-Play エンゲージメント広告
    • エンゲージメント促進広告
    • Google 検索広告
    • トップページ YVA
    • 予約済みのスキップ可能なインストリーム
    • 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 – 視聴回数につながった動画。

例

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

  • チャンネルの例

    • トラフィック ソース <ph type="x-smartling-placeholder">
        </ph>
      • 特定の国におけるトラフィック ソース別の再生回数および再生時間
      • さまざまなトラフィック ソースの 1 日の視聴回数と総再生時間
      • トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
      • トップ 10 – 動画のトラフィックが最も多い Google 検索キーワード
      • ある国におけるさまざまなトラフィック ソースの再生リストの視聴回数と総再生時間
      • 各トラフィック ソースの再生リストの視聴回数と総再生時間（日別）

  • コンテンツ所有者の例

    • トラフィック ソース <ph type="x-smartling-placeholder">
        </ph>
      • トラフィック ソース別の再生回数と再生時間
      • さまざまなトラフィック ソースの 1 日の視聴回数と総再生時間
      • トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
      • トップ 10 – 動画のトラフィックが最も多い Google 検索キーワード
      • ある国におけるさまざまなトラフィック ソースの再生リストの視聴回数と総再生時間
      • 各トラフィック ソースの再生リストの視聴回数と総再生時間（日別）

デバイス

deviceType
このディメンションは、視聴が発生したデバイスの物理的なフォーム ファクタを識別します。 次のリストは、API がデータを返すデバイスタイプを示しています。また、deviceType ディメンションをフィルタとして使用して、オペレーティング システム レポートに特定の種類のデバイスのデータのみが含まれるように制限することもできます。
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • 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 <ph type="x-smartling-placeholder">
        </ph>
      • Android オペレーティング システムの端末のタイプに関する日別の指標
      • 携帯端末のオペレーティング システムに関する日別の指標
      • オペレーティング システムと端末のタイプに関する日別の指標
      • Android オペレーティング システムにおける再生リストの視聴回数のデバイスタイプに関する日別の指標
      • モバイル デバイスでの再生リストの視聴回数に関するオペレーティング システムに関する日別の指標

  • コンテンツ所有者の例

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

ユーザー属性

ユーザー属性ディメンションは、視聴者の年齢層と性別の分布を把握するのに役立ちます。YouTube Analytics レポートのユーザー属性データに関する追加情報については、YouTube ヘルプセンターをご覧ください。

ageGroup（コア ディメンション）
このディメンションは、レポートデータに関連付けられたログイン ユーザーの年齢層を識別します。この 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.

例

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

  • チャンネルの例

    • ユーザー属性 <ph type="x-smartling-placeholder">
        </ph>
      • カリフォルニアの視聴者のユーザー属性（年齢層と性別）
      • カリフォルニア州の再生リスト視聴者のユーザー属性（年齢層と性別）

  • コンテンツ所有者の例

    • ユーザー属性 <ph type="x-smartling-placeholder">
        </ph>
      • カリフォルニアの視聴者のユーザー属性（年齢層と性別）
      • カリフォルニア州の再生リスト視聴者のユーザー属性（年齢層と性別）

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

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

有効なディメンション値を次の表に示します。
共有サービス API 値
Ameba AMEBA
Android のメール ANDROID_EMAIL
Android メッセンジャー ANDROID_MESSENGER
Android のメッセージ ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
クリップボードにコピー COPY_PASTE
サイワールド CYWORLD
Digg DIGG
Dropbox DROPBOX
埋め込み EMBED
メール MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook ページ FACEBOOK_PAGES
フォトカ FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
SMS を開始 GO_SMS
GroupMe GROUPME
ハングアウト HANGOUTS
hi5 HI5
HTC のテキスト メッセージ HTC_MMS
Google 受信トレイ INBOX
iOS のシステム アクティビティ ダイアログ IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO のストーリー KAKAO_STORY
Kakao（Kakao Talk） KAKAO
Kik KIK
LGE メール LGE_EMAIL
線 LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
メネアム MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
ニアバイシェア NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki（プロセス） ODNOKLASSNIKI
その他 OTHER
Pinterest PINTEREST
楽天市場 RAKUTEN
Google.com REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
テキスト メッセージ TEXT_MESSAGE
Tuenti TUENTI
。 TUMBLR
Twitter TWITTER
不明 UNKNOWN
Verizon のメッセージ VERIZON_MMS
Viber VIBER
VKontakte（Our apps that are available） VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! 日本 YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

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

例

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

  • チャンネルの例

    • ソーシャル: 動画が共有されたサービスごとに集計された共有指標

  • コンテンツ所有者の例

    • ソーシャル: 動画が共有されたサービスごとに集計された共有指標

視聴者維持率

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

この API は、動画ごとに 0.01～1.0 の範囲の比率値を持つ 100 個のデータポイントを返します。動画再生中にデータが測定される時間は、動画ごとに等間隔です。つまり、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 – 動画の前に表示される選択肢の中から、ユーザーが複数の動画広告のいずれかを選択します。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 はこの広告タイプを分類できませんでした。

例

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

  • チャンネルの例

    • 収益 ÷ 広告 <ph type="x-smartling-placeholder">
        </ph>
      • チャンネルの収益と広告のパフォーマンスに関する指標
      • 日別の収益と広告パフォーマンスの指標
      • 国別の収益と広告パフォーマンスの指標
      • トップ 10 – 収益が最も高い動画
      • 広告タイプ別の広告の掲載結果の指標

  • コンテンツ所有者の例

    • 収益 ÷ 広告 <ph type="x-smartling-placeholder">
        </ph>
      • 申し立てが行われたコンテンツの収益と広告のパフォーマンスの指標
      • 日別の収益と広告パフォーマンスの指標
      • 国別の収益と広告パフォーマンスの指標
      • トップ 10 – 収益が最も高い動画
      • 広告タイプ別の広告の掲載結果の指標

再生リスト

isCurated （フィルタのみ）
このフィルタは、このリクエストが、 コンテキストです。

例

再生リストレポートを取得するすべてのサンプル リクエストで、isCurated フィルタが使用されます。

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

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

重要: コンテンツ所有者レポートを取得する API リクエストでは、次のいずれかのディメンションを使用してデータをフィルタする必要があります。 <ph type="x-smartling-placeholder">
    </ph>
  • video
  • channel
  • claimedStatus ディメンションと uploaderType ディメンションのサポートされている組み合わせ。以下に定義します。
claimStatus（コンテンツ所有者のレポートでのみ使用）
このディメンションを使用すると、申し立てを受けたコンテンツの指標のみを API レスポンスに含めるよう指定できます。このディメンションの有効な値は claimed のみです。filters パラメータでクエリが claimedStatus==claimed に制限されている場合、API は申し立てを受けたコンテンツのデータのみを取得します。このディメンションの使用方法については、uploaderType ディメンションの定義の表をご覧ください。
UploaderType（コア ディメンション）（コンテンツ所有者レポートでのみ使用）
このディメンションを使用すると、指定したコンテンツ所有者がアップロードしたコンテンツの指標や、第三者がアップロードしたコンテンツ（ユーザーがアップロードした動画など）の指標を API レスポンスに含めるかどうかを指定できます。有効な値は self と thirdParty です。このディメンションは中核的なディメンションであり、非推奨ポリシーの対象となります。

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

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

例

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