Ten dokument określa dane, które możesz pobrać za pomocą interfejsu API Statystyk YouTube. Interfejs API obsługuje zapytania w czasie rzeczywistym, co umożliwia generowanie raportów niestandardowych Statystyk YouTube.
Dane to poszczególne pomiary aktywności użytkowników, skuteczności reklam lub szacunkowych przychodów. Dane o aktywności użytkowników obejmują m.in. liczbę wyświetleń filmu i oceny (polubienia i nielubienia).
Dane podstawowe
Interfejs API YouTube Analytics podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, ale nie dotyczy to wskaźników i wymiarów niestandardowych. W definicjach na tej stronie każdy wskaźnik podstawowy jest wyraźnie oznaczony jako taki.
Poniżej znajdziesz listę podstawowych danych interfejsu API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
engagedViews
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
Aby uzyskać więcej informacji, zapoznaj się z listą interfejsów YouTube API objętych zasadami wycofywania.
Wyświetl dane
- engagedViews (podstawowe dane)
- Liczba obejrzeń filmu przez co najmniej 4 sekundy.
- wyświetleń (dane podstawowe)
- Te dane reprezentują różne liczby w różnych typach raportów.
This is a core metric and is subject to the Deprecation Policy.
- playlistViews
- Te dane są definiowane w sekcji Dane playlisty.
- redViews
- Liczba wyświetleń filmu przez użytkowników YouTube Premium (usługi znanej wcześniej jako YouTube Red).
- viewerPercentage (dane podstawowe)
- Odsetek widzów, którzy byli zalogowani podczas oglądania filmu lub playlisty. This is a core metric and is subject to the Deprecation Policy.
Dane o czasie oglądania
- estimatedMinutesWatched (dane podstawowe)
- Liczba minut, przez które użytkownicy oglądali filmy na określonym kanale, w przypadku właściciela treści, filmu lub playlisty. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- Liczba minut, przez które subskrybenci YouTube Premium (dawniej YouTube Red) oglądali film.
- averageViewDuration (dane podstawowe)
- Średni czas (w sekundach) odtwarzania filmu. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu z pętli z klipami. W raporcie dotyczącym playlisty ta wartość wskazuje średnią długość (w sekundach) odtwarzania filmów, które miały miejsce w kontekście playlisty. This is a core metric and is subject to the Deprecation Policy.
- averageViewPercentage
- Średni procent obejrzenia filmu podczas odtwarzania. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu z pętli z klipami.
Wskaźniki zaangażowania
- comments (dane podstawowe)
- Liczba komentarzy do filmu. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
- polubienia (dane podstawowe)
- Liczba przypadków, w których użytkownicy wyrazili swoją aprobatę dla filmu w postaci przyznania mu pozytywnej oceny. This is a core metric and is subject to the Deprecation Policy.
- nielubienia (dane podstawowe)
- Liczba przypadków, w których użytkownicy wyrazili swoją dezaprobatę dla filmu w postaci przyznania mu negatywnej oceny. This is a core metric and is subject to the Deprecation Policy.
- Liczba udostępnień filmu przez użytkowników za pomocą przycisku
Share
. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy. - subscribersGained (dane podstawowe)
- Liczba subskrypcji kanału przez użytkowników. This is a core metric and is subject to the Deprecation Policy.
Kanały mogą zyskać lub stracić subskrybentów w kilku miejscach, m.in. na stronie filmu, stronie kanału i w przewodniku, który pojawia się na stronie głównej YouTube. W raportach dotyczących kanału te dane obejmują subskrybentów uzyskanych z dowolnego z tych miejsc. Jednak w przypadku raportów, które używają wymiaruvideo
lub parametrufilter
, aby ograniczyć odpowiedź tylko do danych o konkretnym filmie, danesubscribersGained
będą zawierać tylko statystyki z wyświetlanej strony filmu. - subscribersLost (dane podstawowe)
- Liczba subskrypcji anulowanych przez użytkowników. This is a core metric and is subject to the Deprecation Policy.
Dane dotyczące tego wskaźnika są raportowane podobnie jak dane wskaźnikasubscribersGained
. W raportach dotyczących kanału ta wartość obejmuje subskrybentów, którzy zrezygnowali z subskrypcji kanału za pomocą dowolnego mechanizmu. Jednak w przypadku raportów, które używają wymiaruvideo
lub parametrufilter
, aby ograniczyć odpowiedź tylko do danych o konkretnym filmie, ta wartość obejmuje tylko użytkowników, którzy anulowali subskrypcję na stronie odtwarzania określonego filmu. - videosAddedToPlaylists
- Liczba razy, gdy filmy zostały dodane do dowolnych playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.
Wartość danych obejmuje liczbę razy, ile filmy zostały dodane do domyślnych playlist, takich jak playlista „Do obejrzenia”. Nie uwzględnia on jednak playlist, do których film jest dodawany automatycznie, takich jak playlista przesłanych filmów na kanale lub historia oglądania użytkownika.
Ten rodzaj danych zwraca liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go, a następnie doda ponownie, wartość danych będzie odzwierciedlać dodanie filmu do playlisty dwukrotnie. Dane tego typu są niedostępne w przypadku dat poprzedzających 1 października 2014 r. - videosRemovedFromPlaylists
- Liczba przypadków, w których filmy zostały usunięte z dowolnej playlisty w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist innych kanałów.
Wartość danych obejmuje liczbę razy, gdy filmy zostały usunięte z domyślnych playlist, takich jak playlista „Do obejrzenia”.
Te dane zwracają liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go, doda ponownie, a następnie usunie ponownie, wartość danych będzie odzwierciedlać usunięcie filmu z playlisty dwukrotnie. Dane tego typu są niedostępne w przypadku dat poprzedzających 1 października 2014 r.
Dane dotyczące playlist
Raporty dotyczące playlist zawierają 2 rodzaje danych, które wyjaśniają, jak widzowie korzystają z filmów na playliście:
-
Zbiorcze dane o filmach zawierają dane o aktywności użytkowników i wyświetleniach, które są zliczane dla wszystkich filmów na playliście należących do kanału, na którym znajduje się playlista. Dane dotyczące filmów należących do innych kanałów nie są uwzględniane w agregacji. W efekcie, jeśli kanał utworzy playlistę zawierającą tylko filmy należące do innych kanałów, raporty dotyczące tych playlist nie będą zawierać wartości tych danych.
Definicje obsługiwanych zbiorczych danych wideo znajdziesz w sekcji dane dotyczące wyświetleń i dane dotyczące czasu oglądania tego dokumentu.
-
Dane na poziomie playlisty 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.
Większość podanych niżej danych dotyczy interakcji użytkowników z playlistą, a pozostałe dane, takie jak playlistSaves
, dotyczą interakcji z samą playlistą, a nie z filmami na niej. Dlatego te dane nie mogą być klasyfikowane jako dane agregowane dotyczące filmów ani dane dotyczące playlist.
- averageTimeInPlaylist
- Szacowany średni czas (w minutach) oglądania filmów z playlisty po jej rozpoczęciu. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist, które miały miejsce w internecie.
- playlistAverageViewDuration
- Szacowany średni czas oglądania (w sekundach) na wyświetlenie playlisty. Pamiętaj, że te dane przedstawiają średnią długość wyświetleń poszczególnych filmów na danej playliście. Natomiast dane
averageTimeInPlaylist
przedstawiają średni czas, przez jaki każdy widz oglądał playlistę jako całość. Te dane obejmują filmy z playlist należących do innych kanałów. - playlistEstimatedMinutesWatched
- Liczba minut, przez które użytkownicy oglądali zawartość playlisty jako część playlisty. Czas oglądania w innych kontekstach, np. czas oglądania, który miał miejsce, gdy widzowie oglądali ten sam film w ramach innych playlist, nie jest liczony. Ten rodzaj danych obejmuje dane dotyczące filmów z playlist należących do innych kanałów.
- playlistSaves
- Liczba zapisań playlisty przez użytkowników. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Ten rodzaj danych zwraca liczbę netto, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist i zapisze ponownie, wartość tego rodzaju danych będzie odzwierciedlać dodanie zapisu jednej playlisty.
- playlistStarts
- Liczba rozpoczętych przez widzów odtworzeń playlisty. Pamiętaj, że ten wskaźnik uwzględnia tylko wyświetlenia playlist, które miały miejsce w internecie.
- playlistViews
- Liczba wyświetleń filmów na playliście w kontekście tej playlisty.
Te dane obejmują filmy z playlist należących do innych kanałów.
- viewsPerPlaylistStart
- Średnia liczba wyświetleń filmu, która wystąpiła po każdym uruchomieniu playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist, które miały miejsce w internecie.
Dane adnotacji
Uwaga: raporty interfejsu API Statystyk YouTube zwracają dane dotyczące wskaźników annotationClickThroughRate
i annotationCloseRate
od 10 czerwca 2012 r. Ponadto raporty interfejsu YouTube Analytics API zwracają dane tylko dla pozostałych rodzajów danych dotyczących adnotacji od 16 lipca 2013 r.
- annotationImpressions
- Łączna liczba wyświetleń adnotacji.
- annotationClickableImpressions
- Liczba adnotacji, które się wyświetliły i można je było kliknąć.
- annotationClicks
- Liczba kliknięć adnotacji.
- annotationClickThroughRate (dane podstawowe)
- Stosunek liczby adnotacji, które widzowie kliknęli, do łącznej liczby wyświetleń adnotacji, które można kliknąć. This is a core metric and is subject to the Deprecation Policy. Więcej informacji o tworzeniu adnotacji i używaniu adnotacji z linkami znajdziesz w Centrum pomocy YouTube.
- annotationClosableImpressions
- Liczba adnotacji, które się wyświetliły i które można było zamknąć.
- annotationCloses
- Liczba zamkniętych adnotacji.
- annotationCloseRate (wskaźnik podstawowy)
- Stosunek liczby adnotacji zamkniętych przez widzów do łącznej liczby wyświetleń adnotacji. This is a core metric and is subject to the Deprecation Policy.
Dane na karcie
W Centrum pomocy YouTube znajdziesz szczegółowe instrukcje dotyczące dodawania kart do filmów oraz raportu z kartami w Statystykach YouTube.
- cardImpressions
- Liczba wyświetleń kart. Gdy otworzysz panel karty, wyświetlenie karty zostanie zarejestrowane w przypadku każdej karty w filmie.
- cardClicks
- Liczba kliknięć kart.
- cardClickRate
- Współczynnik klikalności karty, który jest obliczany jako stosunek liczby kliknięć karty do liczby jej wyświetleń.
- Liczba wyświetleń zwiastunów karty. Jedno obejrzenie filmu może generować wiele wyświetleń zwiastunów.
- Liczba kliknięć zajawek kart. Kliknięcia ikony karty są przypisywane do ostatniego zwiastuna wyświetlonego użytkownikowi.
- Współczynnik klikalności zwiastunów karty, który jest obliczany jako stosunek liczby kliknięć zwiastunów karty do łącznej liczby wyświetleń zwiastunów karty.
Dane dotyczące transmisji na żywo (równoczesnej liczby widzów)
- averageConcurrentViewers
- Średnia liczba równoczesnych widzów danego filmu. Jeśli w raporcie podany jest wymiar livestreamPosition, wartość
averageConcurrentViewers
określa średnią liczbę jednoczesnych widzów w danym segmencie .
- peakConcurrentViewers
- Maksymalna liczba jednoczesnych widzów danego filmu. Jeśli w raporcie podany jest wymiar livestreamPosition, wartość
peakConcurrentViewers
określa szczytową liczbę równoczesnych widzów w danym segmencie filmu.
dane dotyczące utrzymania uwagi odbiorców,
- audienceWatchRatio
- Bezwzględny współczynnik widzów oglądających film w danym momencie. Współczynnik ten jest obliczany na podstawie porównania liczby obejrzeń danego fragmentu filmu z łączną liczbą obejrzeń filmu. Wymiar
elapsedVideoTimeRatio
wskazuje część filmu, do której odnosi się rodzaj danych.
Pamiętaj, że dany fragment filmu może zostać obejrzany więcej niż raz (lub wcale) podczas danego wyświetlenia filmu. Jeśli na przykład użytkownicy przewiną i obejrzą daną część filmu kilka razy, bezwzględny współczynnik tej części filmu może być większy niż1
.
Poniższe przykłady pokazują, jak obliczana jest ta wartość:- 100-sekundowy film został obejrzany 100 razy. Połowa widzów przestaje oglądać film po 15 sekundach, a reszta ogląda go do końca. Żaden z widzów nie oglądał żadnej części filmu więcej niż raz. W tym przypadku wartość tej metryki wynosiłaby
1
w przypadku przedziałów czasowych w pierwszej ćwiartce filmu, a0.50
– w przypadku pozostałych części filmu. - 100-sekundowy film został obejrzany 100 razy. Wszyscy widzowie oglądają cały film, ale 20 z nich ogląda go do 45. sekund, a potem przewija do 30. sekund i ogląda resztę. W tym przypadku wartość danych będzie wynosić
1
w przypadku przedziałów czasowych w pierwszej połowie lub ostatniej ćwiartce filmu. Natomiast w przypadku przedziałów czasowych w trzecim kwartale filmu wartość wynosi1.2
, ponieważ 100% widzów obejrzało ten segment filmu, ale 20% z nich obejrzało go dwukrotnie.
- 100-sekundowy film został obejrzany 100 razy. Połowa widzów przestaje oglądać film po 15 sekundach, a reszta ogląda go do końca. Żaden z widzów nie oglądał żadnej części filmu więcej niż raz. W tym przypadku wartość tej metryki wynosiłaby
- relativeRetentionPerformance
- Wskaźnik pokazujący, w jakim stopniu film utrzymuje uwagę widzów podczas odtwarzania w porównaniu do wszystkich filmów w YouTube o podobnej długości. Dane mają wartość od
0
do1
, która określa względną skuteczność utrzymania uwagi w danym momencie filmu. Miejsce w filmie jest podawane przez wymiarelapsedVideoTimeRatio
.
Wartość0
oznacza, że film przyciąga uwagę widzów gorzej niż jakikolwiek inny film o podobnej długości, a wartość1
wskazuje, że film przyciąga uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Wartość mediany0.5
wskazuje, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa gorzej.
Poniżej przedstawiono przypadkowy przykład, który pokazuje, jak wartości mogą wyglądać w raporcie. Średnio 90% widzów, którzy oglądają filmy trwające 10 minut, nadal ogląda je po 3 minutach, a 70% – po 8 minutach. Jednak w przypadku 10-minutowego filmu po 3 minutach ogląda go tylko 80% widzów, ale po 8 minutach nadal oglądają go wszyscy.- Wartość
elapsedVideoTimeRatio
odpowiadająca 3 minutom filmu będzie miała wartość poniżej0.5
, ponieważ w tym momencie film ma gorsze wyniki niż przeciętny film.relativeRetentionPerformance
- Wartość
elapsedVideoTimeRatio
odpowiadająca 8 minucie filmu będzie miała wartość wyższą niż0.5
, ponieważ w tym momencie film ma lepsze wyniki niż inne filmy o podobnej długości.relativeRetentionPerformance
- Wartość
- startedWatching
- Liczba razy, gdy dany segment filmu był pierwszym odtworzonym segmentem podczas odtwarzania filmu.
Załóżmy na przykład, że film X trwa 5 minut. Na potrzeby tego raportu YouTube dzieli film na 100 segmentów trwających 3 sekundy, które są identyfikowane za pomocą wymiaru elapsedVideoTimeRatio. Użytkownik odwiedza YouTube i ogląda pierwszą minutę i 10 sekund filmu, co obejmuje wszystkie lub część pierwszych 24 sekcji filmu. Podczas kolejnej wizyty w YouTube widz ogląda resztę filmu, wznawiając odtwarzanie w segmencie 24 i kontynuując od segmentu 100.
W tym przykładzie uzyskamy takie wartości danych dotyczące oglądalności:- Wartość danych
startedWatching
wynosiłaby1
w przypadku segmentów 1 i 24, a w przypadku wszystkich pozostałych segmentów –0
. - Wartość danych
stoppedWatching
wynosiłaby1
w przypadku segmentów 24 i 100, a w przypadku wszystkich pozostałych segmentów –0
. - Wartość danych
totalSegmentImpressions
wynosiłaby2
w przypadku segmentu 24, a we wszystkich pozostałych segmentach –1
.
- Wartość danych
- stoppedWatching
- Liczba razy, gdy dany segment filmu był ostatnim oglądanym segmentem podczas odtwarzania filmu. Aby dowiedzieć się, jak obliczana jest ta wartość danych, zapoznaj się z definicją danych
startedWatching
. - totalSegmentImpressions
- Liczba odtworzeń danego segmentu filmu. Przykładowy sposób obliczania wartości danych
startedWatching
znajdziesz w definicji tych danych. Pamiętaj, że widz może oglądać ten sam fragment filmu wiele razy podczas jednego odtwarzania.
Dane o anulowaniu wspierania
- membershipsCancellationSurveyResponses
- Liczba ankiet wypełnionych przez użytkowników YouTube, którzy anulowali wspieranie określonego kanału w okresie raportowania.
Dane o szacunkowych przychodach
Uwaga: dane o szacunkowych przychodach podlegają korekcie na koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów. Aby uzyskać więcej informacji o szacowanych przychodach, odwiedź Centrum pomocy YouTube.
currency
w przypadku niektórych danych o szacowanych przychodach i skuteczności reklam, co pozwala pobierać dane o szacowanych przychodach w innych walutach.- estimatedRevenue (podstawowy rodzaj danych) (wcześniej
earnings
) - Łączne szacunkowe przychody netto ze wszystkich źródeł reklamy sprzedawanych przez Google oraz ze źródeł niereklamowych w wybranym zakresie dat i regionie.
This is a core metric and is subject to the Deprecation Policy.
Dane o szacowanych przychodach podlegają korekcie na koniec miesiąca i nie obejmują reklam sprzedawanych i wyświetlanych przez partnerów.
- estimatedAdRevenue (wcześniej
adEarnings
) - Łączne szacunkowe przychody netto ze wszystkich źródeł reklamy sprzedawanych przez Google w wybranym okresie i regionie.
Dane o szacunkowych przychodach podlegają korektom na koniec miesiąca i nie obejmują reklam sprzedawanych i wyświetlanych przez partnerów. - estimatedRedPartnerRevenue (wcześniej
redPartnerRevenue
) - Łączne szacunkowe przychody z subskrypcji YouTube Premium (dawniej YouTube Red) w wybranych wymiarach raportu. Wartość tego rodzaju danych odzwierciedla przychody z treści muzycznych i niemuzycznych oraz podlega korektom na koniec miesiąca.
Dane o skuteczności reklamy
- grossRevenue
- Szacunkowe przychody brutto w USD uzyskane ze wszystkich reklam sprzedanych przez Google lub przez partnerów DoubleClick w wybranym zakresie dat i regionie. Wartość przychodów brutto nie uwzględnia reklam wyświetlanych przez partnerów i podlega korekcie na koniec miesiąca. Nie należy mylić przychodów brutto ze szacowanymi przychodami lub przychodami netto, które uwzględniają udział w własności i umowy o podziale przychodów.
- cpm (wcześniej
impressionBasedCpm
) - Szacowany przychód brutto z tysiąca wyświetleń reklamy.
- adImpressions (wcześniej
impressions
) - Liczba zweryfikowanych wyświetleń reklam.
- monetizedPlaybacks
- Liczba przypadków, gdy widz odtworzył Twój film i zobaczył co najmniej jedną reklamę. Odtworzenie generujące przychody jest liczone, gdy widz zobaczy reklamę przed filmem, ale zrezygnuje z oglądania jeszcze przed rozpoczęciem filmu. Oczekiwany błąd szacowany dla tego wyniku wynosi ±2,0%.
- playbackBasedCpm
- Szacowany przychód brutto na tysiąc odtworzeń.