Metrics

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

Dane to pojedyncze pomiary aktywności użytkownika, skuteczności reklam lub szacunkowych przychodów. Dane dotyczące aktywności użytkowników obejmują m.in. liczbę wyświetleń filmu i oceny (pozytywne i negatywne).

Dane podstawowe

Interfejs API do raportowania YouTube podlega zasadom wycofywania funkcji lub usług określonym w Warunkach korzystania z usługi, ale dane i wymiary spoza zestawu podstawowego nie podlegają tym zasadom. W definicjach na tej stronie wszystkie dane, które są danymi podstawowymi, są wyraźnie oznaczone jako takie.

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

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

Wyświetl dane

engaged_views (core metric)
Liczba wyświetleń filmów na kanale po pierwszej klatce lub kliknięciu/dotknięciu przez użytkownika, aby odtworzyć.
wyświetlenia (podstawowe dane),
Liczba wyświetleń filmu. W raporcie dotyczącym playlisty dane te wskazują, ile razy film został wyświetlony w kontekście playlisty. Te dane uwzględniają wspólne oglądanie, czyli sytuacje, gdy wiele osób ogląda treści razem na ekranie telewizora. Więcej informacji o tym, jak raportowane 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 (usługa znana wcześniej jako YouTube Red).
views_percentage (core metric)
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 widzom. 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 zakończyły się kliknięciem w celu obejrzenia filmu. Jest on obliczany jako liczba kliknięć podzielona przez liczbę wyświetleń.

Dane o czasie oglądania

watch_time_minutes (core metric)
Liczba minut, przez które użytkownicy oglądali filmy na określonym kanale, należące do danego właściciela treści, konkretny film lub playlistę. Te dane uwzględniają wspólne oglądanie, czyli sytuacje, gdy wiele osób ogląda treści razem na ekranie telewizora. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
Liczba minut, przez które subskrybenci YouTube Premium (usługa znana wcześniej jako YouTube Red) oglądali film.
average_view_duration_seconds (podstawowe dane)
Średnia długość odtworzeń filmu w sekundach. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu z zapętlonych klipów. W raporcie dotyczącym playlisty dane te wskazują ś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.
average_view_duration_percentage
Średni procent obejrzenia filmu podczas odtwarzania. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu z zapętlonych klipów.

Wskaźniki zaangażowania

comments (podstawowe dane)
Liczba komentarzy dodanych przez 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.
likes (podstawowe dane)
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 (core metric)
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 (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 subskrypcji kanału przez użytkowników. This is a core metric and is subject to the Deprecation Policy.

Kanały mogą zyskiwać lub tracić subskrybentów w kilku miejscach, m.in. na stronie odtwarzania 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 odtwarzania filmu, podstawowy raport aktywności użytkownika 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 (core metric)
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 dla tego wskaźnika są raportowane podobnie jak w przypadku wskaźnika 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, 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 przypadków dodania filmów do playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.

Wartość danych obejmuje liczbę przypadków, gdy 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 czy historia 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 odzwierciedlać dwukrotne dodanie filmu do playlisty. Dane dotyczące tego rodzaju danych nie są dostępne dla dat sprzed 1 października 2014 r.
videos_removed_from_playlists
Liczba usunięć filmów z 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, a następnie znów usunie, wartość danych będzie odzwierciedlać dwukrotne usunięcie filmu z playlisty. Dane dotyczące tego rodzaju danych nie są dostępne dla dat sprzed 1 października 2014 r.

Dane dotyczące playlist

Raporty dotyczące playlist zawierają 2 rodzaje danych, które pokazują, jak widzowie wchodzą w interakcje z filmami 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, które należą do kanału będącego 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 dane o wyświetleniach i dane o czasie oglądania w tym dokumencie.

  • Dane dotyczące playlisty odzwierciedlają aktywność użytkownika i zaangażowanie 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 liczone są tylko wyświetlenia, które miały miejsce w kontekście playlisty.

Większość poniższych danych to dane dotyczące playlisty. Pozostałe dane na liście, takie jak playlistSaves, dotyczą interakcji użytkowników z samą playlistą, a nie z filmami na playliście. Dlatego te dane nie są klasyfikowane jako zbiorcze dane dotyczące filmów ani dane dotyczące playlist.

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 YouTube Reporting API)
Liczba zapisów playlisty przez użytkowników. 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 zapisania playlisty.
playlist_saves_removed (obsługiwane tylko w interfejsie API do raportowania YouTube)
Liczba przypadków, kiedy 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 ponownie usunie, wartość danych będzie odzwierciedlać usunięcie 2 zapisanych playlist.

Dane adnotacji

annotation_impressions
Łączna liczba wyświetleń adnotacji.
annotation_clickable_impressions
Liczba adnotacji, które się pojawiły i które można było kliknąć.
annotation_clicks
Liczba klikniętych adnotacji.
annotation_click_through_rate (podstawowe dane)
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ę pojawiły i mogły zostać zamknięte.
annotation_closes
Liczba zamkniętych adnotacji.
annotation_close_rate (główne dane)
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 karty

W Centrum pomocy YouTube znajdziesz bardziej szczegółowe instrukcje dotyczące dodawania kart do filmów oraz raportu Karty w Statystykach YouTube.

card_impressions
Liczba wyświetleń kart. Gdy panel kart jest otwarty, wyświetlenie karty jest rejestrowane dla każdej karty filmu.
card_clicks
Liczba kliknięć kart.
card_click_rate
Współczynnik klikalności kart, który jest obliczany jako stosunek liczby kliknięć kart do liczby ich wyświetleń.
card_teaser_impressions
Liczba wyświetleń zwiastunów kart. Jedno wyświetlenie filmu może wygenerować wiele wyświetleń zwiastuna.
card_teaser_clicks
Liczba kliknięć zwiastunów kart. 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 kart, który jest obliczany jako stosunek liczby kliknięć zwiastunów kart do łącznej liczby wyświetleń zwiastunów kart.

Dane dotyczące ekranu końcowego

Ekrany końcowe to elementy, które wyświetlają się w ostatnich 5–20 sekundach filmu, aby promować Twoje treści, kanał i strony internetowe. W Centrum pomocy YouTube znajdziesz bardziej szczegółowe instrukcje dotyczące dodawania ekranów końcowych do filmów oraz raportu Statystyk YouTube na temat ekranów końcowych.

end_screen_element_impressions
Liczba wyświetlonych elementów na ekranie końcowym. Każdy wyświetlony element ekranu końcowego jest rejestrowany jako 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, który jest obliczany jako stosunek liczby kliknięć elementów na ekranie końcowym do liczby wyświetleń elementów na ekranie końcowym.

Dane o anulowaniu subskrypcji

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

Dane o szacunkowych przychodach

Uwaga: dane dotyczące szacunkowych przychodów podlegają korektom pod 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.

Interfejs API YouTube do raportowania podaje wszystkie szacunkowe przychody i zarobki w USD.
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 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 dotyczące szacunkowych przychodów 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 YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z reklam uczestniczących w aukcjach w AdSense w danym okresie i regionie. Te dane nosiły wcześniej nazwę estimated_partner_ad_sense_revenue.
estimated_partner_ad_reserved_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z rezerwowanych reklam sprzedawanych przez DoubleClick (DCLK) oraz innych źródeł sprzedaży w YouTube. Te dane nosiły wcześniej nazwę estimated_partner_double_click_revenue.
estimated_partner_red_revenue (obsługiwane tylko w interfejsie API do raportowania YouTube)
Łączne szacunkowe zarobki (przychody netto) z subskrypcji YouTube Premium (usługa znana wcześniej jako YouTube Red).
estimated_partner_transaction_revenue (obsługiwane tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe przychody z transakcji takich jak płatne treści i finansowanie przez fanów, po odjęciu wszelkich zwrotów naliczanych przez partnerów.

Wskaźniki skuteczności reklam

estimated_youtube_ad_revenue
Szacunkowe przychody brutto (w USD) ze wszystkich reklam sprzedanych przez Google lub partnera 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 szacunkowymi przychodami ani przychodami netto, które uwzględniają Twój udział we własności i umowy dotyczące dzielenia się przychodami.
estimated_cpm
Szacowany przychód brutto na 1000 wyświetleń reklamy.
ad_impressions
Liczba zweryfikowanych wyświetleń reklam.
estimated_monetized_playbacks
Liczba przypadków, w których widz odtworzył Twój film i zobaczył co najmniej 1 wyświetlenie reklamy. Odtworzenie generujące przychody jest liczone, gdy widz zobaczy reklamę przed filmem, ale zrezygnuje z oglądania, zanim film się rozpocznie. Oczekiwany szacowany błąd w przypadku tej wartości wynosi ±2,0%.
estimated_playback_based_cpm
Szacunkowe przychody brutto na 1000 odtworzeń.