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.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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