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.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
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.
- 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ść danychsubscribersLost, 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źnikasubscribers_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ść danychsubscribers_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ń.
- Liczba wyświetleń zwiastunów kart. Jedno wyświetlenie filmu może wygenerować wiele wyświetleń zwiastuna.
- Liczba kliknięć zwiastunów kart. Kliknięcia ikony karty są przypisywane do zwiastuna, który został wyświetlony jako ostatni.
- 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.
- 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ń.