Ten dokument zawiera definicje danych, które można pobrać za pomocą interfejsu YouTube Analytics API. Ten interfejs API obsługuje zapytania w czasie rzeczywistym, co umożliwia generowanie raportów niestandardowych Statystyk YouTube.
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
Chociaż interfejs YouTube Analytics API podlega zasadom wycofywania funkcji lub usług określonym w Warunkach korzystania z usługi, to zasady te nie dotyczą danych i wymiarów, które nie są podstawowe. 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.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
Więcej informacji znajdziesz na liście interfejsów API YouTube, które podlegają zasadom wycofywania.
Wyświetl dane
- engagedViews (podstawowe dane)
- Liczba wyświetleń filmów na kanale po pierwszej klatce lub kliknięciu/dotknięciu przez użytkownika, aby odtworzyć.
- wyświetlenia (podstawowe dane),
- Te dane reprezentują różne liczby w różnych typach raportów. 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.
- playlistViews
- Te dane są zdefiniowane w sekcji Dane playlisty.
- redViews
- Liczba wyświetleń filmu przez subskrybentów YouTube Premium (usługa znana wcześniej jako YouTube Red).
- viewerPercentage (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
- estimatedMinutesWatched (podstawowe dane)
- 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.
- estimatedRedMinutesWatched
- Liczba minut, przez które subskrybenci YouTube Premium (usługa znana wcześniej jako YouTube Red) oglądali film.
- averageViewDuration (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.
- averageViewPercentage
- Ś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. - subscribersGained (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. W raportach dotyczących kanału te dane obejmują subskrybentów pozyskanych z dowolnego z tych miejsc. Jednak w raportach, które używają wymiaruvideolub parametrufilter, aby ograniczyć odpowiedź tylko do danych dotyczących konkretnego filmu, danesubscribersGainedbędą zawierać tylko statystyki ze strony odtwarzania określonego filmu. - subscribersLost (podstawowe dane)
- 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źnikasubscribersGained. W raportach dotyczących kanału te dane obejmują subskrybentów utraconych w wyniku dowolnego mechanizmu, za pomocą którego użytkownicy mogą anulować subskrypcję kanału. Jednak w raportach, które używają wymiaruvideolub parametrufilter, aby ograniczyć odpowiedź do danych dotyczących konkretnego filmu, te dane obejmują tylko użytkowników, którzy anulowali subskrypcję na stronie odtwarzania danego filmu. - videosAddedToPlaylists
- 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. - videosRemovedFromPlaylists
- 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.
- averageTimeInPlaylist
- Szacowany średni czas (w minutach) oglądania filmów z playlisty przez użytkownika po rozpoczęciu odtwarzania playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist, które miały miejsce w internecie.
- playlistAverageViewDuration
- Szacowany średni czas oglądania w sekundach na wyświetlenie playlisty. Pamiętaj, że te dane reprezentują średni czas wyświetlania poszczególnych filmów na playliście. Z kolei dane
averageTimeInPlaylistreprezentują średni czas, jaki każdy widz spędza na oglądaniu playlisty jako całości. Te dane obejmują informacje o filmach na playliście, które należą do innych kanałów. - playlistEstimatedMinutesWatched
- Liczba minut, przez które użytkownicy oglądali treści z playlisty w ramach playlisty. Czas oglądania, który miał miejsce w innych kontekstach, np. czas oglądania z wyświetleń, które miały miejsce, gdy widzowie oglądali ten sam film w ramach innych playlist, nie jest liczony. Te dane obejmują informacje o filmach z playlisty, które należą do innych kanałów.
- playlistSaves
- Liczba zapisów playlisty przez użytkowników. Więcej informacji o zapisanych playlistach znajdziesz w Centrum pomocy YouTube. Te dane zwracają liczbę zmian netto, co oznacza, że jeśli użytkownik zapisze playlistę, usunie ją z listy zapisanych playlist i zapisze ją ponownie, wartość danych będzie odzwierciedlać dodanie 1 zapisu playlisty.
- playlistStarts
- 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.
- playlistViews
- Liczba wyświetleń filmów z playlisty w kontekście tej playlisty.
Te dane obejmują informacje o filmach na playliście, które należą do innych kanałów.
- viewsPerPlaylistStart
- Średnia liczba wyświetleń filmu po rozpoczęciu odtwarzania playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlisty, które miały miejsce w internecie.
Dane adnotacji
Uwaga: raporty interfejsu YouTube Analytics API zwracają dane dotyczące danych annotationClickThroughRate i annotationCloseRate tylko od 10 czerwca 2012 r. Dodatkowo raporty YouTube Analytics API zwracają dane dotyczące pozostałych danych adnotacji tylko od 16 lipca 2013 r.
- annotationImpressions
- Łączna liczba wyświetleń adnotacji.
- annotationClickableImpressions
- Liczba adnotacji, które się pojawiły i które można było kliknąć.
- annotationClicks
- Liczba klikniętych adnotacji.
- annotationClickThroughRate (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.
- annotationClosableImpressions
- Liczba adnotacji, które się pojawiły i mogły zostać zamknięte.
- annotationCloses
- Liczba zamkniętych adnotacji.
- annotationCloseRate (podstawowe 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.
- cardImpressions
- Liczba wyświetleń kart. Gdy panel kart jest otwarty, wyświetlenie karty jest rejestrowane dla każdej karty filmu.
- cardClicks
- Liczba kliknięć kart.
- cardClickRate
- 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 transmisji na żywo (równocześni widzowie)
- averageConcurrentViewers
- Średnia liczba równoczesnych widzów danego filmu. Te dane uwzględniają współoglądających, gdy kilka osób ogląda treści razem na ekranie telewizora. Jeśli w raporcie określono wymiar livestreamPosition, wartość
averageConcurrentViewersokreśla średnią liczbę równoczesnych widzów w danym segmencie. - peakConcurrentViewers
- Najwyższa liczba równoczesnych widzów danego filmu. Te dane uwzględniają współoglądających, gdy kilka osób ogląda treści razem na ekranie telewizora. Jeśli w raporcie określono wymiar livestreamPosition, wartość
peakConcurrentViewersokreśla najwyższą liczbę widzów oglądających dany segment filmu jednocześnie.
dane dotyczące utrzymania uwagi odbiorców,
- audienceWatchRatio
- Bezwzględny odsetek widzów oglądających film w danym momencie. Współczynnik ten jest obliczany przez porównanie liczby wyświetleń danego fragmentu filmu z łączną liczbą wyświetleń filmu. Wymiar
elapsedVideoTimeRatiookreśla część filmu, której dotyczą dane.
Pamiętaj, że fragment filmu może zostać obejrzany więcej niż raz (lub wcale) podczas danego wyświetlenia filmu. Jeśli na przykład użytkownicy przewijają i oglądają tę samą część filmu kilka razy, współczynnik bezwzględny dla tej części filmu może być większy niż1.
Poniższe przykłady pokazują, jak obliczana jest wartość:- Film trwający minutę został obejrzany 100 razy. Połowa widzów przestaje oglądać po 15 sekundach, a reszta ogląda cały film. Żaden z widzów nie obejrzał żadnej części filmu więcej niż raz. W tym przypadku wartość tego wskaźnika wynosiłaby
1dla przedziałów czasowych w pierwszej ćwierci filmu i0.50dla pozostałej części filmu. - Film trwający minutę został obejrzany 100 razy. Wszyscy widzowie obejrzeli cały film, ale 20 z nich obejrzało go do 45 sekundy, po czym cofnęło się do 30 sekundy i obejrzało resztę filmu. W tym przypadku wartość danych wynosiłaby
1dla przedziałów czasowych w pierwszej połowie lub w ostatniej ćwiartce filmu. Jednak w przypadku przedziałów czasowych w 3 ćwiartce filmu wartość wynosiłaby1.2, ponieważ 100% widzów obejrzało ten segment filmu, ale 20% z nich obejrzało go dwukrotnie.
- Film trwający minutę został obejrzany 100 razy. Połowa widzów przestaje oglądać po 15 sekundach, a reszta ogląda cały film. Żaden z widzów nie obejrzał żadnej części filmu więcej niż raz. W tym przypadku wartość tego wskaźnika wynosiłaby
- relativeRetentionPerformance
- Wskaźnik, który pokazuje, jak dobrze film na YouTube utrzymuje uwagę widzów podczas odtwarzania w porównaniu ze wszystkimi filmami na YouTube o podobnej długości. Ten wskaźnik ma wartość od
0do1, która określa względną skuteczność utrzymania uwagi widzów w danym momencie filmu. Punkt w filmie jest podawany przez wymiarelapsedVideoTimeRatio.
Wartość0oznacza, że film utrzymuje uwagę widzów gorzej niż jakikolwiek inny film o podobnej długości, a wartość1wskazuje, że film utrzymuje uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Mediana wynosząca0.5oznacza, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa gorzej.
Poniższy hipotetyczny przykład pokazuje, jak wartości mogą wyglądać w raporcie. Średnio 90% widzów, którzy oglądają filmy trwające 10 minut, nadal ogląda je po 3 minutach, a 70% – po 8 minutach. Jednak w przypadku konkretnego 10-minutowego filmu po 3 minutach nadal ogląda go tylko 80% widzów, ale wszyscy ci widzowie oglądają go jeszcze po 8 minutach.- Wartość
elapsedVideoTimeRatioodpowiadająca punktowi, który znajduje się w 3 minucie filmu,relativeRetentionPerformancebędzie miała wartość poniżej0.5, ponieważ w tym momencie film osiąga gorsze wyniki niż przeciętny film. - Wartość
elapsedVideoTimeRatioodpowiadająca punktowi w 8 minucie filmu, danerelativeRetentionPerformancebędą miały wartość wyższą niż0.5, ponieważ w tym momencie film radzi sobie lepiej niż inne filmy o podobnej długości.
- Wartość
- startedWatching
- Liczba przypadków, w których dany segment filmu był pierwszym segmentem wyświetlonym podczas odtwarzania filmu.
Załóżmy na przykład, że film X trwa 5 minut. Na potrzeby tego raportu YouTube dzieli film na 100 segmentów po 3 sekundy, które są identyfikowane za pomocą wymiaru elapsedVideoTimeRatio. Widz odwiedza YouTube i ogląda pierwszą minutę i 10 sekund filmu, co obejmuje całość lub część pierwszych 24 segmentów filmu. Podczas kolejnej wizyty w YouTube widz ogląda resztę filmu, wznawiając odtwarzanie w segmencie 24 i kontynuując je do segmentu 100.
W tym przykładzie uzyskasz takie wartości danych dotyczących oglądania:- Wartość danych
startedWatchingwynosiłaby1dla segmentów 1 i 24, a dla wszystkich pozostałych segmentów –0. - Wartość danych
stoppedWatchingwynosiłaby1dla segmentów 24 i 100, a dla wszystkich pozostałych segmentów –0. - Wartość danych
totalSegmentImpressionswynosiłaby2dla segmentu 24 i1dla wszystkich pozostałych segmentów.
- Wartość danych
- stoppedWatching
- Liczba przypadków, w których dany segment filmu był ostatnim segmentem wyświetlonym podczas odtwarzania filmu. Przykład obliczania wartości tych danych znajdziesz w definicji danych
startedWatching. - totalSegmentImpressions
- Liczba wyświetleń danego segmentu filmu. Przykład obliczania wartości tych danych znajdziesz w definicji danych
startedWatching. Pamiętaj, że widz może obejrzeć ten sam segment filmu kilka razy podczas jednego odtworzenia.
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.
currency w przypadku niektórych danych dotyczących szacunkowych przychodów i wskaźników skuteczności reklam, co pozwala na pobieranie danych o szacunkowych przychodach w innych walutach.- estimatedRevenue (podstawowe dane) (wcześniej
earnings) - Łączne szacunkowe przychody netto ze wszystkich źródeł reklam sprzedawanych przez Google oraz ze źródeł innych niż reklamy w wybranym okresie i regionie.
This is a core metric and is subject to the Deprecation Policy.
Dane dotyczące szacunkowych przychodów podlegają korektom pod koniec miesiąca i nie obejmują reklam sprzedawanych ani wyświetlanych przez partnerów.
- estimatedAdRevenue (wcześniej
adEarnings) - Łą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. - estimatedRedPartnerRevenue (wcześniej
redPartnerRevenue) - Łączne szacunkowe przychody uzyskane z subskrypcji YouTube Premium (wcześniej YouTube Red) w przypadku wybranych wymiarów raportu. Wartość danych odzwierciedla przychody zarówno z treści muzycznych, jak i niemuzycznych i podlega korekcie na koniec miesiąca.
Wskaźniki skuteczności reklam
- grossRevenue
- 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.
- cpm (poprzednia nazwa:
impressionBasedCpm) - Szacowany przychód brutto na 1000 wyświetleń reklamy.
- adImpressions (wcześniej
impressions) - Liczba zweryfikowanych wyświetleń reklam.
- monetizedPlaybacks
- 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%.
- playbackBasedCpm
- Szacunkowe przychody brutto na 1000 odtworzeń.