Na tej stronie znajdziesz przykładowe żądania do interfejsu YouTube Analytics API. W każdym przykładzie przedstawiono krótki opis pobieranego raportu oraz odpowiadające im wartości parametrów dimensions, metrics, filters i sort. (Raporty kanału i raportów właścicieli treści wskazują, które raporty są obsługiwane przez interfejs API).
Każdy przykład zawiera link do narzędzia Google APIs Explorer i wypełnia je pokazanymi wartościami. W przykładach używane są też domyślne daty rozpoczęcia i zakończenia (YYYY-MM-DD) wartości 2023-09-01 i 2024-03-31.
Po utworzeniu połączenia z Eksploratorem interfejsów API musisz jeszcze podać kanał lub właściciela treści, dla których pobierasz raporty. Eksplorator interfejsów API uzupełni wartość parametru ids wartością channel==MINE lub contentOwner==CONTENT_OWNER_ID w zależności od klikniętego zapytania. W przypadku raportów 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ć ciąg CONTENT_OWNER_ID swoim identyfikatorem właściciela treści.
Musisz też uwierzytelnić się jako właściciel określonego kanału lub treści, aby narzędzie Google APIs Explorer mogło autoryzować Twoje żądania do interfejsu API za pomocą usługi OAuth 2.0.
- Sortowanie żądań według wielu wymiarów lub danych
- Raporty dotyczące kanału
- Raporty właściciela treści
Sortowanie żądań według wielu wymiarów lub danych
Interfejs API umożliwia sortowanie danych odpowiedzi według wielu wymiarów lub danych. Na przykład poniższe żądanie pobiera dzienne dane o źródłach wizyt z filmów na konkretnym kanale. Każdy wiersz w zestawie wyników zawiera liczbę wyświetleń i szacowany czas oglądania, które pochodzą z określonego typu źródła wizyt (np. EXT_URL) w danym dniu.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Wyniki są sortowane chronologicznie w odpowiedzi. W zestawie wyników dla każdego dnia wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pierwszy wiersz w zestawie wyników zawiera więc dane dotyczące źródła wizyt, które wygenerowało najwięcej wyświetleń pierwszego dnia w wybranym zakresie dat. Drugi wiersz zawiera dane o źródle wizyt, które wygenerowało kolejną najwyższą liczbę wyświetleń pierwszego dnia.
Raporty dotyczące kanału
Raporty na temat filmów
Łączna liczba wyświetleń, szacowany czas oglądania i inne dane dotyczące kanału
To zapytanie pobiera zbiorcze dane dotyczące treści z kanału. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Liczba wyświetleń kanału w poszczególnych krajach (i inne informacje)
To zapytanie pobiera dane dotyczące filmów na kanale, które dotyczą konkretnego kraju. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 najpopularniejszych – najczęściej oglądanych filmów na kanale
To zapytanie pobiera 10 najczęściej oglądanych filmów na kanale na podstawie szacowanej liczby minut oglądania w wybranym zakresie dat. Wyniki są posortowane według szacowanego czasu oglądania w kolejności malejącej.
Uwaga: ten raport wymaga określenia wartości parametru żądania sort i ustawienia parametru maxResults na liczbę całkowitą równą 10 lub mniejszą.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
Top 10 – współczynniki klikalności adnotacji najczęściej oglądanych filmach na kanale
To żądanie pobiera liczbę wyświetleń, współczynnik klikalności adnotacji, współczynnik zamykania adnotacji i liczbę wyświetleń adnotacji dotyczących 10 najczęściej oglądanych filmów na kanale. Wyniki są sortowane według liczby wyświetleń w porządku malejącym, co oznacza, że na pierwszym miejscu znajduje się najczęściej oglądany film.
Uwaga: ten raport wymaga określenia wartości parametru żądania sort i ustawienia parametru maxResults na liczbę całkowitą równą 10 lub mniejszą.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Raporty dotyczące playlist
Łączna liczba wyświetleń playlisty na kanale
To żądanie pobiera informacje o łącznej liczbie uruchomień playlisty, szacowanym czasie oglądania, wyświetleniach (w zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), i wyświetleń na playlistę w przypadku playlist na kanale uwierzytelnionego użytkownika.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statystyki konkretnej playlisty
To żądanie pobiera informacje o łącznej liczbie uruchomień playlisty, szacowanym czasie oglądania, wyświetleniach (w
zagregowane dane o wideo)
wyświetlenia playlist (dane dotyczące playlist),
i liczby wyświetleń na odtworzenie konkretnej playlisty. Pamiętaj, że aby uruchomić to zapytanie w interfejsach API
Eksplorator, musisz zastąpić ciąg PLAYLIST_ID w filters
z identyfikatorem playlisty w kanale uwierzytelnionego użytkownika.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Aby pobrać zbiorcze statystyki wielu playlist, możesz też zastąpić ciąg PLAYLIST_ID rozdzielaną przecinkami listą maksymalnie 500 identyfikatorów playlist na kanale uwierzytelnionego użytkownika.
10 – najczęściej oglądane playlisty na kanale
To zapytanie pobiera 10 najczęściej oglądanych playlist z kanału, które zostały określone na podstawie wyświetleń playlist w wybranym zakresie dat. Pobiera też kilka innych danych dotyczących playlisty, takich jak to, ile razy widzowie zaczęli odtwarzać każdą playlistę i średnia czas, przez jaki widz oglądał filmy z playlisty po jej rozpoczęciu. Wyniki to posortowane według liczby wyświetleń playlisty w kolejności malejącej.
Uwaga: w tym raporcie używany jest wymiar playlist, dlatego musisz określić wartość parametru żądania sort i ustawić parametr maxResults na liczbę całkowitą równą 10 lub mniejszą.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Raporty na temat filmów
Dane dotyczące dziennego czasu oglądania filmów na kanale
To zapytanie pobiera dzienną liczbę wyświetleń, dane o czasie oglądania i liczbę nowych subskrybentów filmów na kanale. Raport zwraca po 1 wierszu danych na każdy dzień w wybranym zakresie dat. Wiersze są sortowane w kolejności chronologicznej.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Dzienne dane o adnotacjach do filmów na kanale
To żądanie pobiera dzienną liczbę wyświetleń, współczynnik klikalności adnotacji, współczynnik zamykania adnotacji oraz liczbę wyświetleń adnotacji dotyczących treści z kanału. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Raporty dotyczące playlist
Dzienna liczba wyświetleń playlisty na kanale
To żądanie pobiera dzienną liczbę wyświetleń ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), rozpoczęcia playlisty, szacowanego czasu oglądania oraz liczby wyświetleń na włączenie playlisty w przypadku uwierzytelnionych kanał użytkownika. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Raporty na temat filmów
Dane o czasie oglądania filmów na kanale w poszczególnych krajach
To zapytanie pobiera liczbę wyświetleń w poszczególnych krajach, dane o czasie oglądania oraz dane dotyczące subskrypcji filmów z kanału. Raport zawiera jeden wiersz danych dla każdego kraju, w którym oglądane były filmy z danego 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
To żądanie pobiera liczbę wyświetleń w poszczególnych krajach, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz wyświetlenia adnotacji dotyczące filmów na kanale. Wyniki są sortowane według współczynnika klikalności adnotacji w kolejności malejącej. Oznacza to, że jako pierwszy wyświetla się kraj o najwyższym współczynniku klikalności adnotacji.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Dane dotyczące poszczególnych prowincji w Stanach Zjednoczonych i Waszyngtonie
To żądanie pobiera dane z podziałem na prowincje, czyli liczbę wyświetleń, szacowany czas oglądania i średni czas oglądania filmów z kanału. Dane dotyczą stanów w USA i Waszyngtonu. Wyniki są sortowane alfabetycznie według prowincji Kody ISO 3166-2.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 najpopularniejszych – najczęściej oglądanych filmów w danym kraju
To zapytanie pobiera 10 najczęściej oglądanych filmów z kanału na podstawie liczby wyświetleń w wybranym zakresie dat w wybranym kraju. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.
Uwaga: ten raport wymaga określenia wartości parametru żądania sort i ustawienia parametru maxResults na liczbę całkowitą równą 10 lub mniejszą.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
10 miast w USA o największej liczbie wyświetleń
To zapytanie umożliwia pobranie listy 10 miast w Stanach Zjednoczonych, które uzyskały największą liczbę wyświetleń treści z kanału w określonym zakresie dat. Zapytanie można zmodyfikować, aby żądać danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra subContinent i jednej z jego prawidłowych wartości. Obsługiwane są też inne filtry. 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 o największej liczbie wyświetleń dla każdego typu treści
To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, które uzyskały największą liczbę wyświetleń treści z kanału 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 miast w USA o największym łącznym czasie oglądania
To zapytanie umożliwia pobranie listy 10 najpopularniejszych dni w wybranym zakresie dat, w których dowolne miasto w USA odnotowało najdłuższy łączny dzienny czas oglądania treści z tego kanału. Wyniki zapytania zawierają łączny czas oglądania, datę i godzinę obejrzenia oraz miasto, w którym według szacunków treści zostały wyświetlone. Wyniki są posortowane w kolejności malejącej według łącznego czasu oglądania.
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime
10 najpopularniejszych filmów w Europie
To zapytanie pobiera 10 najczęściej oglądanych filmów na kanale w Europie, określonych na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, aby żądało danych z innego kontynentu. Aby to zrobić, wybierz inną prawidłową wartość dla tego filtra. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego 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: ten raport wymaga określenia wartości parametru żądania sort i ustawienia parametru maxResults na liczbę całkowitą równą 10 lub mniejszą.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Raporty dotyczące playlist
Dane o czasie oglądania playlist z kanału w zależności od kraju
To zapytanie pobiera liczby wyświetleń dla danego kraju ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), oraz dane o czasie oglądania dla playlist kanału. Raport zwraca po jednym wierszu danych dla każdego kraj, w którym były oglądane playlisty kanału. Wiersze są posortowane w kolejności malejącej według liczby obejrzanych minut.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
10 – najczęściej słuchane playlisty w Stanach Zjednoczonych
To zapytanie umożliwia pobranie 10 playlist, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym zakresie dat. Wyniki są sortowane według liczby rozpoczęcia playlisty w kolejności malejącej.
Uwaga: w tym raporcie używany jest wymiar playlist, dlatego musisz określić wartość parametru żądania sort i ustawić parametr maxResults na liczbę całkowitą równą 10 lub mniejszą.
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 pobiera liczbę wyświetleń i szacowany czas oglądania filmów z konkretnego kanału. Wyniki są zagregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. Wyniki są sortowane w kolejności malejącej 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 pobiera dzienną liczbę wyświetleń oraz szacowany czas oglądania filmów z danego kanału w Stanach Zjednoczonych. Wyniki są pogrupowane według dnia dla każdego typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
10 – witryny zewnętrzne, 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ą pogrupowane według witryny zewnętrznej, w której umieszczono dany film. 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 listą rozdzielonych przecinkami identyfikatorów filmów przesłanych przez Ciebie.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Raporty dotyczące playlist
liczbę wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;
To zapytanie pobiera liczbę wyświetleń (w polu zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), szacowany czas oglądania i rozpoczęcia playlisty dla playlist na konkretnym kanale. Wyniki to dane zbiorcze z uwzględnieniem typu strony lub aplikacji, w której miały miejsce odtworzenia filmu; Wyniki są sortowane w kolejności malejącej według rozpoczęcia playlisty.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
dziennej liczby wyświetleń playlisty i czasu oglądania w różnych miejscach odtwarzania;
To zapytanie pobiera dzienne uruchomienia playlisty, liczbę wyświetleń ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), i szacowany czas oglądania w Stanach Zjednoczonych dla playlist konkretnego kanału. Wyniki są pogrupowane według dnia dla każdego typu strony lub aplikacji, w której miały miejsce wyświetlenia playlisty. Wyniki są posortowane chronologicznie.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Raporty na temat filmów
Oznaczenia „Podoba mi się” i „Nie podoba mi się” według typu treści
To zapytanie pobiera liczbę polubień i głosów na nie dla każdego typu treści na kanale.
dimensions=creatorContentType metrics=likes,dislikes
Raporty na temat filmów
liczbę wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju;
To żądanie pobiera liczbę wyświetleń i szacowany czas oglądania filmów z kanału w wybranym kraju. Dane są agregowane według źródła wizyt, które opisuje, w jaki sposób użytkownicy docierali do filmu.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt
To żądanie pobiera dzienną liczbę wyświetleń oraz szacowany dzienny 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 – wyszukiwane słowa w YouTube, które generują największy ruch dla filmu
To zapytanie pobiera 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania w YouTube dla jednego lub większej liczby konkretnych filmów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów filmów rozdzielonych przecinkami.
Możesz na przykład wysłać zapytanie dotyczące pojedynczego filmu lub zastąpić ciąg VIDEO_ID, aby zidentyfikować wyszukiwane hasła, które generują najwięcej ruchu dla tego filmu. Możesz też wymienić wszystkie filmy z danej playlisty, aby sprawdzić, które wyszukiwane hasła generują najwięcej ruchu.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 najpopularniejszych – zewnętrznych witryn, które generują największy ruch dla filmu
To zapytanie pobiera 10 zewnętrznych witryn, które wygenerowały najwięcej wyświetleń dla określonego filmu lub grupy filmów. Wyniki są posortowane według szacowanego czasu oglądania w kolejności malejącej. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów filmów przesłanych przez Ciebie.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Raporty dotyczące playlist
liczbę wyświetleń playlisty i czas oglądania z różnych źródeł wizyt w danym kraju;
To żądanie pobiera liczbę wyświetleń (parametr zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), rozpoczęcia odtwarzania playlisty i szacowany czas oglądania w przypadku wyświetleń playlist w danym kraju. są agregowane według źródła wizyt, które opisuje, w jaki sposób użytkownicy docierali do playlisty.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt
To żądanie pobiera dzienną liczbę wyświetleń playlisty kanału ( in-playlist), rozpoczęcia playlisty i szacowany czas oglądania. Gromadzi też łączną liczbę wyświetleń ( zagregowane dane o wideo). Dane są agregowane codziennie według źródła wizyt i sortowane w kolejności chronologicznej.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
Raporty na temat filmów
Dzienne dane o typie urządzeń z systemem operacyjnym Android
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z konkretnego kanału na urządzeniach z Androidem. Wyniki są pogrupowane według dnia dla każdego typu urządzenia, na którym doszło do odtworzenia filmu. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Dzienne dane o systemie operacyjnym urządzeń mobilnych
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z konkretnego kanału na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla każdego systemu operacyjnego, w którym film został odtworzony. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
To zapytanie pobiera dzienną liczbę wyświetleń oraz 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 o typie urządzenia w przypadku wyświetleń playlist w systemie operacyjnym Android
To zapytanie pobiera dzienne wyświetlenia ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), oraz szacowany czas oglądania dla playlist konkretnego kanału na urządzeniach z Androidem. Wyniki to pogrupowane według dnia na każdym typie urządzenia, na którym miały miejsce wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Dzienne dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych
To zapytanie pobiera dzienne wyświetlenia ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), oraz szacowany czas oglądania playlist konkretnego kanału na urządzeniach mobilnych. Wyniki to pogrupowane według dnia dla każdego systemu operacyjnego, w którym miały miejsce wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Raporty na temat filmów
Dane demograficzne widzów 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 filmy na kanale. Wyniki są sortowane według płci, a następnie grupy wiekowej. Można zmodyfikować to zapytanie, aby uzyskać te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z kraju, kontynentu, subkontynentu lub innego stanu USA, dostosowując wartość parametru filters.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Raporty dotyczące playlist
Dane demograficzne widzów playlisty w Kalifornii (grupa wiekowa i płeć)
Ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów z Kalifornii, którzy
obejrzeli playlisty kanału. Wyniki są sortowane według płci, a następnie grupy wiekowej. Ten
można zmodyfikować zapytanie, aby uzyskać te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich
widzów z kraju, kontynentu, subkontynentu lub innego stanu w USA przez dostosowanie wartości parametru filters.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Dane dotyczące udostępniania, zagregowane według usługi, w której udostępniono filmy
To żądanie pobiera informację o tym, ile razy użytkownicy kliknęli przycisk Share, aby udostępnić filmy z kanału. Wyniki są zagregowane według usługi udostępniania (Google+, Twitter itp.) i posortowane w kolejności malejącej według liczby udostępnień.
dimensions=sharingService metrics=shares sort=-shares
dane dotyczące utrzymania uwagi odbiorców dla filmu;
Ten raport sprawdza zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla pojedynczego filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem wideo jednego z przesłanych filmów. Pamiętaj, że w raportach o utrzymaniu uwagi odbiorców nie można określić wielu wartości filtra video.
W tym przykładzie raport korzysta z filtra audienceType, aby ograniczyć odpowiedź, tak aby zawierała tylko dane o bezpłatnych wyświetleniach, które są wynikiem bezpośredniego działania użytkownika, takiego jak wyszukiwanie filmu lub kliknięcie proponowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream i TrueView In-Display. Możesz usunąć filtr, aby pobrać dane dotyczące utrzymania uwagi odbiorców dla filmu dla wszystkich typów odbiorców.
Pamiętaj, że dane dla filtra audienceType są dostępne od 25 września 2013 r. Interfejs API nie zwraca danych dla zapytań, które korzystają z filtra w celu pobrania danych z wcześniejszych dat. Zapytania bez filtra działają po 1 lipca 2008 roku.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Dane dotyczące przychodów kanału i skuteczności reklam
To żądanie pobiera dane dotyczące przychodów kanału i skuteczności reklam. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Dane o dziennych przychodach i skuteczności reklam
To żądanie pobiera dane dotyczące dziennych przychodów i skuteczności reklam kanału.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Dane o przychodach i skuteczności reklam w poszczególnych krajach
To żądanie pobiera dane dotyczące przychodów kanału i skuteczności reklam w poszczególnych krajach. Wyniki są posortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy wymieniony kraj jest tym, w którym partner osiągnął największe przychody netto.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
10 najlepszych – filmy z najwyższymi przychodami
To żądanie pobiera dane o przychodach i skuteczności reklam z 10 filmów na kanale, które uzyskały najwyższe przychody. Wyniki są posortowane w kolejności malejącej według kwoty przychodów. Oznacza to, że pierwszy film będzie tym, który ma najwyższe szacunkowe przychody.
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
To żądanie pobiera dane o skuteczności reklam w przypadku treści, do których prawa zgłosił właściciel treści. Wyniki są pogrupowane według typu reklamy, co pozwala porównać wartości przychodów i CPM 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 o treściach, do których właściciel treści zgłosił roszczenia. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
liczby wyświetleń (i inne) w poszczególnych krajach dla wszystkich filmów przesłanych przez Ciebie
To zapytanie pobiera dane dotyczące konkretnego kraju dotyczące filmów przesłanych przez właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Całkowita liczba wyświetleń (i inne) wszystkich treści osób trzecich objętych roszczeniami
To zapytanie pobiera zbiorcze dane o filmach, do których właściciel treści zgłosił roszczenie, ale ich nie przesłał. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Łączna liczba wyświetleń (i inne informacje) dla wszystkich treści przesłanych przez Ciebie
To zapytanie pobiera zbiorcze dane o filmach przesłanych przez właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Łączna liczba wyświetleń (i inne) wszystkich treści przesłanych samodzielnie i objętych roszczeniem
To zapytanie pobiera zbiorcze dane o filmach, które właściciel treści przesłał, a także zgłosił do nich roszczenia. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 najpopularniejszych – najczęściej oglądanych filmów właściciela treści
To zapytanie pobiera 10 najczęściej oglądanych filmów (określonych na podstawie liczby wyświetleń w wybranym zakresie dat), które przesłał właściciel 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 – najczęściej oglądanych filmów właściciela treści
To zapytanie umożliwia pobranie 10 najczęściej oglądanych filmów przesłanych przez właściciela treści na podstawie szacowanej liczby minut oglądania w określonym zakresie dat. Wyniki są posortowane według szacowanego czasu oglądania w kolejności malejącej.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 najpopularniejszych – najczęściej oglądanych filmów na kanale właściciela treści
To zapytanie pobiera 10 najczęściej oglądanych filmów z określonego 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 narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich kanałów.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
Top 10 – współczynniki klikalności adnotacji najczęściej oglądanych filmach na kanale
To żądanie pobiera liczbę wyświetleń, współczynnik klikalności adnotacji, współczynnik zamykania adnotacji i liczbę wyświetleń adnotacji dla 10 najczęściej oglądanych filmów na określonym kanale lub w określonej grupie kanałów. Wyniki są sortowane według liczby wyświetleń w porządku malejącym, co oznacza, że na pierwszym miejscu znajduje się najczęściej oglądany film. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich kanałów.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Raporty dotyczące playlist
Wyświetlenia playlisty na kanałach właściciela treści
To żądanie pobiera łączną liczbę uruchomień playlisty, szacowany czas oglądania playlisty i playlistę
– liczba wyświetleń i liczba wyświetleń według początków playlist na kanałach właściciela treści.
Dane playlistViews zliczają tylko wyświetlenia filmów, które miały miejsce w kontekście
na playliście. Ponieważ wszystkie żądane dane należą do playlisty, prośba nie
muszą też zawierać filtr playlisty lub grupy.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statystyki konkretnej playlisty
To żądanie pobiera informacje o łącznej liczbie uruchomień playlisty, szacowanym czasie oglądania, wyświetleniach (w
zagregowane dane o wideo)
wyświetlenia playlist (dane dotyczące playlist),
i liczby wyświetleń na odtworzenie konkretnej playlisty. Pamiętaj, że aby uruchomić to zapytanie w interfejsach API
Eksplorator, musisz zastąpić ciąg PLAYLIST_ID w filters
z identyfikatorem playlisty na jednym z kanałów właściciela treści.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Aby pobrać zbiorcze statystyki wielu playlist, możesz też zastąpić ciąg PLAYLIST_ID rozdzielaną przecinkami listą maksymalnie 500 identyfikatorów playlist znajdujących się na kanałach właściciela treści.
Raporty na temat filmów
Dane o dziennym czasie oglądania treści przesłanych przez siebie
To zapytanie pobiera dane dotyczące dziennego czasu oglądania, a także liczby wyświetleń, odtworzeń generujących przychody i wyświetleń filmów przesłanych przez właściciela treści. Raport zwraca po 1 wierszu danych na każdy dzień w wybranym zakresie dat. Wiersze są posortowane 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 oraz wyświetlenia adnotacji dotyczące treści, do których zgłoszono roszczenie 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
Dzienna liczba wyświetleń playlisty dla właściciela treści
To żądanie pobiera dane dotyczące dziennych interakcji użytkowników z filmami na playlistach. Dane pobrane w raporcie to playlistViews, playlistStarts, playlistEstimatedMinutesWatched i viewsPerPlaylistStart. Wszystkie te dane to dane dotyczące playlist. Ponieważ wszystkie żądane dane są danymi w playliście, nie musi to być zastosuj też filtr playlisty lub grupy.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Raporty na temat filmów
Dane o czasie oglądania treści przesłanych samodzielnie w poszczególnych krajach
To zapytanie pobiera liczbę wyświetleń, dane o czasie oglądania i szacunkowe przychody z reklam w poszczególnych krajach. Te dane dotyczą filmów przesłanych przez właściciela treści. Raport zwróci po jednym wierszu danych dla każdego kraju, w którym widzowie oglądali filmy. Wiersze są posortowane w kolejności malejącej według liczby minut oglądania.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Dane dotyczące adnotacji związanych z krajem w przypadku treści przesyłanych przez siebie
To żądanie pobiera liczbę wyświetleń w poszczególnych krajach, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz wyświetlenia adnotacji dotyczące filmów przesłanych przez właściciela treści. Wyniki są sortowane według współczynnika klikalności adnotacji w kolejności malejącej. Oznacza to, że jako pierwszy wyświetla 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 poszczególnych prowincji w Stanach Zjednoczonych i Waszyngtonie
Pobiera ono dane z podziałem na prowincje, czyli liczbę wyświetleń, szacowany czas oglądania (w minutach) i średni czas oglądania filmów objętych roszczeniami właściciela treści. Dane dotyczą stanów w USA i Waszyngtonu. Wyniki są sortowane alfabetycznie według prowincji Kody ISO 3166-2.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 miast w USA o największej liczbie wyświetleń
To zapytanie umożliwia pobranie listy 10 amerykańskich miast, w których w wybranym zakresie dat odnotowano najwięcej wyświetleń filmów objętych roszczeniem zgłoszonym przez właściciela treści. Zapytanie można zmodyfikować, aby żądać danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra subContinent i jednej z jego prawidłowych wartości. Obsługiwane są też inne filtry. 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 o największej liczbie wyświetleń dla każdego typu treści
To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, z których pochodziło najwięcej wyświetleń treści objętych roszczeniem właściciela treści w określonym zakresie dat w przypadku 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 miast w USA o największym łącznym czasie oglądania
To zapytanie umożliwia pobranie listy 10 najlepszych dni w wybranym zakresie dat, w których dowolne miasto w Stanach Zjednoczonych odnotowało najdłuższy łączny dzienny czas oglądania treści, do których zgłoszono roszczenie właściciela treści. Wyniki zapytania zawierają łączny czas oglądania, datę i godzinę obejrzenia oraz miasto, w którym według szacunków treści zostały wyświetlone. Wyniki są posortowane w kolejności malejącej według łącznego czasu oglądania.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime
10 najpopularniejszych filmów w Europie
To zapytanie pobiera 10 najczęściej oglądanych filmów w Europie wśród filmów objętych roszczeniem właściciela treści, które zostały określone na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, aby żądało danych z innego kontynentu. Aby to zrobić, wybierz inną prawidłową wartość dla tego filtra. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego 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 w poszczególnych krajach dotyczące playlist właściciela treści
To zapytanie pobiera liczbę wyświetleń playlisty i dane o czasie oglądania playlisty w poszczególnych krajach we wszystkich playlistach na kanałach właściciela treści. Raport zwraca po jednym wierszu danych dla każdego kraju, w którym były oglądane playlisty. Wiersze są sortowane w kolejności malejącej według liczby minut oglądania.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
10 – najczęściej słuchane playlisty w Stanach Zjednoczonych
To zapytanie pobiera 10 playlist z kanałów właściciela treści, które widzowie oglądają w Największy wzrost liczby wyświetleń w Stanach Zjednoczonych rozpoczął się w wybranym zakresie dat. Wyniki to posortowane według liczby odtworzeń playlisty w kolejności malejącej.
Uwaga: w tym raporcie wykorzystywana jest funkcja
playlist, musisz
określ wartość parametru żądania sort i ustaw też
maxResults na wartość całkowitą nie większą niż 10.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Raporty na temat filmów
Oznaczenia „Podoba mi się” i „Nie podoba mi się” według typu treści
To zapytanie pobiera liczbę polubień i głosów na nie dla każdego typu treści na konkretnym kanale lub w grupie kanałów. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich 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 pobiera liczbę wyświetleń i szacowany czas oglądania filmów przesłanych na konkretny kanał lub określoną grupę kanałów. Wyniki są zagregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. 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 CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich 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ń oraz szacowany czas oglądania w Stanach Zjednoczonych w przypadku filmów przesłanych na konkretny kanał lub określoną grupę kanałów. Wyniki są pogrupowane według dnia dla każdego typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. Wyniki są sortowane w odwrotnej kolejności chronologicznej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich kanałów.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
10 – witryny zewnętrzne, 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ą pogrupowane według witryny zewnętrznej, w której umieszczono film. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów filmów przesłanych przez Ciebie.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Raporty dotyczące playlist
liczbę wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;
To zapytanie pobiera liczbę wyświetleń playlisty, szacowany czas oglądania playlisty oraz jest początek wszystkich playlist na kanałach właściciela treści. Wyniki są oparte na danych zbiorczych według typu strony lub aplikacji, w której miały miejsce odtworzenia filmów, a wyniki są sortowane według w kolejności malejącej według rozpoczęcia playlisty.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
liczbę wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;
To zapytanie pobiera dzienne uruchomienia playlisty, liczbę wyświetleń playlisty i szacowany czas oglądania playlisty w Stanach Zjednoczonych w przypadku wszystkich playlist na kanałach właściciela treści. Wyniki są zwracane dla każdego typu strony lub aplikacji, w których wystąpiły wyświetlenia playlist.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Raporty na temat filmów
Liczba wyświetleń i czas oglądania z różnych źródeł wizyt
To żądanie pobiera liczbę wyświetleń i szacowany czas oglądania filmów właściciela treści. Dane są agregowane według źródła wizyt, które opisuje, w jaki sposób użytkownicy docierali do filmu.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt
To żądanie pobiera dzienną liczbę wyświetleń oraz szacowany dzienny czas oglądania filmów właściciela treści. Dane są agregowane codziennie według źródła wizyt i sortowane w odwrotnej kolejności chronologicznej.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Uwaga: dwa następne przykładowe raporty są obsługiwane tylko w przypadku konkretnych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie ma dodatkowych informacji, więc te raporty są dla niego niedostępne. Szczegółowe informacje o źródłach wizyt, dla których dostępne są raporty tego typu, znajdziesz w definicji insightTrafficSourceType.
10 najpopularniejszych – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla filmu
To zapytanie pobiera 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania w YouTube dla konkretnego filmu lub grupy filmów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów filmów przesłanych przez Ciebie.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 najpopularniejszych – zewnętrznych witryn, które generują największy ruch dla filmu
To zapytanie pobiera 10 zewnętrznych witryn, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania Google dotyczących konkretnego filmu lub grupy filmów. Wyniki są posortowane według szacowanego czasu oglądania w kolejności malejącej. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów filmów przesłanych przez Ciebie.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Raporty dotyczące playlist
liczbę wyświetleń playlisty i czas oglądania z różnych źródeł wizyt w danym kraju;
To żądanie pobiera liczbę wyświetleń playlisty, początków playlisty oraz szacowany czas oglądania playlisty w danym kraju. Dane są agregowane według źródła wizyt, który opisuje, w jaki sposób użytkownicy dotarli do playlisty.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
liczbę wyświetleń playlisty i czas oglądania z różnych źródeł wizyt;
Ta prośba pobiera informacje o wyświetleniach playlisty, uruchomieniach playlisty i szacowanym czasie oglądania
do playlist na co najmniej jednym kanale właściciela treści. Wskaźniki są agregowane według
źródła wizyt. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg znaków
CHANNEL_ID w wartości parametru filters rozdzielonych przecinkami
lista maksymalnie 500 identyfikatorów swoich kanałów.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Raporty na temat filmów
Dzienne dane o typie 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 w przypadku filmów objętych roszczeniem przez konkretnego właściciela treści. Wyniki są pogrupowane według dnia dla każdego typu urządzenia, na którym doszło do odtworzenia filmu. 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óre miały miejsce na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla każdego systemu operacyjnego, w którym zostały odtworzone filmy. Wyniki są sortowane w kolejności chronologicznej.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów objętych roszczeniem przez konkretnego 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
Dane dotyczące typu urządzenia w przypadku wyświetleń playlist w systemie operacyjnym Android
To zapytanie pobiera liczbę wyświetleń playlisty i szacowany czas oglądania playlisty na urządzeniach z Androidem
do playlist na co najmniej jednym kanale właściciela treści. Wyniki są zwracane dla
na poszczególnych rodzajach urządzeń, na których zostały wyświetlone playlisty. Pamiętaj, że aby uruchomić to zapytanie w interfejsach API
Eksplorator, musisz zastąpić ciąg CHANNEL_ID w filters
do 500 identyfikatorów swoich kanałów, rozdzielając je przecinkami.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych
To zapytanie pobiera liczbę wyświetleń playlisty i szacowany czas oglądania playlisty na urządzeniach mobilnych do playlist na kanałach właściciela treści. Wyniki są zwracane dla każdego system operacyjny, w którym playlisty zostały wyświetlone.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Raporty na temat filmów
Dane demograficzne widzów 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 treści objęte roszczeniem właściciela treści. Wyniki są sortowane według płci, a następnie grupy wiekowej. Można zmodyfikować to zapytanie, aby uzyskać te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z kraju, kontynentu, subkontynentu lub innego stanu USA, dostosowując wartość parametru filters.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Dane dotyczące udostępniania, zagregowane 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ą zagregowane według usługi udostępniania (Google+, Twitter itp.) i posortowane w kolejności malejącej według liczby udostępnień.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
dane dotyczące utrzymania uwagi odbiorców dla filmu;
Ten raport sprawdza zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla pojedynczego filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem wideo jednego z przesłanych filmów. Pamiętaj, że w raportach o utrzymaniu uwagi odbiorców nie można określić wielu wartości filtra video.
W tym przykładzie raport korzysta z filtra audienceType, aby ograniczyć odpowiedź, tak aby zawierała tylko dane o bezpłatnych wyświetleniach, które są wynikiem bezpośredniego działania użytkownika, takiego jak wyszukiwanie filmu lub kliknięcie proponowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream i TrueView In-Display. Możesz usunąć filtr, aby pobrać dane dotyczące utrzymania uwagi odbiorców dla filmu dla wszystkich typów odbiorców.
Pamiętaj, że dane dla filtra audienceType są dostępne od 25 września 2013 r. Interfejs API nie zwraca danych dla zapytań, które korzystają z filtra w celu pobrania danych z wcześniejszych dat. Zapytania bez filtra działają po 1 lipca 2008 roku.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Dane o przychodach i skuteczności reklam dotyczące treści objętych roszczeniem
To żądanie pobiera dane o przychodach i skuteczności reklam dotyczące treści, do których zgłoszono roszczenie przez właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych danych w wybranym zakresie dat.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Dane o dziennych przychodach i skuteczności reklam
To żądanie pobiera dzienne dane o przychodach i skuteczności reklam, które dotyczą 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
To żądanie pobiera dane o przychodach i skuteczności reklam w poszczególnych krajach, które dotyczą 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 pierwszy wymieniony kraj jest tym, w którym partner ma najwyższe szacunkowe przychody.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
10 najlepszych – filmy z najwyższymi przychodami
To żądanie pobiera dane o przychodach i skuteczności reklam dotyczące 10 filmów, które zostały objęte roszczeniem przez właściciela treści i które uzyskały najwyższe przychody. Wyniki są posortowane w kolejności malejącej według kwoty przychodów. Oznacza to, że pierwszy film będzie tym, który ma najwyższe szacunkowe przychody.
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
To żądanie pobiera dane o skuteczności reklam w przypadku treści, do których prawa zgłosił właściciel treści. Wyniki są pogrupowane według typu reklamy, co pozwala porównać wartości przychodów i CPM różnych typów reklam.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType