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 pozwala generować niestandardowe raporty Statystyk YouTube.

Dane to indywidualne pomiary aktywności użytkowników, skuteczności reklam lub szacunkowych przychodów. Dane o aktywności użytkowników obejmują liczbę wyświetleń filmów oraz oceny (oceny pozytywne i negatywne).

Wskaźniki podstawowe

Chociaż interfejs YouTube Analytics API podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, dane inne niż podstawowe (i wymiary inne niż podstawowe) nie podlegają tym zasadom. W definicjach na tej stronie wszystkie dane stanowiące podstawowe dane są wyraźnie oznaczone.

Poniższa lista zawiera podstawowe dane interfejsu API.

Uwaga: te podstawowe dane zostały całkowicie wycofane:

Więcej informacji znajdziesz na liście interfejsów API YouTube podlegających zasadom wycofywania.

Wyświetl dane

obejrzenia (podstawowe dane)
Te dane reprezentują różne wartości w różnych typach raportów:
  • W raportach o filmach ta wartość określa liczbę wyświetleń filmu.
  • W raportach o playlistach, które nie korzystają z wymiaru isCurated, te dane określają łączną liczbę wyświetleń filmów z playlisty niezależnie od tego, czy miały one miejsce w kontekście playlisty. Pamiętaj, że wartość danych obejmuje tylko wyświetlenia filmów właściciela kanału.

    W tych raportach dane playlistViews wskazują, ile razy filmy z playlist zostały wyświetlone w kontekście konkretnej playlisty.
  • W raportach o playlistach, które korzystają z wymiaru isCurated, te dane wskazują liczbę wyświetleń filmów w kontekście konkretnej playlisty. Pamiętaj, że w tych raportach dane playlistViews nie są obsługiwane.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Te dane są zdefiniowane w sekcji danych dotyczących playlist.
redViews
Liczba wyświetleń filmu przez subskrybentów YouTube Premium (wcześniej YouTube Red).
unikalni użytkownicy (wycofano 27 września 2016 r.)
Liczba unikalnych widzów, którzy obejrzeli film. Te obliczenia są oparte na liczbie unikalnych plików cookie i dlatego zawyżają liczbę użytkowników, którzy korzystają z kilku urządzeń lub przeglądarek.
Dane uniques zostały wycofane 27 września 2016 r. Nie są one podstawowym wskaźnikiem i będą obsługiwane do 31 października 2016 r.
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 (podstawowe dane)
Liczba minut, przez które użytkownicy oglądali filmy z określonego kanału, 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 (wcześniej YouTube Red) oglądali film.
averageViewDuration (podstawowe dane)
Średnia długość odtworzeń filmów (w sekundach). Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu z klipów zapętlających. W raporcie dotyczącym playlisty dane te wskazują średnią długość (w sekundach) odtworzeń filmów na playliście. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Średnia wartość procentowa filmu obejrzanego podczas odtwarzania. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu z klipów zapętlających.

Dane o zaangażowaniu

komentarze (podstawowe dane)
Liczba komentarzy, które użytkownicy dodali do filmu. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
polubienia (podstawowe dane)
Liczba przypadków, w których użytkownicy stwierdzili, że film im się podobał, przyznając mu pozytywną ocenę. This is a core metric and is subject to the Deprecation Policy.
głosy na nie (podstawowe dane)
Liczba przypadków, w których użytkownicy stwierdzili, że film im się nie podobał, przyznając mu ocenę negatywną. 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 (podstawowe dane)
Liczba przypadków, w których użytkownicy zasubskrybowali kanał. This is a core metric and is subject to the Deprecation Policy.

Kanały mogą zdobywać lub tracić subskrybentów w różnych miejscach, takich jak strona odtwarzania filmu, strona kanału i przewodnik widoczny na stronie głównej YouTube. W raportach dotyczących kanałów dane te obejmują subskrybentów pozyskanych w każdym z tych miejsc. Jednak w raportach, które korzystają z wymiaru video lub parametru filter, aby ograniczyć odpowiedź tylko do danych dotyczących konkretnego filmu, dane subscribersGained będą zawierały tylko statystyki ze strony odtwarzania tego filmu.
subscribersLost (podstawowe dane)
Liczba przypadków, w których użytkownicy anulowali subskrypcję kanału. This is a core metric and is subject to the Deprecation Policy.

Dane tego rodzaju są raportowane podobnie jak dane subscribersGained. W raportach dotyczących kanałów dane te obejmują subskrybentów utraconych z powodu dowolnego mechanizmu, który pozwalał im zrezygnować z subskrypcji kanału. W raportach, które korzystają z wymiaru video lub parametru filter do ograniczania odpowiedzi tylko do danych dotyczących konkretnego filmu, dane te obejmują tylko użytkowników, którzy anulowali subskrypcję strony odtwarzania wskazanego 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 na playlistach innych kanałów.

Te dane obejmują też, ile razy filmy zostały dodane do domyślnych playlist, np. do playlisty „Do obejrzenia”. Nie obejmuje jednak playlist, do których film jest automatycznie dodawany, jak np. przesłanych filmów na kanał lub historii oglądania użytkownika.

Te dane zwraca liczbę bezwzględną, czyli jeśli użytkownik doda film do playlisty, usunie go i doda ponownie, wartość danych odzwierciedla film dodany do playlisty dwukrotnie. Te dane nie są dostępne dla okresu sprzed 1 października 2014 r.
videosRemovedFromPlaylists
Liczba razy, gdy filmy zostały usunięte ze wszystkich playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub innych kanałów.

Te dane obejmują liczbę przypadków usunięcia filmów z domyślnych playlist, takich jak playlista „Do obejrzenia”.

Te dane zwracają liczbę bezwzględną, czyli gdy użytkownik doda film do playlisty, usunie go, doda go ponownie, a potem jeszcze raz. Dane odzwierciedlają dwukrotne usunięcie filmu z playlisty. Te dane nie są dostępne dla okresu sprzed 1 października 2014 r.

Wycofane wskaźniki zaangażowania

Poniższe dane były podstawowymi danymi, które zostały wycofane 31 marca 2015 r.

favoritesAdded (podstawowe dane) (wycofane 31 marca 2015 r.)
Liczba razy, gdy użytkownicy oznaczyli film jako ulubiony. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (podstawowe dane) (wycofane 31 marca 2015)
Liczba przypadków, w których użytkownicy usunęli film ze swoich list ulubionych filmów. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.

Dane dotyczące playlist

Raporty dotyczące playlist zawierają 2 rodzaje danych, które wyjaśniają, w jaki sposób widzowie wchodzą w interakcję z filmami na playliście:

  • Zbiorcze dane o filmach dostarczają danych o aktywności użytkowników i wyświetleniach dla wszystkich filmów z playlisty, które są też własnością kanału, do którego należy playlista. Dane dotyczące filmów należących do innych kanałów nie są uwzględniane podczas agregacji. Dlatego, 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.

    Definicje obsługiwanych zbiorczych danych o filmach znajdziesz w sekcjach Wyświetl dane i danych o czasie oglądania w tym dokumencie.

  • Dane dotyczące playlisty odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Obejmują one wyświetlenia wszystkich filmów z playlisty niezależnie od tego, do którego kanału należą, ale zliczają tylko wyświetlenia w kontekście playlisty.

Większość danych wymienionych poniżej to dane związane z playlistami. Pozostałe dane na liście, np. playlistSaves, dotyczą interakcji użytkowników z playlistą, a nie jej filmów. W związku z tym nie byłyby to zbiorcze dane o filmach ani dane dotyczące playlist.

averageTimeInPlaylist
Szacowany średni czas (w minutach), przez jaki widz oglądał filmy z playlisty po rozpoczęciu odtwarzania. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist, które miały miejsce w internecie.
playlistAverageViewDuration
Szacunkowa średnia długość oglądania (w sekundach) na wyświetlenie playlisty. Pamiętaj, że wartość ta reprezentuje średnią długość wyświetleń poszczególnych filmów na playliście. Z kolei dane averageTimeInPlaylist reprezentują średni czas, jaki każdy widz poświęca na oglądanie całej playlisty. Te dane obejmują dane dotyczące playlist z filmami, które są własnością innych kanałów.
playlistEstimatedMinutesWatched
Liczba minut, przez które użytkownicy oglądali treści playlisty w ramach playlisty. Czas oglądania, który wystąpił w innych kontekstach – na przykład czas oglądania z wyświetleń, które miały miejsce, gdy widzowie oglądali ten sam film jako część innych playlist, nie jest zliczane. Te dane obejmują dane dotyczące playlist z filmami, które są własnością innych kanałów.
playlistSaves
Liczba razy, gdy użytkownicy zapisali playlistę. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Ten wskaźnik zwraca liczbę zmian netto, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist i zapisze ponownie, wartość danych odzwierciedla dodanie 1 zapisanej playlisty.
playlistStarts
Liczba przypadków, w których widzowie zainicjowali odtwarzanie playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist, które miały miejsce w internecie.
playlistViews
Liczba wyświetleń filmów z playlisty w kontekście tej playlisty. Te dane obejmują dane dotyczące playlist z filmami, które są własnością innych kanałów.
viewsPerPlaylistStart
Średnia liczba wyświetleń filmów przy każdym uruchomieniu playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist, które miały miejsce w internecie.

Dane adnotacji

Uwaga: od 10 czerwca 2012 r. raporty interfejsu YouTube Analytics API zwracają tylko dane dotyczące wskaźników annotationClickThroughRate i annotationCloseRate. Ponadto od 16 lipca 2013 r. raporty interfejsu YouTube Analytics API zwracają tylko dane dotyczące pozostałych wskaźników adnotacji.

annotationImpressions
Łączna liczba wyświetleń adnotacji.
annotationClickableImpressions
Liczba adnotacji, które się wyświetliły i można je kliknąć.
annotationClicks
Liczba klikniętych adnotacji.
annotationClickThroughRate (podstawowe dane)
Stosunek adnotacji klikniętych przez widzów do łącznej liczby kliknięć 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 można znaleźć w Centrum pomocy YouTube.
annotationClosableImpressions
Liczba adnotacji, które się pojawiły i które można 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 oraz raportu Karty w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

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

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 przez porównanie liczby odtworzeń części filmu z łączną liczbą wyświetleń filmu. Wymiar elapsedVideoTimeRatio określa tę część filmu, której dotyczą dane.

Pamiętaj, że w ramach danego wyświetlenia filmu fragment filmu może zostać obejrzany więcej niż raz (lub nie można go znaleźć wcale). Jeśli na przykład użytkownicy przewijają film do tyłu i wielokrotnie oglądają ten sam fragment, wartość bezwzględna tej części filmu może być większa niż 1.

Poniższe przykłady pokazują sposób obliczania wartości:
  • Jednominutowy film został obejrzany 100 razy. Połowa widzów przestaje oglądać po 15 sekundach, a pozostali oglądają go w całości. Żaden z widzów nie obejrzał żadnej części filmu więcej niż raz. W tym przypadku w przypadku segmentów czasu w pierwszej kwartale ta wartość wyniesie 1, a w przypadku pozostałej części filmu – 0.50.
  • Jednominutowy film został obejrzany 100 razy. Wszyscy widzowie oglądają film w całości, ale 20 widzów ogląda go do 45 sekund, a potem przechodzi z powrotem do 30 sekund i ogląda resztę filmu. W tym przypadku wartość w przypadku zasobników czasu w pierwszej lub ostatniej kwadracie filmu wyniesie 1. Jednak w 3 kwartale film będzie miał wartość 1.2, ponieważ 100% widzów obejrzało ten segment, ale 20% z nich obejrzało go dwukrotnie.
relativeRetentionPerformance
Pomiar pokazujący, jak skutecznie film utrzymuje uwagę widzów podczas odtwarzania w porównaniu do wszystkich filmów w YouTube o podobnej długości. Wartość tego wskaźnika mieści się w przedziale od 0 do 1, która określa względną skuteczność filmu w konkretnym momencie filmu. Miejsce w filmie jest wskazane w wymiarze elapsedVideoTimeRatio.

Wartość 0 oznacza, że film utrzymuje uwagę widzów gorzej niż jakikolwiek inny film o podobnej długości, a wartość 1 wskazuje, że film utrzymuje uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Mediana wartości 0.5 wskazuje, że połowa filmów o podobnej długości 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 oglądających 10-minutowe filmy nadal ogląda je po 3 minutach, a 70% po 8 minutach. W przypadku konkretnego, 10-minutowego filmu tylko 80% widzów nadal ogląda go po 3 minutach, ale wszyscy widzowie nadal oglądają go po 8 minutach.
  • W przypadku wartości elapsedVideoTimeRatio, która odpowiada momentowi, który rozpoczyna się w 3 minutach filmu, dane relativeRetentionPerformance miałyby wartość mniejszą niż 0.5, ponieważ w tym czasie film osiągałby gorsze wyniki niż przeciętny film.
  • Przy wartości elapsedVideoTimeRatio odpowiadającej punktowi, który zaczyna się 8 minut filmu, dane relativeRetentionPerformance miałyby wartość wyższą niż 0.5, ponieważ w tym czasie film osiąga lepsze wyniki niż inne filmy o podobnej długości.

Dane o szacunkowych przychodach

Uwaga: szacunkowe dane o przychodach podlegają korektom na koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów. Odwiedź Centrum pomocy YouTube, aby uzyskać dodatkowe informacje oraz uwagi na temat szacunkowych danych o przychodach.

Domyślnie wszystkie szacunkowe przychody są podawane w dolarach amerykańskich. Interfejs YouTube Analytics API obsługuje jednak parametr currency w przypadku niektórych szacunkowych danych o przychodach i skuteczności reklam, dzięki czemu możesz pobierać dane o szacunkowych 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ż reklamy w wybranym zakresie dat i regionie. This is a core metric and is subject to the Deprecation Policy.

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

Szacunkowe dane o 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 z subskrypcji YouTube Premium (wcześniej YouTube Red) uzyskane w przypadku wybranych wymiarów raportu. Wartość ta odzwierciedla przychody z muzyki oraz treści niemuzycznych i podlega korekcie na koniec miesiąca.

Dane dotyczące skuteczności reklamy

grossRevenue
Szacunkowe przychody brutto ze wszystkich reklam sprzedawanych przez Google lub partnerów DoubleClick w wybranym przedziale czasowym i regionie. Wartość przychodów brutto nie uwzględnia reklam wyświetlanych przez partnerów i podlega korekcie na koniec miesiąca. Przychodów brutto nie należy mylić z szacunkowymi przychodami ani przychodami netto, które mają wpływ na Twój udział we własności i umowy dotyczące dzielenia się przychodami.
cpm (wcześniej impressionBasedCpm)
Szacowane przychody brutto na tysiąc wyświetleń reklam.
adImpressions (wcześniej impressions)
Liczba zweryfikowanych wyświetleń reklam.
monetizedPlaybacks
Liczba przypadków, gdy widz odtworzył Twój film i zobaczył co najmniej 1 wyświetlenie reklamy. Odtworzenie generuje przychody, jeśli widz zobaczy reklamę przed filmem, ale przerwie oglądanie przed rozpoczęciem filmu. Przewidywany szacowany błąd dla tej liczby wynosi ±2,0%.
playbackBasedCpm
Szacowane przychody brutto na tysiąc odtworzeń.