Metrics

Ten dokument określa wskaźniki, które możesz pobrać za pomocą interfejsu YouTube Analytics API. Interfejs API obsługuje zapytania w czasie rzeczywistym, aby generować raporty YouTube Analytics.

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 Analytics API podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, dane inne niż podstawowe (czyli wymiary inne niż podstawowe) nie podlegają tej zasadzie. 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.

Uwaga: te podstawowe dane zostały całkowicie wycofane:
  • Podstawowe dane (earnings) zostały wycofane 4 sierpnia 2016 roku i zmieniły nazwę estimatedRevenue. Zgodnie z Zasadami wycofywania określonymi w Warunkach korzystania z usługi dane earnings i estimatedRevenue były równocześnie obsługiwane do 10 sierpnia 2017 r.
  • Podstawowe dane favoritesAdded i favoritesRemoved zostały wycofane 31 marca 2015 r. Dane te można pobrać tylko przez interfejs YouTube Analytics API.

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.
widoki czerwone
Liczba wyświetleń filmu przez subskrybentów YouTube Premium (wcześniej YouTube Red).
unikalni użytkownicy (wycofane 27 września 2016 r.)
Liczba unikalnych widzów, którzy obejrzeli film. Te obliczenia są obliczane na podstawie liczby unikalnych plików cookie, przez co uwzględniają użytkowników, którzy korzystają z wielu urządzeń lub przeglądarek.
Dane uniques zostały wycofane 27 września 2016 r. Nie są to dane podstawowe, które będą obsługiwane do 31 października 2016 r.
viewerPercentage (dane podstawowe)
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 (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.
Szacowany czas oglądania w ciągu minut
Liczba minut, przez które subskrybenci YouTube Premium (dawniej YouTube Red) oglądali film.
averageViewDuration (dane podstawowe)
Ś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.
averageViewPercentage,
Ś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.
subskrybenci pozyskani (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. W raportach o kanale dane te obejmują subskrybentów pozyskanych z dowolnego z tych miejsc. Jednak w przypadku raportów, które korzystają z wymiaru video lub parametru filter w celu ograniczenia odpowiedzi tylko do konkretnego filmu, dane subscribersGained będą uwzględniać tylko statystyki ze strony odtwarzania filmu.
subscribersLost (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 subscribersGained. W raportach o kanale dane te obejmują subskrybentów utraconych w wyniku dowolnego sposobu anulowania subskrypcji kanału. Jednak w raportach, które korzystają z wymiaru video lub parametru filter, aby uwzględnić w odpowiedzi tylko dane na temat konkretnego filmu, dane te będą obejmować tylko użytkowników, którzy anulowali subskrypcję filmu na stronie odtwarzania tego filmu.
videosAddToPlaylisty.
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.
videosRemovedFromPlaylisty
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.

Wycofane wskaźniki zaangażowania

Poniższe dane były podstawowymi danymi, które zostały wycofane 31 marca 2015 roku.

favoritesadded (dane podstawowe) (wycofane 31 marca 2015 r.)
Liczba przypadków, w których użytkownicy oznaczyli film jako ulubiony. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (podstawowe dane) (wycofane 31 marca 2015 r.)
Liczba wyświetleń filmu z ulubionych filmów przez użytkowników. Więcej informacji znajdziesz w Centrum pomocy YouTube. This is a core metric and is subject to the Deprecation Policy.

Dane dotyczące playlist

PlayStarty
Liczba przypadków, gdy widzowie zainicjowali odtwarzanie playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.
wyświetlenieNaPlayPlaylisty
Średnia liczba wyświetleń filmów za każdym razem, gdy playlista jest inicjowana. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.
średni czas_odtwarzania
Szacowany czas (w minutach) poświęcony na oglądanie filmów przez użytkowników po utworzeniu playlisty. Pamiętaj, że te dane obejmują tylko wyświetlenia playlist w internecie.

Dane adnotacji

Uwaga: od 10 czerwca 2012 r. raporty YouTube API API zawierają tylko dane dotyczące wskaźników annotationClickThroughRate i annotationCloseRate. Od 16 lipca 2013 r. raporty YouTube Analytics API zwracają tylko dane dotyczące pozostałych danych adnotacji.

adnotacjaWyświetlenia
Łączna liczba wyświetleń adnotacji.
adnotationClickableImpressions
Liczba adnotacji, które mogły zostać kliknięte.
adnotacjaClicks
Liczba klikniętych adnotacji.
adnotationClickthroughRate (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.
adnotacjaClosableImpressions
Liczba wyświetlanych adnotacji, które mogły zostać zamknięte.
adnotacjaZamknij
Liczba adnotacji do filmu.
annotationCloseRate (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.

wyświetlenia miniatur
Liczba wyświetleń kart. Gdy panel jest otwarty, wyświetlenie jest rejestrowane dla każdej karty filmu.
cardClicks
Liczba kliknięć karty.
współczynnik klikalności karty
Współczynnik klikalności kart, obliczany jako stosunek liczby kliknięć karty do liczby jej wyświetleń.
cardTeaserImpressions
Liczba wyświetleń zwiastunów karty Obejrzenie filmu może wygenerować wiele wyświetleń zwiastuna.
CardTeaserClicks,
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 dotyczące utrzymania uwagi odbiorców,

odbiorcyobejrzenia
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 elapsedVideoTimeRatio 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.
relativePrzechowywaniePerformance
Pomiar pokazujący, jak skutecznie film utrzymuje uwagę widzów podczas odtwarzania w porównaniu ze wszystkimi filmami o tej samej długości w YouTube. Wartość tego wskaźnika ma wartość od 0 do 1, która określa względną skuteczność przechowywania w danym momencie filmu. Punkt w filmie określa wymiar elapsedVideoTimeRatio.

Wartość 0 wskazuje, że film zatrzymuje widzów słabiej niż jakikolwiek inny film o podobnej długości, a wartość 1 oznacza, że film utrzymuje uwagę lepiej niż jakikolwiek inny film o podobnej długości. Mediana wartości 0.5 wskazuje, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa mniej.

Ten hipotetyczny przykład pokazuje, jak wartości mogą wyglądać w raporcie. Średnio 90% widzów, którzy oglądają 10-minutowe filmy, nadal ogląda je po 3 minutach, a 70% nadal ogląda po 8 minutach. Jednak w przypadku konkretnego 10-minutowego filmu tylko 80% widzów nadal ogląda go po 3 minutach, ale wszyscy widzowie nadal oglądają treści po 8 minutach.
  • Przy wartości elapsedVideoTimeRatio, która odpowiada 3-minutowemu czasowi rozpoczęcia odtwarzania, wartość relativeRetentionPerformance ma wartość poniżej 0.5, ponieważ w tym czasie film ma niższą skuteczność niż przeciętny film.
  • Przy wartości elapsedVideoTimeRatio odpowiadającej punktowi, który jest 8 minutami filmu, wartość relativeRetentionPerformance będzie miała wartość wyższą niż 0.5, ponieważ w tym momencie film osiąga lepsze wyniki niż inne filmy o podobnej długości.

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.

Domyślnie wszystkie szacunkowe wartości przychodów są podawane w USD. Jednak w przypadku niektórych danych o szacowanych przychodach i skuteczności reklam interfejs YouTube Analytics API obsługuje parametr currency, co pozwala pobierać dane o szacunkowych przychodach w innych walutach.
estimatedRevenue (dane podstawowe) (wcześniej earnings)
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. This is a core metric and is subject to the Deprecation Policy.

Szacunkowe dane o przychodach podlegają korektom dokonywanym na 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 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.
estimatedRedPartnerRevenue (wcześniej redPartnerRevenue)
Łączne szacunkowe przychody z subskrypcji YouTube Premium (wcześniej YouTube Red) dla wybranych wymiarów raportu. Wartość ta odzwierciedla przychody zarówno z muzyki, jak i treści innych niż muzyczne, więc może zostać skorygowana na koniec miesiąca.

Dane skuteczności reklam

bruttoPrzychody
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.
cpm (wcześniej impressionBasedCpm)
Szacowany przychód brutto na tysiąc wyświetleń reklamy.
adImpressions (wcześniej impressions)
Liczba zweryfikowanych wyświetleń reklamy.
odtworzenia generujące przychody
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%.
odtwarzaniena podstawie stopy play-off
Szacunkowe przychody brutto na tysiąc odtworzeń.