Metrics

Ten dokument określa 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 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 kliknięcia przycisku „To mi się nie podoba”).

Dane podstawowe

Interfejs YouTube Reporting API podlega zasadom wycofywania (funkcji lub usług) zdefiniowanym w Warunkach korzystania z usługi, ale dane inne niż podstawowe (i wymiary inne niż podstawowe) nie podlegają tym zasadom. W definicjach na tej stronie wszystkie podstawowe dane są wyraźnie oznaczone jako takie.

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

Więcej informacji znajdziesz na liście interfejsów API YouTube objętych zasadami wycofywania.

Wyświetl dane

engaged_views (podstawowe dane)
Liczba wyświetleń filmów na kanale dłuższych niż kilka pierwszych sekund.
wyświetlenia (podstawowy wskaźnik)
Liczba wyświetleń filmu. W raporcie dotyczącym playlisty ten rodzaj danych wskazuje liczbę wyświetleń filmu 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 (usługi znanej wcześniej jako 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 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. Oblicza się ją, dzieląc liczbę kliknięć przez liczbę wyświetleń.

Dane o czasie oglądania

watch_time_minutes (podstawowy wskaźnik)
Liczba minut, przez które użytkownicy oglądali filmy na określonym kanale, należące do określonego właściciela treści, lub filmy z określonej 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ń filmu w sekundach. Od 13 grudnia 2021 r. te dane nie obejmują ruchu z zapętlonych klipów. W raporcie dotyczącym playlisty ten rodzaj danych wskazuje ś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 obejmują ruchu z zapętlonych klipów.

Wskaźniki zaangażowania

komentarze (podstawowe dane)
Liczba komentarzy 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.
polubienia (podstawowy wskaźnik)
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.
głosy na nie (podstawowy wskaźnik)
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 (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 (podstawowy wskaźnik)
Liczba subskrypcji kanału przez użytkowników. This is a core metric and is subject to the Deprecation Policy.

Subskrybentów można zdobywać i tracić 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 określono też wartość danych subscribersLost, ale nie określono wartości innych danych.
subscribers_lost (podstawowy wskaźnik)
Liczba przypadków, gdy użytkownicy anulowali subskrypcję kanału. This is a core metric and is subject to the Deprecation Policy.

 Dane tego typu są raportowane podobnie jak dane subscribers_gained. Aby określić liczbę użytkowników, którzy zrezygnowali z subskrypcji, ale nie zrobili tego na stronie odtwarzania filmu, podstawowy raport aktywności użytkownika zawiera wiersz, w którym nie określono wartości wymiaru video_id. W tym wierszu określono też wartość danych subscribers_gained, ale nie określono wartości innych danych.
videos_added_to_playlists
Liczba przypadków dodania filmów do dowolnych playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.

Wartość tego wskaźnika obejmuje liczbę dodanych filmów do domyślnych playlist, takich jak „Do obejrzenia”. Nie uwzględnia jednak playlist, do których film jest dodawany automatycznie, np. playlisty z przesłanymi filmami na kanale lub historii oglądania użytkownika.

Ta wartość zwraca liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go, a następnie doda ponownie, wartość odzwierciedla dwukrotne dodanie filmu do playlisty. Dane tego typu nie są dostępne w przypadku dat sprzed 1 października 2014 r.
videos_removed_from_playlists
Liczba usunięć filmów z dowolnych 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 i znowu usunie, wartość danych będzie odzwierciedlać dwukrotne usunięcie filmu z playlisty. Dane tego typu nie są dostępne w przypadku dat sprzed 1 października 2014 r.

Dane dotyczące playlist

Raporty dotyczące playlist zawierają 2 rodzaje danych, które pokazują, 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ą 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. 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 Wyświetlanie danych i Dane dotyczące czasu oglądania w tym dokumencie.

  • Dane dotyczące playlisty odzwierciedlają aktywność użytkownika i zaangażowanie w kontekście strony playlisty. Dane te 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ść z tych danych dotyczy playlist. Pozostałe dane na liście, takie jak playlistSaves, dotyczą interakcji użytkowników z samą playlistą, a nie z filmami na niej. Dlatego nie można ich zakwalifikować ani jako zagregowanych danych o filmie, ani jako danych dotyczących playlisty.

playlist_starts
Liczba rozpoczętych przez widzów odtworzeń playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.
playlist_saves_added (obsługiwane tylko w interfejsie API YouTube do raportowania)
Liczba zapisanych przez użytkowników playlist. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Ten rodzaj danych zwraca liczbę bezwzględną, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist i zapisze ponownie, wartość tego rodzaju danych będzie odzwierciedlać dodanie 2 zapisanych playlist.
playlist_saves_removed (obsługiwane tylko w interfejsie API YouTube do raportowania)
Liczba przypadków, w których 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 i ponownie usunie, wartość danych będzie odzwierciedlać 2 usunięte zapisania playlisty.

Dane adnotacji

annotation_impressions
Łączna liczba wyświetleń adnotacji.
annotation_clickable_impressions
Liczba adnotacji, które się wyświetliły i mogły zostać kliknięte.
annotation_clicks
Liczba klikniętych adnotacji.
annotation_click_through_rate (podstawowy wskaźnik)
Stosunek klikniętych adnotacji 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 korzystaniu z 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 (podstawowy wskaźnik)
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 i raportu o kartach w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

card_impressions
Liczba wyświetleń kart. Gdy panel karty zostanie otwarty, 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. Obejrzenie filmu może wygenerować wiele wyświetleń zwiastuna.
card_teaser_clicks
Liczba kliknięć zajawki 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 kart, który jest obliczany jako stosunek liczby kliknięć zwiastunów kart do łącznej liczby wyświetleń zwiastunów kart.

Dane ekranu końcowego

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 oraz stron internetowych. Więcej szczegółowych instrukcji dotyczących dodawania ekranów końcowych do filmów oraz raportu Statystyk YouTube dotyczącego ekranów końcowych znajdziesz w Centrum pomocy YouTube.

end_screen_element_impressions
Liczba wyświetlonych elementów na ekranie końcowym. Wyświetlenie jest rejestrowane dla każdego wyświetlonego elementu na ekranie końcowym.
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ęć elementów na ekranie końcowym do wyświetleń elementów na ekranie końcowym.

Dane o anulowaniu wspierania

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

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. Więcej informacji i uwag na temat szacunkowych danych o przychodach znajdziesz w Centrum pomocy YouTube.

Interfejs API YouTube do raportowania podaje wszystkie szacunkowe dane o przychodach i zarobkach w USD.
estimated_partner_revenue (podstawowy wskaźnik)
Łą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ą 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 API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z reklam sprzedanych na aukcji za pomocą AdSense w wybranym 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 API YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z reklam sprzedawanych w postaci rezerwacji za pomocą DoubleClick (DCLK) i 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 YouTube do raportowania)
Łączne szacunkowe zarobki (przychody netto) z subskrypcji YouTube Premium (usługi znanej wcześniej jako YouTube Red).
estimated_partner_transaction_revenue (obsługiwane tylko w interfejsie API YouTube do raportowania)
Łączne szacunkowe przychody 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 dotyczące skuteczności reklamy

estimated_youtube_ad_revenue
Szacunkowe przychody brutto w USD ze wszystkich reklam sprzedanych 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. Nie należy mylić przychodów brutto z przychodami szacunkowymi ani przychodami netto, które uwzględniają Twój udział we własności i umowy o podziale przychodów.
estimated_cpm
Szacunkowy przychód brutto z tysiąca wyświetleń reklamy.
ad_impressions
Liczba zrealizowanych wyświetleń zweryfikowanych reklam.
estimated_monetized_playbacks
Liczba przypadków, w których widz odtworzył Twój film i wyświetlono co najmniej jedno wyświetlenie reklamy. 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 tej wartości wynosi ±2,0%.
estimated_playback_based_cpm
Szacunkowe przychody brutto na tysiąc odtworzeń.