Metrics

Ten dokument definiuje dane, które interfejs YouTube Reporting API pobiera. Ten interfejs API pobiera raporty zbiorcze zawierające dane ze Statystyk YouTube dotyczące kanału lub właściciela treści.

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

Chociaż interfejs API Raportowanie YouTube podlega polityce zastąpienia określonej w Warunkach korzystania z usługi, dane niebędące danymi podstawowymi (i niepodstawowe wymiary) nie są objęte tą polityką. W definicjach na tej stronie każdy wskaźnik podstawowy jest wyraźnie oznaczony jako taki.

Poniżej znajdziesz listę podstawowych danych interfejsu API. Wszystkie te dane, które są też używane w interfejsie YouTube Analytics API, są też podstawowymi danymi w tym interfejsie.

Aby uzyskać więcej informacji, zapoznaj się z listą interfejsów YouTube API objętych zasadami wycofywania.

Wyświetl dane

engaged_views (dane podstawowe)
Liczba obejrzeń filmu przez co najmniej 4 sekundy.
wyświetleń (dane podstawowe)
Liczba wyświetleń filmu. W raporcie dotyczącym playlisty dane te wskazują liczbę odtworzeń filmu w kontekście playlisty. Więcej informacji o tym, jak zgłaszane są wyświetlenia, znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
red_views
Liczba wyświetleń filmu przez subskrybentów YouTube Premium (dawniej YouTube Red).
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
Liczba minut, przez które subskrybenci YouTube Premium (dawniej YouTube Red) oglądali film.
average_view_duration_seconds (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.
average_view_duration_percentage
Ś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.
subscribers_gained (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. Aby określić liczbę nowych subskrybentów kanału, którzy nie zasubskrybowali go na stronie filmu, podstawowy raport o aktywności użytkowników zawiera wiersz, który nie określa wartości wymiaru video_id. Ten wiersz określa też wartość danych subscribersLost, ale nie określa wartości innych danych.
subscribers_lost (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źnika subscribers_gained. Aby określić liczbę użytkowników, którzy anulowali subskrypcję, ale nie anulowali jej na stronie odtwarzania filmu, podstawowy raport o aktywności użytkowników zawiera wiersz, który nie określa wartości wymiaru video_id. Ten wiersz określa też wartość danych subscribers_gained, ale nie określa wartości innych danych.
videos_added_to_playlists
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 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.
videos_removed_from_playlists
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.

playlist_starts
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.
playlist_saves_added (obsługiwane tylko w interfejsie API YouTube do raportowania)
Liczba razy, gdy użytkownicy zapisali playlistę. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Te dane zwracają liczbę bezwzględną, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist i zapisze ją ponownie, wartość danych będzie odzwierciedlać 2 zapisane playlisty.
playlist_saves_removed (obsługiwane tylko w interfejsie API YouTube do raportowania)
Liczba przypadków, gdy użytkownicy usunęli playlistę ze swoich list zapisanych playlist. Te dane zwracają liczbę bezwzględną, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist, ponownie ją zapisze, a potem usunie, wartość danych będzie odzwierciedlać 2 zapisane i usunięte playlisty.

Dane adnotacji

annotation_impressions
Łączna liczba wyświetleń adnotacji.
annotation_clickable_impressions
Liczba adnotacji, które się wyświetliły i można je było kliknąć.
annotation_clicks
Liczba kliknięć adnotacji.
annotation_click_through_rate (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.
annotation_closable_impressions
Liczba adnotacji, które się wyświetliły i które można było zamknąć.
annotation_closes
Liczba zamkniętych adnotacji.
annotation_close_rate (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 Statystyk YouTube dotyczącego kart.

card_impressions
Liczba wyświetleń kart. Gdy otworzysz panel karty, wyświetlenie karty zostanie zarejestrowane w przypadku każdej karty w filmie.
card_clicks
Liczba kliknięć kart.
card_click_rate
Współczynnik klikalności karty, który jest obliczany jako stosunek liczby kliknięć karty do liczby jej wyświetleń.
card_teaser_impressions
Liczba wyświetleń zwiastunów karty. Jedno obejrzenie filmu może generować wiele wyświetleń zwiastunów.
card_teaser_clicks
Liczba kliknięć zajawek kart. Kliknięcia ikony karty są przypisywane do ostatniego zwiastuna wyświetlonego użytkownikowi.
card_teaser_click_rate
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 ekranu końcowego

Ekrany końcowe to elementy wyświetlane w ostatnich 5–20 sekundach filmu, które służą do promowania Twoich treści, kanału i stron internetowych. Więcej szczegółowych instrukcji dotyczących dodawania ekranów końcowych do filmów oraz raportu Ekrany końcowe w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

Uwaga: dane dotyczące ekranu końcowego są dostępne od 1 maja 2016 r.

end_screen_element_impressions
Liczba wyświetlonych elementów na ekranie końcowym. Dla każdego wyświetlonego elementu na ekranie końcowym rejestrowane jest 1 wyświetlenie.
end_screen_element_clicks
Liczba kliknięć elementów na ekranie końcowym.
end_screen_element_click_rate
Współczynnik klikalności elementów na ekranie końcowym, który jest obliczany jako stosunek kliknięć elementu na ekranie końcowym do wyświetleń tego elementu.

dane dotyczące utrzymania uwagi odbiorców,

audience_retention_percentage
Bezwzględny odsetek 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 elapsed_video_time_percentage 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.

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ć więcej informacji o szacowanych przychodach, odwiedź Centrum pomocy YouTube.

Interfejs API YouTube do raportowania podaje wszystkie szacunkowe dane o przychodach i zarobkach w dolarach amerykańskich.
estimated_partner_revenue (dane podstawowe)
Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedanych przez Google oraz ze źródeł niereklamowych w wybranym zakresie dat i regionie.
estimated_partner_ad_revenue
Łą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.
estimated_partner_ad_auction_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z reklam sprzedanych w ramach aukcji w AdSense w wybranym okresie i regionie. Te dane miały wcześniej nazwę estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z reklam AdSense sprzedawanych na aukcji w wybranym zakresie dat i regionie.

estimated_partner_ad_reserved_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) uzyskane ze sprzedaży reklam z rezerwacją za pomocą DoubleClick (DCLK) i innych źródeł sprzedaży w YouTube. Te dane miały wcześniej nazwę estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Całkowite szacowane zarobki (przychody netto) z reklam sprzedanych w ramach rezerwacji przez DoubleClick (DCLK) i inne źródła sprzedaży reklam w YouTube.

estimated_partner_red_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z subskrypcji YouTube Premium (dawniej YouTube Red).
estimated_partner_transaction_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Łączna szacunkowa kwota przychodów z transakcji, takich jak płatne treści i finansowanie przez fanów, po odjęciu wszelkich zwrotów obciążających konto partnera.

Dane o skuteczności reklamy

estimated_youtube_ad_revenue
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.
estimated_cpm
Szacowany przychód brutto z tysiąca wyświetleń reklamy.
ad_impressions
Liczba zweryfikowanych wyświetleń reklam.
estimated_monetized_playbacks
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%.
estimated_playback_based_cpm
Szacowany przychód brutto na tysiąc odtworzeń.