このページでは、YouTube Analytics API のリクエスト例を示します。それぞれの例では、取得するレポートについて簡単に説明し、対応する dimensions
、metrics
、filters
、sort
のパラメータ値を示しています。(チャンネル レポートとコンテンツ所有者レポートのドキュメントでは、API でサポートされているレポートを確認できます)。
各例は Google API Explorer にリンクし、表示された値を入力します。この例では、デフォルトの開始日と終了日(YYYY-MM-DD
)に 2022-01-01
と 2022-06-30
を使用しています。
API Explorer にリンクした後も、レポートを取得するチャンネルまたはコンテンツ所有者を指定する必要があります。API Explorer は、クリックしたクエリに応じて、ids
パラメータ値に channel==MINE
または contentOwner==CONTENT_OWNER_ID
を入力します。チャネル レポートでは、MINE
を認証済みユーザーのチャネル ID に変更できます。コンテンツ所有者レポートの場合は、CONTENT_OWNER_ID
をコンテンツ所有者 ID に置き換える必要があります。
また、指定したチャンネルまたはコンテンツ所有者として認証され、API Explorer が OAuth 2.0 を使用して API リクエストを承認できるようにします。
複数のディメンション/指標によるリクエストの並べ替え
API は、複数のディメンションや指標を使用してレスポンス データを並べ替える機能をサポートしています。たとえば、以下のリクエストは、特定のチャンネルの動画の毎日のトラフィック ソース データを取得します。結果セットの各行には、特定の日付の特定のタイプのトラフィック ソース(EXT_URL
など)から発生した視聴回数と推定総再生時間が表示されます。
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
レスポンスでは、結果が時系列で並べ替えられます。各日付の結果セット内で、視聴回数が降順で並べ替えられます。つまり、結果セットの最初の行には、リクエストした期間の最初の日において最も多く再生回数を生成したトラフィック ソースのデータが含まれます。2 番目の行には、最初の日において 2 番目に多く再生回数を生成したトラフィック ソースのデータが含まれます。
チャンネル レポート
動画レポート
チャンネルの合計視聴回数、推定総再生時間など
このクエリは、チャンネルのコンテンツに関する集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
チャンネルの国別の視聴回数(その他)
このクエリは、チャンネルの動画に関する特定の国の指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
トップ 10 – チャンネル内で最も視聴された動画
このクエリは、チャンネル内で最も視聴された上位 10 本の動画を取得します。これは、指定された期間における推定再生時間(分)に基づいた順位です。結果は推定再生時間の降順に並べ替えられます。
注: このレポートでは、sort
リクエスト パラメータの値を指定し、maxResults
パラメータを 10
以下の整数値に設定する必要があります。
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
トップ 10 – チャンネル内で再生回数の多い動画に対するアノテーションのクリック率
このリクエストは、チャンネルの視聴回数が特に多い上位 10 本の動画について、視聴回数、アノテーションのクリック率、アノテーションの成約率、アノテーションのインプレッション数を取得します。結果は視聴回数の降順で並べ替えられます。つまり、最も視聴回数の多い動画が最初に表示されます。
注: このレポートでは、sort
リクエスト パラメータの値を指定し、maxResults
パラメータを 10
以下の整数値に設定する必要があります。
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
再生リストレポート
チャンネルの再生リストの合計視聴回数
このリクエストによって、認証済みユーザーのチャンネル内の再生リストの合計開始時間、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views
指標は、再生リスト内で発生した動画再生回数のみをカウントします。
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1
特定の再生リストの統計情報
このリクエストによって、特定の再生リストの合計開始数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views
指標は、再生リスト内で発生した動画再生回数のみをカウントします。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 PLAYLIST_ID
を、認証済みユーザーのチャンネルの再生リストの再生リスト ID に置き換える必要があります。
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1;playlist==PLAYLIST_ID
複数の再生リストの統計情報をまとめて取得するには、PLAYLIST_ID
という文字列を、認証済みユーザーのチャンネルの再生リストにおける再生リスト ID のカンマ区切りリスト(最大 500 件)に置き換えます。
トップ 10 – チャンネルの視聴回数が最も多い再生リスト
このクエリは、チャンネルの視聴回数が特に多い上位 10 件の再生リストを取得します。これは、指定した期間内の推定再生時間(分)で測定したものです。また、視聴者が各再生リストの再生を開始した回数や、再生リストの再生後に再生リスト内の動画を視聴した平均時間など、その他の再生リストの指標も取得します。結果は推定再生時間の降順に並べ替えられます。
注: このレポートでは playlist
ディメンションを使用しているため、sort
リクエスト パラメータの値を指定し、maxResults
パラメータに 10
以下の整数値を設定する必要があります。
dimensions=playlist metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist filters=isCurated==1 maxResults=10 sort=-estimatedMinutesWatched
動画レポート
チャンネルの動画の日別再生時間の指標
このクエリは、チャンネルの動画の 1 日の視聴回数、総再生時間の指標、新しいチャンネル登録者数を取得します。レポートは、リクエストした期間内の日付ごとに 1 行のデータを返します。各行は時系列で並べ替えられます。
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
チャンネルの動画のアノテーションに関する日別の指標
このリクエストによって、チャンネルのコンテンツの 1 日の視聴回数、アノテーションのクリック率、アノテーションのクリック率、アノテーションのインプレッション数を取得できます。結果は時系列で並べ替えられます。
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
再生リストレポート
チャンネルの 1 日の再生リスト視聴回数
このリクエストによって、認証済みユーザーのチャンネルの 1 日の視聴回数、再生リストの開始時間、推定再生時間(分単位)、再生リストの開始あたりの視聴回数が取得されます。結果は時系列で並べ替えられます。
dimensions=day metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1 sort=day
動画レポート
チャンネルの動画の国別再生時間の指標
このクエリは、チャンネルの動画の国別の視聴回数、総再生時間の指標、チャンネル登録者数を計算します。レポートは、チャンネルの動画が再生された国ごとに 1 行のデータを返します。各行は再生時間(分)で降順に並べ替えられます。
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
チャンネルの動画のアノテーションに関する国別の指標
このリクエストによって、チャンネルの動画の国別の視聴回数、アノテーションのクリック率、アノテーションのクリック率、アノテーションのインプレッション数が取得されます。結果はアノテーションのクリック率の降順に並べ替えられます。つまり、アノテーションのクリック率が高い国の方がリストの最初に表示されます。
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
米国各州とワシントン D.C. の州固有の指標
このリクエストでは、チャンネルの動画の視聴回数、推定再生時間(分)、平均視聴時間を州ごとの内訳で取得できます。米国とワシントン D.C. のデータは、米国の州ごとの ISO 3166-2 コードによるアルファベット順に並べ替えられています。
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
トップ 10 – 特定の国における再生回数が多い動画
このクエリは、チャンネル内で最も再生された上位 10 本の動画を取得します。これは、指定された国での指定された期間における再生回数に基づいた順位です。結果は視聴回数の降順で並べ替えられます。
注: このレポートでは、sort
リクエスト パラメータの値を指定し、maxResults
パラメータを 10
以下の整数値に設定する必要があります。
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
合計閲覧数の上位 10 の米国都市
このクエリは、指定した期間にチャンネルのコンテンツの視聴回数が最も多かった米国の 10 市のリストを取得します。このクエリに別の有効な値を選択して、別の国のデータをリクエストするように変更できます。同様に、subContinent フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。他のフィルタもサポートされています。結果は視聴回数の降順で並べ替えられます。
dimensions=city metrics=views filters=country==US maxResults=10 sort=-views
コンテンツの種類別の合計表示回数の上位 10 位(米国)
このクエリは、サポートされている各 creatorContentType について、指定期間におけるチャンネルのコンテンツの視聴回数が最も多い米国の 10 都市のリストを取得します。結果は視聴回数の降順で並べ替えられます。
dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views
合計総再生時間の上位 10 都市の都市
このクエリでは、指定した期間における米国の上位都市のうち、チャンネル コンテンツの 1 日の合計総再生時間が特に多い日付の上位 10 日間のリストが取得されます。クエリ結果では、合計総再生時間、総再生時間が発生した日付、コンテンツが視聴されたと推定される都市を確認できます。結果は合計総再生時間の降順で並べ替えられます。
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
トップ 10 – ヨーロッパで最も視聴された動画
このクエリは、指定された期間内に視聴回数が測定された、ヨーロッパでチャンネルの視聴回数が特に多い 10 本の動画を取得します。このクエリは、別の大陸のデータを、そのフィルタに別の有効な値を選択してリクエストするように変更できます。同様に、subContinent フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。結果は視聴回数の降順で並べ替えられます。
注: このレポートでは、sort
リクエスト パラメータの値を指定し、maxResults
パラメータを 10
以下の整数値に設定する必要があります。
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
再生リストレポート
チャンネルの再生リストの国別指標
このクエリは、チャンネルの再生リストの国別の視聴回数と総再生時間の指標を取得します。レポートには、チャンネルの再生リストが視聴された国ごとに 1 行のデータが返されます。各行は再生時間(分)で降順に並べ替えられます。
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist filters=isCurated==1 sort=-estimatedMinutesWatched
トップ 10 – 米国で最も人気のあるプレイリスト
このクエリは、米国の視聴者が指定期間内に最も頻繁に再生を開始した 10 件の再生リストを取得します。結果はプレイリストの開始回数の降順で並べ替えられます。
注: このレポートでは playlist
ディメンションを使用しているため、sort
リクエスト パラメータの値を指定し、maxResults
パラメータに 10
以下の整数値を設定する必要があります。
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
動画レポート
各再生場所における再生回数と再生時間
このクエリは、特定のチャンネルの動画の再生回数と推定再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類に基づいて集計され、視聴回数の多い順で並べ替えられます。
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
さまざまな再生場所からの 1 日あたりの視聴回数と総再生時間
このクエリは、特定のチャンネルの動画について、米国での 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類ごとに、日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
トップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
このクエリは、特定の動画または動画のグループについて、視聴回数と推定総再生時間を取得します。結果は、動画が埋め込まれていたサードパーティのサイト別にグループ化されます。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロードした動画の 1 つ以上の動画 ID のカンマ区切りリストに置き換える必要があります。
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
再生リストレポート
さまざまな再生場所からの再生リストの視聴回数と総再生時間
このクエリは、視聴回数、推定総再生時間、特定のチャンネルの再生リストの再生リストの開始回数を取得します。結果は、動画が再生されたページまたはアプリケーションの種類に基づいて集計され、プレイリストの開始順で降順で並べ替えられます。
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts filters=isCurated==1 sort=-playlistStarts
1 日の再生リストの視聴回数と、さまざまな再生場所からの総再生時間
このクエリは、特定のチャンネルの再生リストの米国ごとの再生リストの開始時間、視聴回数、推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したページの種類やアプリケーションごとに、日単位でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,views,estimatedMinutesWatched filters=isCurated==1;country==US sort=day
動画レポート
コンテンツのタイプ別の高評価と低評価
このクエリは、チャンネルのコンテンツの種類ごとに高評価数と低評価数を取得します。
dimensions=creatorContentType metrics=likes,dislikes
動画レポート
特定の国におけるトラフィック ソース別の再生回数および再生時間
このリクエストは、特定の国におけるチャンネルの動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
1 日の視聴回数と、さまざまなトラフィック ソースからの総再生時間
このリクエストによって、チャンネルの動画の 1 日の視聴回数と 1 日あたりの推定総再生時間が取得されます。各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
このクエリでは、1 つまたは複数の特定の動画の YouTube 検索結果から最も多くの視聴回数を獲得した 10 個の検索キーワードを取得します。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、最大 500 個の動画 ID のカンマ区切りのリストに置き換える必要があることに注意してください。
たとえば、1 つの動画に関するクエリを実行したり、VIDEO_ID
を置き換えて、その動画のトラフィックが最も多い検索キーワードを特定したりできます。また、特定の再生リストに含まれている動画をすべて一覧表示して、その再生リスト内のどの動画へのトラフィックが最も多かったかを特定することもできます。
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
トップ 10 – 動画のトラフィックが最も多い外部ウェブサイト
このクエリは、特定の動画または動画グループについて最も多くの視聴回数を獲得した 10 件の外部ウェブサイトを取得します。結果は推定再生時間の降順に並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロード済みの動画 ID のカンマ区切りリスト(最大 500 件)に置き換える必要があります。
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
再生リストレポート
再生リストの視聴回数と、国内の各トラフィック ソースからの総再生時間
このリクエストによって、指定した国での再生リストの視聴回数、再生リストの開始時間、推定再生時間が表示されます。指標はトラフィック ソースごとに集計されます。トラフィック ソースは、ユーザーが再生リストにアクセスした方法を表します。
dimensions=insightTrafficSourceType metrics=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1;country==US
さまざまなトラフィック ソースの 1 日の再生リスト視聴回数と総再生時間
このリクエストによって、チャンネルの 1 日の再生リストの視聴回数、再生リストの開始時間、再生リストの総再生時間の推定値が取得されます。各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。
dimensions=day,insightTrafficSourceType metrics=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1 sort=day
動画レポート
Android オペレーティング システムの端末のタイプに関する日別の指標
このクエリは、Android デバイスで特定のチャンネルの動画について、1 日あたりの視聴回数と推定総再生時間を取得します。結果は、動画が再生された端末のタイプごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
携帯端末のオペレーティング システムに関する日別の指標
このクエリは、特定のチャンネルの動画のモバイル デバイスでの 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたオペレーティング システムごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
オペレーティング システムと端末のタイプに関する日別の指標
このクエリは、チャンネルの 1 日の視聴回数と推定総再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
再生リストレポート
Android オペレーティング システムにおけるプレイリストの視聴回数のデバイスタイプに関する日別の指標
このクエリは、Android デバイスで特定のチャンネルの再生リストの 1 日の再生リスト視聴回数と推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したデバイスの種類ごとに、日ごとにグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,deviceType metrics=views,estimatedMinutesWatched filters=isCurated==1;operatingSystem==ANDROID sort=day
モバイル デバイスでの再生リストの視聴回数に関する 1 日単位のオペレーティング システム指標
このクエリは、モバイル デバイスでの特定のチャンネルの再生リストの 1 日の再生リスト視聴回数と推定総再生時間を取得します。再生リストの視聴が行われたオペレーティング システムごとに結果がグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=isCurated==1;deviceType==MOBILE sort=day
動画レポート
カリフォルニア州の視聴者層(年齢層と性別)
このレポートでは、カリフォルニアのチャンネルの動画を視聴したユーザーの年齢層と性別に関する統計情報を取得できます。検索結果は、性別、次に年齢層で並べ替えられています。filters
パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
再生リストレポート
カリフォルニア州の再生リストの視聴者層(年齢層と性別)
このレポートでは、カリフォルニア州のチャンネルの再生リストを視聴した視聴者の年齢層と性別に関する統計情報を取得できます。検索結果は、性別、次に年齢層で並べ替えられています。filters
パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=isCurated==1;province==US-CA sort=gender,ageGroup
共有に関する指標(動画が共有されているサービス別に集計)
このリクエストによって、ユーザーが Share
ボタンを使用してチャンネルの動画を共有した回数を取得できます。結果は共有サービス別(Google+、Twitter など)に集計され、共有回数の降順に並べ替えられます。
dimensions=sharingService metrics=shares sort=-shares
動画の視聴者維持率の指標
このレポートでは、視聴者維持率を測定できます。このレポートは、一度に 1 つの動画についてのみ取得できます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロード済みのいずれかの動画の動画 ID に置き換える必要があります。なお、視聴者維持率レポートでは、video
フィルタに複数の値を指定することはできません。
この例では、audienceType
フィルタを使用してレスポンスを制限しています。オーガニック検索とは、動画の検索や関連動画のクリックなどの直接的なユーザー アクションの結果であるオーガニック ビューのデータのみが含まれるようにすることです。そのため、TrueView インストリーム広告または TrueView インディスプレイ広告の視聴回数のデータは含まれません。フィルタを削除すると、すべての視聴者タイプから動画の視聴者維持率データを取得できます。
audienceType
フィルタのデータは 2013 年 9 月 25 日現在ご利用可能です。この API は、フィルタを使用して過去の日付からデータを取得するクエリのデータを返しません。フィルタを使用していないクエリは、2008 年 7 月 1 日以降であれば機能します。
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
チャンネルの収益と広告のパフォーマンスに関する指標
このリクエストによって、チャンネルの収益指標と広告パフォーマンス指標が取得されます。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
1 日の収益と広告の掲載結果に関する指標
このリクエストによって、チャンネルの 1 日の収益と広告のパフォーマンスに関する指標が取得されます。
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
国別の収益と広告の掲載結果に関する指標
このリクエストでは、チャンネルの国別の収益と広告のパフォーマンス指標を取得します。結果は収益額の降順で並べ替えられます。つまり、純収益が特に多い国がリストに表示されます。
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
トップ 10 – 収益が最も多い動画
このリクエストは、収益が最も高かったチャンネルの 10 本の動画の収益と広告のパフォーマンス指標を取得します。結果は収益額の降順で並べ替えられます。つまり、推定収益が最も高い動画が最初の動画になります。
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
広告タイプ別の広告の掲載結果の指標
このリクエストは、コンテンツ所有者によって申し立てが行われたコンテンツの広告の掲載結果に関する指標を取得します。結果は広告タイプ別にグループ化されるため、収益と CPM の値をさまざまな広告タイプ間で比較できます。
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
コンテンツ所有者レポート
動画レポート
申し立てを受けたすべてのコンテンツの視聴回数合計、推定総再生時間など
このクエリは、コンテンツ所有者によって申し立てが行われたコンテンツについて集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
セルフアップロード動画の国別視聴回数など
このクエリは、コンテンツ所有者がアップロードした動画の特定の国における指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
申し立てが行われた第三者コンテンツの合計視聴回数(その他)
このクエリは、コンテンツ所有者が申し立てを行い、コンテンツ所有者自身がアップロードしたものではない動画について集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
すべてのセルフアップロード コンテンツの合計視聴回数など
このクエリは、コンテンツ所有者がアップロードした動画について集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
申し立てが行われたセルフアップロード コンテンツの合計視聴回数など
このクエリは、コンテンツ所有者がアップロードし、さらには申し立てが行われた動画について集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
トップ 10 – コンテンツ所有者の最も再生回数の多い動画
このクエリは、コンテンツ所有者がアップロードした動画の中で、指定した期間において最も再生回数の多い上位 10 本の動画を取得します。結果は視聴回数の降順で並べ替えられます。
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
トップ 10 – コンテンツ所有者の最も視聴された動画
このクエリは、コンテンツ所有者がアップロードした動画の中で、指定した期間において最も視聴された上位 10 本の動画を取得します。これは、推定再生時間(分)に基づいた順位です。結果は推定再生時間の降順に並べ替えられます。
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
トップ 10 – コンテンツ所有者のチャンネルの視聴回数が最も多い動画
このクエリでは、コンテンツ所有者が管理している特定のチャンネルまたはチャンネル グループについて、再生回数の多い上位 10 本の動画を取得します。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
トップ 10 – チャンネル内で再生回数の多い動画に対するアノテーションのクリック率
このリクエストによって、指定したチャンネルまたはチャンネル グループで最も視聴された動画 10 件の視聴回数、アノテーションのクリック率、アノテーションの成約率、アノテーションのインプレッション数が取得されます。結果は視聴回数の降順で並べ替えられます。つまり、最も視聴回数の多い動画が最初に表示されます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
再生リストレポート
コンテンツ所有者のチャンネルの再生リストの視聴回数
このリクエストによって、コンテンツ所有者のチャンネルの再生リストの合計開始再生回数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views
指標は、再生リスト内で発生した動画再生回数のみをカウントします。
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1
特定のチャンネルの再生リストの視聴回数
このリクエストによって、コンテンツ所有者のチャンネルの再生リストの合計開始再生回数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views
指標は、再生リスト内で発生した動画再生回数のみをカウントします。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1;channel==CHANNEL_ID
再生リストの統計情報
このリクエストによって、特定の再生リストの合計開始数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views
指標は、再生リスト内で発生した動画再生回数のみをカウントします。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 PLAYLIST_ID
を、コンテンツ所有者のチャンネルの 1 つの再生リストの再生リスト ID に置き換える必要があります。
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1;playlist==PLAYLIST_ID
複数の再生リストの統計情報をまとめて取得するには、PLAYLIST_ID
という文字列を、コンテンツ所有者のチャンネルの再生リスト ID をカンマ区切りで 500 件まで置き換えます。
トップ 10 – コンテンツ所有者の視聴回数が最も多い再生リスト
このクエリは、コンテンツ所有者の最も視聴されている 10 件の再生リストを取得します。これは、指定した期間の推定再生時間(分)で測定します。また、視聴者が各再生リストの再生を開始した回数や、再生リストの再生後に再生リスト内の動画を視聴した平均時間など、その他の再生リストの指標も取得します。結果は推定再生時間の降順に並べ替えられます。
注:このレポートでは playlist
ディメンションを使用しているため、sort
リクエスト パラメータの値を指定し、maxResults
パラメータに 10
以下の整数値を設定する必要があります。
dimensions=playlist metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist filters=isCurated==1 maxResults=10 sort=-estimatedMinutesWatched
動画レポート
自身がアップロードしたコンテンツの日別再生時間の指標
このクエリは、コンテンツ所有者がアップロードした動画の、1 日あたりの総再生時間の指標、視聴回数、収益化対象の再生回数、インプレッションの数を取得します。レポートは、期間内の日付ごとに 1 行のデータとして返されます。各行は時系列で並べ替えられます。
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
申し立てが行われたコンテンツのアノテーションに関する指標
このリクエストによって、コンテンツ所有者が申し立てを行ったコンテンツの 1 日の視聴回数、アノテーションのクリック率、アノテーションの成約率、アノテーションのインプレッション数を取得できます。結果は時系列で並べ替えられます。
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
再生リストレポート
コンテンツ所有者の 1 日の再生リスト視聴回数
このリクエストによって、コンテンツ所有者のチャンネルのすべての再生リストについて、1 日の視聴回数、再生リストの開始回数、推定再生時間(分単位)の取得数が取得されます。結果は時系列で並べ替えられます。
dimensions=day metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart filters==isCurated=1 sort=day
動画レポート
自身がアップロードしたコンテンツの国別再生時間の指標
このクエリは、国ごとの視聴回数、総再生時間の指標、推定広告収益を取得します。この指標は、コンテンツ所有者がアップロードした動画に関するものです。レポートは、動画が再生された国ごとに 1 行のデータとして返されます。各行は再生時間の降順に並べ替えられます。
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
自身がアップロードしたコンテンツのアノテーションに関する国別の指標
このリクエストによって、コンテンツ所有者のアップロードされた動画の国別の視聴回数、アノテーションのクリック率、アノテーションの成約率、アノテーションのインプレッション数が取得されます。結果はアノテーションのクリック率の降順に並べ替えられます。つまり、アノテーションのクリック率が高い国の方がリストの最初に表示されます。
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
米国各州とワシントン D.C. の州固有の指標
このリクエストでは、コンテンツ所有者が申し立てを行った動画について、視聴回数、推定再生時間(分)、平均視聴時間を州ごとの内訳で取得できます。米国とワシントン D.C. のデータは、米国の州ごとの ISO 3166-2 コードによるアルファベット順に並べ替えられています。
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
合計閲覧数の上位 10 の米国都市
このクエリでは、指定した期間にコンテンツ所有者が申し立てを行った動画のうち、最も多く視聴された米国の 10 都市が表示されます。このクエリに別の有効な値を選択して、別の国のデータをリクエストするように変更できます。同様に、subContinent フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。他のフィルタもサポートされています。結果は視聴回数の降順で並べ替えられます。
dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
コンテンツの種類別の合計表示回数の上位 10 位(米国)
このクエリは、指定した creatorContentType ごとに、指定した期間にコンテンツ所有者が申し立てを行ったコンテンツの視聴回数が最も多かった米国の 10 都市のリストを取得します。結果は視聴回数の降順で並べ替えられます。
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
合計総再生時間の上位 10 都市の都市
以下のクエリは、指定した期間における上位 10 日間のリストを取得します。これは、コンテンツ所有者が申し立てを行ったコンテンツについて、1 日の合計総再生時間が米国内の市で占める最大期間である場合です。クエリ結果では、合計総再生時間、総再生時間が発生した日付、コンテンツが視聴されたと推定される都市を確認できます。結果は合計総再生時間の降順で並べ替えられます。
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
トップ 10 – ヨーロッパで最も視聴された動画
このクエリは、コンテンツ所有者が申し立てを行った動画のうち、指定された期間内の視聴回数で測定された、ヨーロッパで最も視聴された 10 本の動画を取得します。このクエリは、別の大陸のデータを、そのフィルタに別の有効な値を選択してリクエストするように変更できます。同様に、subContinent フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。結果は視聴回数の降順で並べ替えられます。
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
再生リストレポート
コンテンツ所有者の再生リストに関する国別の総再生時間の指標
このクエリは、コンテンツ所有者のチャンネルのすべての再生リストについて、国別の視聴回数と総再生時間の指標を取得します。再生リストが視聴された国ごとに 1 行のデータが返されます。各行は再生時間(分)で降順に並べ替えられます。
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist filters=isCurated==1 sort=-estimatedMinutesWatched
トップ 10 – 米国で最も人気のあるプレイリスト
このクエリでは、指定した期間に米国の視聴者が最も頻繁に再生を開始した、コンテンツ所有者のチャンネルから 10 件の再生リストを取得します。結果はプレイリストの開始回数の降順で並べ替えられます。
注: このレポートでは playlist
ディメンションを使用しているため、sort
リクエスト パラメータの値を指定し、maxResults
パラメータに 10
以下の整数値を設定する必要があります。
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
動画レポート
コンテンツのタイプ別の高評価と低評価
このクエリは、特定のチャンネルまたはチャンネルのグループごとに、コンテンツの種類ごとの高評価数と低評価数を取得します。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
動画レポート
各再生場所における再生回数と再生時間
このクエリは、特定のチャンネルまたはチャンネルのグループにアップロードされた動画の視聴回数と総再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類に基づいて集計され、視聴回数の多い順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
さまざまな再生場所からの 1 日あたりの視聴回数と総再生時間
このクエリは、特定のチャンネルまたはチャンネルのグループにアップロードされた動画について、米国での 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類ごとに、日別でグループ化されます。結果は新しい順に並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
トップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
このクエリは、特定の動画または動画のグループについて、視聴回数と推定総再生時間を取得します。結果は、動画が埋め込まれていたサードパーティのサイト別にグループ化されます。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロード済みの動画 ID のカンマ区切りリスト(最大 500 件)に置き換える必要があります。
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
再生リストレポート
さまざまな再生場所からの再生リストの視聴回数と総再生時間
このクエリは、コンテンツ所有者のチャンネルのすべての再生リストの視聴回数、推定総再生時間、再生リストの開始回数を取得します。結果は、動画が再生されたページまたはアプリケーションの種類に基づいて集計され、プレイリストの開始順で降順で並べ替えられます。
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts filters=isCurated==1 sort=-playlistStarts
1 日の再生リストの視聴回数と、さまざまな再生場所からの総再生時間
このクエリは、コンテンツ所有者のチャンネルのすべての再生リストについて、米国での再生リストの 1 日の開始数、視聴回数、推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したページの種類やアプリケーションごとに、日単位でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,views,estimatedMinutesWatched filters=isCurated==1;country==US sort=day
動画レポート
トラフィック ソース別の再生回数および再生時間
このリクエストは、コンテンツ所有者の動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
1 日の視聴回数と、さまざまなトラフィック ソースからの総再生時間
このリクエストによって、コンテンツ所有者の動画の 1 日の視聴回数と 1 日あたりの推定再生時間が取得されます。指標は日別およびトラフィック ソース別に集計され、新しい順に並べ替えられます。
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
注: 次の 2 つのサンプル レポートは、特定のトラフィック ソースでのみサポートされています。たとえば、NO_LINK_EMBEDDED
トラフィック ソースには追加の詳細情報がないため、これらのソースでこれらのレポートを使用することはできません。これらのタイプのレポートを利用できるトラフィック ソースについて詳しくは、insightTrafficSourceType の定義をご覧ください。
トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
このクエリは、YouTube 検索結果から特定の動画または動画グループについて、視聴回数が最も多かった 10 件の検索キーワードを取得します。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロード済みの動画 ID のカンマ区切りリスト(最大 500 件)に置き換える必要があります。
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
トップ 10 – 動画のトラフィックが最も多い外部ウェブサイト
このクエリは、特定の動画または動画グループについて、Google 検索の検索結果から最も多くの視聴回数をもたらした 10 件の外部ウェブサイトを取得します。結果は推定再生時間の降順に並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロード済みの動画 ID のカンマ区切りリスト(最大 500 件)に置き換える必要があります。
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
再生リストレポート
再生リストの視聴回数と、国内の各トラフィック ソースからの総再生時間
このリクエストによって、指定した国での再生リストの視聴回数、再生リストの開始時間、推定再生時間が表示されます。指標はトラフィック ソースごとに集計されます。トラフィック ソースは、ユーザーが再生リストにアクセスした方法を表します。
dimensions=insightTrafficSourceType metrics=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1;country==US
さまざまなトラフィック ソースの 1 日の再生リスト視聴回数と総再生時間
このリクエストによって、1 つ以上のコンテンツ所有者のチャンネルで、再生リストの 1 日の再生リスト視聴回数、再生リストの開始時間、再生リストの推定総再生時間が取得されます。指標はトラフィック ソースごとに毎日集計され、時系列で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=day,insightTrafficSourceType metrics=views,playlistStarts,estimatedMinutesWatched filters=isCurated==1;channel==CHANNEL_ID sort=day
動画レポート
申し立てが行われた動画の端末のタイプに関する日別の指標
このクエリは、特定のコンテンツ所有者が申し立てた動画について、デバイスの種類ごとに 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生された端末のタイプごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
申し立てが行われた動画が携帯端末で再生されたときのオペレーティング システムに関する日別の指標
このクエリでは、指定したコンテンツ所有者によって申し立てが行われた動画がモバイル デバイスで視聴された回数について、オペレーティング システムによって 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたオペレーティング システムごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
オペレーティング システムと端末のタイプに関する日別の指標
このクエリは、特定のコンテンツ所有者が申し立てた動画の 1 日の視聴回数と推定総再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
再生リストレポート
Android オペレーティング システムにおけるプレイリストの視聴回数のデバイスタイプに関する日別の指標
このクエリは、Android デバイス上で 1 つまたは複数のコンテンツ所有者のチャンネルの再生リストの 1 日の再生リスト視聴回数と推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したデバイスの種類ごとに、日ごとにグループ化されます。結果は時系列で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=day,deviceType metrics=views,estimatedMinutesWatched filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID sort=day
モバイル デバイスでの再生リストの視聴回数に関する 1 日単位のオペレーティング システム指標
このクエリは、コンテンツ所有者のチャンネル内の再生リストにおける、モバイル デバイスでの再生リストの 1 日の視聴回数と推定総再生時間を取得します。再生リストの視聴が行われたオペレーティング システムごとに結果がグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=isCurated==1;deviceType==MOBILE sort=day
動画レポート
カリフォルニア州の視聴者層(年齢層と性別)
このレポートでは、コンテンツ所有者が申し立てを行ったコンテンツを視聴したカリフォルニア州の視聴者の年齢層と性別に関するデータを取得できます。検索結果は、性別、次に年齢層で並べ替えられています。filters
パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
再生リストレポート
カリフォルニア州の再生リストの視聴者層(年齢層と性別)
カリフォルニア州の視聴者のうち、コンテンツ所有者のチャンネルで再生リストを視聴した視聴者の年齢層と性別に関する統計情報を取得します。検索結果は、性別、次に年齢層で並べ替えられています。filters
パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=isCurated==1;province==US-CA sort=gender,ageGroup
共有に関する指標(動画が共有されているサービス別に集計)
このリクエストによって、ユーザーがコンテンツ所有者がアップロードした動画を共有するために Share
ボタンを使用した回数が取得されます。結果は共有サービス別(Google+、Twitter など)に集計され、共有回数の降順に並べ替えられます。
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
動画の視聴者維持率の指標
このレポートでは、視聴者維持率を測定できます。このレポートは、一度に 1 つの動画についてのみ取得できます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 VIDEO_ID
を、アップロード済みのいずれかの動画の動画 ID に置き換える必要があります。なお、視聴者維持率レポートでは、video
フィルタに複数の値を指定することはできません。
この例では、audienceType
フィルタを使用してレスポンスを制限しています。オーガニック検索とは、動画の検索や関連動画のクリックなどの直接的なユーザー アクションの結果であるオーガニック ビューのデータのみが含まれるようにすることです。そのため、TrueView インストリーム広告または TrueView インディスプレイ広告の視聴回数のデータは含まれません。フィルタを削除すると、すべての視聴者タイプから動画の視聴者維持率データを取得できます。
audienceType
フィルタのデータは 2013 年 9 月 25 日現在ご利用可能です。この API は、フィルタを使用して過去の日付からデータを取得するクエリのデータを返しません。フィルタを使用していないクエリは、2008 年 7 月 1 日以降であれば機能します。
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
申し立てが行われたコンテンツの収益と広告のパフォーマンス指標
このリクエストでは、コンテンツ所有者が申し立てを行ったコンテンツの収益と広告のパフォーマンス指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
1 日の収益と広告の掲載結果に関する指標
このリクエストでは、コンテンツ所有者が申し立てを行ったコンテンツの 1 日の収益と広告のパフォーマンス指標を取得します。
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
国別の収益と広告の掲載結果に関する指標
このリクエストでは、コンテンツ所有者が申し立てを行ったコンテンツについて、国別の収益と広告のパフォーマンス指標を取得します。結果は収益額の降順で並べ替えられます。つまり、推定収益が最も高い国がリストに表示されます。
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
トップ 10 – 収益が最も多い動画
このリクエストにより、コンテンツ所有者が申し立てを行って収益が最も高かった 10 本の動画の収益と広告のパフォーマンス指標が取得されます。結果は収益額の降順で並べ替えられます。つまり、推定収益が最も高い動画が最初の動画になります。
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
広告タイプ別の広告の掲載結果の指標
このリクエストは、コンテンツ所有者によって申し立てが行われたコンテンツの広告の掲載結果に関する指標を取得します。結果は広告タイプ別にグループ化されるため、収益と CPM の値をさまざまな広告タイプ間で比較できます。
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType