Uwaga:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
Ta strona zawiera listę raportów, które właściciele treści mogą pobierać za pomocą interfejsu YouTube Analytics API. Raporty właściciela treści zawierają dane dotyczące kanałów powiązanych z określonym właścicielem treści w YouTube. Dane to indywidualne pomiary aktywności użytkowników, skuteczności reklam lub szacunkowych przychodów.
Raporty na temat filmów zawierają dane o aktywności użytkowników, skuteczności reklam oraz szacunkowych przychodach z filmów na kanałach właściciela treści.
Raporty dotyczące playlist zawierają statystyki dotyczące wyświetleń filmów w kontekście playlisty. Raporty dotyczące playlist korzystają z wielu tych samych wymiarów i filtrów co raporty o filmach.
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 właściciela treści, wywołaj metodę reports.query interfejsu API i ustaw wartość parametru ids w żądaniu do interfejsu API na contentOwner==OWNER_NAME, gdzie OWNER_NAME określa identyfikator właściciela treści. Jeśli nie masz pewności co do tych wartości, zapytaj swojego menedżera ds. partnera.
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: dane oznaczone gwiazdką (*) wymagają tokena autoryzacji, który przyznaje dostęp do zakresu https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Filtry
Wszystkie żądania interfejsu API pobierania raportów właściciela treści muszą filtrować dane za pomocą wymiaru video, channel, wymiaru isCurated lub obsługiwanej kombinacji wymiarów claimedStatus i uploaderType. (Obsługiwane kombinacje są wymienione w definicji wymiaru uploaderType).
Tabele, które opisują obsługiwane raporty, wskazują filtry, których można używać w każdym raporcie. W opisach filtry podane w nawiasach są opcjonalne. Jeśli na przykład w raporcie znajduje się opcja filtrowania video(,country), może on zostać przefiltrowany, by uwzględnić dane dotyczące tylko konkretnego filmu lub tylko dane dotyczące konkretnego filmu w konkretnym kraju.
Interfejs API umożliwia też określenie wielu wartości filtrów video, playlist i channel. 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.
Ważne: wszystkie żądania do interfejsu API umożliwiające pobieranie raportów o filmach przesłanych przez właścicieli treści muszą filtrować dane przy użyciu wymiaru video, channel, wymiaru group lub obsługiwanej kombinacji wymiarów claimedStatus i uploaderType. (Niektóre raporty nie obsługują wszystkich tych opcji). Obsługiwane kombinacje, które są też wymienione w definicji wymiaru uploaderType, to:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
Raporty na temat filmów
Podstawowe statystyki
podstawowe statystyki (w tym liczba subskrybentów);
Ten raport zawiera statystyki dotyczące działań użytkowników na wszystkich kanałach właściciela treści. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące konkretnego filmu lub kraju. Za jego pomocą można też pobierać statystyki dotyczące tylko treści objętych roszczeniem, w tym treści objętych roszczeniem przesłanych przez właściciela treści, osoby trzecie lub obu tych typów treści.
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.
Ten raport zawiera statystyki dotyczące działań użytkowników na wszystkich kanałach właściciela treści w wybranym przedziale 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
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.
Ten raport zawiera statystyki aktywności użytkowników dotyczące wszystkich kanałów właściciela treści, z podziałem na kraje. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące konkretnego filmu lub kanału.
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.
Raporty o szczegółach odtwarzania zawierają statystyki dotyczące następujących atrybutów wyświetlania:
Czy oglądano transmisję na żywo czy film na żądanie?
Czy widz subskrybował kanał, do którego należy film?
W której usłudze YouTube miało miejsce wyświetlenie?
Z technicznego punktu widzenia wymiary dotyczące szczegółów odtwarzania obsługiwane przez te raporty są opcjonalne. Jeśli w żądaniu nie uwzględnisz wymiarów szczegółów odtwarzania, zwrócony raport będzie podobny do jednego z raportów podstawowych, związanych z czasem lub danych geograficznych użytkownika.
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 treści należących do właściciela treści. Pobierając ten raport, ustaw filtr insightPlaybackLocationType na EMBEDDED.
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.
W tym raporcie zebrane są statystyki wyświetlania oparte na stronach odsyłających, które wygenerowały najwięcej wyświetleń treści należących do właściciela treści. 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 np. 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 należących do właściciela treści.
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 zawiera dane zbiorcze według typu urządzenia, na którym widzowie oglądali Twoje treści. Wskazuje na przykład liczbę wyświetleń na tabletach 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.
Uwaga: wartości parametru viewerPercentage w tym raporcie nie są normalizowane w przypadku różnych wartości wymiaru szczegółów odtwarzania subscribedStatus.
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 ogółem, według kraju, kontynentu lub subkontynentu (<= 200 wyników)
Raport zawiera listę najpopularniejszych filmów właściciela treści według określonych kryteriów filtrowania i sortowania.
Najpopularniejsze filmy w całym stanie w USA (<= 200)
Raport zawiera listę najlepszych filmów właściciela treści 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, 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 i obsługuje szczegóły 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 właściciela treści i jest filtrowany według co najmniej jednego wymiaru szczegółów odtwarzania: liveOrOnDemand, subscribedStatus i youtubeProduct. Raport można też filtrować według regionu.
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 znajdującymi się na playlistach na kanałach właściciela treści. Raport nie zawiera wymaganych wymiarów.
Ten raport zawiera statystyki związane z interakcjami użytkowników z filmami na playlistach na kanałach właściciela treści w określonych przedziałach czasowych. Możesz przefiltrować raport, aby wyświetlić tylko dane dotyczące określonej playlisty lub kanału.
Ten raport zawiera statystyki aktywności związanej z playlistami w stanach USA i Dystrykcie Kolumbii. Na potrzeby tego raportu jako wartość parametru filters podasz country==US.
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 na playlistach właściciela treści.
Ten raport przedstawia zbiorcze statystyki wyświetleń na podstawie tego, jak widzowie trafili na Twoje playlisty. Wskazuje na przykład liczbę wyświetleń, które pochodzą z wyszukiwania w Google lub strony kanału.
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ń playlist właściciela treści. 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 w przypadku playlist właściciela treści.
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 – playlisty
Ten raport przedstawia zbiorcze statystyki na podstawie typu urządzeń, za pomocą których widzowie oglądali Twoje playlisty. 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ń playlisty na urządzeniach z Androidem lub konsolach PlayStation.
System operacyjny i typ urządzenia w przypadku playlist
Ten raport przedstawia zbiorcze statystyki wyświetleń według systemów operacyjnych i typów urządzeń widzów. Ta wartość określa na przykład liczbę wyświetleń playlisty, które wystąpiły 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 ani kombinacji wartości wymiarów szczegółów odtwarzania (subscribedStatus i youtubeProduct).
Na przykład raport, w którym korzysta się z wymiaru subscribedStatus, zwraca dane o viewerPercentage przez wzrost wartości o 100% w przypadku wyświetleń subskrypcji i do zwiększenia wartości wyświetleń subskrypcji. viewerPercentage (Łączna wartość wszystkich pól viewerPercentage w raporcie wynosi 200 procent).
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.
Najpopularniejsze playlisty
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 właściciela treści 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.
