Metrics

Ten dokument określa dane, które możesz pobrać za pomocą interfejsu YouTube Analytics API. Ten 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 kliknięcia przycisku „To mi się nie podoba”).

Dane podstawowe

Interfejs YouTube Analytics API podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, ale zasady te nie dotyczą wskaźników (ani wymiarów) podstawowych. W definicjach na tej stronie wszystkie podstawowe dane są wyraźnie oznaczone jako takie.

Poniższa lista zawiera podstawowe dane interfejsu API.

Więcej informacji znajdziesz na liście interfejsów API YouTube objętych zasadami wycofywania.

Wyświetl dane

engagedViews (podstawowe dane)
Liczba wyświetleń filmów na kanale po pierwszej klatce lub po kliknięciu/dotknięciu przez użytkownika przycisku odtwarzania.
wyświetlenia (podstawowe dane)
W różnych typach raportów ten wskaźnik reprezentuje różne liczby. This is a core metric and is subject to the Deprecation Policy.
playlistViews
Ten wskaźnik jest zdefiniowany w sekcji wskaźniki playlisty.
redViews
Liczba wyświetleń filmu przez subskrybentów YouTube Premium (usługi znanej wcześniej jako YouTube Red).
viewerPercentage (podstawowe dane)
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 (podstawowy wskaźnik)
Liczba minut, przez które użytkownicy oglądali filmy na określonym kanale, należące do określonego właściciela treści, lub filmy z określonej playlisty. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
Liczba minut, przez które subskrybenci YouTube Premium (wcześniej YouTube Red) oglądali film.
averageViewDuration (podstawowe dane)
Średnia długość odtworzeń filmu w sekundach. Od 13 grudnia 2021 r. te dane nie obejmują ruchu z zapętlonych klipów. W raporcie dotyczącym playlisty ten rodzaj danych wskazuje średnią długość (w sekundach) odtworzeń 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 obejmują ruchu z zapętlonych klipów.

Wskaźniki zaangażowania

komentarze (podstawowe dane)
Liczba komentarzy użytkowników do filmu. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
polubienia (podstawowy rodzaj danych)
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.
dislikes (podstawowy rodzaj danych)
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 (podstawowe dane)
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 (podstawowy wskaźnik)
Liczba subskrypcji kanału przez użytkowników. This is a core metric and is subject to the Deprecation Policy.

Subskrybentów można zdobywać i tracić w kilku miejscach, m.in. na stronie odtwarzania filmu, na 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 w dowolnym z tych miejsc. Jeśli jednak w raportach używasz wymiaru video lub parametru filter, aby ograniczyć odpowiedź tylko do danych dotyczących konkretnego filmu, dane subscribersGained będą zawierać tylko statystyki ze strony odtwarzania filmu określonego filmu.
subscribersLost (podstawowy wskaźnik)
Liczba przypadków, gdy użytkownicy anulowali subskrypcję kanału. This is a core metric and is subject to the Deprecation Policy.

Dane tego typu są raportowane podobnie jak dane subscribersGained. W raportach dotyczących kanału te dane obejmują subskrybentów utraconych w wyniku dowolnego mechanizmu, za pomocą którego użytkownicy mogą anulować subskrypcję kanału. W raportach, które używają wymiaru video lub parametru filter, aby ograniczyć odpowiedź do danych dotyczących tylko konkretnego filmu, ta wartość obejmuje tylko użytkowników, którzy zrezygnowali z subskrypcji strony odtwarzania filmu określonego filmu.
videosAddedToPlaylists
Liczba przypadków dodania filmów do dowolnych playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.

Wartość tego rodzaju danych obejmuje liczbę dodanych filmów do domyślnych playlist, takich jak „Do obejrzenia”. Nie obejmuje jednak playlist, do których film jest dodawany automatycznie, np. playlisty z przesłanymi filmami na kanale lub historii oglądania użytkownika.

Ta wartość zwraca liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go, a następnie doda ponownie, wartość odzwierciedla dwukrotne dodanie filmu do playlisty. Dane tego typu nie są dostępne w przypadku dat sprzed 1 października 2014 r.
videosRemovedFromPlaylists
 Liczba przypadków usunięcia filmów z dowolnych playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist innych kanałów.

Wartość danych obejmuje liczbę usunięć filmów z domyślnych playlist, takich jak „Do obejrzenia”.

Te dane zwracają liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go, doda ponownie i znowu usunie, wartość danych będzie odzwierciedlać dwukrotne usunięcie filmu z playlisty. Dane tego typu nie są dostępne w przypadku dat sprzed 1 października 2014 r.

Dane dotyczące playlist

Raporty dotyczące playlist zawierają 2 rodzaje danych, które pokazują, 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ą 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ę 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 zagregowanych danych dotyczących filmów znajdziesz w sekcjach Wyświetlanie danych i Dane dotyczące czasu oglądania w tym dokumencie.

  • Dane dotyczące playlisty odzwierciedlają aktywność użytkownika i zaangażowanie w kontekście strony playlisty. Dane te 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ść z tych danych dotyczy playlisty. Pozostałe dane na liście, np. playlistSaves, dotyczą interakcji użytkowników z samą playlistą, a nie z filmami na niej. Dlatego nie można ich zakwalifikować ani jako zagregowanych danych o filmie, ani jako danych dotyczących playlisty.

averageTimeInPlaylist
Szacowany średni czas (w minutach) oglądania filmów na playliście po jej rozpoczęciu. Pamiętaj, że ten wskaźnik obejmuje tylko wyświetlenia playlist, które miały miejsce w internecie.
playlistAverageViewDuration
Szacowana średnia długość oglądania w sekundach na wyświetlenie playlisty. Pamiętaj, że te dane przedstawiają średnią długość wyświetleń poszczególnych filmów na playliście. Dane averageTimeInPlaylist przedstawiają natomiast średni czas, jaki każdy widz spędza na oglądaniu całej playlisty. Te dane obejmują filmy z playlist należące do innych kanałów.
playlistEstimatedMinutesWatched
Liczba minut, przez które użytkownicy oglądali treści z playlisty w ramach tej playlisty. Czas oglądania, który wystąpił w innych kontekstach, np. czas oglądania z wyświetleń, które miały miejsce, gdy widzowie oglądali ten sam film w ramach innych playlist, nie jest uwzględniany. Te dane obejmują filmy na playliście, które należą do innych kanałów.
playlistSaves
Łączna liczba zapisanych przez użytkowników playlist. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Ten rodzaj danych zwraca liczbę zmian netto, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist i zapisze ją ponownie, wartość tego rodzaju danych będzie odzwierciedlać dodanie 1 zapisanej playlisty.
playlistStarts
Liczba rozpoczętych przez widzów odtworzeń playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.
playlistViews
Liczba wyświetleń filmów z playlisty w kontekście tej playlisty. Ten rodzaj danych obejmuje informacje o filmach na playliście, które należą do innych kanałów.
viewsPerPlaylistStart
Średnia liczba wyświetleń filmów, która nastąpiła po każdym rozpoczęciu odtwarzania playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.

Dane adnotacji

Uwaga: od 10 czerwca 2012 r. raporty interfejsu YouTube Analytics API zwracają tylko dane dotyczące danych annotationClickThroughRate i annotationCloseRate. Dodatkowo od 16 lipca 2013 r. raporty YouTube Analytics API zwracają dane tylko w przypadku pozostałych rodzajów danych dotyczących adnotacji.

annotationImpressions
Łączna liczba wyświetleń adnotacji.
annotationClickableImpressions
Liczba wyświetlonych adnotacji, które można było kliknąć.
annotationClicks
Liczba klikniętych adnotacji.
annotationClickThroughRate (podstawowe dane)
Stosunek klikniętych adnotacji 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 korzystaniu z adnotacji z linkami znajdziesz w Centrum pomocy YouTube.
annotationClosableImpressions
Liczba wyświetlonych adnotacji, które można było zamknąć.
annotationCloses
Liczba zamkniętych adnotacji.
annotationCloseRate (podstawowe dane)
Stosunek 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 karty

Więcej szczegółowych instrukcji dotyczących dodawania kart do filmów i raportu o kartach w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

cardImpressions
Liczba wyświetleń kart. Gdy panel karty zostanie otwarty, wyświetlenie karty jest rejestrowane dla każdej karty filmu.
cardClicks
Liczba kliknięć kart.
cardClickRate
Współczynnik klikalności kart, który jest obliczany jako stosunek liczby kliknięć karty do liczby jej wyświetleń.
cardTeaserImpressions
Liczba wyświetleń zajawki karty. Obejrzenie filmu może wygenerować wiele wyświetleń zwiastuna.
cardTeaserClicks
Liczba kliknięć zajawki karty. Kliknięcia ikony karty są przypisywane do zwiastuna, który został wyświetlony jako ostatni.
cardTeaserClickRate
Współczynnik klikalności zwiastunów kart, który jest obliczany jako stosunek liczby kliknięć zwiastunów kart do łącznej liczby wyświetleń zwiastunów kart.

Dane transmisji na żywo (równocześni widzowie)

averageConcurrentViewers
Średnia liczba równoczesnych widzów danego filmu. Jeśli w raporcie określono wymiar livestreamPosition, wartość averageConcurrentViewers określa średnią liczbę widzów oglądających transmisję równolegle w danym segmencie.
peakConcurrentViewers
Maksymalna liczba jednoczesnych widzów danego filmu. Jeśli w raporcie określono wymiar livestreamPosition, wartość peakConcurrentViewers określa najwyższą liczbę transmisji równoległych w określonym segmencie filmu.

dane dotyczące utrzymania uwagi odbiorców,

audienceWatchRatio
Bezwzględny odsetek widzów oglądających film w danym momencie. Współczynnik ten oblicza się, porównując liczbę obejrzeń fragmentu filmu z łączną liczbą wyświetleń filmu. Wymiar elapsedVideoTimeRatio określa część filmu, do której odnosi się rodzaj danych.

Pamiętaj, że podczas jednego wyświetlenia filmu jego fragment może zostać obejrzany więcej niż raz (lub wcale). Jeśli na przykład użytkownicy przewijają i oglądają tę samą część filmu kilka razy, bezwzględny współczynnik dla tej części filmu może być większy niż 1.

Poniższe przykłady pokazują, jak obliczana jest ta wartość:
  • Minutowy film został obejrzany 100 razy. Po 15 sekundach połowa widzów przestaje oglądać film, a pozostali oglądają go w całości. Żaden z widzów nie ogląda żadnej części filmu więcej niż raz. W tym przypadku wartość tego rodzaju danych wyniesie 1 w przypadku przedziałów czasowych w pierwszej ćwiartce filmu, a 0.50 w przypadku pozostałej części filmu.
  • Minutowy film został obejrzany 100 razy. Wszyscy widzowie oglądają cały film, ale 20 z nich ogląda go do 45 sekundy, a potem wraca do 30 sekundy i ogląda resztę filmu. W tym przypadku wartość tego rodzaju danych wynosiłaby 1 w przypadku przedziałów czasowych w pierwszej połowie lub ostatniej ćwiartce filmu. Wartość ta wynosiłaby jednak 1.2 w przypadku przedziałów czasowych w trzecim kwartale filmu, ponieważ 100% widzów obejrzało ten segment filmu, ale 20% z nich obejrzało go 2 razy.
relativeRetentionPerformance
Wskaźnik pokazujący, w jakim stopniu film utrzymuje uwagę widzów podczas odtwarzania w porównaniu z filmami w YouTube o podobnej długości. Wartość tego parametru mieści się w zakresie od 0 do 1 i określa względną skuteczność utrzymania uwagi widzów w danym momencie filmu. Punkt w filmie jest podawany przez wymiar elapsedVideoTimeRatio.

Wartość 0 oznacza, że film utrzymuje uwagę odbiorców gorzej niż jakikolwiek inny film o podobnej długości, a wartość 1 oznacza, że film utrzymuje uwagę odbiorców lepiej niż jakikolwiek inny film o podobnej długości. Mediana 0.5 oznacza, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa gorzej.

Poniższy hipotetyczny przykład pokazuje, jak wartości mogą wyglądać w raporcie. Średnio 90% widzów, którzy oglądają 10-minutowe filmy, nadal ogląda je po 3 minutach, a 70% – po 8 minutach. W przypadku konkretnego 10-minutowego filmu po 3 minutach ogląda go tylko 80% widzów, ale po 8 minutach wszyscy ci widzowie nadal oglądają film.
  • W przypadku elapsedVideoTimeRatio, która odpowiada punktowi w 3 minucie filmu, wartość relativeRetentionPerformance będzie mniejsza niż 0.5, ponieważ w tym czasie film osiąga gorsze wyniki niż przeciętny film.
  • W przypadku wartości elapsedVideoTimeRatio odpowiadającej punktowi w 8 minucie filmu wartość wskaźnika relativeRetentionPerformance byłaby wyższa niż 0.5, ponieważ w tym czasie film ma lepsze wyniki niż inne filmy o podobnej długości.
startedWatching
Liczba przypadków, w których dany segment filmu był pierwszym segmentem wyświetlonym podczas odtwarzania filmu.

Załóżmy na przykład, że film X trwa 5 minut. Na potrzeby tego raportu YouTube dzieli film na 100 3-sekundowych segmentów, 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 segmentów filmu. Podczas kolejnej wizyty w YouTube widz ogląda resztę filmu, wznawiając odtwarzanie od segmentu 24 i kontynuując do segmentu 100.

W tym przykładzie uzyskasz te wartości danych dotyczących oglądania:
  • Wartość danych startedWatching wynosiłaby 1 w przypadku segmentów 1 i 24, a w przypadku wszystkich pozostałych segmentów – 0.
  • Wartość danych stoppedWatching wyniesie 1 w przypadku segmentów 24 i 100, a wartość danych wyniesie 0 w przypadku wszystkich pozostałych segmentów.
  • Wartość danych totalSegmentImpressions w segmencie 24 wyniesie 2, a w pozostałych segmentach – 1.
stoppedWatching
Liczba przypadków, w których dany segment filmu był ostatnim segmentem obejrzanym podczas odtwarzania filmu. Definicję danych startedWatching znajdziesz w przykładzie obliczania wartości tych danych.
totalSegmentImpressions
Liczba wyświetleń danego segmentu filmu. Przykład obliczania wartości tych danych znajdziesz w definicji danych startedWatching. Pamiętaj, że widz może wielokrotnie oglądać ten sam segment filmu w ramach tego samego 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 uwzględnionym w raporcie.

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. Więcej informacji i uwag na temat szacunkowych przychodów znajdziesz w Centrum pomocy YouTube.

Domyślnie wszystkie szacunkowe dane o przychodach są podawane w USD. Interfejs YouTube Analytics API obsługuje jednak parametr currency w przypadku niektórych szacunkowych danych o przychodach i skuteczności reklam, co umożliwia pobieranie szacunkowych danych o przychodach w innych walutach.
estimatedRevenue (podstawowe dane) (wcześniej earnings)
Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google oraz ze źródeł innych niż reklamowe w wybranym okresie i regionie. This is a core metric and is subject to the Deprecation Policy.

Dane o szacunkowych przychodach podlegają korekcie na koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów.
estimatedAdRevenue (wcześniej adEarnings)
Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google w wybranym okresie i regionie.

Dane o szacunkowych przychodach podlegają korekcie na koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów.
estimatedRedPartnerRevenue (wcześniej redPartnerRevenue)
Łączne szacunkowe przychody uzyskane z subskrypcji YouTube Premium (usługi znanej wcześniej jako YouTube Red) w przypadku wybranych wymiarów raportu. Wartość tego wskaźnika odzwierciedla przychody z treści muzycznych i niemuzycznych i podlega korekcie na koniec miesiąca.

Dane dotyczące skuteczności reklamy

grossRevenue
Szacunkowe przychody brutto w USD ze wszystkich reklam sprzedanych przez Google lub partnerów DoubleClick w wybranym okresie 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 z przychodami szacunkowymi ani przychodami netto, które uwzględniają Twój udział w własności i umowy o podziale przychodów.
cpm (wcześniej impressionBasedCpm)
Szacunkowy przychód brutto z tysiąca wyświetleń reklamy.
adImpressions (wcześniej impressions)
Liczba zrealizowanych wyświetleń zweryfikowanych reklam.
monetizedPlaybacks
Liczba przypadków, w których widz odtworzył Twój film i wyświetlił co najmniej jedną reklamę. Odtworzenie generujące przychody jest liczone, jeśli widz zobaczy reklamę przed filmem, ale zrezygnuje z oglądania, zanim Twój film się rozpocznie. Oczekiwany szacunkowy błąd tej wartości wynosi ±2,0%.
playbackBasedCpm
Szacunkowe przychody brutto na tysiąc odtworzeń.