Metrics

Ten dokument określa wskaźniki pobierane przez interfejs YouTube Reporting API. Ten interfejs API pobiera raporty dotyczące danych zbiorczych, które zawierają dane z YouTube Analytics 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 dotyczące aktywności użytkowników obejmują liczbę wyświetleń filmów i oceny (oceny pozytywne i negatywne).

Podstawowe dane

Chociaż interfejs YouTube Reporting API podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, dane inne niż podstawowe (a nie podstawowe wymiary) nie podlegają tym zasadom. W definicjach na tej stronie wyraźnie określa się wszystkie dane, które są podstawowymi danymi.

Lista poniżej zawiera podstawowe wskaźniki interfejsu API. Wszystkie te dane, które są również używane w interfejsie YouTube Analytics API, również stanowią podstawowe dane w tym interfejsie.

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

Wyświetl dane

obejrzenia (dane podstawowe)
Liczba wyświetleń filmu. Dane dotyczące playlisty wskazują, ile razy film został wyświetlony w kontekście playlisty. Centrum pomocy YouTube zawiera dodatkowe informacje na temat sposobu zgłaszania wyświetleń. This is a core metric and is subject to the Deprecation Policy.
czerwone_wyświetlenia
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 (dane podstawowe)
Liczba minut, jaką użytkownicy poświęcili na oglądanie filmów 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.
czerwony_czas_oglądania_min
Liczba minut, przez które subskrybenci YouTube Premium (dawniej YouTube Red) oglądali film.
average_view_duration_seconds (podstawowe dane)
Średnia długość (w sekundach) odtwarzania filmu. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu związanego z pętlami klipów. Dane w raporcie playlisty wskazują średnią długość odtwarzania filmu w kontekście (w sekundach). This is a core metric and is subject to the Deprecation Policy.
średni_odsłony_odsetka_wyświetleń
Średni procent filmu obejrzany podczas odtwarzania. Od 13 grudnia 2021 r. te dane nie uwzględniają ruchu związanego z pętlami klipów.

Dane o zaangażowaniu

komentarze (dane podstawowe)
Liczba wyświetleń filmu przez użytkowników. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
polubienia (dane podstawowe)
Liczba razy, gdy użytkownicy zaznaczyli, że film im się podobał, przyznając mu pozytywną ocenę. This is a core metric and is subject to the Deprecation Policy.
nie podoba mi się (dane podstawowe)
Liczba wskazująca na to, że film nie podobał się użytkownikowi, przyznając mu negatywną ocenę. This is a core metric and is subject to the Deprecation Policy.
udostępnienia (podstawowe dane)
Liczba wyświetleń 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 użytkowników, którzy zasubskrybowali kanał. This is a core metric and is subject to the Deprecation Policy.

Kanały mogą zdobywać lub tracić subskrybentów w kilku miejscach, takich jak strona odtwarzania filmu, strona kanału oraz przewodnik widoczny na stronie głównej YouTube. Podstawowy raport aktywności użytkownika zawiera liczbę nowych subskrybentów, którzy nie zasubskrybowali strony odtwarzania filmu. Zawiera on wiersz, który nie określa wartości wymiaru video_id. Wskazuje on też wartość danych subscribersLost, ale nie określa innych wartości.
subscribers_lost (dane podstawowe)
Liczba użytkowników, którzy anulowali subskrypcję kanału. This is a core metric and is subject to the Deprecation Policy.

Te dane są raportowane podobnie do danych subscribers_gained. Aby określić liczbę użytkowników, którzy anulowali subskrypcję, ale nie anulowali jej na stronie odtwarzania filmu, podstawowy raport aktywności użytkownika zawiera wiersz bez wartości wymiaru video_id. Wskazuje on też wartość danych subscribers_gained, ale nie określa innych wartości.
Filmy_dodane_do_playlisty
Liczba wyświetleń filmów, które zostały dodane do playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist na innych kanałach.

Wartość ta wskazuje, ile razy filmy zostały dodane do playlist domyślnych, takich jak „Do obejrzenia”. Nie uwzględnia to jednak playlist, do których automatycznie dodano film, takich jak playlisty przesłane na kanał 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 ponownie doda, wartość danych odzwierciedla film dodany do playlisty 2 razy. Nie są dostępne dane sprzed 1 października 2014 r.
Filmy_usunięte_z_playlist
Liczba wyświetleń filmów, które zostały usunięte z playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist na innych kanałach.

Wartość ta określa, ile razy filmy zostały usunięte z playlist domyślnych (takich jak playlista „Do obejrzenia”).

Te dane podają liczbę bezwzględną, co oznacza, że jeśli użytkownik doda film do playlisty, usunie go ponownie, a następnie usunie, ponownie przyjmie wartość. Nie są dostępne dane sprzed 1 października 2014 r.

Dane dotyczące playlist

start_playlist
Liczba przypadków, gdy widzowie zainicjowali odtwarzanie playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.
playlist_saves_added (obsługiwany tylko w interfejsie API do raportowania YouTube)
Liczba przypadków, gdy użytkownicy zapisali playlistę. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Te dane zwracają wartość bezwzględną, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych i zapisze ponownie, wartość danych odzwierciedla 2 dodane playlisty.
playlist_saves_removed (obsługiwane tylko przez interfejs YouTube Reporting API)
Liczba przypadków, gdy użytkownicy usunęli playlistę z listy zapisanych playlist. Te dane zwracają wartość bezwzględną, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist, ponownie zapisze i usunie, wartość wskaźnika odzwierciedla 2 usunięte playlisty.

Dane adnotacji

adnotacja_wyświetlenia
Łączna liczba wyświetleń adnotacji.
adnotacja_klikalne_wyświetlenia
Liczba adnotacji, które mogły zostać kliknięte.
adnotacja_kliknięcia
Liczba klikniętych adnotacji.
annotation_click_through_rate (dane podstawowe)
Stosunek adnotacji, które widzowie klikali, do łącznej liczby wyświetleń adnotacji, które można 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.
adnotacja_zamknięcia_wyświetleń
Liczba wyświetlanych adnotacji, które mogły zostać zamknięte.
zamknięcie_adnotacji
Liczba adnotacji do filmu.
annotation_close_rate (dane podstawowe)
Współczynnik adnotacji, które widzowie zamknęli, do łącznej liczby wyświetleń adnotacji. This is a core metric and is subject to the Deprecation Policy.

Dane karty

Szczegółowe informacje o dodawaniu kart do filmów i w raporcie Karty w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

card_impressions
Liczba wyświetleń kart. Gdy panel jest otwarty, wyświetlenie jest rejestrowane dla każdej karty filmu.
card_clicks,
Liczba kliknięć karty.
współczynnik_kliknięcia_karty
Współczynnik klikalności kart, obliczany jako stosunek liczby kliknięć karty do liczby jej wyświetleń.
karty_zwiastuna_wyświetleń
Liczba wyświetleń zwiastunów karty Obejrzenie filmu może wygenerować wiele wyświetleń zwiastuna.
karty_zwiastuna_kliknięć
Liczba kliknięć zwiastunów karty Kliknięcia ikony karty są przypisywane do zwiastuna wyświetlanego ostatnio użytkownikowi.
współczynnik_klikalności_karty
Współczynnik klikalności zajawki karty, obliczany jako stosunek liczby kliknięć zajawki karty do łącznej liczby wyświetleń zajawek kart.

Dane na ekranie końcowym

Ekrany końcowe to elementy, które pojawiają się w ciągu ostatnich 5–20 sekund filmu, promując Twoje treści, kanał i strony internetowe. Szczegółowe informacje o dodawaniu ekranów końcowych do filmów i w raporcie dotyczącym ekranów końcowych w YouTube Analytics znajdziesz w Centrum pomocy YouTube.

Uwaga: w przypadku danych na ekranie końcowym dostępne są dane od 1 maja 2016 r.

ekran_elementu_końcowego
Liczba wyświetlonych elementów na ekranie końcowym. Dla każdego wyświetlanego elementu końcowego ekranu jest rejestrowane 1 wyświetlenie.
end_screen_element_clicks
Liczba kliknięć elementów na ekranie końcowym.
współczynnik_kliknięć_ekranu_końcowego
Współczynnik klikalności elementów na ekranie końcowym, czyli stosunek liczby kliknięć elementów na ekranie do liczby wyświetleń elementu na ekranie końcowym.

dane dotyczące utrzymania uwagi odbiorców,

protokół_retencji_odbiorców
Bezwzględna liczba widzów oglądających dany film w danym momencie. Współczynnik ten jest obliczany poprzez porównanie liczby obejrzeń części filmu z łączną liczbą wyświetleń. Wymiar elapsed_video_time_percentage określa, do której części filmu pasuje dane.

Pamiętaj, że dany fragment filmu można obejrzeć więcej niż raz (lub nie wyświetli się wcale) w danym wyświetleniu filmu. Jeśli np. użytkownicy wielokrotnie przewijają film i oglądają ten sam fragment filmu, współczynnik bezwzględny dla tej części filmu może być większy niż 1.

Poniżej przedstawiamy przykłady obliczania wartości:
  • jednominutowy film jest oglądany 100 razy. Połowa widzów kończy oglądanie po 15 sekundach, a pozostałe oglądają cały film. Żaden z widzów nie ogląda więcej niż jednego fragmentu filmu więcej niż raz. W tym przypadku w poszczególnych segmentach filmu wartość tego wskaźnika wynosiła 1, a w przypadku pozostałej wartości wynosiła 0.50.
  • jednominutowy film jest oglądany 100 razy. Wszyscy widzowie oglądają cały film, ale 20 z nich ogląda go do 45 sekund, po czym wraca do 30-sekundowego fragmentu, a następnie do końca. W tym przypadku wartością w segmentach czasu w pierwszej lub ostatniej kwarty filmu będzie 1. Będzie to jednak wartość 1.2 dla przedziałów czasowych w 3 kwartale filmu, ponieważ 100% widzów obejrzało dany segment, ale 20% widzów obejrzało go 2 razy.

Dane o szacunkowych przychodach

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

Interfejs YouTube Reporting API podaje wszystkie szacunkowe przychody i kwoty w dolarach amerykańskich.
szacowane_przychody_partnera (dane podstawowe)
Całkowite szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google, a także ze źródeł innych niż reklamowe w wybranym zakresie dat i regionie.
szacowane_przychody_partnera_reklam
Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google w wybranym zakresie dat i regionie.

Szacunkowe dane o przychodach podlegają korektom dokonywanym na koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów.
estimated_partner_ad_auction_revenue (obsługiwany tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) uzyskane ze sprzedaży reklam na aukcjach w AdSense w wybranym zakresie dat i regionie Ten wskaźnik miał wcześniej nazwę estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (funkcja obsługiwana tylko przez interfejs 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 (tylko obsługiwane w YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z rezerwowanych reklam sprzedawanych przez DoubleClick (DCLK) oraz z innych źródeł sprzedaży w YouTube. Ten wskaźnik miał wcześniej nazwę estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (obsługiwany tylko w interfejsie API do raportowania w YouTube)
Łączne szacunkowe zarobki (przychody netto) z rezerwowanych reklam sprzedawanych przez DoubleClick (DCLK) oraz innych źródeł sprzedaży w YouTube.
estimated_partner_red_revenue (obsługiwany tylko w interfejsie YouTube Reporting API)
Łączne szacunkowe zarobki (przychody netto) z subskrypcji YouTube Premium (wcześniej YouTube Red).
estimated_partner_transaction_revenue (obsługiwany 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 naliczone przez partnera.

Dane skuteczności reklam

szacowane_youtube_ad_przychody
Szacunkowe przychody brutto (USD) ze wszystkich reklam sprzedawanych przez Google lub sprzedawanych przez partnerów 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. Przychodów brutto nie należy mylić z szacunkowymi przychodami lub przychodem netto, które są uwzględniane przy podziale własności i w przypadku umów dotyczących dzielenia się przychodami.
szacunkowy_cpm
Szacowany przychód brutto na tysiąc wyświetleń reklamy.
ad_impressions
Liczba zweryfikowanych wyświetleń reklamy.
Szacowane_odtworzenia_szacunkowe
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 przestanie ją oglądać przed rozpoczęciem filmu. Szacowany błąd dla tej liczby wynosi ±2%.
estimated_playback_based_cpm,
Szacunkowe przychody brutto na tysiąc odtworzeń.