YouTube Analytics API: Channel Reports

Wymiary 7DayTotals i 30DayTotals zostaną wycofane. Więcej informacji znajdziesz w Historii wersji.

Ta strona zawiera listę raportów, które właściciele kanałów mogą pobierać za pomocą interfejsu YouTube Analytics API. Raporty dotyczące kanału podają dane o aktywności użytkowników dotyczące określonego kanału. Mierzą takie czynniki jak wyświetlenia filmów, oceny i liczba subskrybentów.

  • Raporty na temat filmów zawierają statystyki dotyczące wszystkich działań użytkowników związanych z filmami na kanale.
  • Raporty playlist podają statystyki odnoszące się konkretnie do wyświetleń filmów, które występują w kontekście playlisty.
  • Raporty skuteczności reklam zawierają dane związane z przychodami i skutecznością reklam. Używają wymiaru adType, aby grupować dane na podstawie typów reklam wyświetlanych podczas odtwarzania filmów. W sekcji Raporty skuteczności reklam opisano 2 rodzaje danych o skuteczności reklam obsługiwanych przez interfejs API.

Pobieranie raportu

Aby pobrać raport dotyczący kanału, ustaw w żądaniu interfejsu API wartość parametru ids na jedną z tych wartości:

  • channel==MINE – interfejs API zwraca dane kanału YouTube uwierzytelnionego użytkownika.

  • channel==CHANNEL_ID – w polu CHANNEL_ID wpisz unikalny identyfikator kanału, dla którego pobierasz dane. Użytkownik, który autoryzuje żądanie, musi być właścicielem kanału.

    Identyfikator kanału to obecnie ciąg znaków rozpoczynający się od liter UC, choć 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 za pomocą metody YouTube Data API's channels.list.

Upoważnienie

Wszystkie żądania do interfejsu YouTube Analytics API muszą być autoryzowane. Przewodnik po autoryzacji zawiera instrukcje pobierania tokenów autoryzacji za pomocą protokołu OAuth 2.0.

Żądania do interfejsu YouTube Analytics API używają tych zakresów autoryzacji:

Zakresy
https://www.googleapis.com/auth/yt-analytics.readonly Wyświetlaj raporty Statystyk YouTube dotyczące treści w YouTube. Zakres ten zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i oceny.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Wyświetlanie raportów finansowych Statystyk YouTube dotyczących treści w YouTube Zakres ten umożliwia 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 swoim kontem YouTube. W interfejsie YouTube Analytics API właściciele kanałów używają tego zakresu do zarządzania grupami i elementami grup w YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Wyświetlanie zasobów YouTube i powiązanych treści w YouTube oraz zarządzanie nimi. W interfejsie YouTube Analytics API właściciele treści używają tego zakresu do zarządzania grupami i elementami grup w YouTube Analytics.

Uwaga: w raportach kanału nie są obecnie obsługiwane dane o szacowanych przychodach i skuteczności reklam. W rezultacie zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie przyznaje obecnie dostępu do danych pieniężnych w tych raportach.

Filtry

Tabele wyjaśniające obsługiwane raporty określają filtry, których można używać w przypadku poszczególnych raportów. W tabelach filtry wyświetlane w nawiasach są opcjonalne. Na przykład w przypadku opcji filtrowania video(,country) wymagany jest filtr wideo, a filtr kraj jest opcjonalny.

Interfejs API obsługuje też możliwość określenia wielu wartości filtrów video i playlist. Jeśli dla jednego z tych filtrów ustawisz wiele wartości, możesz też dodać ten filtr do listy wymiarów określonych w żądaniu. Dzieje się tak nawet wtedy, gdy filtr nie znajduje się na liście obsługiwanych wymiarów w danym raporcie.

Wyjaśnienie sposobu filtrowania wyników interfejsu API pod kątem określonej wartości lub zbioru wartości znajdziesz w definicji parametrów filters.

Omówienie tabel raportów

Ta sekcja zawiera omówienie formatowania i terminologii używanej w tabelach definiujących raporty obsługiwane przez interfejs API. W tabeli poniżej znajdują się wymiary, dane i filtry obsługiwane w raportach czasowych playlist na kanale:

Spis treści
Wymiary:
Użyj dokładnie 1 dzień, miesiąc
Użyj co najmniej 0 subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Tabela zawiera dwa wiersze dla wymiarów, jeden dla danych i cztery wiersze dla filtrów. W przypadku wymiarów i filtrów wartości z każdego wiersza można łączyć w żądaniu do interfejsu API, o ile kombinacja jest zgodna z regułami użytkowania w tabeli. Przykładowe prawidłowe wartości parametru dimensions w tym raporcie:

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Wartość parametru day,month jest jednak nieprawidłowa, ponieważ używa dwóch wymiarów czasowych, ale żądanie musi zawierać dokładnie 1. W tym przypadku wartość parametru subscribedStatus,youtubeProduct zwraca raport, ale dane nie są agregowane według dnia, tygodnia, miesiąca itd. (raport ten jest udokumentowany osobno w dokumentacji).

Terminologia dotycząca raportów

Tabele używają tej terminologii do określania, czy wymiary są wymagane czy opcjonalne:

  • Te warunki oznaczają, że wartość jest wymagana:
    • Wymagane: musisz podać wartość.
    • Użyj dokładnie 1 wartości: musisz podać 1 wartość z grupy.
    • Użyj co najmniej 1 wartości: możesz uwzględnić dowolne lub wszystkie wartości z grupy, ale musisz podać przynajmniej jedną.
  • Te warunki oznaczają, że wartość jest opcjonalna:
    • Opcjonalnie: możesz podać wartość.
    • Użyj wartości 0 lub 1: możesz użyć jednej wartości z grupy.
    • Użyj wartości 0 lub większej: możesz uwzględnić dowolne lub wszystkie 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 przefiltrować raport, aby wyświetlić dane dotyczące tylko konkretnego filmu lub kraju.

Spis treści
Wymiary:
[Brak]
Dane:
Użyj co najmniej 1 Prawa autorskie
Filtry:
Wpisz 0 lub 1 country (kraj), kontynent, subContinent
Wpisz 0 lub 1 film, grupa

Podstawowe statystyki aktywności użytkowników w stanach USA

Raport zawiera statystyki dotyczące stanu USA lub Dystryktu Kolumbii. Pamiętaj, że ten raport obsługuje tylko część danych dostępnych w raporcie powyżej.

Spis treści
Wymiary:
[Brak]
Dane:
Użyj co najmniej 1 Giełda nie ma
Filtry:
Wymagany province
Wpisz 0 lub 1 film, grupa

Oparte na czasie

Aktywność użytkowników według kraju w określonych przedziałach czasu

Raport zawiera statystyki związane z działaniami użytkowników na kanale w określonych przedziałach czasu. Możesz przefiltrować raport, aby wyświetlić dane dotyczące tylko konkretnego filmu lub kraju.

Spis treści
Wymiary:
Użyj dokładnie 1 dzień, miesiąc
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 Kliknij, aby dodać
Filtry:
Wpisz 0 lub 1 country (kraj), kontynent, subContinent
Wpisz 0 lub 1 film, grupa

Aktywność użytkowników w stanach USA w określonych przedziałach czasu

Raport zawiera statystyki związane z aktywnością użytkownika w określonym stanie USA lub Dystrykcie Kolumbii. Pamiętaj, że ten raport obsługuje tylko część danych dostępnych w raporcie powyżej.

Spis treści
Wymiary:
Użyj dokładnie 1 dzień, miesiąc
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 Giełda nie ma
Filtry:
Wymagany province
Wpisz 0 lub 1 film, grupa

Obszar geograficzny użytkownika

Aktywność użytkowników według kraju

Raport zawiera statystyki związane z aktywnością użytkownika w poszczególnych krajach. Możesz przefiltrować raport, aby wyświetlić dane dotyczące tylko konkretnego filmu.

Spis treści
Wymiary:
Wymagany country
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 Prawa autorskie
Filtry:
Wpisz 0 lub 1 kontynent, subkontynent
Wpisz 0 lub 1 film, grupa

Aktywność użytkowników według prowincji

Ten raport zawiera statystyki aktywności użytkowników w stanach USA i Dystrykcie Kolumbii. W tym raporcie musisz ustawić wartość parametru filters na country==US.

Spis treści
Wymiary:
Wymagany province
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 Giełda nie ma
Filtry:
Wymagany country==PL
Wpisz 0 lub 1 film, grupa

Aktywność użytkowników według miasta (<= 250 wyników)

Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą równą 250 lub mniejszą. W przeciwieństwie do 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.

Spis treści
Wymiary:
Wymagany city
Użyj co najmniej 0 creatorContentType, country, province, subscribedStatus

Uwaga: jeśli uwzględnisz wymiar prowincja, musisz też użyć filtra country==US.
Wpisz 0 lub 1 dzień, miesiąc
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Opcje sortowania: -wyświetlenia
-estimatedMinutesWatch

Szczegóły odtwarzania

Raporty o szczegółach odtwarzania zawierają statystyki dotyczące następujących atrybutów wyświetlania:

  • Czy wyświetliła się transmisja wideo na żywo lub film na żądanie?
  • Czy widz subskrybował kanał, do którego należy film?
  • W której usłudze YouTube wystąpił błąd?

Uwaga: wymiaru i filtra liveOrOnRequest nie można używać w połączeniu z danymi averageViewPercentage. Z tego względu każdy z podpunktów poniżej zawiera dwa raporty. Jeden raport obsługuje wymiar liveOrOnRequest, a drugi obsługuje dane averageViewPercentage.

Aktywność użytkowników według stanu subskrypcji

Ten raport zawiera dane dotyczące aktywności użytkowników, którzy subskrybują Twój kanał, oraz tych, którzy nie są subskrybentami. Statystyki można grupować według przedziału czasowego (dzień lub miesiąc), a raport można też filtrować według kraju, kontynentu lub kontynentu.

Spis treści
Wymiary:
Użyj co najmniej 0 creatorContentType, subscribedStatus
Wpisz 0 lub 1 dzień, miesiąc
Dane:
Użyj co najmniej 1 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:
Wpisz 0 lub 1 country (kraj), kontynent, subContinent
Wpisz 0 lub 1 film, grupa
Opcjonalna subscribedStatus

Aktywność użytkowników według stanu subskrypcji w prowincjach

Ten raport zawiera dane o aktywności użytkowników w Stanach Zjednoczonych oraz w Dystrykcie Kolumbii. Ten raport obsługuje mniej danych niż poprzedni.

Spis treści
Wymiary:
Użyj co najmniej 0 creatorContentType, subscribedStatus
Wpisz 0 lub 1 dzień, miesiąc
Dane:
Użyj co najmniej 1 Giełda nie ma
Filtry:
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 prowincja, subscribedStatus

Szczegóły odtwarzania z opcjonalnym wymiarem czasu

Wymiar czasu (dzień lub miesiąc) w tych raportach jest opcjonalny, ponieważ musisz użyć parametrów żądania startDate i endDate, aby określić zakres dat, jaki ma obejmować raport. Wymiar oznacza, że dane w raporcie mają być agregowane według dnia, miesiąca itd.

Szczegóły odtwarzania z opcjonalnym wymiarem czasu i statystykami liveOrOnRequest

Ten raport zawiera statystyki odtwarzania w określonych przedziałach czasu. Obsługuje ono wymiar (i filtr) liveOrOnRequest.

Spis treści
Wymiary:
Użyj co najmniej 0 creatorContentType, liveOrOnRequest, subscribedStatus, youtubeProduct
Wpisz 0 lub 1 dzień, miesiąc
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus, youtubeProduct
Szczegóły odtwarzania z opcjonalnym wymiarem czasu i danymi averageViewPercentage.

Ten raport zawiera statystyki odtwarzania w określonych przedziałach czasu. Obsługuje dane averageViewPercentage.

Spis treści
Wymiary:
Użyj co najmniej 0 creatorContentType, subscribedStatus, youtubeProduct
Wpisz 0 lub 1 dzień, miesiąc
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Szczegóły odtwarzania według kraju

Szczegóły odtwarzania według kraju ze statystykami liveOrOnRequest

Raport zawiera szczegółowe statystyki odtwarzania w poszczególnych krajach. Obsługuje ono wymiar (i filtr) liveOrOnRequest.

Spis treści
Wymiary:
Wymagany country
Użyj co najmniej 0 creatorContentType, liveOrOnRequest, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtry:
Wpisz 0 lub 1 kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus, youtubeProduct
Szczegóły odtwarzania według kraju z danymi averageViewPercentage.

Ten raport jest podobny do poprzedniego. Dodaje obsługę danych averageViewPercentage, ale nie obsługuje liveOrOnRequest jako wymiaru ani filtra.

Spis treści
Wymiary:
Wymagany country
Użyj co najmniej 0 creatorContentType, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtry:
Wpisz 0 lub 1 kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Szczegóły odtwarzania według prowincji

Szczegóły odtwarzania według prowincji ze statystykami liveOrOnRequest

Ten raport zawiera statystyki odtwarzania w stanach USA i Dystrykcie Kolumbii. Obsługuje ono wymiar (i filtr) liveOrOnRequest.

Spis treści
Wymiary:
Wymagany province
Użyj co najmniej 0 creatorContentType, liveOrOnRequest, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtry:
Wymagany kraj==US
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus, youtubeProduct
Szczegóły odtwarzania według prowincji z wartością averageViewPercentage.

Ten raport jest podobny do poprzedniego. Dodaje obsługę danych averageViewPercentage, ale nie obsługuje liveOrOnRequest jako wymiaru ani filtra.

Spis treści
Wymiary:
Wymagany province
Użyj co najmniej 0 creatorContentType, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtry:
Wymagany kraj==US
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Miejsca odtwarzania

Raport lokalizacji odtwarzania filmu

Raport zawiera statystyki związane z typem strony lub aplikacji, w której były odtwarzane filmy.

Spis treści
Wymiary:
Wymagany insightplayLocationType
Użyj co najmniej 0 creatorContentType, day, liveOrOnRequest, subscribedStatus
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus,

Szczegóły miejsca odtwarzania (<= 25 wyników)

Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą równą 25 lub mniejszą. W przeciwieństwie do większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.

Ten raport pokazuje odtwarzacze wideo umieszczone na stronie, które wygenerowały najwięcej wyświetleń lub czas oglądania filmów na Twoim kanale.

Spis treści
Wymiary:
Wymagany Szczegóły lokalizacji odtwarzania statystyk
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wymagany insightplayLocationType==EMBEDDED
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus,
Opcje sortowania: -wyświetlenia
-estimatedMinutesWatch

Źródła wizyt

Źródło wizyt

Ten raport gromadzi statystyki wyświetlania na podstawie sposobu, w jaki widzowie dotarli do Twoich treści wideo. Określa na przykład liczbę wyświetleń pochodzących z wyszukiwania w Google lub linku do podobnego filmu.

Spis treści
Wymiary:
Wymagany insightTrafficSourceType
Użyj co najmniej 0 creatorContentType, day, liveOrOnRequest, subscribedStatus
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus,

Szczegóły źródła wizyt (<= 25 wyników)

Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą równą 25 lub mniejszą. W przeciwieństwie do większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.

Ten raport gromadzi statystyki wyświetlania na podstawie stron odsyłających, które przyniosły najwięcej wyświetleń treści kanału. Strony odsyłające są podzielone według typu źródła wizyt, a definicja wymiaru insightTrafficSourceDetails określa źródła wizyt, dla których dostępny jest raport. Jeśli np. ustawisz filtr insightTrafficSourceType na ADVERTISING, raport pokaże typy reklam, które wygenerowały najwięcej wyświetleń lub czas oglądania treści na kanale.

Spis treści
Wymiary:
Wymagany insightTrafficSourceDetails
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wymagany insightTrafficSourceType (patrz tabela poniżej)
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus,
Opcje sortowania: -wyświetlenia
-estimatedMinutesWatch

Uwaga: ten raport jest obsługiwany tylko w przypadku określonych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie zawiera dodatkowych szczegółów i dlatego nie obsługuje tego raportu. Aby dowiedzieć się, które źródła wizyt obsługują ten raport, zapoznaj się z definicją insightTrafficSourceType.

Typ urządzenia i system operacyjny

Typ urządzenia

Ten raport gromadzi statystyki wyświetlania na podstawie sposobu, w jaki widzowie dotarli do Twoich treści wideo. Określa na przykład liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.

Spis treści
Wymiary:
Wymagany deviceType,
Użyj co najmniej 0 creatorContentType, day, liveOrOnRequest, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 operatingSystem, liveOrOnRequest, subscribedStatus, youtubeProduct

System operacyjny

Ten raport gromadzi statystyki wyświetlania na podstawie systemów operacyjnych widzów. Określa na przykład liczbę wyświetleń na urządzeniach z Androidem lub PlayStation.

Spis treści
Wymiary:
Wymagany System operacyjny
Użyj co najmniej 0 creatorContentType, day, liveOrOnRequest, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 deviceType, liveOrOnRequest, subscribedStatus, youtubeProduct

System operacyjny i typ urządzenia

Ten raport gromadzi statystyki wyświetlania na podstawie systemów operacyjnych i typów urządzeń widzów. Określa na przykład liczbę wyświetleń na tabletach z Androidem lub na komputerach z systemem Windows.

Spis treści
Wymiary:
Wymagany deviceType, operatingSystem,
Użyj co najmniej 0 creatorContentType, day, liveOrOnRequest, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus, youtubeProduct

Dane demograficzne widzów

Ten raport gromadzi statystyki wyświetlania na podstawie grupy wiekowej i płci widzów.

Spis treści
Wymiary:
Użyj co najmniej 1 ageGroup, płeć
Użyj co najmniej 0 creatorContentType, liveOrOnRequest, subscribedStatus
Dane:
Użyj co najmniej 1 odsetek widzów
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 film, grupa
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus,
Uwaga: wartości viewerPercentage w tym raporcie nie są znormalizowane dla różnych wartości ani ich kombinacji w przypadku wymiarów szczegółów odtwarzania (subscribedStatus, liveOrOnRequest lub youtubeProduct).

Na przykład raport, który używa wymiaru subscribedStatus, zwraca dane odsetek użytkowników, które dodają dane do 10.10, 10} wchodzi się na
6. (Całkowita 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 1 wartości (lub kombinacji wartości) dla 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:
Wymagany UdostępnianieUsług
Użyj co najmniej 0 creatorContentType, subscribedStatus
Dane:
Użyj co najmniej 1 udostępnienia
Filtry:
Wpisz 0 lub 1 country (kraj), kontynent, subContinent
Wpisz 0 lub 1 film, grupa
Opcjonalna subscribedStatus

Utrzymanie uwagi odbiorców

Ten raport pokazuje zdolność filmu do utrzymania uwagi odbiorców. Wymiar elapsedVideoTimeRatio mierzy ilość filmu, która upłynęła dla odpowiednich wartości danych. Dane audienceWatchRatio i relativeRetentionPerformance dostarczają 2 wskaźników, które pokazują, jak dobrze film utrzymuje uwagę odbiorców. Pierwsza to wartość bezwzględna, a druga – wyniki filmu w porównaniu z innymi filmami o podobnej długości w YouTube.

Uwaga: raporty utrzymania uwagi odbiorców nie umożliwiają określenia listy wartości filtra video oddzielonych przecinkami. Wartość musi zawierać pojedynczy identyfikator filmu.

Spis treści
Wymiary:
Wymagany elapsedVideoTimeRatio
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 audienceWatchRatio, relativePrzechowywaniePerformance
Filtry:
Wymagany wideo
Użyj co najmniej 0 audienceType, subscribedStatus, youtubeProduct

Najpopularniejsze filmy

Uwaga: te raporty wymagają ustawienia parametru maxResults na liczbę całkowitą równą 200 lub mniejszą. Dane sprzed 1 stycznia 2013 r. są dostępne tylko w przypadku 10 najpopularniejszych filmów. W przeciwieństwie do większości innych raportów te raporty również wymagają określenia wartości parametru żądania sort.

Najpopularniejsze filmy z opcjonalnymi filtrami regionalnymi (<= 200 wyników)

Ten raport zawiera listę najpopularniejszych filmów na tym kanale. Możesz przefiltrować raport, aby wyświetlić najpopularniejsze filmy według kraju, kontynentu lub subkontynentu.

Spis treści
Wymiary:
Wymagany wideo
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 Prawa autorskie
Filtry:
Wpisz 0 lub 1 country (kraj), kontynent, subContinent
Opcje sortowania: -wyświetlenia
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subskrybentów
-utraconych subskrybentów

Najpopularniejsze filmy według stanu (<= 200 wyników)

Ten raport zawiera listę najlepszych filmów z danego stanu w USA lub Dystrykcie Kolumbii. Pamiętaj, że ten raport obsługuje tylko część danych dostępnych w raporcie powyżej.

Spis treści
Wymiary:
Wymagany wideo
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 Giełda nie ma
Filtry:
Wymagany province
Opcjonalna subscribedStatus
Opcje sortowania: -wyświetlenia
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Najpopularniejsze filmy dla subskrybentów i użytkowników bez subskrypcji(<= 200 wyników)

Ten raport zawiera listę filmów z największą liczbą subskrybowanych i zasubskrybowanych kanałów. Możesz przefiltrować raport, aby wyświetlić najpopularniejsze filmy według kraju, kontynentu lub subkontynentu. Poprzedni raport pozwala wyświetlić najpopularniejsze filmy z danego stanu w Stanach Zjednoczonych dotyczące widzów, którzy dokonali subskrypcji lub bez subskrypcji, ale raport zawiera mniej danych niż ten raport.

Spis treści
Wymiary:
Wymagany wideo
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 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:
Opcjonalna subscribedStatus
Wpisz 0 lub 1 country (kraj), kontynent, subContinent
Opcje sortowania: -wyświetlenia
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Najpopularniejsze filmy według usługi YouTube (<= 200 wyników)

Raport zawiera listę najpopularniejszych filmów na kanale oraz obsługuje szczegółowe dane dotyczące odtwarzania i filtry geograficzne. Ten raport jest podobny do poprzedniego, ale zawiera mniej danych i obsługuje filtr youtubeProduct.

Spis treści
Wymiary:
Wymagany wideo
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Użyj co najmniej 0 subscribedStatus, youtubeProduct
Opcje sortowania: -wyświetlenia
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Najpopularniejsze filmy z filtrami szczegółów odtwarzania (<= 200 wyników)

Ten raport pokazuje listę najpopularniejszych filmów na kanale przefiltrowanych według dowolnych wymiarów lub szczegółów: liveOrOnRequest, subscribedStatus i youtubeProduct. W przeciwieństwie do poprzedniego raportu ten obsługuje filtr liveOrOnRequest i nie obsługuje danych averageViewPercentage.

Spis treści
Wymiary:
Wymagany wideo
Opcjonalna creatorContentType
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtry:
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Użyj co najmniej 0 liveOrOnRequest, subscribedStatus, youtubeProduct
Opcje sortowania: -wyświetlenia
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Raporty dotyczące playlist

Podstawowe statystyki

Ten raport zawiera statystyki dotyczące interakcji użytkowników z playlistami kanału. Możesz odfiltrować raport, aby wyświetlić tylko dane z konkretnej playlisty lub kraju.

Spis treści
Wymiary:
[Brak]
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Oparte na czasie

Ten raport zawiera statystyki dotyczące interakcji użytkowników z playlistami kanału. Możesz odfiltrować raport, aby wyświetlić tylko dane z konkretnej playlisty lub kraju.

Spis treści
Wymiary:
Użyj dokładnie 1 dzień, miesiąc
Użyj co najmniej 0 subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Obszar geograficzny użytkownika

Aktywność na playliście według kraju

Ten raport zawiera statystyki dotyczące interakcji użytkowników z playlistami kanału. Możesz przefiltrować raport, aby wyświetlić dane dotyczące tylko konkretnych playlist, grup playlist lub kraju.

Spis treści
Wymiary:
Wymagany country
Użyj co najmniej 0 subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Aktywność na playliście wg prowincji

Raport zawiera statystyki aktywności playlist w stanach USA i Dystrykcie Kolumbii. W tym raporcie wartość country==US jest zawarta w wartości parametru filters.

Spis treści
Wymiary:
Wymagany province
Użyj co najmniej 0 subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany isCurated==1;kraj==US
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Miejsca odtwarzania

Ten raport zawiera statystyki związane z typem strony lub aplikacji, w której były odtwarzane playlisty.

Spis treści
Wymiary:
Wymagany insightplayLocationType
Użyj co najmniej 0 day, subscribedStatus
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Opcjonalna subscribedStatus

Szczegóły miejsca odtwarzania (<= 25 wyników)

Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą równą 25 lub mniejszą. W przeciwieństwie do większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.

Ten raport pokazuje odtwarzacze umieszczone na stronie, które wygenerowały najwięcej wyświetleń lub czas oglądania playlist na kanale.

Spis treści
Wymiary:
Wymagany Szczegóły lokalizacji odtwarzania statystyk
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany isCurated==1;insightplayLocationType==EMBEDDED
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Opcjonalna subscribedStatus
Opcje sortowania: -wyświetlenia
-estimatedMinutesWatched
-playlistyRozpoczęcia

Źródła wizyt

Ten raport gromadzi statystyki wyświetlania na podstawie sposobu, w jaki widzowie dotarli do treści Twojej playlisty. Określa na przykład liczbę wyświetleń pochodzących z wyszukiwania w Google.

Spis treści
Wymiary:
Wymagany insightTrafficSourceType
Użyj co najmniej 0 day, subscribedStatus
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Opcjonalna subscribedStatus

Szczegóły źródła wizyt (<= 25 wyników)

Uwaga: ten raport wymaga ustawienia parametru maxResults na liczbę całkowitą równą 25 lub mniejszą. W przeciwieństwie do większości innych raportów ten raport wymaga również określenia wartości parametru żądania sort.

Ten raport gromadzi statystyki wyświetleń na podstawie stron odsyłających, które przyniosły najwięcej wyświetleń playlist kanału. Strony odsyłające są podzielone na kategorie według typu źródła wizyt, a definicja wymiaru insightTrafficSourceDetails określa źródła wizyt, dla których dostępny jest raport.

Jeśli np. ustawisz filtr insightTrafficSourceType na ADVERTISING, raport pokaże rodzaje reklam, które wygenerowały najwięcej wyświetleń lub czas oglądania playlist na kanale.

Spis treści
Wymiary:
Wymagany insightTrafficSourceDetails
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany isCurated==1;insightTrafficSourceType
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Opcjonalna subscribedStatus
Opcje sortowania: -wyświetlenia
-estimatedMinutesWatched
-playlistyRozpoczęcia

Uwaga: ten raport jest obsługiwany tylko w przypadku określonych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie zawiera dodatkowych szczegółów i dlatego nie obsługuje tego raportu. Aby dowiedzieć się, które źródła wizyt obsługują ten raport, zapoznaj się z definicją insightTrafficSourceType.

Typ urządzenia i system operacyjny

Typ urządzenia

Ten raport gromadzi statystyki wyświetlania na podstawie sposobu, w jaki widzowie dotarli do treści Twojej playlisty. Określa na przykład liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.

Spis treści
Wymiary:
Wymagany deviceType,
Użyj co najmniej 0 day, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 operatingSystem, subscribedStatus, youtubeProduct

System operacyjny

Ten raport gromadzi statystyki wyświetlania na podstawie systemów operacyjnych widzów. Określa na przykład liczbę wyświetleń playlist na urządzeniach z Androidem lub PlayStation.

Spis treści
Wymiary:
Wymagany System operacyjny
Użyj co najmniej 0 day, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 deviceType, subscribedStatus, youtubeProduct

System operacyjny i typ urządzenia

Ten raport gromadzi statystyki wyświetlania na podstawie systemów operacyjnych i typów urządzeń widzów. Określa na przykład liczbę wyświetleń playlist na tabletach z Androidem lub na komputerach z systemem Windows.

Spis treści
Wymiary:
Wymagany deviceType, operatingSystem,
Użyj co najmniej 0 day, subscribedStatus, youtubeProduct
Dane:
Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Użyj co najmniej 0 subscribedStatus, youtubeProduct

Dane demograficzne widzów

Spis treści
Wymiary:
Użyj co najmniej 1 ageGroup, płeć
Użyj co najmniej 0 subscribedStatus
Dane:
Wymagany odsetek widzów
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Wpisz 0 lub 1 playlista, grupa
Opcjonalna subscribedStatus
Uwaga: wartości viewerPercentage w tym raporcie nie są znormalizowane dla różnych wartości lub kombinacji wartości wymiarów szczegółów odtwarzania (subscribedStatus i youtubeProduct).

W raporcie na podstawie wymiaru subscribedStatus wyświetlane są dane viewerPercentage, które sumują się do 100% w przypadku wyświetleń subskrybentów i{/1{/100.01 (Całkowita 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 1 wartości (lub kombinacji wartości) dla wymiarów szczegółów odtwarzania.

Najpopularniejsze playlisty

Uwaga: te raporty wymagają ustawienia parametru maxResults na liczbę całkowitą równą 200 lub mniejszą. Dane sprzed 1 stycznia 2013 r. są dostępne tylko w przypadku 10 najpopularniejszych playlist. W przeciwieństwie do większości innych raportów te raporty również wymagają określenia wartości parametru żądania sort.

Ten raport pokazuje listę najpopularniejszych playlist na kanale na podstawie określonych kryteriów filtrowania i sortowania.

Spis treści
Wymiary:
Wymagany playlista
Dane:
Użyj co najmniej 1 wyświetlenia, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtry:
Wymagany wyselekcjonowane==1
Wpisz 0 lub 1 country [kraj], region, kontynent, subkontynent
Użyj co najmniej 0 playlista, subscribedStatus, youtubeProduct
Opcje sortowania: -wyświetlenia
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-PlaysStarts

Raport skuteczności reklam

Uwaga: raporty skuteczności reklamy wymagają tokena autoryzacji, który zapewnia dostęp do zakresu https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Raporty skuteczności reklam zawierają dane związane z wyświetleniami reklam, które były wyświetlane podczas odtwarzania filmów. Dane te odpowiadają za każde wyświetlenie reklamy, a każde odtworzenie filmu może przynieść kilka wyświetleń.

Dane o skuteczności reklam zależne od liczby wyświetleń:

Poza tym niektóre raporty o reklamach wideo obsługują opisane poniżej dane o skuteczności reklam zależne od odtwarzania. Dane te nie są jednak uwzględniane w raportach skuteczności reklam.

Skuteczność reklam według typu

Spis treści
Wymiary:
Wymagany adType,
Opcjonalna dzień
Dane:
Użyj co najmniej 1 grossRevenue, adImpressions, cpm
Filtry:
Wpisz 0 lub 1 film, grupa
Wpisz 0 lub 1 country (kraj), kontynent, subContinent