Metrics

W tym dokumencie opisujemy dane pobierane przez interfejs API YouTube do raportowania. Ten interfejs API pobiera zbiorcze raporty z danymi ze Statystyk YouTube dotyczącymi 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 brak polubień).

Podstawowe dane

Interfejs API YouTube do raportowania podlega zasadom wycofywania usług określonym w Warunkach korzystania z usługi, ale dane niepodstawowe (i wymiary niepodstawowe) nie podlegają tym zasadom. W definicjach na tej stronie wszystkie dane podstawowe są wyraźnie oznaczone.

Poniższa lista zawiera podstawowe dane interfejsu API. Wszystkie te dane, które są też używane w YouTube Analytics API, są również danymi podstawowymi w tym interfejsie API.

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

Dane o wyświetleniach

engaged_views (dane podstawowe)
Liczba przypadków, gdy użytkownik obejrzał film na kanale dłużej niż pierwszą klatkę lub kliknął/dotknął, aby odtworzyć film.
wyświetlenia (dane podstawowe)
Liczba wyświetleń filmu. W raporcie dotyczącym playlisty te dane wskazują, ile razy film został wyświetlony w kontekście playlisty. Więcej informacji o tym, jak są raportowane 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 (wcześniej 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 zasięgu

video_thumbnail_impressions
Liczba wyświetleń miniatur filmów. Aby wyświetlenie było ważne, miniatura musi wyświetlać się dłużej niż sekundę, a na ekranie widoczne musi być co najmniej 50% jej powierzchni. Więcej informacji znajdziesz w Centrum pomocy YouTube.
video_thumbnail_impressions_ctr
Odsetek wyświetleń, które doprowadziły do kliknięcia i obejrzenia filmu. Jest on obliczany jako liczba kliknięć podzielona przez liczbę wyświetleń.

Dane o czasie oglądania

watch_time_minutes (dane podstawowe)
Liczba minut, przez które użytkownicy oglądali filmy na określonym kanale, należące do właściciela treści, film lub playlistę. 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 (dane podstawowe)
Średnia długość odtworzenia filmu w sekundach. Od 13 grudnia 2021 r. te dane nie obejmują ruchu z klipów w pętli. W raporcie dotyczącym playlisty te dane wskazują średnią długość odtworzenia filmu w sekundach, które miało miejsce w kontekście playlisty. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
Średni odsetek obejrzenia filmu podczas odtwarzania. Od 13 grudnia 2021 r. te dane nie obejmują ruchu z klipów w pętli.

Wskaźniki zaangażowania

comments (dane podstawowe)
Liczba przypadków, gdy użytkownicy skomentowali film. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
likes (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.
dislikes (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.
shares (dane podstawowe)
Liczba przypadków, gdy użytkownicy udostępnili film 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 przypadków, gdy użytkownicy zasubskrybowali kanał. This is a core metric and is subject to the Deprecation Policy.

Subskrybentów można zyskać lub stracić 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. Aby określić liczbę nowych subskrybentów kanału, którzy nie zasubskrybowali go na stronie odtwarzania filmu, podstawowy raport aktywności użytkownika zawiera wiersz, w którym nie jest określona wartość wymiaru video_id. W tym wierszu jest też określona wartość danych subscribersLost, ale nie ma w nim wartości innych danych.
subscribers_lost (dane podstawowe)
Liczba przypadków, gdy użytkownicy anulowali subskrypcję kanału. This is a core metric and is subject to the Deprecation Policy.

Dane dla tego wskaźnika są raportowane podobnie jak wskaźnik subscribers_gained. Aby określić liczbę użytkowników, którzy anulowali subskrypcję, ale nie zrobili tego na stronie odtwarzania filmu, podstawowy raport aktywności użytkownika zawiera wiersz, w którym nie jest określona wartość wymiaru video_id. W tym wierszu jest też określona wartość danych subscribers_gained, ale nie ma w nim wartości innych danych.
videos_added_to_playlists
Liczba przypadków, gdy filmy zostały dodane do dowolnych playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.

Wartość tych danych obejmuje liczbę przypadków, gdy filmy zostały dodane do domyślnych playlist, takich jak „Do obejrzenia później”. Nie obejmuje ona jednak playlist, do których film jest dodawany automatycznie, np. playlisty z przesłanymi filmami na kanale lub historii oglądania użytkownika.

Te dane zwracają 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 wskazywać, że film został dodany do playlisty 2 razy. Dane te są dostępne tylko od 1 października 2014 r.
videos_removed_from_playlists
Liczba przypadków, gdy filmy zostały usunięte z dowolnych playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist innych kanałów.

Wartość tych danych obejmuje liczbę przypadków, gdy filmy zostały usunięte z domyślnych playlist, takich jak „Do obejrzenia później”.

Te dane zwracają liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go, doda ponownie, a następnie znowu usunie, wartość danych będzie wskazywać, że film został usunięty z playlisty 2 razy. Dane te są dostępne tylko od 1 października 2014 r.

Dane dotyczące playlist

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

  • Dane zbiorcze o filmach obejmują 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. Jeśli więc 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 danych zbiorczych o filmach znajdziesz w sekcjach Dane o wyświetleniach i Dane o czasie oglądania w tym dokumencie.

  • Dane dotyczące playlisty odzwierciedlają aktywność użytkowników i zaangażowanie w kontekście strony playlisty. Dane te obejmują wyświetlenia wszystkich filmów na playliście, 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 to dane dotyczące playlisty. Pozostałe dane na liście, takie jak dane playlistSaves, dotyczą interakcji użytkowników z samą playlistą, a nie z filmami na playliście. Dlatego nie można ich zakwalifikować jako danych zbiorczych o filmach ani danych dotyczących playlisty.

playlist_starts
Liczba rozpoczętych przez widzów odtworzeń playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlisty, które miały miejsce w internecie.
playlist_saves_added (obsługiwane tylko w interfejsie API YouTube do raportowania)
Liczba przypadków, 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 ponownie, wartość danych będzie wskazywać, że playlista została zapisana 2 razy.
playlist_saves_removed (obsługiwane tylko w interfejsie API YouTube do raportowania)
Liczba przypadków, gdy użytkownicy usunęli playlistę z listy zapisanych playlist. Te dane zwracają liczbę bezwzględną, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist, zapisze ponownie i znowu usunie, wartość danych będzie wskazywać, że playlista została usunięta 2 razy.

Dane dotyczące adnotacji

annotation_impressions
Łączna liczba wyświetleń adnotacji.
annotation_clickable_impressions
Liczba wyświetlonych adnotacji, które można było kliknąć.
annotation_clicks
Liczba kliknięć adnotacji.
annotation_click_through_rate (dane podstawowe)
Stosunek liczby kliknięć adnotacji przez widzów do łącznej liczby wyświetleń adnotacji, które można było kliknąć. 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 wyświetlonych adnotacji, które można było zamknąć.
annotation_closes
Liczba zamkniętych adnotacji.
annotation_close_rate (dane podstawowe)
Stosunek liczby zamkniętych adnotacji przez widzów do łącznej liczby wyświetleń adnotacji. This is a core metric and is subject to the Deprecation Policy.

Dane dotyczące kart

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

card_impressions
Liczba wyświetleń kart. Gdy otworzy się panel karty, wyświetlenie karty jest rejestrowane dla każdej karty w filmie.
card_clicks
Liczba kliknięć kart.
card_click_rate
Współczynnik klikalności kart, który jest obliczany jako stosunek liczby kliknięć karty do liczby jej wyświetleń.
card_teaser_impressions
Liczba wyświetleń zajawki karty. Wyświetlenie filmu może generować wiele wyświetleń zajawki.
card_teaser_clicks
Liczba kliknięć zajawki karty. Kliknięcia ikony karty są przypisywane do ostatniej zajawki wyświetlonej użytkownikowi.
card_teaser_click_rate
Współczynnik klikalności zajawki karty, który jest obliczany jako stosunek liczby kliknięć zajawki karty do łącznej liczby wyświetleń zajawki karty.

Dane dotyczące ekranów końcowych

Ekrany końcowe to elementy, które wyświetlają się w ostatnich 5–20 sekundach filmu i 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 i raportu Ekrany końcowe w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

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 liczby kliknięć elementu na ekranie końcowym do liczby jego wyświetleń.

Dane o anulowaniu subskrypcji

membershipsCancellationSurveyResponses
Liczba ankiet wypełnionych przez użytkowników YouTube, którzy anulowali subskrypcję kanału w określonym okresie raportowania.

Dane o szacunkowych przychodach

Uwaga: dane o szacunkowych przychodach podlegają korektom na koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów. Dodatkowe informacje i uwagi dotyczące szacunkowych przychodów znajdziesz w Centrum pomocy YouTube.

Interfejs API YouTube do raportowania podaje wszystkie szacunkowe przychody i zarobki w USD.
estimated_partner_revenue (dane podstawowe)
Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google oraz ze źródeł innych niż reklamowe w wybranym okresie i regionie.
estimated_partner_ad_revenue
Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google w wybranym okresie i regionie.

Dane o szacunkowych przychodach podlegają korektom 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 API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z reklam sprzedawanych na aukcji za pomocą AdSense w wybranym okresie i regionie. Te dane były wcześniej nazywane estimated_partner_ad_sense_revenue.
estimated_partner_ad_reserved_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z reklam sprzedawanych w rezerwacji za pomocą DoubleClick (DCLK) i innych źródeł sprzedaży w YouTube. Te dane były wcześniej nazywane estimated_partner_double_click_revenue.
estimated_partner_red_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z subskrypcji YouTube Premium (wcześniej YouTube Red).
estimated_partner_transaction_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe przychody z transakcji, takich jak treści płatne i wsparcie fanów, po odjęciu wszelkich zwrotów środków obciążających partnerów.

Dane dotyczące skuteczności reklamy

estimated_youtube_ad_revenue
Szacunkowe przychody brutto w USD ze wszystkich reklam sprzedawanych 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. Przychody brutto nie powinny być mylone z przychodami szacunkowymi ani przychodami netto, które uwzględniają Twój udział w przychodach i umowy o podziale przychodów.
estimated_cpm
Szacunkowe przychody brutto na tysiąc wyświetleń reklamy.
ad_impressions
Liczba zweryfikowanych wyświetleń reklamy.
estimated_monetized_playbacks
Liczba przypadków, gdy widz odtworzył Twój film i zobaczył 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 dla tej wartości wynosi ±2,0%.
estimated_playback_based_cpm
Szacunkowe przychody brutto na tysiąc odtworzeń.