Przykładowe żądania do interfejsu API

Ta strona zawiera przykładowe żądania do YouTube Analytics API. Każdy przykład krótko opisuje pobieranie raportu, a potem pokazuje odpowiednie wartości parametrów dimensions, metrics, filters i sort. (Raporty kanałów i właścicieli treści identyfikują raporty obsługiwane przez interfejs API).

Każdy przykład zawiera link do wyświetlanej zawartości interfejsu Google API i wypełnia ją wyświetlanymi wartościami. W tych przykładach stosowane są też domyślne daty rozpoczęcia i zakończenia (YYYY-MM-DD) dla znaczników 2022-01-01 i 2022-06-30.

Po połączeniu z eksploratorem interfejsów API musisz określić kanał lub właściciela treści, dla których chcesz pobierać raporty. W zależności od klikniętego zapytania eksplorator interfejsów API wypełni wartość parametru ids channel==MINE lub contentOwner==CONTENT_OWNER_ID. W raportach dotyczących kanałów możesz zmienić MINE na identyfikator kanału uwierzytelnionego użytkownika. W przypadku raportów właściciela treści musisz zastąpić CONTENT_OWNER_ID swoim identyfikatorem właściciela treści.

Aby eksplorator interfejsów API mógł autoryzować żądania do interfejsu API za pomocą OAuth 2.0, musisz też uwierzytelnić się jako określony kanał lub właściciel treści.

  1. Sortowanie żądań według wielu wymiarów/danych
  2. Raporty kanału
  3. Raporty właścicieli treści

Sortowanie żądań według wielu wymiarów/danych

Interfejs API obsługuje możliwość sortowania danych odpowiedzi przy użyciu wielu wymiarów lub danych. W poniższym żądaniu pobiera się dzienne dane o źródłach wizyt dla filmów na danym kanale. Każdy wiersz zestawu wyników określa liczbę wyświetleń oraz szacowany czas oglądania, który pochodzi z określonego typu ruchu (np. EXT_URL) w danym dniu.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

W odpowiedzi wyniki są sortowane chronologicznie. Wyniki w każdym zbiorze są sortowane malejąco według liczby wyświetleń. Pierwszy wiersz w zestawie wyników zawiera więc dane o źródle wizyt, które wygenerowało najwięcej wyświetleń pierwszego dnia w wybranym zakresie dat. Drugi wiersz zawiera dane źródła wizyt, które pierwszego dnia wygenerowały najwięcej wyświetleń.

Raporty kanału

Podstawowe statystyki

Raporty na temat filmów

Łączna liczba wyświetleń, szacowany czas oglądania i inne dane dla kanału

To zapytanie pobiera zbiorcze dane dotyczące treści na kanale. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Liczba wyświetleń kanału w danym kraju (i inne)

To zapytanie pobiera dane dotyczące filmów na kanale w konkretnym kraju. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

10 najpopularniejszych filmów – najczęściej oglądane filmy na kanale

Pobiera ono 10 najczęściej oglądanych filmów z kanału, określone na podstawie szacowanego czasu oglądania w wybranym zakresie dat. Wyniki są sortowane według szacowanego czasu oglądania (malejąco).

Uwaga: w tym raporcie musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

10 najpopularniejszych filmów – współczynniki klikalności adnotacji dotyczących najczęściej oglądanych filmów na kanale

Tutaj wyświetlana jest liczba wyświetleń, współczynnik klikalności adnotacji, współczynnik zamykania adnotacji i wyświetlenia adnotacji w 10 najczęściej oglądanych filmach na kanale. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej, co oznacza, że na początku listy wyświetli się najczęściej oglądany film.

Uwaga: w tym raporcie musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Raporty dotyczące playlist

Łączna liczba wyświetleń playlisty kanału

To żądanie pobiera łączną liczbę początków playlisty, szacowany czas oglądania, wyświetlenia i liczbę wyświetleń na rozpoczęcie playlisty, jeśli chodzi o playlisty w kanale uwierzytelnionego użytkownika. Dane views uwzględniają tylko wyświetlenia filmów, które miały miejsce w kontekście playlisty.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Statystyki dotyczące określonej playlisty

To żądanie obejmuje łączną liczbę początków playlisty, szacowany czas oglądania, wyświetlenia i liczbę wyświetleń na początek playlisty w przypadku konkretnej playlisty. Dane views uwzględniają tylko wyświetlenia filmów, które miały miejsce w kontekście playlisty. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg PLAYLIST_ID w wartości parametru filters identyfikatorem playlisty z kanału uwierzytelnionego użytkownika.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Aby pobrać zbiorcze statystyki wielu playlist, możesz też zastąpić ciąg znaków PLAYLIST_ID listą rozdzielonych przecinkami identyfikatorów maksymalnie 500 identyfikatorów playlist w kanale uwierzytelnionego użytkownika.

10 najpopularniejszych filmów – najczęściej oglądane playlisty na kanale

Pobiera ono 10 najczęściej oglądanych playlist na kanale, szacowane w minutach w określonym zakresie dat. Pobiera też kilka innych danych dotyczących playlisty, np. ile razy odbiorcy zainicjowali odtwarzanie każdej z playlist oraz średni czas oglądania filmów przez tę playlistę po jej rozpoczęciu. Wyniki są sortowane według szacowanego czasu oglądania (malejąco).

Uwaga: ten raport używa wymiaru playlist, dlatego musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
Ograniczony czasowo

Raporty na temat filmów

Dzienne wskaźniki czasu oglądania filmów na kanale

To zapytanie pobiera dzienne wyświetlenia, dane o czasie oglądania i nowe liczby subskrybentów filmów w Twoim kanale. Raport zwróci po jednym wierszu danych dla każdego dnia w wybranym zakresie dat. Wiersze są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Dzienne wskaźniki adnotacji w filmach na kanale

Zawiera ona informacje o dziennej liczbie wyświetleń, współczynniku klikalności adnotacji, współczynniku zamykania adnotacji i wyświetleniach adnotacji w przypadku treści kanału. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Raporty dotyczące playlist

dzienne wyświetlenia playlisty na kanale,

To żądanie pobiera dzienną liczbę wyświetleń, rozpoczęcia playlisty, szacowany czas oglądania i liczbę wyświetleń na początek playlisty na kanale uwierzytelnionego użytkownika. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Położenie geograficzne

Raporty na temat filmów

Wskaźniki czasu oglądania filmów na danym kraju

To zapytanie pobiera informacje o liczbie wyświetleń dla danego kraju, danych o czasie oglądania i danych dotyczących subskrypcji kanału. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym były oglądane filmy z kanału. Wiersze są posortowane w kolejności malejącej według liczby obejrzanych minut.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Dane dotyczące adnotacji do filmów na kanale w poszczególnych krajach

Tutaj pojawiają się liczby wyświetleń filmów, współczynnik klikalności adnotacji, współczynnik zamykania adnotacji i liczba wyświetleń adnotacji dla poszczególnych filmów w danym kraju. Wyniki są posortowane według współczynnika klikalności adnotacji w kolejności malejącej. Oznacza to, że na liście znajduje się kraj o najwyższym współczynniku klikalności adnotacji.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Dane dotyczące prowincji w stanach USA i Waszyngtonie

Pobiera ono zestawienie danych na temat wyświetleń w poszczególnych prowincjach, liczby wyświetleń, szacowanego czasu oglądania i średniego czasu oglądania filmów na kanale. Dane obejmują stany USA i Waszyngton D.C. Wyniki są sortowane alfabetycznie według kodów ISO 3166-2 prowincji.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 najpopularniejszych filmów – najczęściej wyświetlane filmy w danym kraju

Pobiera ono 10 najczęściej oglądanych filmów z kanału, mierzone za pomocą liczby wyświetleń w określonym zakresie dat w wybranym kraju. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

Uwaga: w tym raporcie musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 największych miast w USA według łącznej liczby wyświetleń

Pobiera ono listę 10 miast w Stanach Zjednoczonych, które wygenerowały najwięcej wyświetleń treści na kanale w określonym zakresie dat. Zapytanie można zmodyfikować tak, by żądało danych z innego kraju, wybierając inną prawidłową wartość tego filtra. Podobnie zapytanie może zostać zmodyfikowane w celu pobrania danych o subkontynentach, takich jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra SubContinent i jednej z jego prawidłowych wartości. Inne filtry też są obsługiwane. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

10 miast w USA według łącznej liczby wyświetleń dla każdego typu treści

Zawiera ono listę 10 miast w Stanach Zjednoczonych, które wygenerowały najwięcej wyświetleń treści na kanale w określonym zakresie dat dla każdego obsługiwanego typu creatorContentType. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 największych miast w USA według łącznego czasu oglądania

To zapytanie pobiera listę 10 pierwszych dni z wybranego zakresu dat, w którym dowolne miasto w USA wygenerowało najwyższy łączny czas oglądania treści na kanale. Wyniki wyszukiwania podają łączny czas oglądania, datę i godzinę wyświetlenia filmu oraz miasto, w którym według szacunków film został obejrzany. Wyniki są posortowane w porządku malejącym według łącznego czasu oglądania.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

10 najpopularniejszych filmów – najczęściej oglądanych w Europie

Pobiera ono 10 najczęściej oglądanych filmów z Europy, mierzone na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować tak, by żądało danych z innego kontynentu, wybierając inną prawidłową wartość tego filtra. Podobnie zapytanie może zostać zmodyfikowane w celu pobrania danych o subkontynentach, takich jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra SubContinent i jednej z jego prawidłowych wartości. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

Uwaga: w tym raporcie musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Raporty dotyczące playlist

Dane dotyczące czasu oglądania w poszczególnych krajach dotyczące playlist na kanale

To zapytanie pobiera liczbę wyświetleń w danym kraju i dane o czasie oglądania playlist na kanale. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym oglądano playlisty na kanale. Wiersze są posortowane w kolejności malejącej według liczby obejrzanych minut.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

10 najlepszych playlist w Stanach Zjednoczonych

Pobiera ono 10 playlist, które widzowie z USA najczęściej oglądali w wybranym okresie. Wyniki są sortowane według liczby rozpoczęcia playlisty w porządku malejącym.

Uwaga: ten raport używa wymiaru playlist, dlatego musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Lokalizacja odtwarzania

Raporty na temat filmów

Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie sprawdza liczbę wyświetleń oraz szacowany czas oglądania filmów na danym kanale. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której zostały odtworzone filmy, a wyniki są sortowane malejąco według liczby wyświetleń.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie sprawdza dzienną liczbę wyświetleń i szacowany czas oglądania filmów z danego kanału w Stanach Zjednoczonych. Wyniki są grupowane według dnia dla poszczególnych typów stron lub aplikacji, w których przypadku były odtwarzane. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

10 najpopularniejszych witryn – zewnętrzne witryny, które generują najwięcej wyświetleń umieszczonego filmu

To zapytanie pobiera liczbę wyświetleń i szacowany czas oglądania określonego filmu lub grupy filmów. Wyniki są grupowane według witryny zewnętrznej, w której film został umieszczony. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters rozdzielaną przecinkami listą co najmniej jednego identyfikatora przesłanego filmu.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Raporty dotyczące playlist

Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania

To zapytanie pobiera liczbę wyświetleń, szacowany czas oglądania i początki playlisty z konkretnego kanału. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której zostały odtworzone filmy. Wyniki są posortowane w kolejności malejącej według rozpoczęcia playlisty.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Dzienna liczba wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania

To zapytanie pobiera dzienne odtworzenia playlist, liczbę wyświetleń i szacowany czas oglądania w przypadku Stanów Zjednoczonych w przypadku playlist z konkretnego kanału. Wyniki są grupowane według dnia dla poszczególnych typów stron lub aplikacji, w których zostały wyświetlone wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Szczegóły odtwarzania

Raporty na temat filmów

Oceny „Podoba mi się” i „Nie podoba mi się” według typu treści

To zapytanie pobiera liczbę ocen pozytywnych i negatywnych dla każdego typu treści na kanale.

dimensions=creatorContentType
metrics=likes,dislikes
Źródło wizyt

Raporty na temat filmów

Liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt w danym kraju

Pobiera ona liczbę wyświetleń i szacowany czas oglądania filmów na kanale w danym kraju. Dane są agregowane według źródła wizyt i opisują sposób, w jaki użytkownicy dotarli do filmu.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Dzienna liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt

To żądanie pobiera dzienną liczbę wyświetleń i dzienny szacowany czas oglądania filmów na kanale. Dane są agregowane codziennie według źródła wizyt i sortowane w kolejności chronologicznej.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 najpopularniejszych filmów – wyszukiwane w YouTube słowa, które generują największy ruch w przypadku danego filmu

Pobiera ono 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń wyników wyszukiwania filmów w YouTube. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą rozdzielonych przecinkami maksymalnie 500 identyfikatorów wideo.

Możesz na przykład wpisać zapytanie dotyczące jednego filmu lub zastąpić VIDEO_ID, by zobaczyć, które wyszukiwane hasła generują najwięcej wizyt dla tego filmu. Możesz też wymienić wszystkie filmy na danej playliście, aby określić, które wyszukiwane słowa generują najwięcej ruchu dla znajdujących się na niej filmów.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 najpopularniejszych – zewnętrzne witryny, które generują największy ruch dla filmu

Pobiera ono 10 stron zewnętrznych, które przyniosły najwięcej wyświetleń dla danego filmu lub grupy filmów. Wyniki są sortowane według szacowanego czasu oglądania, w porządku malejącym. Pamiętaj, że aby uruchomić to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów filmów przesyłanych przez Ciebie.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Raporty dotyczące playlist

Liczba wyświetleń i czas oglądania playlisty z różnych źródeł wizyt w danym kraju

Pobiera ona liczbę wyświetleń playlisty, rozpoczęcia playlisty i szacowany czas oglądania takich filmów w danym kraju. Dane są agregowane według źródła wizyt i opisują sposób, w jaki użytkownicy trafiają na playlistę.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

Dzienna liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

Żądanie pobiera liczbę dziennych wyświetleń playlisty kanału, rozpoczęcia playlisty i szacowanego czasu oglądania. Dane są agregowane codziennie według źródła wizyt i sortowane w kolejności chronologicznej.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
sort=day
Urządzenie/system operacyjny

Raporty na temat filmów

Dzienne dane typu urządzenia z systemem operacyjnym Android

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania na urządzeniach z Androidem, na których znajdują się filmy z danego kanału. Wyniki są grupowane według dnia dla każdego typu urządzeń, na których były odtwarzane filmy. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Dzienne dane systemu operacyjnego na urządzenia mobilne

To zapytanie sprawdza dzienną liczbę wyświetleń i szacowany czas oglądania na urządzeniach mobilnych w przypadku filmów z danego kanału. Wyniki są grupowane według dnia każdego systemu operacyjnego, w którym były odtwarzane filmy. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Dzienne wskaźniki systemu operacyjnego i typu urządzenia

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania kanału. Statystyki są pogrupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Raporty dotyczące playlist

Dzienne dane typu urządzenia w przypadku wyświetleń playlisty w systemie operacyjnym Android

To zapytanie pobiera dzienną liczbę wyświetleń playlist i szacowany czas oglądania na urządzeniach z Androidem w przypadku playlist z konkretnego kanału. Wyniki są grupowane według dnia według urządzeń, na których wyświetlono playlistę. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;operatingSystem==ANDROID
sort=day

Dzienne dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń playlist i szacowany czas oglądania na urządzeniach mobilnych w przypadku playlist z konkretnego kanału. Wyniki są grupowane według dnia każdego systemu operacyjnego, w którym zostały zarejestrowane wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
Dane demograficzne

Raporty na temat filmów

Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)

Zawiera on statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy oglądali filmy prezentowane na kanale. Wyniki są sortowane według płci, a następnie według grupy wiekowej. Dzięki temu można zmienić te same dane dla wszystkich widzów z całego świata, wszystkich kontynentów, subkontynentów lub innych stanów USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Raporty dotyczące playlist

Dane demograficzne użytkowników playlisty w Kalifornii (grupa wiekowa i płeć)

Ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy oglądali playlisty na kanale. Wyniki są sortowane według płci, a następnie według grupy wiekowej. Dzięki temu można zmienić te same dane dla wszystkich widzów z całego świata, wszystkich kontynentów, subkontynentów lub innych stanów USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Społeczności

Wskaźniki udostępniania, pogrupowane według usługi, w której udostępniono filmy

Tutaj znajduje się liczba pobrań filmu z kanału za pomocą przycisku Share. Wyniki są agregowane według usługi udostępniania (Google+, Twitter itp.) i sortowane malejąco według liczby udostępnień.

dimensions=sharingService
metrics=shares
sort=-shares
Utrzymanie uwagi odbiorców

Dane dotyczące utrzymania uwagi odbiorców w filmie

Ten raport pokazuje zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla jednego filmu. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem filmu, który został przesłany przez Ciebie. Pamiętaj, że raporty utrzymania uwagi odbiorców nie obsługują określania wielu wartości filtra video.

W tym przykładzie raport używa filtra audienceType, aby ograniczyć odpowiedzi tylko do tych wyświetleń bezpłatnych, które są efektem bezpośrednich działań użytkowników, takich jak wyszukiwanie filmu czy kliknięcie sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach z reklam TrueView In-Stream ani TrueView In-Display. Możesz usunąć filtr, aby pobrać dane o utrzymaniu uwagi odbiorców filmu ze wszystkich typów odbiorców.

Pamiętaj, że dane filtra audienceType są dostępne od 25 września 2013 roku. Interfejs API nie będzie zwracać danych dla zapytań, które korzystają z filtra do próby pobrania danych z wcześniejszych dat. Zapytania bez filtra działają po dowolnej dacie po 1 lipca 2008 roku.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Przychody/reklamy

Dane o przychodach kanału i skuteczności reklam

To żądanie pobiera dane o przychodach i skuteczności reklam kanału. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Dzienne dane o przychodach i skuteczności reklam

To żądanie pobiera dzienne dane dotyczące przychodów kanału i skuteczności reklam.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Dane o przychodach i skuteczności reklam w poszczególnych krajach

Pobiera z niego dane o przychodach i skuteczności reklam w poszczególnych krajach. Wyniki są posortowane w kolejności malejącej według kwoty przychodów. Oznacza to, że partner, który znalazł się na pierwszym miejscu, ma największy przychód netto.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

10 najpopularniejszych filmów – największe przychody

Pobiera dane o przychodach i skuteczności reklam w 10 filmach z największymi przychodami. Wyniki są posortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy film będzie filmem o najwyższych szacunkowych przychodach.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Dane o skuteczności różnych typów reklam

Pobiera ono dane o skuteczności reklam dotyczące treści objętych roszczeniem właściciela treści. Wyniki są pogrupowane według typu reklamy, co umożliwia porównywanie przychodów i wartości CPM dla różnych typów reklam.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Raporty właściciela treści

Podstawowe statystyki

Raporty na temat filmów

Łączna liczba wyświetleń, szacowany czas oglądania i inne dane dotyczące wszystkich treści objętych roszczeniem

To zapytanie pobiera zbiorcze dane treści objętych roszczeniem właściciela treści. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Liczba wyświetleń dla wszystkich filmów przesłanych w danym kraju (i inne)

To zapytanie pobiera dane dotyczące określonego kraju dla filmów przesłanych przez właściciela treści. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Łączna liczba wyświetleń (i nie tylko) wszystkich treści osób trzecich, do których zgłoszono roszczenie

To zapytanie pobiera zbiorcze dane dotyczące filmów, do których właściciel treści zgłosił roszczenie, ale ich nie przesłał. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Łączna liczba wyświetleń (i nie tylko) wszystkich treści przesłanych przez Ciebie

To zapytanie pobiera zbiorcze dane o filmach przesłanych przez właściciela treści. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Łączna liczba wyświetleń (i inne dane) wszystkich treści objętych roszczeniem

To zapytanie pobiera zbiorcze dane o filmach, które właściciel treści przesłał i do którego zgłosił również roszczenie. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

10 najpopularniejszych filmów – najczęściej oglądane filmy przez właściciela treści

Pobiera ono 10 najczęściej oglądanych filmów, które mierzy się liczbą wyświetleń w określonym zakresie dat, przesłanych przez właściciela treści. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

10 najpopularniejszych filmów – najczęściej oglądane filmy przez właściciela treści

Pobiera ono 10 filmów najczęściej oglądanych w określonym zakresie dat (czyli minuty) przesłane przez właściciela treści. Wyniki są sortowane według szacowanego czasu oglądania (malejąco).

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

10 najpopularniejszych filmów – najczęściej oglądane filmy na kanale właściciela treści

Pobiera ono 10 najczęściej oglądanych filmów z danego kanału lub grupy kanałów, którymi zarządza właściciel treści. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

10 najpopularniejszych filmów – współczynniki klikalności adnotacji dotyczących najczęściej oglądanych filmów na kanale

W ramach tego żądania pobierana jest liczba wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji i wyświetlenia adnotacji w 10 najczęściej oglądanych filmach na określonym kanale lub grupie kanałów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej, co oznacza, że na początku listy wyświetli się najczęściej oglądany film. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Raporty dotyczące playlist

Wyświetlenia playlist na kanałach właściciela treści

Otrzymane żądanie obejmuje łączną liczbę początków playlisty, szacowany czas oglądania, liczbę wyświetleń i liczbę wyświetleń na rozpoczęcie playlisty w przypadku kanałów należących do właściciela treści. Dane views uwzględniają tylko wyświetlenia filmów, które miały miejsce w kontekście playlisty.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Liczba wyświetleń playlisty konkretnego kanału

Otrzymane żądanie obejmuje łączną liczbę początków playlisty, szacowany czas oglądania, liczbę wyświetleń i liczbę wyświetleń na rozpoczęcie playlisty w przypadku kanałów należących do właściciela treści. Dane views uwzględniają tylko wyświetlenia filmów, które miały miejsce w kontekście playlisty. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

Statystyki playlisty

To żądanie obejmuje łączną liczbę początków playlisty, szacowany czas oglądania, wyświetlenia i liczbę wyświetleń na początek playlisty w przypadku konkretnej playlisty. Dane views uwzględniają tylko wyświetlenia filmów, które miały miejsce w kontekście playlisty. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg PLAYLIST_ID w wartości parametru filters identyfikatorem playlisty z jednego z kanałów właściciela treści.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Aby pobrać zbiorcze statystyki wielu playlist, możesz też zastąpić ciąg PLAYLIST_ID listą rozdzielonych przecinkami identyfikatorów maksymalnie 500 identyfikatorów playlist z kanałów właściciela treści.

10 najpopularniejszych – najczęściej oglądane playlisty właściciela treści

Pobiera ono 10 najczęściej oglądanych playlist właściciela treści, które są szacowane w przybliżeniu w wybranym zakresie dat. Pobiera też kilka innych danych dotyczących playlisty, np. ile razy odbiorcy zainicjowali odtwarzanie każdej z playlist oraz średni czas oglądania filmów przez tę playlistę po jej rozpoczęciu. Wyniki są sortowane według szacowanego czasu oglądania (malejąco).

Uwaga: ten raport używa wymiaru playlist, dlatego musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
Ograniczony czasowo

Raporty na temat filmów

Dzienne wskaźniki czasu oglądania treści przesłanych samodzielnie

To zapytanie pobiera dzienne dane dotyczące czasu oglądania oraz liczby wyświetleń, liczby odtworzeń generujących przychody i liczbę wyświetleń filmów przesłanych przez właściciela treści. Raport zawiera po jednym wierszu danych dla każdego dnia w wybranym zakresie dat, a wiersze są sortowane w kolejności chronologicznej.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Dane dotyczące adnotacji do treści objętych roszczeniem

To żądanie pobiera dzienną liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji i wyświetlenia adnotacji w przypadku treści objętych roszczeniem właściciela treści. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Raporty dotyczące playlist

Dzienne wyświetlenia playlist właściciela treści

Zawiera ona informacje o dziennej liczbie wyświetleń, początkach odtwarzania playlisty, szacowanym czasie oglądania i wyświetleniach każdej playlisty z kanałów właściciela treści. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Położenie geograficzne

Raporty na temat filmów

Wskaźniki czasu oglądania dotyczące treści przesłanych samodzielnie

To zapytanie pobiera liczbę wyświetleń, dane o czasie oglądania i szacunkowe przychody z reklam dla każdego kraju. Dane dotyczą filmów przesłanych przez właściciela treści. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym filmy były oglądane, a ich wiersze są posortowane w kolejności malejącej według liczby obejrzanych minut.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Wskaźniki adnotacji dla poszczególnych filmów w poszczególnych krajach

Zawiera ono informacje na temat liczby wyświetleń adnotacji, współczynników klikalności, liczby zamykających adnotacji i wyświetleń adnotacji w poszczególnych krajach przesłanych przez właściciela treści. Wyniki są posortowane według współczynnika klikalności adnotacji w kolejności malejącej. Oznacza to, że na liście znajduje się kraj o najwyższym współczynniku klikalności adnotacji.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Dane dotyczące prowincji w stanach USA i Waszyngtonie

Pobiera ono zestawienie danych na temat wyświetleń w poszczególnych prowincjach, liczby wyświetleń, szacowanego czasu oglądania i średniego czasu oglądania filmów objętych roszczeniem właściciela treści. Dane obejmują stany USA i Waszyngton D.C. Wyniki są sortowane alfabetycznie według kodów ISO 3166-2 prowincji.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 największych miast w USA według łącznej liczby wyświetleń

Pobiera ono listę 10 miast w Stanach Zjednoczonych, które w wybranym zakresie dat wygenerowały najwięcej wyświetleń filmów objętych roszczeniem właściciela treści. Zapytanie można zmodyfikować tak, by żądało danych z innego kraju, wybierając inną prawidłową wartość tego filtra. Podobnie zapytanie może zostać zmodyfikowane w celu pobrania danych o subkontynentach, takich jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra SubContinent i jednej z jego prawidłowych wartości. Inne filtry też są obsługiwane. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 miast w USA według łącznej liczby wyświetleń dla każdego typu treści

To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, które wygenerowały najwięcej wyświetleń treści objętych roszczeniem przez właściciela treści w określonym zakresie dat dla każdego obsługiwanego typu creatorContentType. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 największych miast w USA według łącznego czasu oglądania

To zapytanie pobiera listę pierwszych 10 dni z określonego zakresu dat, w którym dowolne miasto w Stanach Zjednoczonych wygenerowało najlepszy łączny czas oglądania treści objętych roszczeniem właściciela treści. Wyniki wyszukiwania podają łączny czas oglądania, datę i godzinę wyświetlenia filmu oraz miasto, w którym według szacunków film został obejrzany. Wyniki są posortowane w porządku malejącym według łącznego czasu oglądania.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 najpopularniejszych filmów – najczęściej oglądanych w Europie

Pobiera ono 10 najczęściej oglądanych filmów w Europie spośród wszystkich filmów objętych roszczeniem właściciela treści. Ta liczba jest mierzona na podstawie liczby wyświetleń w określonym zakresie dat. Zapytanie można zmodyfikować tak, by żądało danych z innego kontynentu, wybierając inną prawidłową wartość tego filtra. Podobnie zapytanie może zostać zmodyfikowane w celu pobrania danych o subkontynentach, takich jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra SubContinent i jednej z jego prawidłowych wartości. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Raporty dotyczące playlist

Dane o czasie oglądania dla playlist właściciela treści

Zapytanie pobiera liczbę wyświetleń w danym kraju i czas oglądania dla wszystkich playlist na kanale właściciela treści. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym były oglądane playlisty. Wiersze są posortowane w kolejności malejącej według liczby obejrzanych minut.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

10 najlepszych playlist w Stanach Zjednoczonych

Zawiera ono 10 playlist z kanałów właściciela treści, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym okresie. Wyniki są sortowane według liczby rozpoczęcia playlisty w porządku malejącym.

Uwaga: ten raport używa wymiaru playlist, dlatego musisz określić wartość parametru żądania sort oraz ustawić wartość maxResults na liczbę całkowitą nie większą niż 10.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Szczegóły odtwarzania

Raporty na temat filmów

Oceny „Podoba mi się” i „Nie podoba mi się” według typu treści

To zapytanie pobiera liczbę ocen pozytywnych i negatywnych dla każdego typu treści na określonym kanale lub w danej grupie kanałów. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
Lokalizacja odtwarzania

Raporty na temat filmów

Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie pozwala sprawdzić liczbę wyświetleń oraz szacowany czas oglądania filmów przesłanych na dany kanał lub grupę kanałów. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której zostały odtworzone filmy, a wyniki są sortowane malejąco według liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania w Stanach Zjednoczonych w przypadku filmów przesłanych na określony kanał lub grupę kanałów. Wyniki są grupowane według dnia dla poszczególnych typów stron lub aplikacji, w których przypadku były odtwarzane. Wyniki są sortowane w odwrotnej kolejności chronologicznej. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

10 najpopularniejszych witryn – zewnętrzne witryny, które generują najwięcej wyświetleń umieszczonego filmu

To zapytanie pobiera liczbę wyświetleń i szacowany czas oglądania określonego filmu lub grupy filmów. Wyniki są grupowane według witryny zewnętrznej, w której film został umieszczony. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów filmów przesyłanych przez Ciebie.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Raporty dotyczące playlist

Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania

To zapytanie pobiera liczbę wyświetleń, szacowany czas oglądania i uruchamianie playlist w przypadku wszystkich playlist na kanałach właściciela treści. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której zostały odtworzone filmy. Wyniki są posortowane w kolejności malejącej według rozpoczęcia playlisty.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Dzienna liczba wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania

To zapytanie pobiera dzienne odtworzenia playlist, liczbę wyświetleń i szacowany czas oglądania w Stanach Zjednoczonych w przypadku wszystkich playlist na kanałach właściciela treści. Wyniki są grupowane według dnia dla poszczególnych typów stron lub aplikacji, w których zostały wyświetlone wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Źródło wizyt

Raporty na temat filmów

Liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt

Zawiera ono informacje o liczbie wyświetleń i szacowanym czasie oglądania filmów właściciela treści. Dane są agregowane według źródła wizyt i opisują sposób, w jaki użytkownicy dotarli do filmu.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Dzienna liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt

To żądanie pobiera dzienną liczbę wyświetleń i dzienny szacowany czas oglądania filmów właściciela treści. Wskaźniki są agregowane codziennie według źródła wizyt i posortowane w odwrotnej kolejności chronologicznej.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Uwaga: kolejne 2 przykładowe raporty są obsługiwane tylko w przypadku określonych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie ma dodatkowych szczegółów i dlatego raporty te nie są dla niego dostępne. Więcej informacji o źródłach wizyt dla tych typów raportów znajdziesz w definicji insightTrafficSourceType.

10 najpopularniejszych filmów – wyszukiwane w YouTube słowa, które generują największy ruch w przypadku danego filmu

Pobiera ono 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń określonego filmu lub grupy filmów w wynikach wyszukiwania w YouTube. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów filmów przesyłanych przez Ciebie.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 najpopularniejszych – zewnętrzne witryny, które generują największy ruch dla filmu

Pobiera ono 10 zewnętrznych witryn, które przyniosły najwięcej wyświetleń określonego filmu lub grupy filmów w wynikach wyszukiwania Google. Wyniki są sortowane według szacowanego czasu oglądania, w porządku malejącym. Pamiętaj, że aby uruchomić to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów filmów przesyłanych przez Ciebie.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Raporty dotyczące playlist

Liczba wyświetleń i czas oglądania playlisty z różnych źródeł wizyt w danym kraju

Pobiera ona liczbę wyświetleń playlisty, rozpoczęcia playlisty i szacowany czas oglądania takich filmów w danym kraju. Dane są agregowane według źródła wizyt i opisują sposób, w jaki użytkownicy trafiają na playlistę.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

Dzienna liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

To żądanie pobiera dzienne wyświetlenia playlisty, rozpoczęcia playlisty oraz szacowany czas oglądania playlist na kanałach co najmniej jednego właściciela treści. Dane są agregowane codziennie według źródła wizyt i sortowane w kolejności chronologicznej. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
Urządzenie/system operacyjny

Raporty na temat filmów

Dzienne dane typu urządzenia w przypadku filmów objętych roszczeniem

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według typu urządzenia, którego dotyczy dany film. Wyniki są grupowane według dnia dla każdego typu urządzeń, na których były odtwarzane filmy. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Dzienne dane systemu operacyjnego dotyczące filmów objętych roszczeniem wyświetlonych na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według systemu operacyjnego dla wyświetleń filmów objętych roszczeniem przez określonego właściciela treści, który miał miejsce na urządzeniach mobilnych. Wyniki są pogrupowane według dni w każdym systemie operacyjnym, w którym były odtwarzane filmy. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Dzienne wskaźniki systemu operacyjnego i typu urządzenia

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów objętych roszczeniem przez danego właściciela treści. Statystyki są pogrupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Raporty dotyczące playlist

Dzienne dane typu urządzenia w przypadku wyświetleń playlisty w systemie operacyjnym Android

To zapytanie pobiera dzienną liczbę wyświetleń playlist i szacowany czas oglądania na urządzeniach z Androidem, w przypadku playlist w co najmniej jednym kanale właściciela treści. Wyniki są grupowane według dnia według urządzeń, na których wyświetlono playlistę. Wyniki są sortowane w kolejności chronologicznej. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters rozdzielaną przecinkami listę maksymalnie 500 identyfikatorów kanałów.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

Dzienne dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń playlist i szacowany czas oglądania na urządzeniach mobilnych w przypadku playlist w dowolnym z kanałów właściciela treści. Wyniki są grupowane według dnia każdego systemu operacyjnego, w którym zostały zarejestrowane wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
Dane demograficzne

Raporty na temat filmów

Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)

Ten raport pobiera statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy oglądali treści objęte roszczeniem. Wyniki są sortowane według płci, a następnie według grupy wiekowej. Dzięki temu można zmienić te same dane dla wszystkich widzów z całego świata, wszystkich kontynentów, subkontynentów lub innych stanów USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Raporty dotyczące playlist

Dane demograficzne użytkowników playlisty w Kalifornii (grupa wiekowa i płeć)

Zawiera on statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy oglądali playlisty na dowolnym kanale właściciela treści. Wyniki są sortowane według płci, a następnie według grupy wiekowej. Dzięki temu można zmienić te same dane dla wszystkich widzów z całego świata, wszystkich kontynentów, subkontynentów lub innych stanów USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Społeczności

Wskaźniki udostępniania, pogrupowane według usługi, w której udostępniono filmy

To żądanie pobiera, ile razy użytkownicy kliknęli przycisk Share, aby udostępnić filmy przesłane przez właściciela treści. Wyniki są agregowane według usługi udostępniania (Google+, Twitter itp.) i sortowane malejąco według liczby udostępnień.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares
Utrzymanie uwagi odbiorców

Dane dotyczące utrzymania uwagi odbiorców w filmie

Ten raport pokazuje zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla jednego filmu. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem filmu, który został przesłany przez Ciebie. Pamiętaj, że raporty utrzymania uwagi odbiorców nie obsługują określania wielu wartości filtra video.

W tym przykładzie raport używa filtra audienceType, aby ograniczyć odpowiedzi tylko do tych wyświetleń bezpłatnych, które są efektem bezpośrednich działań użytkowników, takich jak wyszukiwanie filmu czy kliknięcie sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach z reklam TrueView In-Stream ani TrueView In-Display. Możesz usunąć filtr, aby pobrać dane o utrzymaniu uwagi odbiorców filmu ze wszystkich typów odbiorców.

Pamiętaj, że dane filtra audienceType są dostępne od 25 września 2013 roku. Interfejs API nie będzie zwracać danych dla zapytań, które korzystają z filtra do próby pobrania danych z wcześniejszych dat. Zapytania bez filtra działają po dowolnej dacie po 1 lipca 2008 roku.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Przychody/reklamy

Dane o przychodach i skuteczności reklam w treściach objętych roszczeniem

Pobiera z niego dane o przychodach i skuteczności reklam z treści objętych roszczeniem właściciela treści. Raport zawiera pojedynczy wiersz danych, które zawierają łączne wartości wszystkich żądanych danych w wybranym zakresie dat.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Dzienne dane o przychodach i skuteczności reklam

Zawiera ono dzienne dane o przychodach i skuteczności reklam pochodzące z treści objętych roszczeniem właściciela treści.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Dane o przychodach i skuteczności reklam w poszczególnych krajach

Pobiera z niego dane o przychodach i skuteczności reklam w poszczególnych krajach dla treści objętych roszczeniem właściciela treści. Wyniki są posortowane w kolejności malejącej według kwoty przychodów. Oznacza to, że partner, który jako pierwszy wymieniony na liście, uzyska najwyższe przychody.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

10 najpopularniejszych filmów – największe przychody

Pobiera dane o przychodach i skuteczności reklam z 10 filmów, do których zgłosił prawa właściciel treści i które wygenerowały największe przychody. Wyniki są posortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy film będzie filmem o najwyższych szacunkowych przychodach.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Dane o skuteczności różnych typów reklam

Pobiera ono dane o skuteczności reklam dotyczące treści objętych roszczeniem właściciela treści. Wyniki są pogrupowane według typu reklamy, co umożliwia porównywanie przychodów i wartości CPM dla różnych typów reklam.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType