このページでは、YouTube Analytics API リクエストの例を紹介します。それぞれの例では、取得するレポートの簡単な説明を説明し、対応する dimensions
、metrics
、filters
、sort
のパラメータ値を表示します。(API がサポートするレポートは、チャンネル レポートとコンテンツ所有者レポートのドキュメントに記載されています)。
各サンプルは、Google APIs Explorer にリンクされ、表示されている値で構成されています。また、この例ではデフォルトの開始日と終了日(YYYY-MM-DD
)の 2023-09-01
と 2024-03-31
を使用しています。
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
再生リストレポート
チャンネルの合計再生リスト視聴回数
このリクエストは、認証済みユーザーのチャンネルに含まれる再生リストの合計開始数、推定再生時間(分)、視聴回数(動画の集計指標)、再生リストの視聴回数(再生リスト内指標)、再生リスト開始あたりの視聴回数を取得します。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
特定の再生リストの統計情報
このリクエストは、特定の再生リストについて、再生リストの合計開始数、推定再生時間(分)、視聴回数(動画の集計指標)、再生リストの視聴回数(再生リスト内指標)、再生リスト開始あたりの視聴回数を取得します。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 PLAYLIST_ID
を、認証されたユーザーのチャンネルの再生リストの再生リスト ID に置き換える必要があります。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
複数の再生リストの集計データを取得するには、文字列 PLAYLIST_ID
を、認証されたユーザーのチャンネル内の再生リスト ID(最大 500 個)のカンマ区切りのリストに置き換えることもできます。
トップ 10 – チャンネルで特に視聴された再生リスト
このクエリは、指定した期間内の再生リストの視聴回数によって測定された、チャンネルで特に視聴された上位 10 件の再生リストを取得します。また、視聴者が各再生リストの再生を開始した回数や、再生開始後に視聴者が再生リスト内の動画を視聴した平均時間など、再生リストの他の指標も取得します。結果は再生リストの視聴回数の降順で表示されます。
注: このレポートでは playlist
ディメンションを使用するため、sort
リクエスト パラメータの値を指定し、maxResults
パラメータを 10
以下の整数値に設定する必要があります。
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
動画レポート
チャンネルの動画の日別再生時間の指標
このクエリは、チャンネルの動画の 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,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart 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 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,playlistViews sort=-playlistStarts
各再生場所における 1 日の再生リストの視聴回数と総再生時間
このクエリは、毎日の再生リストの開始数、視聴回数(動画の集計指標)、再生リストの視聴回数(再生リスト内の指標)、特定のチャンネルの再生リストについて、米国内での推定総再生時間を取得します。結果は、再生リストの再生が発生したページまたはアプリケーションのタイプごとに日別にグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=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,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
さまざまなトラフィック ソースからの 1 日の再生リストの視聴回数と総再生時間
このリクエストは、チャンネルの 1 日あたりの再生リスト視聴回数(再生リスト内指標)、再生リストの開始時刻、推定総再生時間を取得します。また、合計視聴回数(動画の集計指標)も取得します。 各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews 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,playlistViews filters=operatingSystem==ANDROID sort=day
モバイル デバイスでの再生リスト表示に関するオペレーティング システムの日次指標
このクエリは、モバイル デバイスで特定のチャンネルの再生リストについて、1 日の視聴回数(動画の集計指標)、再生リストの視聴回数(再生リスト内の指標)、推定総再生時間を取得します。結果は、再生リストが視聴されたオペレーティング システムごとに日別にグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
動画レポート
カリフォルニア州の視聴者のユーザー属性(年齢層と性別)
このレポートでは、チャンネルの動画を視聴したカリフォルニア州の視聴者の年齢層と性別に関する統計情報を取得します。結果は性別で、次に年齢層の順に並べ替えられます。このクエリは、filters
パラメータ値を調整することで、世界中のすべての視聴者、またはある国、大陸、亜大陸、米国の別の州にいるすべての視聴者について、同じ統計情報を取得するように変更できます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
再生リストレポート
カリフォルニア州の再生リストの視聴者層(年齢層と性別)
このレポートでは、チャンネルの再生リストを視聴したカリフォルニア州の視聴者の年齢層と性別に関する統計情報を取得します。結果は性別で、次に年齢層の順に並べ替えられます。このクエリは、filters
パラメータ値を調整することで、世界中のすべての視聴者、またはある国、大陸、亜大陸、米国の別の州にいるすべての視聴者について、同じ統計情報を取得するように変更できます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=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
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
トップ 10 – チャンネルで特に視聴された動画のアノテーションのクリック率
このリクエストは、指定されたチャンネルまたはチャンネル グループで最も再生回数の多い 10 件の動画の視聴回数、アノテーションのクリック率、アノテーションのクローズ率、アノテーションのインプレッション数を取得します。結果は視聴回数の降順で並べ替えられます。つまり、視聴回数の多い動画が最初に表示されます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
再生リストレポート
コンテンツ所有者のチャンネルの再生リストの視聴回数
このリクエストは、コンテンツ所有者のチャンネルの再生リストについて、再生リストの合計開始数、推定再生時間(分)、再生リストの視聴回数、再生リスト開始あたりの視聴回数を取得します。playlistViews
指標は、再生リスト内で発生した動画再生回数のみをカウントします。リクエストする指標はすべて再生リスト内の指標であるため、リクエストに再生リストまたはグループ フィルタを含める必要はありません。
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
特定の再生リストの統計情報
このリクエストは、特定の再生リストについて、再生リストの合計開始数、推定再生時間(分)、視聴回数(動画の集計指標)、再生リストの視聴回数(再生リスト内指標)、再生リスト開始あたりの視聴回数を取得します。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 PLAYLIST_ID
を、コンテンツ所有者のチャンネルにある再生リストの再生リスト ID に置き換える必要があります。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
複数の再生リストの集計データを取得するには、文字列 PLAYLIST_ID
を、コンテンツ所有者のチャンネル内の再生リスト ID 最大 500 件のカンマ区切りのリストに置き換えることもできます。
動画レポート
自身がアップロードしたコンテンツの日別再生時間の指標
このクエリは、コンテンツ所有者がアップロードした動画の 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 日あたりの再生リストの視聴回数
このリクエストは、コンテンツ所有者の再生リスト内の動画に対するユーザーの日々のインタラクションの指標を取得します。レポートで取得される指標は、playlistViews、playlistStarts、playlistEstimatedMinutesWatched、viewsPerPlaylistStart です。これらの指標はすべてプレイリスト内指標です。リクエストする指標はすべて再生リスト内の指標であるため、リクエストに再生リストまたはグループ フィルタを含める必要はありません。
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart 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 都市
このクエリは、コンテンツ所有者が申し立てを行ったコンテンツの 1 日の合計総再生時間が、指定した日付範囲の上位 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=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
トップ 10 – 米国で最も開始されたプレイリスト
このクエリは、指定した期間内に米国の視聴者が最も頻繁に視聴し始めた 10 件の再生リストをコンテンツ所有者のチャンネルから取得します。結果は、再生リストの開始数の降順で並べ替えられます。
注: このレポートでは playlist
ディメンションを使用するため、sort
リクエスト パラメータの値を指定するとともに、maxResults
パラメータを 10
以下の整数値に設定する必要があります。
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
動画レポート
コンテンツ タイプ別の高評価と低評価
このクエリは、特定のチャンネルまたはチャンネル グループのコンテンツ タイプごとに高評価と低評価の数を取得します。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
動画レポート
各再生場所における再生回数と再生時間
このクエリは、特定のチャンネルまたはチャンネル グループにアップロードされた動画の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションのタイプに基づいて集計され、視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
さまざまな視聴場所での 1 日の視聴回数と総再生時間
このクエリは、特定のチャンネルまたはチャンネル グループにアップロードされた動画の 1 日あたりの視聴回数と推定総再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類ごとに、日別でグループ化されます。結果は新しい順に並べ替えられます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
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=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
さまざまな再生場所での再生リストの視聴回数と総再生時間
このクエリは、コンテンツ所有者のチャンネル内のすべての再生リストについて、米国における 1 日の再生リストの開始数、再生リストの視聴回数、再生リストの推定総再生時間を取得します。結果は、再生リストの表示が発生したページまたはアプリケーションのタイプごとに返されます。
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
動画レポート
トラフィック ソース別の再生回数および再生時間
このリクエストは、コンテンツ所有者の動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。
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=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
さまざまなトラフィック ソースからの再生リストの視聴回数と総再生時間
このリクエストは、1 つ以上のコンテンツ所有者のチャンネルに含まれる再生リストについて、再生リストの視聴回数、再生リストの開始回数、再生リストの推定総再生時間を取得します。この指標はトラフィック ソースごとに集計されます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
動画レポート
申し立てが行われた動画の端末のタイプに関する日別の指標
このクエリは、特定のコンテンツ所有者によって申し立てが行われている動画の 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 オペレーティング システムでの再生リスト表示のデバイスタイプ指標
このクエリは、1 つ以上のコンテンツ所有者のチャンネルの再生リストについて、Android デバイスで再生リストの視聴回数と推定総再生時間を取得します。結果は、再生リストを視聴したデバイスのタイプごとに返されます。API Explorer でこのクエリを実行するには、filters
パラメータ値の文字列 CHANNEL_ID
を、チャンネルの ID(最大 500 個)のカンマ区切りのリストに置き換える必要があります。
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
モバイル デバイスでの再生リスト視聴に関するオペレーティング システムの指標
このクエリは、コンテンツ所有者のチャンネルにある再生リストについて、モバイル デバイスでの再生リスト視聴回数と推定総再生時間を取得します。結果は、再生リストが視聴されたオペレーティング システムごとに返されます。
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
動画レポート
カリフォルニア州の視聴者のユーザー属性(年齢層と性別)
このレポートは、コンテンツ所有者が申し立てたコンテンツを視聴したカリフォルニア州の視聴者の年齢層と性別に関する統計情報を取得します。結果は性別で、次に年齢層の順に並べ替えられます。このクエリは、filters
パラメータ値を調整することで、世界中のすべての視聴者、またはある国、大陸、亜大陸、米国の別の州にいるすべての視聴者について、同じ統計情報を取得するように変更できます。
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;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 日の収益と広告のパフォーマンスに関する指標
このリクエストは、コンテンツ所有者が申し立てを行ったコンテンツの日次収益と広告パフォーマンスの指標を取得します。
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