Metrics

Ten dokument definiuje 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.

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ń filmów na kanale po pierwszych kilku sekundach.
wyświetleń (dane podstawowe)
Te dane mają różne wartości 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 obejrzeń filmu przez subskrybentów YouTube Premium (dawniej 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 klipów. 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 klipów.

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.
Udostępnienia (dane podstawowe)
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ą wymiaru video lub parametru filter, aby ograniczyć odpowiedź tylko do danych o konkretnym filmie, dane subscribersGained będą zawierać tylko statystyki z wyświetlanej strony filmu.
subscribersLost (podstawowe dane)
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źnika subscribersGained. 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ą wymiaru video lub parametru filter, 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 dowolnej playlisty 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 „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 na playliście po rozpoczęciu jej odtwarzania. 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. Dane averageTimeInPlaylist przedstawiają natomiast ś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 zapisanych przez użytkowników playlist. 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 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ń klikalnych adnotacji. 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 (dane podstawowe)
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ń.
cardTeaserImpressions
Liczba wyświetleń zwiastunów karty. Jedno obejrzenie filmu może generować wiele wyświetleń zwiastunów.
cardTeaserClicks
Liczba kliknięć zajawek kart. Kliknięcia ikony karty są przypisywane do ostatniego zwiastuna wyświetlonego użytkownikowi.
cardTeaserClickRate
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ą tę samą 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 miary wynosiłaby 1 w przypadku przedziałów czasowych w pierwszej ćwiartce filmu, a 0.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ść wynosi 1.2, ponieważ 100% widzów obejrzało ten segment filmu, ale 20% z nich obejrzało go dwukrotnie.
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 do 1, która określa względną skuteczność utrzymania uwagi w danym momencie filmu. Miejsce w filmie jest podawane przez wymiar elapsedVideoTimeRatio.

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ść mediany 0.5 wskazuje, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa gorzej.

Poniżej przedstawiono przypadek hipotetyczny, 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.
  • W przypadku wartości elapsedVideoTimeRatio odpowiadającej 3 minutom filmu wskaźnik relativeRetentionPerformance ma wartość poniżej 0.5, ponieważ w tym czasie film osiąga gorsze wyniki niż przeciętny film.
  • W przypadku wartości elapsedVideoTimeRatio odpowiadającej 8 minucie filmu wskaźnik relativeRetentionPerformance będzie miał wartość wyższą niż 0.5, ponieważ w tym momencie film ma lepsze wyniki niż inne filmy o podobnej długości.
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 w przypadku segmentów 1 i 24 wynosi 1, a w przypadku wszystkich pozostałych segmentów – 0.
  • Wartość danych stoppedWatching w przypadku segmentów 24 i 100 wynosi 1, a w przypadku pozostałych segmentów – 0.
  • Wartość danych totalSegmentImpressions wynosiłaby 2 w przypadku segmentu 24, a we wszystkich pozostałych segmentach – 1.
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 objętym raportem.

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ć dodatkowe informacje i notki na temat szacowanych przychodów, odwiedź Centrum pomocy YouTube.

Domyślnie wszystkie szacowane przychody są podawane w USD. Interfejs API Statystyk YouTube obsługuje jednak parametr currency w przypadku niektórych danych o szacowanych przychodach i skuteczności reklam, co pozwala pobierać dane o szacowanych przychodach w innych walutach.
estimatedRevenue (podstawowe dane) (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ń.