Dimensions

Ten dokument definiuje wymiary obsługiwane przez interfejs YouTube Analytics API. Interfejs ten obsługuje kierowane zapytania w czasie rzeczywistym, co umożliwia generowanie raportów niestandardowych Statystyk YouTube.

Wymiary to wspólne kryteria służące do agregowania danych, np. data, w której miała miejsce aktywność użytkownika, lub kraj, w którym się on znajdował.

Każdy raport z zapytania podaje wymiary, które obsługuje. Na przykład podczas pobierania aktywności użytkownika według czasu możesz wybrać okres, którego dane mają być raportowane: dzień lub miesiąc. W każdym raporcie każdy wiersz danych ma unikalną kombinację wartości wymiarów.

Aby pobrać raport zapytania, wywołaj metodę reports.query interfejsu API Statystyk YouTube. W żądaniu użyj parametru dimensions, aby określić wymiary, których YouTube użyje do obliczenia wartości danych w raportach.

Wymiary podstawowe

Interfejs API Statystyk YouTube podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, ale nie dotyczy to wymiarów i danych niebędących podstawowymi. W definicjach na tej stronie każdy wymiar, który jest wymiarem podstawowym, jest wyraźnie oznaczony jako taki.

Poniższa lista zawiera wymiary podstawowe interfejsu API.

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

Filtry

Filtry są obsługiwane we wszystkich raportach zapytań. Filtry określają wartości wymiarów, które muszą występować w wyodbytej grupie danych. Ograniczają one odpowiedź interfejsu API tak, aby zawierała tylko dane pasujące do określonej wartości lub zestawu wartości. Zamiast pobierać dane o aktywności użytkowników we wszystkich krajach, możesz użyć filtra, aby pobierać dane tylko z określonego kraju.

W żądaniu służącym do pobierania raportu z zapytania opcjonalny parametr filters określa wartości wymiarów, według których chcesz filtrować dane. Aby np. pobrać dane o aktywności użytkowników w Europie, należy ustawić wartość parametru filters na continent==150.

Ważne: żądania interfejsu API służące do pobierania raportów właścicieli treści muszą filtrować dane za pomocą jednego z wymiarów podmiotu raportującego lub za pomocą obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

Wymiary

W kolejnych sekcjach zdefiniowano wymiary używane w raportach zapytań interfejsu API Statystyk YouTube. O ile nie zaznaczono inaczej, te wymiary są używane zarówno w raportach kanał, jak i właściciel treści. Wymiary, których można używać tylko jako filtrów, są też oznaczane.

Zasoby

Te wymiary odpowiadają zasobom, którymi zarządzają kanały i właściciele treści w YouTube:

Uwaga: interfejs API umożliwia określenie wielu wartości wymiarów video, playlist i channel, gdy są one używane jako filtry. Aby to zrobić, ustaw wartość parametru filters na rozdzieloną przecinkami listę identyfikatorów filmów, playlist lub kanałów, dla których odpowiedź interfejsu API ma zostać odfiltrowana. Wartość parametru może zawierać maksymalnie 500 identyfikatorów.

wideo (wymiar podstawowy)
Identyfikator filmu w YouTube. W interfejsie YouTube Data API jest to wartość właściwości id zasobu video. This is a core dimension and is subject to the Deprecation Policy.
playlist
Identyfikator playlisty w YouTube. W interfejsie YouTube Data API jest to wartość właściwości id zasobu playlist.
channel (wymiar podstawowy) (używany tylko w raportach właścicieli treści)
Identyfikator kanału w YouTube. W interfejsie YouTube Data API jest to wartość właściwości id zasobu channel. This is a core dimension and is subject to the Deprecation Policy.

Wymiar channel jest często używany w raportach właścicieli treści, ponieważ raporty te zwykle zawierają dane z wielu kanałów.
group (tylko filtr)
Identyfikator grupy w Statystykach YouTube. Możesz pobrać tę wartość, używając metody groups.list interfejsu API Statystyk YouTube. Gdy użyjesz filtra group, odpowiedź interfejsu API będzie zawierać dane wszystkich filmów, playlist lub kanałów w danej grupie.

Przykłady

Te przykładowe żądania korzystają z wymiarów lub filtrów dotyczących podmiotu raportowania:

  • Przykłady kanałów

    • Statystyki podstawowe
      • Top 10 – najczęściej oglądane filmy na kanale,
      • Top 10 – współczynniki klikalności adnotacji w przypadku najczęściej oglądanych filmów na kanale.
      • Statystyki dotyczące konkretnej playlisty
      • Top 10 – najczęściej oglądane playlisty na kanale,
    • Geograficzne
      • Top 10 – najczęściej oglądane filmy w określonym kraju;
      • Top 10 – najczęściej oglądane filmy w Europie

  • Przykłady właścicieli treści

    • Statystyki podstawowe
      • Top 10 – najczęściej oglądane filmy właściciela treści
      • Top 10 – najczęściej oglądane filmy właściciela treści
      • Top 10 – najczęściej oglądane filmy na kanale właściciela treści.
      • Top 10 – współczynniki klikalności adnotacji w przypadku najczęściej oglądanych filmów na kanale.
      • Top 10 – najczęściej oglądane playlisty właściciela treści
    • Geograficzne
      • Top 10 – najczęściej oglądane filmy w Europie dla właściciela treści
      • Top 10 – najczęściej uruchamiane playlisty w Stanach Zjednoczonych

Obszary geograficzne

Te wymiary określają region geograficzny powiązany z aktywnością użytkowników, skutecznością reklam lub szacowanymi danymi o przychodach.

country (wymiar podstawowy)
Kraj powiązany z danymi w wierszu raportu. Wartość wymiaru to 2-literowy kod kraju w standardzie ISO 3166-1, np. US, CN (Chiny) lub FR (Francja). Kod kraju ZZ jest używany do raportowania danych, których nie udało się przypisać do konkretnego kraju. This is a core dimension and is subject to the Deprecation Policy.
province
Stan lub terytorium Stanów Zjednoczonych powiązane z danymi w wierszu raportu. Wartość wymiaru to kod ISO 3166-2, który identyfikuje stan w USA lub Dystrykt Kolumbiiady, np. US-MI (Michigan) lub US-TX (Teksas). Kod prowincji US-ZZ jest używany do raportowania danych, dla których YouTube nie mógł zidentyfikować powiązanego stanu w Stanach Zjednoczonych. Gdy żądanie interfejsu API zawiera wartość province w parametrze dimensions, musi też ograniczyć dane do Stanów Zjednoczonych, podając wartość country==US w parametrze filters.

Uwaga: ta wymiar nie obsługuje wartości ISO 3166-2, które identyfikują obszary przyległe do USA, ponieważ te terytoria mają też własne kody krajów w formacie ISO 3166-1. Nie obsługuje też podziałów administracyjnych innych krajów niż Stany Zjednoczone.

dma
3-cyfrowy identyfikator używany przez Nielsen do identyfikowania rynku docelowego (DMA) powiązanego ze zdarzeniami obejrzenia opisanymi w wierszu danych.
city
Szacowany obszar miasta powiązany z danymi w wierszu raportu. Dane dotyczące tego wymiaru są dostępne od 1 stycznia 2022 r.
continent (tylko filtr)
Kod regionu statystycznego ONZ. Interfejs API obsługuje te wartości:
Wartości
002 Afryka
019 Ameryka (Ameryka Północna, Ameryka Łacińska, Ameryka Południowa i Karaiby)
142 Azja
150 Europa
009 Oceania
Tego wymiaru można używać tylko do filtrowania danych. Aby użyć tego wymiaru, ustaw wartość parametru filters na continent==REGION_CODE, podając wartość REGION_CODE z tabeli.
subContinent (tylko filtr)
Kod regionu statystycznego ONZ, który identyfikuje podregion geograficzny. United Nations Statistics Division podaje listę regionów oraz krajów powiązanych z poszczególnymi regionami.

Tego wymiaru można używać tylko do filtrowania danych. Aby użyć tego wymiaru, ustaw wartość parametru filters na subContinent==REGION_CODE, podając wartość REGION_CODE z listy ONZ.

Przykłady

Te przykładowe żądania korzystają z wymiarów lub filtrów geograficznych:

  • Przykłady kanałów

    • Statystyki podstawowe: liczba wyświetleń (i inne dane) na kanał w danym kraju.
    • Geograficzne
      • Dane o czasie oglądania filmów na kanale w poszczególnych krajach
      • Dane dotyczące adnotacji w poszczególnych krajach dotyczące filmów na kanale
      • Dane dotyczące poszczególnych stanów w USA i Waszyngtonu
      • Dane dotyczące czasu oglądania playlist na kanale w poszczególnych krajach
      • Top 10 – najczęściej uruchamiane playlisty w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Źródło wizyty: liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt w danym kraju.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć).
    • Najpopularniejsze filmy
      • Top 10 – najczęściej oglądane filmy w określonym kraju;
      • Top 10 – najczęściej oglądane filmy w Europie

  • Przykłady właścicieli treści

    • Statystyki podstawowe: liczba wyświetleń (i inne dane) w przypadku wszystkich przesłanych przez Ciebie filmów w danym kraju.
    • Geograficzne
      • Dane dotyczące czasu oglądania w poszczególnych krajach w przypadku treści przesłanych przez użytkownika
      • Dane o adnotacji w poszczególnych krajach dotyczące treści przesłanych przez użytkowników
      • Dane dotyczące poszczególnych stanów w USA i Waszyngtonu
      • Dane dotyczące czasu oglądania w poszczególnych krajach na playlistach właściciela treści
      • Top 10 – najczęściej uruchamiane playlisty w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć).
    • Najpopularniejsze filmy: Top 10 – najczęściej oglądane filmy w Europie dla właściciela treści.
    • Przychody/skuteczność reklam: dane o przychodach i skuteczności reklam w poszczególnych krajach.

Okresy

Te wymiary wskazują, że raport powinien agregować dane na podstawie okresu, np. dnia, tygodnia lub miesiąca. Parametry zapytania startDate i endDate określają zakres czasowy, którego dane obejmuje raport. Pamiętaj, że raport zwraca dane aż do ostatniego dnia, dla którego w momencie wysłania zapytania są dostępne wszystkie dane określone w zapytaniu. W raportach daty są podawane w formacie YYYY-MM-DD.

Ważne: wszystkie daty odnoszą się do okresu rozpoczynającego się o 12:00 czasu pacyficznego (UTC-7 lub UTC-8) i kończącego się o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W rezultacie daty, w których zegary są przestawiane do przodu na czas letni, reprezentują okres 23-godzinny, a te, w których zegary są przestawiane do tyłu, reprezentują okres 25-godzinny.

Wymiar miesiąc odnosi się do okresu rozpoczynającego się o 12:00 czasu pacyficznego (UTC-7 lub UTC-8) pierwszego dnia wybranego miesiąca i roku.

dzień (wymiar podstawowy)
Gdy używasz tego wymiaru, dane w raporcie są agregowane na podstawie dnia, a każdy wiersz zawiera dane z jednego dnia. Aby uzyskać jeszcze bardziej szczegółowy podział danych, możesz użyć innych wymiarów. Na przykład raport o źródłach wizyt może zawierać zbiorcze statystyki dotyczące codziennego oglądania na podstawie sposobu, w jaki użytkownicy znajdują Twoje filmy. This is a core dimension and is subject to the Deprecation Policy.
miesiąc (wymiar podstawowy)
Dane w raporcie są agregowane według miesiąca kalendarzowego. Podobnie jak w przypadku raportów dziennych, możesz użyć innych filtrów, aby jeszcze bardziej podzielić dane na segmenty. W raporcie daty są podawane w formacie YYYY-MM.

Uwaga: jeśli zapytanie do interfejsu API używa wymiaru month, parametry start-date i end-date muszą być ustawione na pierwszy dzień miesiąca. This is a core dimension and is subject to the Deprecation Policy.

Przykłady

Te przykładowe żądania korzystają z wymiarów lub filtrów czasowych:

  • Przykłady kanałów

    • Na podstawie czasu
      • Dane o dziennym czasie oglądania filmów na kanale
      • Dane dotyczące codziennych statystyk powiadomień na temat kanału
      • wyświetlenia playlisty na kanale w danym dniu,
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Źródło wizyt: dzienna liczba wyświetleń i czas oglądania pochodzący z różnych źródeł wizyt
    • Urządzenie/system operacyjny
      • Dane dzienne o typie urządzenia w przypadku systemu operacyjnego Android
      • Dane dzienne o systemie operacyjnym na urządzeniach mobilnych
      • Dane dzienne dotyczące systemu operacyjnego i typu urządzenia

  • Przykłady właścicieli treści

    • Na podstawie czasu
      • Dane o dziennym czasie oglądania treści przesłanych przez Ciebie
      • Dane dotyczące adnotacji w przypadku treści objętych roszczeniem
      • wyświetlenia playlisty dziennie dla właściciela treści;
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Źródło wizyt: dzienna liczba wyświetleń i czas oglądania pochodzący z różnych źródeł wizyt
    • Urządzenie/system operacyjny
      • Dane dzienne dotyczące typu urządzenia w przypadku filmów objętych roszczeniem
      • Dane dzienne dotyczące systemu operacyjnego w przypadku roszczeń dotyczących filmów wyświetlanych na urządzeniach mobilnych
      • Dane dzienne dotyczące systemu operacyjnego i typu urządzenia
    • Przychody/skuteczność reklam: dane o przychodach i skuteczności reklam

Miejsca odtwarzania

Te wymiary dostarczają informacji o stronie lub aplikacji, w której miała miejsce aktywność użytkownika.

insightPlaybackLocationType
Dane w raporcie są agregowane na podstawie typu strony lub aplikacji, na której odtwarzano film. Możliwe wartości tego wymiaru to:

  • BROWSE – dane opisują wyświetlenia na stronie głównej lub ekranie głównym YouTube, na karcie Subskrypcje lub w innej funkcji przeglądania w YouTube.

  • CHANNEL – dane opisują wyświetlenia, które miały miejsce na stronie kanału.

  • EMBEDDED – dane opisują wyświetlenia, które miały miejsce w innej witrynie lub aplikacji, w której film został umieszczony za pomocą kodu <iframe> lub <object>.

  • EXTERNAL_APP – dane opisują wyświetlenia, które miały miejsce w aplikacji innej firmy, w której film został odtworzony za pomocą metody innej niż <iframe> lub <object>. Na przykład odtwarzanie w aplikacjach, które korzystają z interfejsu YouTube Player API na Androida, będzie przypisane do tej kategorii.

  • MOBILE – dane opisują wyświetlenia, które miały miejsce w witrynie mobilnej YouTube lub w zatwierdzonych klientach interfejsu API YouTube, w tym na urządzeniach mobilnych.

    Od 10 września 2013 r. odtwarzania nie są już w raportach Statystyk YouTube przypisywane do kategorii MOBILE. Wartość może pozostać w raportach, ponieważ starsze dane nadal należą do tej kategorii. Po tej dacie odtwarzanie na urządzeniach mobilnych jest klasyfikowane jako odtwarzanie WATCH, EMBEDDED lub EXTERNAL_APP w zależności od typu aplikacji, w której występuje.

  • SEARCH – dane opisujące wyświetlenia, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.

  • WATCH – dane opisują obejrzenia, które miały miejsce na stronie odtwarzania filmu w YouTube lub w oficjalnej aplikacji YouTube, takiej jak aplikacja YouTube na Androida.

  • YT_OTHER – dane opisują widoki, które nie zostały przypisane do żadnej innej kategorii.

insightPlaybackLocationDetail
Dane są agregowane na podstawie strony, na której znajduje się odtwarzacz. Pamiętaj, że ten raport dotyczy tylko wyświetleń w odtwarzaczach umieszczonych na stronie i określa odtwarzacze, które wygenerowały najwięcej wyświetleń danego filmu. Dzięki temu raport ten zapewnia bardziej szczegółowy widok niż raport o lokalizacji odtworzeń, ponieważ identyfikuje adresy URL lub aplikacje powiązane z najpopularniejszymi wbudowanymi odtwarzaczami.

Przykłady

Przykładowe zapytania korzystające z wymiarów lokalizacji odtwarzania:

  • Przykłady kanałów

    • Miejsce odtwarzania
      • Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania
      • dzienna liczba wyświetleń i czas oglądania z różnych lokalizacji odtwarzania;
      • Top 10 – strony zewnętrzne, które wygenerowały najwięcej wyświetleń umieszczonego filmu
      • Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania
      • dzienna liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;

  • Przykłady właścicieli treści

    • Miejsce odtwarzania
      • Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania
      • dzienna liczba wyświetleń i czas oglądania z różnych lokalizacji odtwarzania;
      • Top 10 – strony zewnętrzne, które wygenerowały najwięcej wyświetleń umieszczonego filmu
      • Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania
      • dzienna liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;

Szczegóły odtwarzania

creatorContentType
Ta wymiar identyfikuje typ treści powiązany z danymi o aktywności użytkowników w wierszu danych. Dane w tym wymiarze są dostępne od 1 stycznia 2019 r.

Wartości wymiaru:
Wartości
LIVE_STREAM Oglądane treści to transmisja na żywo w YouTube.
SHORTS Treści, które zostały obejrzane, to YouTube Short.
STORY Treści, które zostały obejrzane, to opowiadania w YouTube.
VIDEO_ON_DEMAND Wyświetlone treści to film w YouTube, który nie mieści się w żadnym z innych wartości wymiaru.
UNSPECIFIED Typ treści, które były oglądane, jest nieznany.
liveOrOnDemand
Ten wymiar wskazuje, czy dane o aktywności użytkowników w wierszu z danymi są powiązane z wyświetleniami transmisji na żywo. Dane tego wymiaru są dostępne od 1 kwietnia 2014 r.

Wartości tego wymiaru znajdziesz w tej tabeli:
Wartości
LIVE Dane w tym wierszu opisują aktywność użytkowników podczas transmisji na żywo.
ON_DEMAND Dane w tym wierszu opisują aktywność użytkownika, która nie miała miejsca podczas transmisji na żywo.
subscribedStatus
Ta wymiar wskazuje, czy dane o aktywności użytkowników w rzędzie danych są powiązane z widzami, którzy subskrybowali kanał filmu lub playlisty. Możliwe wartości to SUBSCRIBED i UNSUBSCRIBED.

Pamiętaj, że wartość wymiaru jest prawidłowa w momencie wystąpienia aktywności użytkownika. Załóżmy na przykład, że użytkownik nie subskrybuje kanału i ogląda jeden z jego filmów, a następnie subskrybuje kanał i ogląda kolejny film, wszystko w tym samym dniu. Raport kanału wskazuje, że jedno wyświetlenie ma wartość subscribedStatus SUBSCRIBED, a drugie – wartość subscribedStatus UNSUBSCRIBED.
youtubeProduct
Ten wymiar identyfikuje usługę YouTube, w której miała miejsce aktywność użytkownika. Dane dla tego wymiaru są dostępne od 18 lipca 2015 r.

Wartości wymiaru znajdziesz w tabeli poniżej:
Wartości
CORE Aktywność użytkownika, która nie miała miejsca w jednej z aplikacji YouTube (YouTube Gaming, YouTube Kids lub YouTube Music). Wyjątek: aktywność użytkownika w YouTube Music przed 1 marca 2021 r. jest uwzględniana w CORE.
GAMING Aktywność użytkownika w YouTube Gaming.
KIDS Aktywność użytkownika w YouTube Kids.
MUSIC Aktywność użytkownika w YouTube Music miała miejsce 1 marca 2021 r. lub później. Dane sprzed 1 marca 2021 r. są uwzględnione w sekcji CORE. Dane w czasie rzeczywistym nie są rejestrowane.
UNKNOWN Aktywność użytkownika miała miejsce przed 18 lipca 2015 r.

Źródła wizyt

insightTrafficSourceType
Dane w raporcie są agregowane na podstawie typu witryny odsyłającej, która opisuje sposób, w jaki użytkownicy dotarli do filmu. Możliwe wartości tego wymiaru:
  • ADVERTISING – widz został przekierowany do filmu przez reklamę. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail wskazuje typ reklamy.
  • ANNOTATION – widzowie dotarli do filmu, klikając adnotację w innym filmie.
  • CAMPAIGN_CARD – wyświetlenia pochodzące z filmów przesłanych przez użytkowników, które zostały objęte roszczeniem i które właściciel treści wykorzystał do promowania oglądanych treści. To źródło wizyt jest obsługiwane tylko w przypadku raportów właścicieli treści.
  • END_SCREEN – wyświetlenia pochodzą z ekranu końcowego innego filmu.
  • EXT_URL – wyświetlenia filmu pochodzą z linku na innej stronie. Jeśli filtrujesz dane na podstawie tego źródła wizyt, pole insightTrafficSourceDetail wskazuje stronę internetową. To źródło wizyt obejmuje odesłania z wyników wyszukiwania Google.
  • HASHTAGS – Wyświetlenia pochodzące ze stron hashtagów filmów VOD lub stron hashtagów filmów Short.
  • LIVE_REDIRECT – odsłony filmu pochodzą z przekierowań transmisji na żywo.
  • NO_LINK_EMBEDDED – film był umieszczony w innej witrynie w momencie oglądania.
  • NO_LINK_OTHER – w przypadku tego ruchu YouTube nie zidentyfikował odsyłacza. Ta kategoria obejmuje ruch kierowany bezpośrednio na film oraz ruch w aplikacjach mobilnych.
  • NOTIFICATION – odtworzenia filmu pochodzą z e-maila lub powiadomienia z YouTube.
  • PLAYLIST – obejrzenia filmu, który był odtwarzany jako część playlisty. Obejmuje on ruch z strony playlisty.
  • PRODUCT_PAGE – wyświetlenia filmu pochodzą z linku na stronie Produktu.
  • PROMOTED – wyświetlenia filmu pochodzą z niepłatnej promocji w YouTube, np. ze strony „Filmy w centrum uwagi” w YouTube.
  • RELATED_VIDEO – obejrzenia filmu pochodzą z powiązanego filmu na innej stronie odtwarzania filmu. Jeśli filtrujesz dane według tego źródła wizyt, pole insightTrafficSourceDetail zawiera identyfikator filmu.
  • SHORTS – widz został przekierowany do filmu Short, gdy przesunął palcem w pionie z poprzedniego filmu.
  • SOUND_PAGE – Wyświetlenia pochodzące ze stron dźwięku w Shorts.
  • SUBSCRIBER – wyświetlenia filmu pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji w YouTube. Jeśli filtrujesz dane według tego źródła wizyt, pole insightTrafficSourceDetail określa elementy na stronie głównej lub innej stronie, z których pochodzą wyświetlenia.
  • YT_CHANNEL – wyświetlenia filmu na stronie kanału. Jeśli filtrujesz dane według tego źródła wizyt, pole insightTrafficSourceDetail zawiera identyfikator tego kanału.
  • YT_OTHER_PAGE – wyświetlenia filmu pochodzą z linku innego niż wynik wyszukiwania lub link do powiązanego filmu, który pojawił się na stronie w YouTube. Jeśli filtrujesz dane na podstawie tego źródła wizyt, stronę identyfikuje pole insightTrafficSourceDetail.
  • YT_SEARCH – wyświetlenia filmu pochodzą z wyników wyszukiwania w YouTube. Jeśli filtrujesz dane według tego źródła wizyt, pole insightTrafficSourceDetail określa wyszukiwane hasło.
  • VIDEO_REMIXES – wyświetlenia filmu pochodzą z linku do zremiksowanego filmu w odtwarzaczu do filmów Short. Jeśli filtrujesz dane według tego źródła wizyt, pole insightTrafficSourceDetail wskazuje film, z którego użytkownik został przekierowany.
insightTrafficSourceDetail
Dane w raporcie są agregowane na podstawie odesłań, które wygenerowały najwięcej wyświetleń określonego filmu i określonego typu źródła wizyt. Na liście poniżej znajdziesz źródła wizyt, dla których jest dostępny ten raport. W przypadku każdego źródła wizyt lista zawiera informacje, które zawiera wymiar insightTrafficSourceDetail.
  • ADVERTISING – typ reklamy, która spowodowała wyświetlenia. Możliwe wartości:
    • Reklama typu „kliknij, aby odtworzyć”
    • Reklama angażująca
    • Reklamy w wyszukiwarce Google
    • Reklama wideo na stronie głównej
    • Rezerwowane reklamy In-Stream możliwe do pominięcia
    • Reklamy TrueView In-Search i In-Display
    • Reklama TrueView In-Stream
    • Reklamy bez kategorii w YouTube
    • Ściana wideo
  • CAMPAIGN_CARD – film objęty roszczeniem, który doprowadził widzów do filmu wskazanego w raporcie.
  • END_SCREEN – film, który doprowadził widzów do filmu wskazanego w zgłoszeniu.
  • EXT_URL – witryna, z której widzowie trafili do filmu.
  • HASHTAGS – hashtag, który doprowadził do wyświetleń.
  • NOTIFICATION – e-mail lub powiadomienie, które spowodowało wizytę.
  • RELATED_VIDEO – powiązany film, który doprowadził widzów do filmu objętego zgłoszeniem.
  • SOUND_PAGE – film, który spowodował wyświetlenia.
  • SUBSCRIBER – element na stronie głównej lub funkcja subskrypcji w YouTube, która doprowadziła widzów do filmu objętego raportem. Prawidłowe wartości to:
    • activity – Wyświetlenia treści widocznych na karcie „Subskrypcje” i stronie głównej, które nie są związane z przesyłaniem ani aktywnością na kanale, m.in. polubienia, ulubione, posty w biuletynie i dodania do playlisty.
    • blogged – wyświetlenia treści na karcie Subskrypcje na stronie głównej, które nastąpiły po kliknięciu linków z popularnych blogów.
    • mychannel – wyświetlenia z elementów na innych kartach widocznych na stronie głównej, takich jak „Polubione”, „Historia oglądania” i „Do obejrzenia”.
    • podcasts – wyświetlenia pochodzące z elementów na stronie docelowej Podcasty.
    • sdig – wyświetlenia pochodzące z e-maili z aktualizacjami subskrypcji.
    • uploaded – wyświetlenia elementów uploaded na karcie Subskrypcje i stronie głównej.
    • / – inne wyświetlenia pochodzące ze strony głównej YouTube.
    • /my_subscriptions – wyświetlenia pochodzące ze stron Moje subskrypcje w YouTube.
  • YT_CHANNEL – strona kanału, na której widzowie obejrzeli film.
  • YT_OTHER_PAGE – strona w YouTube, z której widzowie zostali przekierowani do filmu.
  • YT_SEARCH – wyszukiwane hasło, które przyciągnęło widzów do filmu.
  • VIDEO_REMIXES – film, który spowodował wyświetlenia.

Przykłady

Te przykładowe żądania korzystają z wymiarów źródeł wizyt:

  • Przykłady kanałów

    • Źródło wizyt
      • Liczba wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju
      • Liczba wyświetleń i czas oglądania z różnych źródeł wizyt
      • Top 10 – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla danego filmu.
      • 10 najpopularniejszych – wyszukiwane słowa w Google, które generują najwięcej ruchu dla danego filmu.
      • Liczba wyświetleń playlist i czas oglądania z różnych źródeł wizyt w danym kraju
      • dzienne liczby wyświetleń playlist i czas oglądania z różnych źródeł wizyt;

  • Przykłady właścicieli treści

    • Źródło wizyt
      • Liczba wyświetleń i czas oglądania z różnych źródeł wizyt
      • Liczba wyświetleń i czas oglądania z różnych źródeł wizyt
      • Top 10 – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla danego filmu.
      • 10 najpopularniejszych – wyszukiwane słowa w Google, które generują najwięcej ruchu dla danego filmu.
      • Liczba wyświetleń playlist i czas oglądania z różnych źródeł wizyt w danym kraju
      • dzienne liczby wyświetleń playlist i czas oglądania z różnych źródeł wizyt;

Urządzenia

deviceType
Ten wymiar określa fizyczny format urządzenia, na którym nastąpiło wyświetlenie. Na liście poniżej znajdziesz typy urządzeń, dla których interfejs API zwraca dane. Wymiar deviceType możesz też użyć jako filtra, aby ograniczyć raport o systemie operacyjnym do danych dotyczących tylko określonego typu urządzenia.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Ten wymiar identyfikuje system operacyjny urządzenia, na którym nastąpiło wyświetlenie. Poniższa lista zawiera systemy operacyjne, dla których interfejs API zwraca dane. Możesz też użyć filtra operatingSystem, aby ograniczyć raport o typie urządzenia do danych dotyczących tylko określonego systemu operacyjnego.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

Przykłady

W tych przykładowych żądaniach użyto wymiarów urządzenia:

  • Przykłady kanałów

    • Urządzenie/system operacyjny
      • Dane dzienne o typie urządzenia w przypadku systemu operacyjnego Android
      • Dane dzienne o systemie operacyjnym na urządzeniach mobilnych
      • Dane dzienne dotyczące systemu operacyjnego i typu urządzenia
      • Dane dzienne dotyczące typu urządzenia w przypadku wyświetleń playlist w systemie operacyjnym Android
      • Dane dzienne dotyczące systemu operacyjnego w przypadku wyświetleń playlist na urządzeniach mobilnych

  • Przykłady właścicieli treści

    • Urządzenie/system operacyjny
      • Dane dzienne dotyczące typu urządzenia w przypadku filmów objętych roszczeniem
      • Dane dzienne dotyczące systemu operacyjnego w przypadku roszczeń dotyczących filmów wyświetlanych na urządzeniach mobilnych
      • Dane dzienne dotyczące systemu operacyjnego i typu urządzenia
      • Dane dzienne dotyczące typu urządzenia w przypadku wyświetleń playlist w systemie operacyjnym Android
      • Dane dzienne dotyczące systemu operacyjnego w przypadku wyświetleń playlist na urządzeniach mobilnych

Dane demograficzne

Wymiary demograficzne pomagają określić przedział wiekowy Twoich odbiorców i ich podział według płci. Więcej informacji o danych demograficznych znajdziesz w raportach YouTube Analytics w Centrum pomocy YouTube.

ageGroup (wymiar podstawowy)
Ten wymiar określa grupę wiekową zalogowanych użytkowników powiązanych z danymi raportu. Interfejs API używa tych grup wiekowych:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (wymiar podstawowy)
Ten wymiar określa płeć zalogowanych użytkowników powiązanych z danymi raportu. Prawidłowe wartości to female, male i user_specified. This is a core dimension and is subject to the Deprecation Policy.

Przykłady

Te przykładowe żądania korzystają z wymiarów demograficznych:

  • Przykłady kanałów

    • Dane demograficzne
      • Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)
      • Dane demograficzne odbiorców playlisty w Kalifornii (grupa wiekowa i płeć)

  • Przykłady właścicieli treści

    • Dane demograficzne
      • Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)
      • Dane demograficzne odbiorców playlisty w Kalifornii (grupa wiekowa i płeć)

Zaangażowanie i udostępnianie treści

sharingService (wymiar podstawowy)
Ten wymiar wskazuje usługę, której użyto do udostępniania filmów. Filmy w YouTube (lub za pomocą odtwarzacza YouTube) można udostępniać za pomocą przycisku „Udostępnij”. This is a core dimension and is subject to the Deprecation Policy.

W tabeli poniżej znajdziesz listę prawidłowych wartości wymiaru:
Platforma Wartość interfejsu API
Ameba AMEBA
Android Email ANDROID_EMAIL
Komunikator na Androida ANDROID_MESSENGER
Wiadomości na Androida ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
Kopiuj do schowka COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Umieść EMBED
E-mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Strony na Facebooku FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Wiadomość tekstowa HTC HTC_MMS
Skrzynka odbiorcza Google INBOX
Okno aktywności systemu na iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE Email LGE_EMAIL
Linia LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Udostępnianie w pobliżu NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Inne OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Nieznany UNKNOWN
Wiadomości Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japonia YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Więcej informacji znajdziesz w dokumentacji pomocy.

Przykłady

Te przykładowe żądania korzystają z wymiarów dotyczących sieci społecznościowych:

  • Przykłady kanałów

  • Przykłady właścicieli treści

Utrzymanie uwagi odbiorców

elapsedVideoTimeRatio
Ta wymiar określa stosunek upływu czasu do długości filmu. Wymiary i dane dotyczące utrzymania uwagi służą do pomiaru utrzymania uwagi odbiorców w czasie, a wymiar elapsedVideoTimeRatio to miara czasu. Wartość 0.4 oznacza na przykład, że odpowiadające jej dane raportu zawierają dane o okresie retencji po upływie 40% czasu trwania filmu.

Interfejs API zwraca 100 punktów danych dla każdego filmu z wartościami współczynnika w zakresie od 0.01 do 1.0. Czasy pomiaru danych podczas odtwarzania filmów są rozmieszczone w równych odstępach w przypadku każdego filmu. Oznacza to, że w przypadku 2-minutowego filmu odstęp między punktami danych wynosi 1,2 sekundy. W przypadku 2-godzinnego filmu interwał między punktami danych wynosi jednak 72 sekundy. Wartość wymiaru oznacza koniec przedziału (wyłącznie).
audienceType (dotyczy tylko filtra)
Wartość wymiaru określa typ ruchu powiązanego z danymi w raporcie. Obsługiwane wartości to ORGANIC, AD_INSTREAM i AD_INDISPLAY. Więcej informacji o tych typach źródeł wizyt znajdziesz w Centrum pomocy YouTube.

Pamiętaj, że dane dla filtra audienceType są dostępne od 25 września 2013 r. Interfejs API nie zwraca danych w przypadku zapytań, które używają filtra do próby pobrania danych z wcześniejszych dat. Zapytania, które nie używają filtra, działają w przypadku każdej daty po 1 lipca 2008 r.

Przykłady

Te przykładowe żądania korzystają z wymiarów utrzymania uwagi odbiorców:

Transmisje na żywo

livestreamPosition
Ta wymiar określa konkretną minutę transmisji na żywo. Dane w raporcie wskazują, ilu użytkowników oglądało transmisję na żywo w danym momencie.

Anulowanie wspierania

membershipsCancellationSurveyReason
Liczba ankiet wypełnionych przez użytkowników YouTube, którzy anulowali wspieranie określonego kanału w okresie raportowania. Tabela poniżej zawiera listę prawidłowych wartości wymiaru:
Wartość interfejsu API Wyjaśnienie
UNKNOWN Użytkownik nie ukończył ankiety.
DISLIKE_PERKS Użytkownikowi nie podobały się korzyści z członkostwa.
PERKS_NOT_DELIVERED Użytkownik stwierdził, że obiecane korzyści z członkostwa nie zostały dostarczone.
CANNOT_ACCESS_PERKS Użytkownik nie miał dostępu do korzyści.
NO_LONGER_INTERESTED użytkownik nie jest już zainteresowany subskrypcją kanału;
FEEL_UNAPPRECIATED Użytkownik czuł się niedoceniany jako członek kanału.
FINANCIAL_REASONS Użytkownik anulował rezerwację z powodu kwestii finansowych.
JOIN_LIMITED_TIME Użytkownik chciał dołączyć tylko na ograniczony czas.
OTHER Użytkownik miał inny powód rezygnacji.

Skuteczność reklamy

adType
Wymiar adType jest używany w raportach skuteczności reklam i zbiera żądane dane na podstawie typów reklam wyświetlanych podczas odtwarzania filmów. Poniżej znajdziesz listę możliwych wartości wymiarów. Więcej informacji o formatach reklam w YouTube znajdziesz w Centrum pomocy YouTube.

  • auctionBumperInstream – reklamy wideo niemożliwe do pominięcia, umieszczane za pomocą aukcji, które trwają do 6 sekund i muszą być wyświetlane, zanim rozpocznie się odtwarzanie filmu.

  • auctionDisplay – reklama rich media lub graficzna, która pojawia się jako nakładka u dołu odtwarzacza wideo, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako kombinacja obu tych opcji. Gdy nakładka jest wyświetlana, zamyka się automatycznie po upływie określonego czasu. Użytkownik może ją też zamknąć. Jeśli nakładka i baner są wyświetlane razem, każde z tych wyświetleń jest zliczane jako osobne.

  • auctionInstream – reklamy wideo niemożliwe do pominięcia, które wyświetlają się przed filmem, w jego trakcie lub po jego zakończeniu.

  • auctionTrueviewInslate – widz wybiera jedną z kilku reklam wideo spośród opcji wyświetlanych przed filmem. See the TrueView documentation for more information.

  • auctionTrueviewInstream – reklamy wideo możliwe do pominięcia, które są wyświetlane przed filmem głównym lub w jego trakcie. Więcej informacji znajdziesz w dokumentacji TrueView.

  • auctionUnknown – reklama zakupiona w aukcji AdWords, która nie została zaklasyfikowana jako żaden z innych typów reklam.

  • reservedBumperInstream – reklamy wideo niemożliwe do pominięcia, sprzedawane na podstawie rezerwacji, które trwają do 6 sekund i muszą być wyświetlane, zanim rozpocznie się odtwarzanie filmu.

  • reservedClickToPlay – reklama wideo, którą użytkownik musi kliknąć, aby rozpocząć odtwarzanie. Wyświetlenie reklamy jest rejestrowane za każdym razem, gdy wyświetla się jednostka reklamowa typu „kliknij, aby odtworzyć”, niezależnie od tego, czy użytkownik rozpoczyna odtwarzanie. Są one sprzedawane w ramach rezerwacji.

  • reservedDisplay – reklama rich media lub graficzna, która pojawia się jako nakładka u dołu odtwarzacza wideo, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako kombinacja obu tych opcji. Gdy nakładka jest wyświetlana, zamyka się automatycznie po upływie określonego czasu. Użytkownik może ją też zamknąć. Jeśli nakładka i baner są wyświetlane razem, każde z tych wyświetleń jest zliczane jako osobne.

  • reservedInstream – reklamy wideo niemożliwe do pominięcia wstawiane przed filmem, w jego trakcie lub po nim.

  • reservedInstreamSelect

  • reservedMasthead – duża reklama, która może zawierać elementy wideo i graficzne, wyświetlana na stronie głównej.

  • reservedUnknown – reklama sprzedana na podstawie rezerwacji, której nie można przypisać do żadnego z innych typów reklam.

  • unknown – YouTube nie mógł sklasyfikować tego typu reklamy.

Przykłady

Z tych przykładowych raportów możesz pobrać dane o skuteczności reklam lub dane o przychodach:

  • Przykłady kanałów

    • Przychody/reklamy
      • Dane o przychodach z kanału i skuteczności reklam
      • Dane o przychodach i skuteczności reklamy
      • Dane o przychodach i skuteczności reklamy w poszczególnych krajach
      • Top 10 – filmy z najwyższymi przychodami
      • Dane o skuteczności reklam w przypadku różnych typów reklam

  • Przykłady właścicieli treści

    • Przychody/reklamy
      • Dane o przychodach i skuteczności reklam w przypadku treści zgłoszonych do Google
      • Dane o przychodach i skuteczności reklamy
      • Dane o przychodach i skuteczności reklamy w poszczególnych krajach
      • Top 10 – filmy z najwyższymi przychodami
      • Dane o skuteczności reklam w przypadku różnych typów reklam

Wymiary właściciela treści

Te wymiary są obsługiwane tylko w przypadku raportów właścicieli treści.

Ważne: żądania interfejsu API służące do pobierania raportów właścicieli treści muszą filtrować dane za pomocą jednej z tych wymiarów:
  • video
  • channel
  • Obsługiwana kombinacja wymiarów claimedStatus i uploaderType zdefiniowanych poniżej.
claimedStatus (używany tylko w raportach właścicieli treści)
Ten wymiar pozwala określić, że odpowiedź interfejsu API powinna zawierać tylko dane o zawłaszczonych treściach. Jedyną prawidłową wartością w tym wymiarze jest claimed. Jeśli parametr filters ogranicza zapytanie do claimedStatus==claimed, interfejs API pobiera dane tylko dla treści zgłoszonych do Google. Więcej informacji o używaniu tego wymiaru znajdziesz w tabeli w definicji wymiaru uploaderType.
uploaderType (wymiar podstawowy) (używany tylko w raportach właścicieli treści)
Ta wymiar pozwala określić, czy odpowiedź interfejsu API powinna zawierać dane o treściach przesłanych przez określonego właściciela treści lub przez osoby trzecie, np. filmy przesłane przez użytkowników. Prawidłowe wartości to self i thirdParty. Jest to wymiar podstawowy, który podlega zasadom wycofywania.

Tabela poniżej zawiera obsługiwane kombinacje wymiarów claimedStatus i uploaderType, które są używane w parametrze filters:

Wartość claimedStatus Wartość uploaderType Opis
[Nie wybrano] self Pobiera dane Statystyk YouTube dotyczące treści objętych i nieobjętych roszczeniami przesłanych przez właściciela treści.
objęte roszczeniem [Nie wybrano] Pobiera dane dotyczące treści zgłoszonych przez właściciela treści lub osobę trzecią.
objęte roszczeniem self Pobiera dane dotyczące treści zgłoszonych przez właściciela treści.
objęte roszczeniem thirdParty Pobiera dane dotyczące treści objętych roszczeniem przesłanych przez osobę trzecią.

Przykłady

Wiele przykładowych żądań interfejsu API dotyczących raportów właścicieli treści używa obsługiwanej kombinacji wymiarów claimedStatus i uploaderType do filtrowania danych.