Metrics

Definiuje on dane, które pobiera YouTube Reporting API. Pobiera on raporty z danymi zbiorczymi, które zawierają dane Statystyk YouTube dotyczące kanału lub właściciela treści.

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 Reporting 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. Wszystkie te dane, które są też używane w interfejsie YouTube Analytics API, są też podstawowymi danymi w tym interfejsie.

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

Wyświetl dane

obejrzenia (podstawowe dane)
Liczba wyświetleń filmu. W raporcie dotyczącym playlisty dane wskazują, ile razy film został wyświetlony w kontekście playlisty. Centrum pomocy YouTube zawiera dodatkowe informacje o sposobie raportowania wyświetleń. This is a core metric and is subject to the Deprecation Policy.
red_views
Liczba wyświetleń filmu przez subskrybentów YouTube Premium (wcześniej YouTube Red).
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
Liczba minut, przez które subskrybenci YouTube Premium (wcześniej YouTube Red) oglądali film.
average_view_duration_seconds (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.
average_view_duration_percentage
Ś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.
subscribers_gained (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. Aby określić liczbę nowych subskrybentów kanału, którzy nie zasubskrybowali kanału na stronie odtwarzania filmu, podstawowy raport aktywności użytkownika zawiera wiersz bez wartości wymiaru video_id. Wiersz ten zawiera też wartość danych subscribersLost, ale nie wartości dla innych danych.
subscribers_lost (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 subscribers_gained. Aby zidentyfikować liczbę użytkowników, którzy anulowali subskrypcję na stronie odtwarzania filmu, ale nie zrezygnowali z subskrypcji, podstawowy raport aktywności użytkownika zawiera wiersz bez wartości wymiaru video_id. Wiersz ten zawiera też wartość danych subscribers_gained, ale nie wartości dla 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 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.
videos_removed_from_playlists
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.

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.

playlist_starts
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.
playlist_saves_added (obsługiwany tylko przez interfejs YouTube Reporting API)
Liczba przypadków, w których 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 ponownie, wartość danych odzwierciedla 2 dodane zapisane playlisty.
playlist_saves_removed (obsługiwane tylko przez interfejs YouTube Reporting API)
Ile razy 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, zapisze ją ponownie i usunie ponownie, wartość danych odzwierciedla usunięte 2 zapisane 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 kliknąć.
annotation_clicks
Liczba klikniętych adnotacji.
annotation_click_through_rate (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.
annotation_closable_impressions
Liczba adnotacji, które się pojawiły i które można zamknąć.
annotation_closes
Liczba zamkniętych adnotacji.
annotation_close_rate (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.

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

Dane dotyczące ekranu końcowego

Ekrany końcowe to elementy wyświetlane przez ostatnie 5–20 sekund filmu, które promują Twoje treści, kanał i strony internetowe. W Centrum pomocy YouTube znajdziesz bardziej szczegółowe instrukcje dodawania ekranów końcowych do filmów oraz raport Ekrany końcowe w Statystykach YouTube.

Uwaga: dane dotyczące ekranów końcowych są dostępne od 1 maja 2016 r.

end_screen_element_impressions
Liczba wyświetlonych elementów na ekranie końcowym. Dla każdego elementu na ekranie końcowym rejestrowane jest jedno 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, czyli stosunek liczby kliknięć elementu na ekranie końcowym do liczby wyświetleń elementu na ekranie końcowym.

dane dotyczące utrzymania uwagi odbiorców,

audience_retention_percentage
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 elapsed_video_time_percentage 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.

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.

YouTube Reporting API podaje wszystkie szacunkowe przychody i zarobki w dolarach amerykańskich.
estimated_partner_revenue (podstawowe dane)
Łą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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z reklam sprzedawanych na aukcjach AdSense w wybranym przedziale czasowym i regionie. Wcześniej te dane miały nazwę estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z reklam AdSense sprzedawanych na aukcjach w wybranym zakresie dat i regionie.
estimated_partner_ad_reserved_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Całkowite szacunkowe zarobki (przychody netto) z rezerwowanych reklam sprzedawanych przez DoubleClick (DCLK) i innych źródeł sprzedaży w YouTube. Wcześniej te dane miały nazwę estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z rezerwowanych reklam sprzedawanych przez DoubleClick (DCLK) i inne źródła reklam w YouTube.
estimated_partner_red_revenue (obsługiwany tylko przez interfejs YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z subskrypcji YouTube Premium (wcześniej YouTube Red).
estimated_partner_transaction_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Całkowite szacunkowe przychody z transakcji takich jak płatne treści i finansowanie przez fanów, pomniejszone o zwroty środków obciążających konto partnera.

Dane dotyczące skuteczności reklamy

estimated_youtube_ad_revenue
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.
estimated_cpm
Szacowane przychody brutto na tysiąc wyświetleń reklam.
ad_impressions
Liczba zweryfikowanych wyświetleń reklam.
estimated_monetized_playbacks
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%.
estimated_playback_based_cpm
Szacowane przychody brutto na tysiąc odtworzeń.