Uwaga: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
Na tej stronie znajdziesz listę raportów, które właściciele treści mogą pobierać za pomocą interfejsu YouTube Analytics API. Raporty właścicieli treści zawierają dane dotyczące kanałów powiązanych z określonym właścicielem treści w YouTube. Dane to poszczególne pomiary aktywności użytkowników, skuteczności reklam lub szacunkowych przychodów.
-
Raporty dotyczące filmów zawierają dane o aktywności użytkowników, skuteczności reklam i 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, które mają miejsce w kontekście playlisty. Raporty dotyczące playlisty korzystają z wielu tych samych wymiarów i filtrów co raporty dotyczące filmów.
-
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 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 to identyfikator właściciela treści. Jeśli nie masz pewności, zapytaj swojego menedżera ds. partnera.
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: 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 dotyczące pobierania raportów właściciela treści muszą filtrować dane za pomocą wymiaru video, wymiaru channel lub obsługiwanej kombinacji wymiarów claimedStatus i uploaderType. (Obsługiwane kombinacje są wymienione w uploaderTypedefinicji wymiaru).
W tabelach z opisem obsługiwanych raportów znajdziesz filtry, których możesz używać w poszczególnych raportach. W opisach filtry podane w nawiasach są opcjonalne. Jeśli na przykład w raporcie jako opcja filtrowania jest wymieniony element video(,country), raport można przefiltrować tak, aby zawierał tylko dane dotyczące konkretnego filmu lub tylko dane dotyczące konkretnego filmu w określonym kraju.
Interfejs API umożliwia też określanie wielu wartości filtrów video, playlist i channel. 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.
Ważne: wszystkie żądania do interfejsu API dotyczące pobierania raportów o filmach właściciela treści muszą filtrować dane za pomocą wymiaru
film, wymiaru
kanał, wymiaru
grupa 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==selfclaimedStatus==claimedclaimedStatus==claimed;uploaderType==selfclaimedStatus==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 filtrować raport, aby wyświetlać tylko dane dotyczące konkretnego filmu lub kraju. Można go też używać do pobierania statystyk tylko w przypadku treści, do których zgłoszono prawa, w tym treści przesłanych przez właściciela treści, osoby trzecie lub obie te grupy.
| 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 dotyczące stanów w 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ść w okresach
Ten raport zawiera statystyki dotyczące działań użytkowników na wszystkich kanałach właściciela treści 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 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: |
|
Lokalizacja użytkownika
Aktywność użytkowników według kraju
Ten raport zawiera statystyki dotyczące aktywności użytkowników w poszczególnych krajach na wszystkich kanałach właściciela treści. Możesz filtrować raport, aby wyświetlać tylko dane dotyczące konkretnego filmu lub kanału.
| 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.
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?
Wymiary szczegółów odtwarzania, które są obsługiwane w tych raportach, 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 statystyk, zależnych od czasu lub geografii użytkowników.
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.
| 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 wskazuje odtwarzacze wideo, które wygenerowały najwięcej wyświetleń lub czasu oglądania treści właściciela. Podczas pobierania tego raportu musisz ustawić filtr insightPlaybackLocationType na EMBEDDED.
Ź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ądalności na podstawie źródeł, które wygenerowały najwięcej wyświetleń treści właściciela. 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 właściciela.
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 zgrupowane według typu urządzenia, z którego widzowie korzystali podczas oglądania Twoich treści. Na przykład określa liczbę wyświetleń na tabletach 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: |
|
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 pokazuje, w jakim stopniu film utrzymuje uwagę odbiorców. Wymiar elapsedVideoTimeRatio mierzy czas, który upłynął od początku filmu, w przypadku odpowiednich wartości danych. Dane audienceWatchRatio i relativeRetentionPerformance to 2 rodzaje pomiarów, które pokazują, w jakim stopniu film utrzymuje uwagę odbiorców. Pierwsza wartość jest bezwzględna, a druga pokazuje, jak film wypada w porównaniu z innymi filmami w YouTube o podobnej długości.
Uwaga: raporty Utrzymanie uwagi odbiorców nie obsługują możliwości określania listy wartości rozdzielonych przecinkami dla filtra video. Wartość musi określać pojedynczy identyfikator filmu.
| 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 ogółem, według kraju, kontynentu lub subkontynentu (maksymalnie 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów właściciela treści na podstawie określonych kryteriów filtrowania i sortowania.
| 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: |
-engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost |
Najpopularniejsze filmy w poszczególnych stanach USA (maksymalnie 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów właściciela treści 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: |
-engagedViews
-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 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: |
-engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Najpopularniejsze filmy według usługi YouTube (maksymalnie 200 wyników)
Ten raport zawiera listę najpopularniejszych filmów 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 właściciela treści, filtrowaną według co najmniej jednego wymiaru szczegółów odtwarzania: liveOrOnDemand, subscribedStatus i youtubeProduct. Raport umożliwia też filtrowanie według regionu.
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 na kanałach właściciela treści. Raport nie zawiera żadnych wymaganych wymiarów.
| 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 na kanałach właściciela treści w określonych przedziałach czasu. Możesz filtrować raport, aby wyświetlać tylko dane dotyczące konkretnej playlisty lub kanału.
| 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
Ten raport zawiera statystyki dotyczące interakcji użytkowników z danego kraju z filmami na playlistach kanału.
Ten raport zawiera statystyki playlist według kraju.
| 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 w wartości parametru filters uwzględniasz znak country==US.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
Miejsca odtwarzania
Ten raport zawiera statystyki dotyczące typu strony lub aplikacji, w których odtwarzane były 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 wskazuje odtwarzacze wideo, które wygenerowały najwięcej wyświetleń lub czasu oglądania playlist właściciela treści.
Źródła wizyt
Ten raport zawiera zbiorcze statystyki oglądalności na podstawie sposobu, w jaki widzowie trafili na treści na Twojej playliście. Na przykład określa liczbę wyświetleń pochodzących z wyszukiwarki Google lub strony kanału.
| 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 oglądalności na podstawie źródeł, które wygenerowały najwięcej wyświetleń playlist właściciela treści. 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 właściciela treści.
| 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 w przypadku playlist
Ten raport zawiera zbiorcze statystyki oglądania na podstawie typu urządzenia, którego widzowie używali do oglądania treści na Twojej playliście. Na przykład określa liczbę wyświetleń na urządzeniach mobilnych lub konsolach do gier.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
System operacyjny playlist
Ten raport zawiera zbiorcze statystyki oglądania na podstawie systemów operacyjnych widzów. Na przykład określa liczbę wyświetleń playlisty na urządzeniach z Androidem lub na konsolach PlayStation.
| Spis treści |
| Wymiary: |
|
| Dane: |
|
| Filtry: |
|
System operacyjny i typ urządzenia w przypadku list odtwarzania
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ń playlisty 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 i
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.
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 właściciela treści na podstawie 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 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: |
|
