Ta strona zawiera listę raportów, które właściciele kanałów mogą pobierać za pomocą interfejsu YouTube Analytics API. Raporty kanału zawierają dane o aktywności użytkowników na określonym kanale i mierzą m.in. wyświetlenia filmów, oceny i liczbę subskrypcji.
Raporty na temat filmów zawierają statystyki dotyczące całej aktywności użytkownika związanej z filmami na kanale.
Raporty skuteczności reklam zawierają dane dotyczące przychodów i skuteczności reklam. Wykorzystują one wymiar adType do grupowania danych na podstawie typów reklam wyświetlanych podczas odtwarzania filmów. Sekcja raporty skuteczności reklam zawiera omówienie 2 rodzajów danych o skuteczności reklam obsługiwanych przez interfejs API.
Pobieranie raportu
Aby pobrać raport dotyczący kanałów, musisz ustawić w żądaniu do interfejsu API jedną z tych wartości parametru ids:
channel==MINE – interfejs API zwraca dane kanału YouTube uwierzytelnionego użytkownika.
channel==CHANNEL_ID – ustaw CHANNEL_ID na unikalny identyfikator kanału, z którego pobierasz dane. Użytkownik, który wyraził zgodę na przesłanie prośby, musi być właścicielem kanału.
Identyfikator kanału jest obecnie ciągiem znaków rozpoczynającym się od liter UC, ale jego format może ulec zmianie. Identyfikator kanału znajdziesz na stronie zaawansowanych ustawień konta kanału w YouTube. Możesz go też pobrać automatycznie, korzystając z metody YouTube Data API'schannels.list.
Upoważnienie
Wszystkie żądania do interfejsu YouTube Analytics API muszą być autoryzowane. W przewodniku po autoryzacji dowiesz się, jak używać protokołu OAuth 2.0 do pobierania tokenów autoryzacji.
Żądania do interfejsu YouTube Analytics API używają tych zakresów autoryzacji:
Wyświetlanie raportów Statystyk YouTube dotyczących treści w YouTube. Ten zakres zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i liczba ocen.
Wyświetlanie raportów finansowych Statystyk YouTube dotyczących treści w YouTube. Ten zakres zapewnia dostęp do danych o aktywności użytkowników oraz szacunkowych danych o przychodach i skuteczności reklam.
https://www.googleapis.com/auth/youtube
Zarządzaj kontem YouTube. W YouTube Analytics API właściciele kanałów używają tego zakresu do zarządzania grupami i elementami grupowania w Statystykach YouTube.
https://www.googleapis.com/auth/youtubepartner
Wyświetlanie zasobów YouTube i powiązanych treści w YouTube oraz zarządzanie nimi. W YouTube Analytics API właściciele treści używają tego zakresu do zarządzania grupami i elementami w Statystykach YouTube.
Uwaga: raporty dotyczące kanałów nie obsługują obecnie danych o szacunkowych przychodach i skuteczności reklam. W efekcie zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie umożliwia obecnie dostępu do danych pieniężnych w tych raportach.
Filtry
Tabele, które opisują obsługiwane raporty, wskazują filtry, których można użyć w poszczególnych raportach. W tabelach filtry w nawiasach są opcjonalne. Na przykład w przypadku opcji filtrowania video(,country) wymagany jest filtr wideo, a filtr kraju jest opcjonalny.
Interfejs API umożliwia też określenie wielu wartości filtrów video i playlist. Jeśli podasz wiele wartości dla jednego z tych filtrów, możesz go dodać do listy wymiarów określonych dla żądania. Dzieje się tak nawet wtedy, gdy filtr nie jest wymieniony na liście wymiarów obsługiwanych w danym raporcie.
Dokładne wyjaśnienie sposobu filtrowania wyników interfejsu API pod kątem konkretnej wartości lub zbioru wartości znajdziesz w definicji parametru filters.
Omówienie tabel raportów
W tej sekcji opisano formatowanie i terminologię używane w tabelach definiujących raporty obsługiwane przez interfejs API. W tabeli poniżej znajdziesz wymiary, dane i filtry obsługiwane w raporcie ze szczegółami odtwarzania dotyczącymi reklam wideo wykorzystujących wymiar czasu i dane averageViewPercentage.
Tabela zawiera dwa wiersze na wymiary, jeden na dane i trzy na filtry. W przypadku wymiarów i filtrów wartości z każdego wiersza można połączyć w żądaniu do interfejsu API, o ile jest ona zgodna z regułami użycia podanymi w tabeli. Na przykład prawidłowe wartości parametrów dimensions w tym raporcie obejmują:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Wartość parametru day,month jest jednak nieprawidłowa, ponieważ używa 2 wymiarów opartych na czasie, ale w żądaniu może być używana wartość 0 lub 1. W tym przypadku wartość parametru subscribedStatus,youtubeProduct faktycznie zwraca raport, ale dane nie są agregowane według dnia, tygodnia, miesiąca itp. (Ten raport jest dokumentowany oddzielnie w dokumentacji).
Terminologia tabeli raportów
W tabelach do określenia, czy wymiary są wymagane, czy opcjonalne, używana jest ta terminologia:
Te terminy oznaczają, że wymagana jest wartość:
Wymagane: musisz podać wartość.
Użyj dokładnie 1: musisz podać jedną wartość z grupy.
Użyj 1 lub więcej: możesz uwzględnić dowolne wartości z grupy lub wszystkie, ale musisz uwzględnić co najmniej 1 wartość.
Te terminy oznaczają, że wartość jest opcjonalna:
Opcjonalnie: możesz podać wartość.
Użyj 0 lub 1: możesz dodać 1 wartość z grupy.
Użyj 0 lub większej liczby: możesz uwzględnić wszystkie wartości z grupy lub wybrane z nich.
Raporty na temat filmów
Podstawowe statystyki
Podstawowe statystyki aktywności użytkowników
Ten raport zawiera statystyki dotyczące działań użytkowników na kanale. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące konkretnego filmu lub kraju.
Podstawowe statystyki aktywności użytkowników w stanach w USA
Raport zawiera statystyki dotyczące konkretnego stanu w USA lub Dystryktu Kolumbii. Pamiętaj, że ten raport obsługuje tylko podzbiór danych dostępnych w tym raporcie.
Aktywność użytkowników według kraju w określonych przedziałach czasu
Ten raport zawiera statystyki dotyczące działań użytkowników w kanale w wybranych przedziałach czasu. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące konkretnego filmu lub kraju.
Aktywność użytkowników w stanach w USA w określonych przedziałach czasu
Ten raport zawiera statystyki dotyczące aktywności użytkowników w konkretnym stanie w USA lub Dystrykcie Kolumbii. Pamiętaj, że ten raport obsługuje tylko podzbiór danych dostępnych w tym raporcie.
Zawiera on statystyki dotyczące aktywności użytkowników kanału z podziałem na kraje. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące konkretnego filmu.
Ten raport zawiera statystyki aktywności użytkowników w stanach w USA i Dystrykcie Kolumbii. Na potrzeby tego raportu musisz ustawić wartość parametru filters na country==US.
Aktywność użytkowników według miasta (<= 250 wyników)
Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą nie większą niż 250. W odróżnieniu od większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.
Ten raport zawiera statystyki aktywności użytkowników według miasta.
Ten raport zawiera dane o aktywności użytkowników dotyczące subskrybentów i widzów bez subskrypcji. Statystyki można grupować według przedziału czasowego (dzień lub miesiąc) oraz filtrować według kraju, kontynentu lub subContinent.
Aktywność użytkowników według stanu subskrypcji dla prowincji
Ten raport zawiera dane o aktywności użytkowników dotyczące subskrybentów i widzów bez subskrypcji, ze stanów w Stanach Zjednoczonych lub Dystrykcie Kolumbii. Ten raport obsługuje mniej rodzajów danych niż poprzedni.
Szczegóły odtwarzania z opcjonalnym wymiarem czasu
Wymiar czasu – dzień lub miesiąc – jest opcjonalny w tych raportach, bo niezależnie od tego, jaki zakres dat ma zostać uwzględniony w raporcie, musisz użyć parametrów żądania startDate i endDate. Jeśli istnieje odpowiedni wymiar, wskazuje, że chcesz, aby dane w raporcie były agregowane według dnia, miesiąca itp.
Szczegóły odtwarzania z opcjonalnym wymiarem czasu i statystykami liveOrOnDemand
Raport ten zawiera statystyki dotyczące szczegółów odtwarzania w określonych przedziałach czasu. Obsługuje wymiar (i filtr) liveOrOnDemand.
Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.
Ten raport wskazuje umieszczone odtwarzacze wideo, które wygenerowały najwięcej wyświetleń lub czasu oglądania filmów na kanale.
Ten raport przedstawia zbiorcze statystyki wyświetleń na podstawie tego, w jaki sposób widzowie dotarli do Twojej treści wideo. Wskazuje ona np. liczbę wyświetleń, które pochodzą z wyszukiwania w Google lub z linku do podobnego filmu.
Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.
Ten raport przedstawia zbiorcze statystyki na podstawie stron odsyłających, które wygenerowały najwięcej wyświetleń treści na kanale. Strony odsyłające są podzielone na kategorie według typu źródła wizyt. Definicja wymiaru insightTrafficSourceDetail wskazuje źródła wizyt, dla których dostępny jest raport. Jeśli na przykład ustawisz filtr insightTrafficSourceType na wartości ADVERTISING, w raporcie znajdą się typy reklam, które wygenerowały najwięcej wyświetleń lub czasu oglądania treści na kanale.
Uwaga: ten raport jest dostępny tylko w przypadku określonych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie zawiera dodatkowych informacji, dlatego nie obsługuje tego raportu. Aby dowiedzieć się, które źródła wizyt obsługują ten raport, zapoznaj się z definicją narzędzia insightTrafficSourceType.
Typ urządzenia i system operacyjny
Typ urządzenia
Ten raport przedstawia zbiorcze statystyki wyświetleń na podstawie tego, w jaki sposób widzowie dotarli do Twojej treści wideo. Pozwalają na przykład określić liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.
W tym raporcie znajdują się zbiorcze statystyki wyświetlania pochodzące z systemów operacyjnych widzów. Pozwalają na przykład określić liczbę wyświetleń na urządzeniach z Androidem lub konsolach PlayStation.
Ten raport przedstawia zbiorcze statystyki wyświetleń według systemów operacyjnych i typów urządzeń widzów. Pozwalają na przykład określić liczbę wyświetleń na tabletach z Androidem lub komputerach z systemem Windows.
Możesz użyć filtrów, by uwzględnić w raporcie tylko dane viewerPercentage dla jednej wartości (lub kombinacji wartości) wymiarów szczegółów odtwarzania.
Zaangażowanie i udostępnianie treści
Ten raport zawiera statystyki pokazujące, jak często filmy z kanału były udostępniane na różnych platformach społecznościowych.
Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Wymiar elapsedVideoTimeRatio mierzy czas, jaki upłynął od momentu wyświetlenia filmu, w przypadku odpowiednich wartości danych. audienceWatchRatio i relativeRetentionPerformance podają 2 wskaźniki, które pokazują, w jakim stopniu film utrzymuje uwagę odbiorców. Pierwszy jest wartością bezwzględną, a drugi pokazuje, jak film radzi sobie w porównaniu z innymi filmami w YouTube o podobnej długości.
Uwaga: w raportach Utrzymanie uwagi odbiorców nie można utworzyć listy wartości filtra video rozdzielonych przecinkami. Wartość musi określać pojedynczy identyfikator filmu.
Uwaga: te raporty wymagają ustawienia parametru maxResults na liczbę całkowitą nie większą niż 200. Dane sprzed 1 stycznia 2013 r. obejmują tylko 10 najpopularniejszych filmów. W odróżnieniu od większości innych raportów te raporty wymagają również określenia wartości parametru żądania sort.
Najpopularniejsze filmy z opcjonalnymi filtrami regionalnymi (<= 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów na kanale. Raport można filtrować, aby wyświetlić najlepsze filmy według kraju, kontynentu lub subContinent.
Raport zawiera listę najpopularniejsze filmy na kanale w danym stanie w Stanach Zjednoczonych lub Dystrykcie Kolumbii. Pamiętaj, że ten raport obsługuje tylko podzbiór danych dostępnych w tym raporcie.
Najpopularniejsze filmy dla widzów z subskrypcją i bez subskrypcji(<= 200 wyników)
Ten raport zawiera listę filmów na kanale, które są najpopularniejsze wśród widzów z subskrypcją i bez subskrypcji. Raport można filtrować, aby wyświetlić najlepsze filmy według kraju, kontynentu lub subContinent. Poprzedni raport pozwala Ci pobrać najpopularniejsze filmy w określonym stanie w USA wśród widzów z subskrypcją i bez subskrypcji, ale obsługuje on mniej danych niż ten raport.
Najpopularniejsze filmy według usługi YouTube (<= 200 wyników)
Raport ten zawiera listę najpopularniejszych filmów na kanale i obsługuje filtry szczegółów odtwarzania oraz filtry geograficzne. Ten raport jest podobny do poprzedniego, ale obsługuje mniej danych i obsługuje filtr youtubeProduct.
Najpopularniejsze filmy z filtrami szczegółów odtwarzania (<= 200 wyników)
Raport ten zawiera listę najpopularniejszych filmów na kanale i jest filtrowany według dowolnych lub wszystkich wymiarów związanych ze szczegółami odtwarzania: liveOrOnDemand, subscribedStatus i youtubeProduct. W przeciwieństwie do poprzedniego raportu ten raport obsługuje filtr liveOrOnDemand i nie obsługuje danych averageViewPercentage.
Raporty dotyczące playlist zawierają dane związane z aktywnością użytkowników związaną z filmami na playlistach właściciela kanału. Dostępne są 2 wersje tych raportów. Przy każdym dostępnym raporcie znajdują się następujące sekcje zawierające opis każdej z nich:
Karta Zalecane w każdej sekcji opisuje preferowany format żądania do interfejsu API do pobierania odpowiedniego raportu. Zalecane raporty korzystają z rozszerzonego zestawu danych, który obejmuje zarówno zbiorcze dane o filmach, jak i dane dotyczące playlist. Ten format żądania nie używa wymiaru isCurated.
Karta Używanie isCurated w każdej sekcji opisuje starszy format żądania do interfejsu API, w którym wymagany jest wymiar isCurated. Te raporty obsługują tylko dane dotyczące playlist. Pamiętaj, że wymiar isCurated został wycofany w przypadku wszystkich raportów. Harmonogram wycofywania zawiera komunikat z ostrzeżeniem.
Poniżej znajduje się ostrzeżenie, w którym szczegółowo wyjaśniamy zmiany w obu wersjach raportu.
Zbiorcze dane o reklamach wideo
Te dane dostarczają zagregowanych danych o aktywności użytkowników i wyświetleniach dotyczących wszystkich filmów z playlisty, które są też własnością kanału, który jest właścicielem tej playlisty. Dane dotyczące filmów należących do innych kanałów nie są obliczane przez agregację. Jeśli więc kanał utworzy playlistę, która zawiera tylko filmy należące do innych kanałów, raporty dotyczące tych playlist nie będą zawierać wartości tych danych.
Te dane odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Obejmują one wyświetlenia wszystkich filmów z playlisty niezależnie od tego, do którego kanału należą, ale zliczają tylko wyświetlenia w kontekście playlisty.
Ten raport zawiera statystyki dotyczące interakcji użytkowników z filmami z playlist na kanale. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące określonej playlisty.
Ten raport zawiera statystyki dotyczące interakcji użytkowników z filmami z playlist na kanale. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące określonej playlisty.
Ten raport zawiera statystyki aktywności związanej z playlistami w stanach USA i Dystrykcie Kolumbii.
W przypadku tego raportu musisz przefiltrować wyniki, aby wyświetlić tylko dane dotyczące Stanów Zjednoczonych.
Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.
Ten raport wskazuje umieszczone odtwarzacze wideo, które wygenerowały najwięcej wyświetleń lub czasu oglądania filmów z playlist na kanale.
Ten raport przedstawia zbiorcze statystyki wyświetleń na podstawie tego, jak widzowie trafili na Twoje playlisty.
Wskazuje na przykład liczbę wyświetleń pochodzących z wyszukiwania w Google.
Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.
Ten raport przedstawia zbiorcze statystyki wyświetleń na podstawie stron odsyłających, które wygenerowały najwięcej wyświetleń filmów z playlist na kanale. Strony odsyłające są dzielone na kategorie według typu źródła wizyt, a definicja wymiaru insightTrafficSourceDetail wskazuje źródła wizyt, dla których dostępny jest raport.
Jeśli np. ustawisz filtr insightTrafficSourceType na ADVERTISING, w raporcie zobaczysz rodzaje reklam, które wygenerowały najwięcej wyświetleń lub najwięcej czasu oglądania na playlistach kanału.
Uwaga: ten raport jest dostępny tylko w przypadku określonych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie zawiera dodatkowych informacji, dlatego nie obsługuje tego raportu. Aby dowiedzieć się, które źródła wizyt obsługują ten raport, zapoznaj się z definicją narzędzia insightTrafficSourceType.
Typ urządzenia i system operacyjny
Typ urządzenia
Ten raport przedstawia zbiorcze statystyki wyświetleń na podstawie tego, jak widzowie dotarli do filmów z Twoich playlist. Wskazuje on np. liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.
W tym raporcie znajdują się zbiorcze statystyki wyświetlania pochodzące z systemów operacyjnych widzów. Określa on na przykład liczbę wyświetleń na urządzeniach z Androidem lub konsolach PlayStation.
Ten raport przedstawia zbiorcze statystyki wyświetleń według systemów operacyjnych i typów urządzeń widzów.
Wskazuje na przykład, ile wyświetleń miało miejsce na tabletach z Androidem lub komputerach z systemem Windows.
Uwaga: wartości viewerPercentage w tym raporcie nie są normalizowane pod kątem różnych wartości wymiaru szczegółów odtwarzania subscribedStatus.
Na przykład raport korzystający z wymiaru subscribedStatus zwraca w przypadku wyświetleń z subskrypcją dane viewerPercentage do 100 procent iviewerPercentage do 100 procent wyświetleń. (Łączna wartość wszystkich pól viewerPercentage w raporcie wynosi 200 procent).
Uwaga: te raporty wymagają ustawienia parametru maxResults na liczbę całkowitą nie większą niż 200. Dane sprzed 1 stycznia 2013 r. obejmują tylko 10 najpopularniejszych playlist. W odróżnieniu od większości innych raportów te raporty wymagają również określenia wartości parametru żądania sort.
Raport zawiera listę najpopularniejszych playlist na kanale według określonych kryteriów filtrowania i sortowania.
Uwaga: raporty skuteczności reklam wymagają tokena autoryzacji, który przyznaje dostęp do zakresu https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Raporty skuteczności reklam zawierają dane oparte na wyświetleniach reklam, które pojawiły się w trakcie odtwarzania filmów. Te dane uwzględniają każde wyświetlenie reklamy, a każde odtworzenie filmu może spowodować wiele wyświetleń.
Dane o skuteczności reklam zależne od liczby wyświetleń:
Dodatkowo niektóre raporty na temat filmów uwzględniają podane niżej dane o skuteczności reklam wg odtworzeń. Dane te nie są jednak uwzględniane w raportach skuteczności reklam.
