Na tej stronie znajdziesz listę raportów, które właściciele kanałów mogą pobierać za pomocą interfejsu YouTube Analytics API. Raporty dotyczące kanału zawierają dane o aktywności użytkowników na określonym kanale i mierzą takie wartości jak liczba wyświetleń filmów, oceny i liczba subskrypcji.
- Raporty dotyczące filmów zawierają statystyki dotyczące całej aktywności użytkowników związanej z filmami na kanale.
- Raporty dotyczące playlist zawierają statystyki dotyczące wyświetleń filmów, które mają miejsce w kontekście playlisty.
-
Raporty skuteczności reklam zawierają dane dotyczące przychodów i skuteczności reklam. Używają one wymiaru adType, aby grupować dane na podstawie typów reklam wyświetlanych podczas odtwarzania filmów. W sekcji Raporty skuteczności reklam znajdziesz wyjaśnienie 2 rodzajów danych o skuteczności reklam, które obsługuje interfejs API.
Pobieranie raportu
Aby pobrać raport o kanale, musisz ustawić wartość parametru ids w żądaniu do interfejsu API na jedną z tych wartości:
-
channel==MINE – interfejs API zwraca dane dotyczące kanału YouTube uwierzytelnionego użytkownika.
-
channel==CHANNEL_ID – ustaw CHANNEL_ID na unikalny identyfikator kanału, z którego pobierasz dane. Użytkownik autoryzujący żądanie musi być właścicielem kanału.
Identyfikator kanału to obecnie ciąg znaków rozpoczynający się od liter UC, ale jego format może ulec zmianie. (Identyfikator kanału znajdziesz na stronie zaawansowanych ustawień konta na kanale w YouTube. Możesz też pobrać identyfikator kanału programowo za pomocą metody YouTube Data API's channels.list).
Autoryzacja
Wszystkie żądania do interfejsu YouTube Analytics API muszą być autoryzowane. W przewodniku po autoryzacji znajdziesz informacje o tym, jak używać protokołu OAuth 2.0 do pobierania tokenów autoryzacji.
Żądania do interfejsu YouTube Analytics API korzystają z tych zakresów autoryzacji:
| Zakresy |
| https://www.googleapis.com/auth/yt-analytics.readonly |
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 ocen. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
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 do szacunkowych danych o przychodach i skuteczności reklam. |
| https://www.googleapis.com/auth/youtube |
Zarządzanie kontem YouTube. Właściciele kanałów używają tego zakresu w interfejsie YouTube Analytics API do zarządzania grupami Statystyk YouTube i elementami grup. |
| https://www.googleapis.com/auth/youtubepartner |
Przeglądaj zasoby YouTube oraz powiązane treści i zarządzaj nimi w serwisie YouTube. W interfejsie YouTube Analytics API właściciele treści używają tego zakresu do zarządzania grupami Statystyk YouTube i elementami grup. |
Uwaga: w raportach dotyczących kanałów nie są obecnie obsługiwane szacunkowe przychody ani dane o skuteczności reklam. W związku z tym zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie daje obecnie dostępu do danych pieniężnych w tych raportach.
Filtry
W tabelach z opisem obsługiwanych raportów znajdziesz filtry, których możesz używać w poszczególnych raportach. W tabelach filtry podane w nawiasach są opcjonalne. Na przykład w przypadku opcji filtrowania video(,country) filtr film jest wymagany, a filtr kraj jest opcjonalny.
Interfejs API umożliwia też określanie wielu wartości filtrów video i playlist. Jeśli określisz wiele wartości dla jednego z tych filtrów, możesz też dodać ten filtr do listy wymiarów określonych w żądaniu. Dzieje się tak nawet wtedy, gdy filtr nie jest wymieniony jako obsługiwany wymiar w przypadku danego raportu.
Pełne wyjaśnienie, jak filtrować wyniki interfejsu API pod kątem określonej wartości lub zbioru wartości, znajdziesz w definicji parametru filters.
Interpretowanie tabel raportów
W tej sekcji wyjaśniamy formatowanie i terminologię używaną w tabelach, które definiują raporty obsługiwane przez interfejs API. W tabeli poniżej znajdziesz listę wymiarów, danych i filtrów obsługiwanych w raporcie szczegółów odtwarzania filmu z wymiarem czasu i danymi averageViewPercentage.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Tabela zawiera 2 wiersze wymiarów, 1 wiersz danych i 3 wiersze filtrów. W przypadku wymiarów i filtrów wartości z każdego wiersza można łączyć w żądaniu API, o ile kombinacja jest zgodna z regułami użycia w tabeli. Prawidłowe wartości parametru dimensions w tym raporcie to na przykład:
dimensions=daydimensions=day,subscribedStatusdimensions=month,subscribedStatus,youtubeProductdimensions=month,youtubeProduct
Wartość parametru day,month jest jednak nieprawidłowa, ponieważ używa 2 wymiarów opartych na czasie, a żądanie musi używać wartości 0 lub 1.
Terminologia tabeli raportu
W tabelach używamy tych terminów, aby określić, czy wymiary są wymagane czy opcjonalne:
- Te terminy oznaczają, że wartość jest wymagana:
- Wymagane: musisz podać wartość.
- Użyj dokładnie 1: musisz podać jedną wartość z grupy.
- Użyj co najmniej 1 wartości: możesz uwzględnić dowolne lub wszystkie wartości z grupy, ale musisz uwzględnić co najmniej 1.
- Te terminy oznaczają, że wartość jest opcjonalna:
- Opcjonalnie: możesz uwzględnić tę wartość.
- Użyj wartości 0 lub 1: możesz uwzględnić jedną wartość z grupy.
- Użyj co najmniej 0 wartości: możesz uwzględnić dowolną liczbę wartości z grupy.
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 filtrować raport, aby wyświetlać tylko dane dotyczące konkretnego filmu lub kraju.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtry: |
|
Podstawowe statystyki aktywności użytkowników w poszczególnych stanach USA
Ten 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 opisanym powyżej raporcie dotyczącym konkretnego kraju.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
Zależne od czasu
Aktywność użytkowników według kraju w określonych przedziałach czasu
Ten raport zawiera statystyki dotyczące działań użytkowników na kanale w określonych przedziałach czasu. Możesz filtrować raport, aby wyświetlać tylko dane dotyczące konkretnego filmu lub kraju.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtry: |
|
Aktywność użytkowników w stanach USA w określonych przedziałach czasu
Ten raport zawiera statystyki aktywności użytkowników w danym stanie USA lub w Dystrykcie Kolumbii. Pamiętaj, że ten raport obsługuje tylko podzbiór danych dostępnych w opisanym powyżej raporcie dotyczącym konkretnego kraju.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
Lokalizacja użytkownika
Aktywność użytkowników według kraju
Ten raport zawiera statystyki dotyczące aktywności użytkowników na kanale w poszczególnych krajach. Możesz filtrować raport, aby wyświetlać tylko dane dotyczące konkretnego filmu.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtry: |
|
Aktywność użytkowników według województwa
Ten raport zawiera statystyki aktywności użytkowników w poszczególnych stanach USA i Dystrykcie Kolumbii.
W przypadku tego raportu musisz ustawić wartość parametru filters na country==US.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
Aktywność użytkowników według miasta (maks. 250 wyników)
Uwaga: w tym raporcie musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 250. W odróżnieniu od większości innych raportów ten raport wymaga też podania wartości parametru żądania sort.
Ten raport zawiera statystyki aktywności użytkowników według miast.
Aktywność użytkowników według obszaru rynkowego
Ten raport zawiera statystyki aktywności użytkowników według wyznaczonego obszaru rynkowego (DMA). W przypadku tego raportu musisz ustawić wartość parametru filters na country==US lub odfiltrować dane według konkretnego województwa (stanu w USA).
Szczegóły odtwarzania
Raporty ze szczegółami odtwarzania zawierają statystyki dotyczące tych atrybutów wyświetlania:
- Czy wyświetlenie dotyczyło transmisji na żywo czy filmu na żądanie?
- Czy widz subskrybował kanał, do którego należy film?
- W której usłudze YouTube miało miejsce wyświetlenie?
Uwaga: wymiar i filtr liveOrOnDemand nie mogą być używane w połączeniu z danymi averageViewPercentage. W każdej z tych sekcji znajdziesz 2 raporty. Jeden raport obsługuje wymiar (i filtr) liveOrOnDemand, a drugi – dane averageViewPercentage.
Aktywność użytkowników według stanu subskrypcji
Ten raport zawiera dane o aktywności użytkowników, którzy subskrybują Twój kanał, i tych, którzy tego nie robią. Statystyki można grupować według okresu (dzień lub miesiąc), a raport można też filtrować według kraju, kontynentu lub subContinent.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
Aktywność użytkowników według stanu subskrypcji w przypadku prowincji
Ten raport zawiera dane o aktywności użytkowników, którzy subskrybują Twój kanał, i tych, którzy tego nie robią, w poszczególnych stanach USA lub w Dystrykcie Kolumbii. Ten raport obsługuje mniej danych niż poprzedni.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
Szczegóły odtwarzania z opcjonalnym wymiarem czasu
Wymiar czasu – dzień lub miesiąc – jest w tych raportach opcjonalny, ponieważ niezależnie od tego musisz użyć parametrów żądania startDate i endDate, aby określić zakres dat, który ma obejmować raport. Wymiar, jeśli występuje, oznacza, ż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
Ten raport zawiera szczegółowe statystyki odtwarzania w określonych przedziałach czasu. Obsługuje wymiar (i filtr) liveOrOnDemand.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły odtwarzania z opcjonalnym wymiarem czasu i danymi averageViewPercentage
Ten raport zawiera szczegółowe statystyki odtwarzania w określonych przedziałach czasu. Obsługuje rodzaj danych averageViewPercentage.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły odtwarzania według kraju
Szczegóły odtwarzania według kraju ze statystykami liveOrOnDemand
Ten raport zawiera szczegółowe statystyki odtworzeń w poszczególnych krajach. Obsługuje wymiar (i filtr) liveOrOnDemand.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły odtwarzania według kraju z wykorzystaniem danych averageViewPercentage
Poniższy raport jest podobny do poprzedniego. Dodaje obsługę danych averageViewPercentage, ale nie obsługuje liveOrOnDemand jako wymiaru ani filtra.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły odtwarzania według prowincji
Szczegóły odtwarzania według województwa ze statystykami liveOrOnDemand
Ten raport zawiera szczegółowe statystyki odtwarzania w poszczególnych stanach USA i Dystrykcie Kolumbii. Obsługuje wymiar (i filtr) liveOrOnDemand.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły odtwarzania według prowincji z danymi averageViewPercentage
Poniższy raport jest podobny do poprzedniego. Dodaje obsługę danych averageViewPercentage, ale nie obsługuje liveOrOnDemand jako wymiaru ani filtra.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Miejsca odtwarzania
Raport o miejscach odtwarzania filmu
Ten raport zawiera statystyki dotyczące typu strony lub aplikacji, w których odtwarzano filmy.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły miejsca odtwarzania (<= 25 wyników)
Uwaga: w tym raporcie musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga też podania wartości parametru żądania sort.
Ten raport pokazuje, które odtwarzacze wideo osadzone na innych stronach wygenerowały najwięcej wyświetleń lub najdłuższy czas oglądania filmów na kanale.
Źródła wizyt
Źródło wizyt
Ten raport zawiera statystyki oglądania zebrane na podstawie sposobu, w jaki widzowie trafili na Twoje treści wideo. Na przykład określa liczbę wyświetleń pochodzących z wyszukiwarki Google lub z linku do powiązanego filmu.
Uwaga: ten raport zwraca błąd, jeśli iloczyn liczby filmów, o które wysłano zapytanie i liczby dni w zakresie dat przekracza 50 000. Na przykład zapytanie, które pobiera dane dotyczące 500 identyfikatorów filmów, może żądać danych z maksymalnie 100 dni. Aby zmniejszyć liczbę wierszy zwracanych przez żądanie, podziel zapytanie na kilka zapytań, które określają mniejszą liczbę filmów lub krótsze zakresy dat.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły źródła wizyt (maks. 25 wyników)
Uwaga: w tym raporcie musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga też podania wartości parametru żądania sort.
Ten raport zawiera zbiorcze statystyki oglądania na podstawie witryn odsyłających, które wygenerowały najwięcej wyświetleń treści na kanale. Odesłania są podzielone na kategorie według typu źródła wizyt, a definicja wymiaru insightTrafficSourceDetail określa źródła wizyt, dla których dostępny jest raport. Jeśli na przykład ustawisz filtr insightTrafficSourceType na ADVERTISING, raport będzie zawierać listę typów reklam, które wygenerowały najwięcej wyświetleń lub czasu oglądania treści na kanale.
Uwaga: ten raport jest obsługiwany tylko w przypadku określonych źródeł wizyt. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES i NO_LINK_EMBEDDED to niektóre z nieobsługiwanych źródeł wizyt.
Typ urządzenia i system operacyjny
Typ urządzenia
Ten raport zawiera statystyki oglądania zebrane na podstawie sposobu, w jaki widzowie trafili na Twoje treści wideo. Na przykład określa liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
System operacyjny
Ten raport zawiera zbiorcze statystyki oglądania na podstawie systemów operacyjnych widzów. Na przykład określa liczbę wyświetleń na urządzeniach z Androidem lub na konsolach PlayStation.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
System operacyjny i typ urządzenia
Ten raport zawiera zbiorcze statystyki oglądania na podstawie systemów operacyjnych i typów urządzeń widzów. Na przykład określa liczbę wyświetleń na tabletach z Androidem lub na komputerach z systemem Windows.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Dane demograficzne widzów
Ten raport zawiera zbiorcze statystyki oglądania według grupy wiekowej i płci widzów.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
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,
liveOrOnDemand lub
youtubeProduct).
Na przykład raport, który korzysta z wymiaru
subscribedStatus, zwraca dane
viewerPercentage, które sumują się do 100% w przypadku wyświetleń przez subskrybentów
i dane
viewerPercentage, które sumują się do 100% w przypadku wyświetleń przez osoby, które nie subskrybują kanału. (Łączna wartość wszystkich pól
viewerPercentage w raporcie wynosi 200%).
Możesz użyć filtrów, aby mieć pewność, że raport zawiera 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.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Utrzymanie uwagi odbiorców
Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców, a także pokazuje, jak często oglądane były poszczególne części filmu. Wymiar elapsedVideoTimeRatio mierzy czas, który upłynął od początku filmu w przypadku odpowiednich wartości danych. Dane można podzielić na 2 kategorie:
-
Utrzymanie uwagi odbiorców
Te dane pokazują, w jakim stopniu film utrzymuje uwagę odbiorców.
audienceWatchRatio to stosunek liczby obejrzeń fragmentu filmu do łącznej liczby wyświetleń filmu.relativeRetentionPerformance pokazuje, jak dobrze film utrzymuje uwagę widzów podczas odtwarzania w porównaniu z innymi filmami w YouTube o podobnej długości.
-
Szczegółowe statystyki dotyczące zegarka
Te dane dostarczają informacji o tym, jak często oglądane były poszczególne części filmu.
Uwaga: ten raport nie obsługuje możliwości określania rozdzielonej przecinkami listy wartości dla filtra video. Wartość musi określać pojedynczy identyfikator filmu.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Równoczesni widzowie (w przypadku transmisji na żywo)
Ten raport pokazuje liczbę równoczesnych widzów w danym momencie w przypadku pojedynczego filmu transmitowanego na żywo.
Filtr określa film. Wymiar pozycji zwykle reprezentuje jedną minutę.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Najpopularniejsze filmy
Uwaga: w tych raportach musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 200. Dane sprzed 1 stycznia 2013 r. są dostępne tylko w przypadku 10 najpopularniejszych filmów. W odróżnieniu od większości innych raportów te raporty wymagają też podania 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świetlać najpopularniejsze filmy według kraju, kontynentu lub subContinent.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtry: |
|
| Opcje sortowania: |
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost |
Najpopularniejsze filmy według stanu (maksymalnie 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów na kanale w danym stanie USA lub w Dystrykcie Kolumbii. Pamiętaj, że ten raport obsługuje tylko podzbiór danych dostępnych w opisanym powyżej raporcie dotyczącym konkretnego kraju.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
| Opcje sortowania: |
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Najpopularniejsze filmy dla subskrybentów i osób, które nie subskrybują kanału(<= 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów na kanale wśród subskrybentów i widzów bez subskrypcji. Raport można filtrować, aby wyświetlać najpopularniejsze filmy według kraju, kontynentu lub subContinent. Poprzedni raport umożliwia pobieranie najpopularniejszych filmów w określonym stanie w Stanach Zjednoczonych dla subskrybentów i osób, które nie subskrybują kanału, ale obsługuje mniej danych niż ten raport.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtry: |
|
| Opcje sortowania: |
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Najpopularniejsze filmy według usługi YouTube (maksymalnie 200 wyników)
Ten raport 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 dodaje filtr youtubeProduct.
Najpopularniejsze filmy z filtrami szczegółów odtwarzania (maksymalnie 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów na kanale, filtrowaną według dowolnego lub wszystkich wymiarów szczegółów odtwarzania: liveOrOnDemand, subscribedStatus i youtubeProduct. W przeciwieństwie do poprzedniego raportu ten obsługuje filtr liveOrOnDemand, ale nie obsługuje danych averageViewPercentage.
Raporty dotyczące playlist
Raporty dotyczące playlist zawierają dane związane z aktywnością użytkowników w przypadku filmów na playlistach właściciela kanału. Dostępne są 2 wersje tych raportów. W przypadku każdego z nich w sekcjach poniżej znajdziesz opis poszczególnych wersji:
Zbiorcze dane o wideo
Te dane zawierają statystyki aktywności użytkowników i wyświetleń, które są agregowane dla wszystkich filmów na playliście należących do kanału, który jest właścicielem playlisty. Dane dotyczące filmów należących do innych kanałów nie są uwzględniane w agregacji. W związku z tym, jeśli 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.
Listę zagregowanych danych o filmach obsługiwanych przez YouTube znajdziesz w sekcji Obsługiwane dane dotyczące playlist.
Dane na playliście
Te dane odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane obejmują wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą, ale uwzględniają tylko wyświetlenia, które miały miejsce w kontekście playlisty.
Obsługiwane dane playlisty
Podstawowe statystyki
Ten raport zawiera statystyki dotyczące interakcji użytkowników z filmami na playlistach kanału. Możesz filtrować raport, aby wyświetlać tylko dane dotyczące określonej playlisty.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtry: |
|
Zależne od czasu
Ten raport zawiera statystyki dotyczące interakcji użytkowników z filmami na playlistach kanału. Możesz filtrować raport, aby wyświetlać tylko dane dotyczące określonej playlisty.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtry: |
|
Lokalizacja użytkownika
Aktywność na playlistach według kraju
Ten raport zawiera statystyki dotyczące interakcji użytkowników z danego kraju z filmami na playlistach kanału.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Aktywność związana z playlistami według prowincji
Ten raport zawiera statystyki aktywności na playlistach w poszczególnych stanach USA i Dystrykcie Kolumbii.
W przypadku tego raportu musisz przefiltrować wyniki, aby wyświetlały się tylko dane dotyczące Stanów Zjednoczonych.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Miejsca odtwarzania
Ten raport zawiera statystyki dotyczące typu strony lub aplikacji, w których odtwarzane były filmy z Twojej playlisty.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Szczegóły miejsca odtwarzania (<= 25 wyników)
Uwaga: w tym raporcie musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga też podania wartości parametru żądania sort.
Ten raport pokazuje odtwarzacze umieszczone na stronach, które wygenerowały najwięcej wyświetleń lub czasu oglądania filmów z playlist kanału.
Źródła wizyt
Ten raport gromadzi statystyki oglądalności na podstawie tego, jak widzowie trafili do treści na Twojej playliście.
Na przykład określa liczbę wyświetleń pochodzących z wyszukiwarki Google.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtry: |
|
Szczegóły źródła wizyt (maks. 25 wyników)
Uwaga: w tym raporcie musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 25. W odróżnieniu od większości innych raportów ten raport wymaga też podania wartości parametru żądania sort.
Ten raport zawiera statystyki wyświetleń na podstawie witryn odsyłających, które wygenerowały najwięcej wyświetleń filmów na playlistach kanału. Odesłania są podzielone na kategorie według typu źródła wizyt, a definicja wymiaru insightTrafficSourceDetail określa źródła wizyt, dla których dostępny jest raport.
Jeśli na przykład ustawisz filtr insightTrafficSourceType na ADVERTISING, raport będzie zawierać listę typów reklam, które wygenerowały najwięcej wyświetleń lub czasu oglądania w przypadku playlist na kanale.
| Spis treści |
| Wymiary: |
|
| Dane: |
| Użyj co najmniej 1 |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtry: |
|
| Opcje sortowania: |
-playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts |
Uwaga: ten raport jest obsługiwany tylko w przypadku określonych źródeł wizyt. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES i NO_LINK_EMBEDDED to niektóre z nieobsługiwanych źródeł wizyt.
Typ urządzenia i system operacyjny
Typ urządzenia
Ten raport zawiera zagregowane statystyki oglądania na podstawie tego, jak widzowie trafili na filmy na Twoich playlistach. Na przykład określa liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
System operacyjny
Ten raport zawiera zbiorcze statystyki oglądania na podstawie systemów operacyjnych widzów. Na przykład określa liczbę wyświetleń na urządzeniach z Androidem lub na konsolach PlayStation.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
System operacyjny i typ urządzenia
Ten raport zawiera zbiorcze statystyki oglądania na podstawie systemów operacyjnych i typów urządzeń widzów.
Na przykład określa, ile wyświetleń miało miejsce na tabletach z Androidem lub komputerach z systemem Windows.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Dane demograficzne widzów
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Najpopularniejsze playlisty
Uwaga: w tych raportach musisz ustawić parametr maxResults na wartość całkowitą nie większą niż 200. Dane sprzed 1 stycznia 2013 r. są dostępne tylko w przypadku 10 najpopularniejszych playlist. W odróżnieniu od większości innych raportów te raporty wymagają też podania wartości parametru żądania sort.
Ten raport zawiera listę najpopularniejszych playlist na kanale na podstawie określonych kryteriów filtrowania i sortowania.
Raporty dotyczące członkostwa
anulowania subskrypcji,
Ten raport zawiera statystyki pokazujące, dlaczego użytkownicy anulowali wspieranie kanału.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
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 o reklamach wyświetlanych podczas odtwarzania filmów, które są oparte na wyświetleniach. Te dane uwzględniają każde wyświetlenie reklamy, a każde odtworzenie filmu może generować wiele wyświetleń.
Dane o skuteczności reklamy oparte na wyświetleniach to:
Niektóre raporty dotyczące filmów obsługują też te dane o skuteczności reklam oparte na odtworzeniach: Nie są one jednak uwzględniane w raportach o skuteczności reklam.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
