Na tej stronie znajdziesz przykładowe żądania do interfejsu YouTube Analytics API. W każdym przykładzie pokrótce opisano pobierany raport i pokazujemy odpowiadające mu wartości parametrów dimensions
, metrics
, filters
i sort
. (Raporty obsługiwane przez interfejs API można znaleźć w raportach dotyczących kanałów i raportach właściciela treści).
Każdy przykład zawiera link do narzędzia Google APIs Explorer i wypełnia go wyświetlanymi wartościami. W przykładach używana jest też domyślna data rozpoczęcia i zakończenia (YYYY-MM-DD
) równa 2023-09-01
i 2024-03-31
.
Po utworzeniu połączenia z narzędziem APIs Explorer musisz nadal określić kanał lub właściciela treści, dla którego chcesz pobrać raporty. W zależności od klikniętego zapytania narzędzie Google APIs Explorer uzupełni wartość parametru ids
wartością channel==MINE
lub contentOwner==CONTENT_OWNER_ID
. W przypadku raportów dotyczących kanałów możesz zmienić MINE
na identyfikator kanału uwierzytelnionego użytkownika. W przypadku zgłoszeń właścicieli treści musisz zastąpić CONTENT_OWNER_ID
swoim identyfikatorem właściciela treści.
Musisz też uwierzytelnić się jako określony kanał lub właściciel treści, aby Eksplorator interfejsów API mógł autoryzować żądania do interfejsu API za pomocą OAuth 2.0.
- Sortowanie żądań według wielu wymiarów lub danych
- Raporty dotyczące kanałów
- Zgłoszenia właścicieli treści
Sortowanie żądań według wielu wymiarów/danych
Interfejs API umożliwia sortowanie danych odpowiedzi za pomocą wielu wymiarów lub danych. Przykład: to żądanie pobiera dane o dziennych źródłach wizyt dla filmów z konkretnego kanału. Każdy wiersz w zestawie wyników wskazuje liczbę wyświetleń i szacowany czas oglądania pochodzących z danego typu źródła wizyt (np. EXT_URL
) w danym dniu.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Wyniki w odpowiedzi są sortowane chronologicznie. W zestawie wyników z każdego dnia wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pierwszy wiersz w wynikach 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 dotyczące źródła wizyt, które wygenerowało kolejną największą liczbę wyświetleń pierwszego dnia.
Raporty kanałów
Raporty na temat filmów
Łączna liczba wyświetleń, szacowany czas oglądania i inne dane dotyczące kanału
To zapytanie pobiera zagregowane wskaźniki dotyczące treści kanału. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Liczba wyświetleń kanału w danym kraju (i więcej)
To zapytanie pobiera dane dotyczące filmów na kanale z konkretnego kraju. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 najpopularniejszych 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ą sortowane 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ą nie większą niż 10
.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
Top 10 – współczynniki klikalności adnotacji dla najczęściej oglądanych filmów na kanale
To żądanie pobiera liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz 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 najczęściej oglądany film będzie wymieniony jako pierwszy.
Uwaga: ten raport wymaga określenia wartości parametru żądania sort
i ustawienia parametru 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ń playlist na kanale
To żądanie pobiera informacje o łącznej liczbie rozpoczęć odtwarzania playlisty, szacowanym czasie oglądania, wyświetleniach (zbiorczy wskaźnik filmu), wyświetleń playlisty (dane na playliście) oraz wyświetleń przypadających na początek playlisty w przypadku playlist na kanale uwierzytelnionego użytkownika.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statystyki konkretnej playlisty
To żądanie pobiera łączną liczbę odtworzeń playlisty, szacowany czas oglądania, liczbę wyświetleń (zbiorcze dane o filmach), wyświetlenia playlisty (dane na playliście) oraz wyświetlenia przypadające na każde rozpoczęcie playlisty w przypadku określonej playlisty. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg PLAYLIST_ID
w wartości parametru filters
identyfikatorem playlisty na kanale uwierzytelnionego użytkownika.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Aby pobrać zbiorcze statystyki dla wielu playlist, możesz też zastąpić ciąg PLAYLIST_ID
listą rozdzielonych przecinkami maksymalnie 500 identyfikatorów playlist na kanale użytkownika uwierzytelnionego.
10 najpopularniejszych playlist na kanale
To zapytanie pobiera 10 najczęściej oglądanych playlist na kanale. Ustalone na podstawie liczby wyświetleń playlist w wybranym zakresie dat. Wykorzystuje też kilka innych danych dotyczących playlisty, takich jak liczba przypadków rozpoczęcia odtwarzania każdej playlisty przez widzów oraz średni czas oglądania przez nich filmów z playlisty po jej rozpoczęciu. Wyniki są sortowane według wyświetleń playlisty w kolejności malejącej.
Uwaga: w tym raporcie używany jest wymiar playlist
, więc musisz określić wartość parametru żądania sort
, a także ustawić parametr maxResults
na liczbę całkowitą nie większą niż 10
.
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 dotyczące czasu oglądania i nowych subskrybentów filmów z kanału. Raport zwraca jeden wiersz danych dla każdego dnia w żądanym zakresie dat. Wiersze są sortowane chronologicznie.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Dzienne wskaźniki adnotacji do filmów na kanale
To żądanie pobiera dzienną liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz liczbę wyświetleń adnotacji dotyczących treści kanału. Wyniki są sortowane chronologicznie.
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ń (zbiorcze dane o filmach), wyświetlenia playlisty (dane na playliście), rozpoczęcia odtwarzania playlisty, szacowany czas oglądania oraz liczbę wyświetleń na rozpoczęcie playlisty z kanału uwierzytelnionego użytkownika. Wyniki są sortowane chronologicznie.
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
Pobiera ono liczbę wyświetleń w poszczególnych krajach, dane o czasie oglądania i liczbę subskrypcji filmów z danego kanału. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym widzowie oglądali filmy na kanale. Wiersze są posortowane malejąco 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 do filmów na kanale. Wyniki są sortowane według współczynnika klikalności adnotacji w kolejności malejącej, co oznacza, że kraj o najwyższym współczynniku klikalności adnotacji jest wymieniony jako pierwszy.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu
Pobiera ono dane o liczbie wyświetleń, szacowanym czasie oglądania i średnim czasie oglądania filmów z kanału w poszczególnych prowincjach. Dane dotyczą stanów USA i Waszyngtonu. 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 oglądane filmy w danym kraju
To zapytanie pobiera 10 najczęściej oglądanych filmów na kanale według liczby wyświetleń w wybranym kraju w wybranym zakresie dat. 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ą nie większą niż 10
.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
10 miast w USA o największej łącznej liczbie wyświetleń
To zapytanie pobiera listę 10 miast w USA, które wygenerowały najwięcej wyświetleń treści na kanale w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając filtra subContinent i jednej z jego prawidłowych wartości. Inne filtry również 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 o największej łącznej liczbie wyświetleń dla każdego typu treści
To zapytanie pobiera listę 10 miast w USA, które wygenerowały najwięcej wyświetleń treści na kanale w wybranym zakresie dat dla każdego obsługiwanego elementu 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 pobiera listę 10 dni najpopularniejszych w wybranym zakresie dat, kiedy to dowolne miasto w USA miało największy dzienny czas oglądania treści na kanale. Wyniki zapytania zawierają całkowity czas oglądania, datę czasu oglądania oraz miasto, w którym według szacunków treści były oglądane. Wyniki są posortowane malejąco według łącznego czasu oglądania.
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
Top 10 – najczęściej oglądane filmy w Europie
To zapytanie pobiera 10 filmów najczęściej oglądanych przez kanał w Europie. Dane zmierzono na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kontynentu, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając 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ą nie większą niż 10
.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Raporty dotyczące playlist
Dane o czasie oglądania playlist kanału w poszczególnych krajach
To zapytanie pobiera liczbę wyświetleń w poszczególnych krajach (zbiorcze dane o filmach), liczbę wyświetleń playlist (dane playlisty) i dane o czasie oglądania dotyczące playlist kanału. Raport zwraca po jednym wierszu danych dla każdego kraju, w którym oglądano playlisty na kanale. Wiersze są posortowane malejąco według liczby obejrzanych minut.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
Top 10 – najczęściej odtwarzane playlisty w Stanach Zjednoczonych
To zapytanie pobiera 10 playlist, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym zakresie dat. Wyniki są sortowane według liczby początków playlisty w kolejności malejącej.
Uwaga: w tym raporcie używany jest wymiar playlist
, więc musisz określić wartość parametru żądania sort
, a także ustawić parametr 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 pobiera liczbę wyświetleń i szacowany czas oglądania filmów z określonego kanału. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Dzienne liczby wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z określonego kanału w Stanach Zjednoczonych. Wyniki są pogrupowane według dnia dla poszczególnych typów stron lub aplikacji, w których miały miejsce odtworzenia filmu. Wyniki są sortowane chronologicznie.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
Top 10 – witryny innych firm, które generują najwięcej wyświetleń dla 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, w której został umieszczony film. 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
listą co najmniej jednego identyfikatora filmu oddzielonych przecinkami.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Raporty dotyczące playlist
liczby wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania.
To zapytanie pobiera informacje o liczbie wyświetleń (zbiorczych danych o filmach), wyświetleniach playlist (dane na playliście), szacowanym czasie oglądania oraz początkach odtwarzania playlisty na konkretnym kanale. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu, a wyniki są sortowane w kolejności malejącej według rozpoczęcia odtwarzania playlisty.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Dzienna liczba wyświetleń playlist i czas oglądania w różnych lokalizacjach odtwarzania
To zapytanie pobiera dzienną liczbę rozpoczęcia odtwarzania playlisty, liczbę wyświetleń (zbiorcze dane o filmach), liczbę wyświetleń playlist (dane na playliście) oraz 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 wystąpiły wyświetlenia playlisty. Wyniki są sortowane chronologicznie.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Raporty na temat filmów
Oceny pozytywne i negatywne 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
liczby 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 danym kraju. Dane są agregowane według źródła wizyt, czyli w jaki sposób użytkownicy dotarli do filmu.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt
To żądanie pobiera dzienną liczbę wyświetleń i szacowany dzienny czas oglądania filmów z kanału. Dane są codziennie agregowane według źródła wizyt i sortowane chronologicznie.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
10 najpopularniejszych – słowa wyszukiwane w YouTube, które generują największy ruch dla filmu
Pobiera ono 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń w wynikach wyszukiwania w YouTube dla co najmniej jednego konkretnego filmu. 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 uruchomić zapytanie dotyczące pojedynczego filmu lub zastąpić VIDEO_ID
, aby zidentyfikować wyszukiwane hasła, które generują najwięcej ruchu dla tego filmu. Możesz też wymienić wszystkie filmy na playliście, aby określić, które wyszukiwane hasła generują największy ruch w przypadku dowolnego z filmów z tej playlisty.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 największych witryn – witryny zewnętrzne, które generują największy ruch związany z filmem
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ą sortowane według szacowanego czasu oglądania 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 przesłanych filmów, rozdzielonych przecinkami.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Raporty dotyczące playlist
liczby wyświetleń playlisty i czasu oglądania z różnych źródeł wizyt w danym kraju;
To żądanie pobiera informacje o liczbie wyświetleń (zbiorczych danych o filmach), wyświetleniach playlisty (w przypadku playlisty), rozpoczęcia odtwarzania playlisty oraz szacowanym czasie oglądania wyświetleń playlisty w danym kraju. Wskaźniki są agregowane według źródła wizyt, które określają, w jaki sposób użytkownicy dotarli do playlisty.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Dzienne liczby wyświetleń playlist i czas oglądania z różnych źródeł wizyt
To żądanie pobiera dzienną liczbę wyświetleń playlisty z kanału (dane na playliście), rozpoczęcia odtwarzania playlisty i szacowany czas oglądania. Zbiera też łączną liczbę wyświetleń (zbiorcze dane o filmach). Dane są codziennie agregowane według źródła wizyt i sortowane chronologicznie.
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 określonego kanału na urządzeniach z Androidem. Wyniki są pogrupowane według dnia dla każdego typu urządzeń, na których odtworzone zostały filmy. Wyniki są sortowane chronologicznie.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Dzienne dane o systemie operacyjnym na urządzeniach mobilnych
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z określonego kanału na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla poszczególnych systemów operacyjnych, w których miały miejsce odtworzenia filmu. Wyniki są sortowane chronologicznie.
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ń i szacowany czas oglądania kanału. Statystyki są pogrupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane chronologicznie.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Raporty dotyczące playlist
Dzienne dane o typie urządzeń dotyczące wyświetleń playlist w systemie operacyjnym Android
To zapytanie pobiera liczbę wyświetleń dziennie (zbiorcze dane o filmach), wyświetleń playlist (dane na playliście) oraz szacowany czas oglądania playlist konkretnego kanału na urządzeniach z Androidem. Wyniki są pogrupowane według dnia dla każdego typu urządzeń, na których wystąpiły wyświetlenia playlisty. Wyniki są sortowane chronologicznie.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Dzienne dane o systemie operacyjnym dotyczące wyświetleń playlist na urządzeniach mobilnych
To zapytanie podaje liczbę dziennych wyświetleń (zbiorcze dane o filmach), wyświetleń playlist (dane na playliście) oraz szacowany czas oglądania playlist konkretnego kanału na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla każdego systemu operacyjnego, w którym wystąpiły wyświetlenia playlisty. Wyniki są sortowane chronologicznie.
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 z Kalifornii, którzy oglądali filmy na tym kanale. Wyniki są posortowane według płci, a następnie według grupy wiekowej. Zapytanie można zmodyfikować tak, by pobierało te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z danego kraju, kontynentu, subkontynentu lub innego stanu w USA. W tym celu należy dostosować wartość parametru filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Raporty dotyczące playlist
Dane demograficzne odbiorcó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 oglądali playlisty na kanale. Wyniki są posortowane według płci, a następnie według grupy wiekowej. Zapytanie można zmodyfikować tak, by pobierało te same statystyki dotyczące wszystkich widzów z całego świata lub wszystkich widzów z danego kraju, kontynentu, subkontynentu lub innego stanu w USA. W tym celu należy dostosować wartość parametru filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Dane o udostępnieniach agregowane według usługi, w której udostępniono filmy
To żądanie podaje, ile razy użytkownicy użyli przycisku Share
, aby udostępnić filmy z kanału. Wyniki są agregowane według usługi udostępniania (Google+, Twitter itp.) i sortowane w kolejności malejącej według liczby udostępnień.
dimensions=sharingService metrics=shares sort=-shares
dane dotyczące utrzymania uwagi odbiorców dotyczące filmu,
Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla 1 filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID
w wartości parametru filters
identyfikatorem filmu jednego z przesłanych przez siebie filmów. Pamiętaj, że w raportach utrzymania uwagi odbiorców nie można określić wielu wartości filtra video
.
W tym przykładzie raport używa 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 sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream ani TrueView In-Display. Możesz usunąć ten filtr, aby pobrać dane o utrzymaniu uwagi odbiorców dotyczące 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 w przypadku zapytań, które używają filtra do próby pobrania danych z wcześniejszych dat. Zapytania, które nie korzystają z tego filtra, nie działają w przypadku dat po 1 lipca 2008 roku.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Dane dotyczące przychodów z kanału i skuteczności reklam
Pobiera ono dane o przychodach kanału i skuteczności reklam. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów 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 dzienne dane o przychodach kanału i skuteczności reklam.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Dane dotyczące przychodów i skuteczności reklam w poszczególnych krajach
To żądanie pobiera dane o przychodach z kanału i skuteczności reklam w danym kraju. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy kraj na liście będzie krajem, w którym partner uzyskał 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
Pobiera ono dane o przychodach i skuteczności reklam dla 10 filmów na kanale, które przyniosły największe przychody. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy film będzie miał najwyższe szacunkowe przychody.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
Dane o skuteczności reklam dla 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ą grupowane według typu reklamy, co pozwala porównać przychody i wartości CPM w przypadku różnych typów reklam.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Raporty właścicieli treści
Raporty na temat filmów
Łączna liczba wyświetleń, szacowany czas oglądania i inne informacje dotyczące wszystkich treści objętych roszczeniem
To zapytanie pobiera zbiorcze wskaźniki dotyczące treści objętych roszczeniem właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Liczby wyświetleń wszystkich przesłanych samodzielnie filmów w poszczególnych krajach
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 wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Łączna liczba wyświetleń (i więcej) wszystkich treści należących do osób trzecich, które są objęte roszczeniami
To zapytanie pobiera zbiorcze wskaźniki dotyczące filmów, 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 wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Łączna liczba wyświetleń (i inne) wszystkich przesłanych przez siebie treści
To zapytanie pobiera zbiorcze wskaźniki dotyczące filmów przesłanych przez właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Łączna liczba wyświetleń (i inne) wszystkich przesłanych przez siebie treści, które zostały objęte roszczeniem
To zapytanie pobiera zbiorcze dane o filmach, które właściciel treści przesłał i zgłosił do nich roszczenia. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 najpopularniejszych filmów przez właściciela treści
To zapytanie pobiera 10 najczęściej oglądanych filmów przesłanych przez właściciela treści według liczby wyświetleń w określonym zakresie dat. 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 właściciela treści
To zapytanie pobiera 10 najczęściej oglądanych filmów przesłanych przez właściciela treści według szacowanej liczby minut oglądania w podanym zakresie dat. Wyniki są sortowane 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 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 Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID
w wartości parametru filters
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
Top 10 – współczynniki klikalności adnotacji dla najczęściej oglądanych filmów na kanale
To żądanie pobiera liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji i wyświetlenia adnotacji dla 10 najczęściej oglądanych filmów w określonym kanale lub grupie kanałów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej, co oznacza, że najczęściej oglądany film będzie wymieniony jako pierwszy. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID
w wartości parametru filters
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
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
To żądanie pobiera informacje o łącznej liczbie początków odtwarzania playlisty, szacowanym czasie oglądania playlisty, liczbie wyświetleń playlisty i liczbie wyświetleń przypadającej na każdy początek playlisty w przypadku playlist na kanałach właściciela treści. Wartość playlistViews
uwzględnia tylko wyświetlenia filmów, które miały miejsce w kontekście playlisty. Wszystkie żądane dane są danymi na temat playlisty, więc żądanie nie musi też zawierać filtra playlisty ani grupy.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statystyki konkretnej playlisty
To żądanie pobiera łączną liczbę odtworzeń playlisty, szacowany czas oglądania, liczbę wyświetleń (zbiorcze dane o filmach), wyświetlenia playlisty (dane na playliście) oraz wyświetlenia przypadające na każde rozpoczęcie playlisty w przypadku określonej playlisty. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg PLAYLIST_ID
w wartości parametru filters
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
listą rozdzielonych przecinkami maksymalnie 500 identyfikatorów playlist na kanałach właściciela treści.
Raporty na temat filmów
Statystyki dziennego czasu oglądania treści przesłanych przez siebie
To zapytanie pobiera dane o dziennym czasie oglądania, a także liczby wyświetleń i odtworzeń generujących przychody oraz liczby wyświetleń filmów przesłanych przez właściciela treści. Raport zwraca po jednym wierszu danych dla każdego dnia w żądanym zakresie dat, a wiersze są posortowane w kolejności chronologicznej.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
Dane adnotacji dotyczące treści objętych roszczeniem
To żądanie pobiera dzienną liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz liczbę wyświetleń adnotacji dotyczących treści objętych roszczeniem właściciela treści. Wyniki są sortowane chronologicznie.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Raporty dotyczące playlist
Wyświetlenia playlisty dziennie przez właściciela treści
To żądanie pobiera dane o codziennych interakcjach użytkowników z filmami na playlistach właściciela treści. Dane pobrane w raporcie to playlistViews, playlistStarts, playlistEstimatedMinutesWatched i viewsPerPlaylistStart. Wszystkie te dane są podawane na playliście. Wszystkie żądane dane są danymi na temat playlisty, więc żądanie nie musi zawierać filtra playlisty ani grupy.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Raporty na temat filmów
Dane o czasie oglądania treści przesłanych przez siebie w poszczególnych krajach
To zapytanie pobiera liczby wyświetleń, dane o czasie oglądania i szacunkowe przychody z reklam w poszczególnych krajach. 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 można było obejrzeć filmy. Wiersze są sortowane w kolejności malejącej według liczby minut czasu oglądania.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Dane dotyczące adnotacji w poszczególnych krajach dotyczące treści przesł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 do 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, co oznacza, że kraj o najwyższym współczynniku klikalności adnotacji jest wymieniony jako pierwszy.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu
Pobiera ono podział na prowincje według liczby wyświetleń, szacowanego czasu oglądania i średniego czasu oglądania filmów objętych roszczeniami właściciela treści. Dane dotyczą stanów USA i Waszyngtonu. 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 miast w USA o największej łącznej liczbie wyświetleń
To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, z których pochodziło najwięcej wyświetleń filmów objętych roszczeniem właściciela treści w określonym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając filtra subContinent i jednej z jego prawidłowych wartości. Inne filtry również 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 o największej łącznej 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 wybranym zakresie dat dla każdego obsługiwanego elementu 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 pobiera listę 10 dni najpopularniejszych w wybranym zakresie dat, kiedy to dowolne miasto w Stanach Zjednoczonych miało największy łączny czas oglądania dziennie treści objętych roszczeniem właściciela treści. Wyniki zapytania zawierają całkowity czas oglądania, datę czasu oglądania oraz miasto, w którym według szacunków treści były oglądane. Wyniki są posortowane malejąco według łącznego czasu oglądania.
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
10 najpopularniejszych – najczęściej oglądane filmy w Europie
To zapytanie pobiera 10 najczęściej oglądanych filmów w Europie spośród filmów objętych roszczeniem przez właściciela treści. Liczba wyświetleń na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kontynentu, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając 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 na playlistach właściciela treści w poszczególnych krajach
To zapytanie pobiera liczbę wyświetleń playlist w poszczególnych krajach i dane o czasie oglądania playlisty dla wszystkich playlist na kanałach właściciela treści. Raport zwróci po jednym wierszu danych dla każdego kraju, w którym oglądano playlisty. Wiersze są posortowane malejąco według liczby obejrzanych minut.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
Top 10 – najczęściej odtwarzane playlisty w Stanach Zjednoczonych
To zapytanie pobiera 10 playlist z kanałów właściciela treści, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym zakresie dat. Wyniki są sortowane według liczby uruchomień playlisty w kolejności malejącej.
Uwaga: w tym raporcie używany jest wymiar playlist
, więc musisz określić wartość parametru żądania sort
, a także ustawić dla parametru maxResults
liczbę całkowitą nie mniejszą niż 10
.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Raporty na temat filmów
Oceny pozytywne i negatywne według typu treści
To zapytanie pobiera liczbę ocen pozytywnych i negatywnych dla każdego typu treści na określonym kanale lub 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
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
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 określony kanał lub grupę kanałów. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu. 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 CHANNEL_ID
w wartości parametru filters
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Dzienne liczby wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania w Stanach Zjednoczonych dla filmów przesłanych na określony kanał lub grupę kanałów. Wyniki są pogrupowane według dnia dla poszczególnych typów stron lub aplikacji, w których miały miejsce odtworzenia filmu. 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
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
Top 10 – witryny innych firm, które generują najwięcej wyświetleń dla 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, w której został umieszczony film. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. 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 przesłanych filmów, rozdzielonych przecinkami.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Raporty dotyczące playlist
liczby wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania.
To zapytanie pobiera liczbę wyświetleń playlist, szacowany czas oglądania playlisty i rozpoczęcia odtwarzania na wszystkich playlistach na kanałach właściciela treści. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu, a wyniki są sortowane w kolejności malejącej według rozpoczęcia odtwarzania playlisty.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
liczby wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania.
To zapytanie pobiera dzienną liczbę odtworzeń playlisty, liczbę wyświetleń playlist 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órej wystąpiły wyświetlenia playlisty.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Raporty na temat filmów
liczby 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, czyli w jaki sposób użytkownicy dotarli do filmu.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt
To żądanie pobiera dzienną liczbę wyświetleń i szacowany dzienny czas oglądania filmów właściciela treści. Dane są codziennie agregowane 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: 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 zawiera dodatkowych informacji, dlatego te raporty są dla niego niedostępne. Szczegółowe informacje o źródłach wizyt, w przypadku których dostępne są raporty tego typu, znajdziesz w definicji insightTrafficSourceType.
10 najpopularniejszych – słowa wyszukiwane 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 dotyczących określonego filmu lub grupy 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 przesłanych filmów, rozdzielonych przecinkami.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 największych witryn – witryny zewnętrzne, które generują największy ruch związany z filmem
To zapytanie pobiera 10 zewnętrznych witryn, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania Google dotyczących określonego filmu lub grupy filmów. Wyniki są sortowane według szacowanego czasu oglądania 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 przesłanych filmów, rozdzielonych przecinkami.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Raporty dotyczące playlist
liczby wyświetleń playlisty i czasu oglądania z różnych źródeł wizyt w danym kraju;
To żądanie pobiera liczbę wyświetleń playlisty, rozpoczęcia odtwarzania playlisty oraz szacowany czas oglądania playlisty w przypadku wyświetleń playlisty w danym kraju. Dane są agregowane według źródła wizyt, które określają, w jaki sposób użytkownicy dotarli do playlisty.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
liczby wyświetleń playlisty i czasu oglądania z różnych źródeł wizyt.
To żądanie pobiera wyświetlenia playlist, rozpoczęcia odtwarzania playlisty i szacowany czas oglądania playlist z co najmniej jednego kanału właściciela treści. Wskaźniki są agregowane według źródła wizyt. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID
w wartości parametru filters
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Raporty na temat filmów
Dzienne dane o typie urządzeń dotyczące filmów objętych roszczeniem
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według typu urządzenia dla filmów objętych roszczeniem przez konkretnego właściciela treści. Wyniki są pogrupowane według dnia dla każdego typu urządzeń, na których odtworzone zostały filmy. Wyniki są sortowane chronologicznie.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Dzienne dane o systemie operacyjnym dotyczące filmów objętych roszczeniem wyświetlanych na urządzeniach mobilnych
To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według systemu operacyjnego. Dotyczy to wyświetleń filmów objętych roszczeniem konkretnego właściciela treści, które miały miejsce na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla poszczególnych systemów operacyjnych, w których miały miejsce odtworzenia filmu. Wyniki są sortowane chronologicznie.
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 chronologicznie.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Raporty dotyczące playlist
Dane o typie urządzenia dotyczące wyświetleń playlist w systemie operacyjnym Android
To zapytanie pobiera liczby wyświetleń playlist i szacowany czas oglądania playlist na urządzeniach z Androidem w przypadku playlist z co najmniej jednego kanału właściciela treści. Wyniki są zwracane dla każdego typu urządzeń, na których wystąpiły wyświetlenia playlisty. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID
w wartości parametru filters
listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Dane o systemie operacyjnym dotyczące wyświetleń playlist na urządzeniach mobilnych
To zapytanie pobiera liczby wyświetleń playlist i szacowany czas oglądania playlist na urządzeniach mobilnych w przypadku playlist na dowolnym kanale właściciela treści. Wyniki są zwracane dla każdego systemu operacyjnego, w którym wystąpiły wyświetlenia playlisty.
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 z Kalifornii, którzy oglądali treści objęte roszczeniem właściciela treści. Wyniki są posortowane według płci, a następnie według grupy wiekowej. Zapytanie można zmodyfikować tak, by pobierało te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z danego kraju, kontynentu, subkontynentu lub innego stanu w USA. W tym celu należy dostosować wartość parametru filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Dane o udostępnieniach agregowane według usługi, w której udostępniono filmy
To żądanie sprawdza, ile razy użytkownicy użyli przycisku 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 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 dotyczące filmu,
Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla 1 filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID
w wartości parametru filters
identyfikatorem filmu jednego z przesłanych przez siebie filmów. Pamiętaj, że w raportach utrzymania uwagi odbiorców nie można określić wielu wartości filtra video
.
W tym przykładzie raport używa 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 sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream ani TrueView In-Display. Możesz usunąć ten filtr, aby pobrać dane o utrzymaniu uwagi odbiorców dotyczące 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 w przypadku zapytań, które używają filtra do próby pobrania danych z wcześniejszych dat. Zapytania, które nie korzystają z tego filtra, nie działają w przypadku dat 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
Pobiera ono dane o przychodach i skuteczności reklam dotyczące treści objętych roszczeniem właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów 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
Pobiera ono dane o dziennych przychodach i skuteczności reklam dotyczące 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 dotyczące przychodów i skuteczności reklam w poszczególnych krajach
Pobiera ono dane o przychodach i skuteczności reklam w poszczególnych krajach dotyczące treści objętych roszczeniem właściciela treści. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że kraj na liście jest krajem, w którym partner osiągnął 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 w 10 filmach, do których właściciel treści zgłosił roszczenie i które przyniosły największe przychody. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy film będzie miał 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 reklam dla 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ą grupowane według typu reklamy, co pozwala porównać przychody i wartości CPM w przypadku różnych typów reklam.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType