Dimensions

Ten dokument określa wymiary obsługiwane w interfejsie YouTube Analytics API. Umożliwia on generowanie niestandardowych zapytań w czasie rzeczywistym, co pozwala generować niestandardowe raporty Statystyk YouTube.

Wymiary to często używane kryteria agregacji danych, takie jak data aktywności użytkownika lub kraj zamieszkania.

Każdy raport wskazuje wymiary, które obsługuje. Pobierając dane o aktywności użytkowników według czasu, możesz wybrać okres, z którego będą gromadzone dane: dzień lub miesiąc. W każdym raporcie każdy wiersz danych zawiera unikalną kombinację wartości wymiarów.

Aby pobrać raport wyszukiwań, wywołaj metodę reports.query interfejsu API YouTube Analytics. W żądaniu użyj parametru dimensions, aby określić wymiary, których YouTube będzie używać do obliczania wartości danych w raportach.

Wymiary podstawowe

Chociaż interfejs YouTube Analytics API podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, wymiary inne niż podstawowe (dane spoza zestawu podstawowego) nie podlegają tej zasadzie. W definicjach na tej stronie każdy wymiar podstawowy jest wyraźnie określony.

Poniższa lista przedstawia podstawowe wymiary interfejsu API.

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

Filtry

Wszystkie raporty zapytań obsługują filtry. Filtry identyfikują wartości wymiarów, które muszą znajdować się w pobranym zbiorze danych. Dlatego ograniczają odpowiedź interfejsu API tylko do danych pasujących do określonej wartości lub zbioru wartości. Na przykład zamiast pobierać dane o aktywności użytkowników dla wszystkich krajów możesz użyć filtra, aby pobrać tylko dane dla określonego kraju.

W żądaniu pobrania raportu zapytania opcjonalny parametr filters określa wartości wymiarów, których dane chcesz filtrować. Aby na przykład pobrać dane o aktywności użytkowników w Europie, ustaw wartość parametru filters na continent==150.

Ważne: żądania API do pobierania raportów o właścicielu treści muszą filtrować dane za pomocą jednego z wymiarów zgłaszających lub przy użyciu obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

Wymiary

Poniższe sekcje określają wymiary używane w raportach zapytań dotyczących interfejsu YouTube Analytics API. O ile nie zaznaczono inaczej, te wymiary są używane w raportach dotyczących kanału i właściciela treści. Widoczne są też wymiary, których można używać tylko jako filtrów.

Zasoby

Te wymiary odpowiadają zasobom, którymi kanały i właściciele treści zarządzają 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 oddzieloną przecinkami listę identyfikatorów filmów, playlist lub kanałów, dla których chcesz odfiltrować odpowiedź interfejsu API. 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.
playlista
Identyfikator playlisty w YouTube W interfejsie YouTube Data API jest to wartość właściwości id zasobu playlist.
kanał (wymiar podstawowy) (tylko w raportach właściciela 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 wykorzystywany w raportach właściciela treści, ponieważ zwykle zawierają one dane pochodzące z wielu kanałów.
grupa (tylko filtr)
Identyfikator grupy w YouTube Analytics. Tę wartość możesz pobrać za pomocą metody groups.list interfejsu YouTube Analytics API. Gdy używasz filtra group, odpowiedź interfejsu API zawiera dane dotyczące wszystkich filmów, playlist i kanałów w tej grupie.

Przykłady

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

  • Przykłady kanałów

    • Podstawowe statystyki
      • 10 najpopularniejszych filmów – najczęściej oglądane filmy na kanale
      • 10 najpopularniejszych filmów – współczynniki klikalności adnotacji dotyczących najczęściej oglądanych filmów na kanale
      • Statystyki dotyczące określonej playlisty
      • 10 najpopularniejszych filmów – najczęściej oglądane playlisty na kanale
    • Geograficzne
      • 10 najpopularniejszych filmów – najczęściej wyświetlane filmy w danym kraju
      • 10 najpopularniejszych filmów – najczęściej oglądanych w Europie

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

    • Podstawowe statystyki
      • 10 najpopularniejszych filmów – najczęściej oglądane przez właściciela treści
      • 10 najpopularniejszych filmów – najczęściej oglądane filmy przez właściciela treści
      • 10 najpopularniejszych filmów – najczęściej oglądane filmy na kanale właściciela treści
      • 10 najpopularniejszych filmów – współczynniki klikalności adnotacji dotyczących najczęściej oglądanych filmów na kanale
      • 10 najpopularniejszych – najczęściej oglądane playlisty właściciela treści
    • Geograficzne
      • 10 najpopularniejszych filmów – najczęściej oglądane filmy w Europie dla właściciela treści
      • 10 najlepszych playlist w Stanach Zjednoczonych

Obszary geograficzne

Wymiary te wskazują regiony geograficzne powiązane z aktywnością użytkowników, skutecznością reklam lub prognozowanymi danymi o przychodach.

kraj (wymiar podstawowy)
Kraj powiązany z danymi w wierszu raportu. Wartość wymiaru to dwuliterowy kod kraju w formacie ISO-3166-1, np. US, CN (Chiny) lub FR (Francja). Kod kraju ZZ służy do raportowania danych, w przypadku których YouTube nie może zidentyfikować powiązanego kraju. This is a core dimension and is subject to the Deprecation Policy.
province
Stan lub region w Stanach Zjednoczonych powiązany z danymi w wierszu raportu. Wartość wymiaru to kod ISO 3166-2 identyfikujący stan USA lub Dystrykt Kolumbii, np. US-MI (Michigan) lub US-TX (Teksas). Kod prowincji US-ZZ służy do raportowania danych, w przypadku których YouTube nie może zidentyfikować powiązanego stanu USA. Gdy żądanie do interfejsu API zawiera wartość province w wartości parametru dimensions, musi też ograniczać dane do Stanów Zjednoczonych, dodając w wartości filters parametr country==US.

Uwaga: ten wymiar nie obsługuje wartości ISO 3166-2 identyfikujących obszary Dalekie Stanów Zjednoczonych, ponieważ mają one też własne kody krajów w formacie ISO 3166-1. Podział na podgrupy nie jest obsługiwany w przypadku krajów innych niż Stany Zjednoczone.

city
Szacunkowe miasto powiązane z danymi w wierszu raportu. Dane dotyczące tego wymiaru są dostępne od 1 stycznia 2022 r.
kontynent (tylko filtr)
Kod regionu statystycznego ONZ. Interfejs API obsługuje te wartości:
Wartości
002 Afryka
019 Ameryka Północna i Południowa (Ameryka Łacińska, Ameryka Łacińska, 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, określając wartość REGION_CODE z listy powyżej.
subkontynent (tylko filtr)
Kod statystyczny ONZ, który identyfikuje podregion geograficzny. Dział Statystyki ONZ wyświetla podregiony, a także kraje, z którymi jest powiązany.

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

Przykłady

Te przykładowe żądania wykorzystują wymiary lub filtry geograficzne:

  • Przykłady kanałów

    • Podstawowe statystyki: liczba wyświetleń dla danego kraju (i inne)
    • Geograficzne
      • Wskaźniki czasu oglądania filmów na danym kraju
      • Dane dotyczące adnotacji do filmów na kanale w poszczególnych krajach
      • Dane dotyczące prowincji w stanach USA i Waszyngtonie
      • Dane dotyczące czasu oglądania w poszczególnych krajach dotyczące playlist na kanale
      • 10 najlepszych playlist w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Źródło wizyt: 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
      • 10 najpopularniejszych filmów – najczęściej wyświetlane filmy w danym kraju
      • 10 najpopularniejszych filmów – najczęściej oglądanych w Europie

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

    • Podstawowe statystyki: liczba wyświetleń dla poszczególnych filmów przesłanych w danym kraju (i inne)
    • Geograficzne
      • Wskaźniki czasu oglądania dotyczące treści przesłanych samodzielnie
      • Wskaźniki adnotacji dla poszczególnych filmów w poszczególnych krajach
      • Dane dotyczące prowincji w stanach USA i Waszyngtonie
      • Dane o czasie oglądania dla playlist właściciela treści
      • 10 najlepszych playlist w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)
    • Najpopularniejsze filmy: 10 filmów – najczęściej oglądane filmy w Europie dla właściciela treści
    • Przychody / skuteczność reklamy: dane o przychodach i skuteczności reklam w poszczególnych krajach

Okresy

Te wymiary wskazują, że raport powinien zbierać dane na podstawie przedziału czasu, np. dzień, tydzień lub miesiąc. Parametry żądań startDate i endDate określają przedział czasu, którego dotyczy raport. Pamiętaj, że raport zwraca dane do ostatniego dnia, dla którego wszystkie dane określone w żądaniu są dostępne w momencie wykonywania zapytania. W raportach daty są podawane w formacie YYYY-MM-DD.

Ważne: wszystkie daty dotyczą okresu od godziny 00:00 czasu pacyficznego (UTC-7 lub UTC-8) do 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. Dlatego daty, w których zegar jest przesunięty do przodu w przypadku czasu letniego, pochodzą z 23 godzin, a te z tyłu – z 25-godzinnego okresu.

Wymiar Miesiąc odnosi się do okresu rozpoczynającego się o północy czasu pacyficznego (UTC-7 lub UTC-8) pierwszego dnia danego miesiąca i roku.

dzień (wymiar podstawowy)
Gdy używasz tego wymiaru, dane w raporcie są agregowane codziennie, a każdy wiersz zawiera dane z 1 dnia. Aby dokładniej podzielić dane, możesz użyć innych wymiarów. Na przykład raport o źródłach wizyt może gromadzić zbiorcze dzienne statystyki dotyczące sposobu, w jaki użytkownicy docierają do Twoich filmów. 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

W tych przykładowych żądaniach używane są tymczasowe wymiary lub filtry:

  • Przykłady kanałów

    • Ograniczony czasowo
      • Dzienne wskaźniki czasu oglądania filmów na kanale
      • Dzienne wskaźniki adnotacji w filmach na kanale
      • dzienne wyświetlenia playlisty na kanale,
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Źródło wizyt: dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/OS
      • Dzienne dane typu urządzenia z systemem operacyjnym Android
      • Dzienne dane systemu operacyjnego na urządzenia mobilne
      • Dzienne wskaźniki systemu operacyjnego i typu urządzenia

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

    • Ograniczony czasowo
      • Dzienne wskaźniki czasu oglądania treści przesłanych samodzielnie
      • Dane dotyczące adnotacji do treści objętych roszczeniem
      • Dzienne wyświetlenia playlist właściciela treści
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Źródło wizyt: dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/OS
      • Dzienne dane typu urządzenia w przypadku filmów objętych roszczeniem
      • Dzienne dane systemu operacyjnego dotyczące filmów objętych roszczeniem wyświetlonych na urządzeniach mobilnych
      • Dzienne wskaźniki systemu operacyjnego i typu urządzenia
    • Przychody/skuteczność reklamy: dzienne przychody i dane o skuteczności reklam

Miejsca odtwarzania

Wymiary te dostarczają informacji o stronie lub aplikacji, na której miała miejsce aktywność użytkownika.

insightplayLocationType
Dane w raporcie są podawane zbiorczo na podstawie typu strony lub aplikacji, na której odtworzone zostały filmy. Możliwe wartości tego wymiaru to:

  • BROWSE – dane dotyczą wyświetleń, które miały miejsce na stronie głównej YouTube lub na ekranie głównym, w sekcji Subskrypcje użytkownika lub w innej funkcji przeglądania YouTube.

  • CHANNEL – dane dotyczące wyświetleń, które miały miejsce na stronie kanału.

  • EMBEDDED – dane dotyczą wyświetleń, które miały miejsce w innej witrynie lub aplikacji, w której film został umieszczony przy użyciu funkcji <iframe> lub <object>.

  • EXTERNAL_APP – dane dotyczące wyświetleń, które miały miejsce w aplikacji innej firmy, w której film był odtwarzany przy użyciu metody innej niż umieszczenie danych <iframe> lub <object>. Na przykład przy użyciu tej wartości będą klasyfikowane odtworzenia w aplikacjach, które korzystają z interfejsu YouTube Android Player API.

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

    Od 10 września 2013 r. w raportach YouTube Analytics odtworzenia nie są klasyfikowane jako odtworzenia MOBILE. Ta wartość może pozostać w raportach, ponieważ starsze dane wciąż należą do tej kategorii. Po tym terminie odtworzenia na urządzeniach mobilnych mogą być klasyfikowane jako WATCH, EMBEDDED lub EXTERNAL_APP, w zależności od typu aplikacji.

  • SEARCH – dane dotyczą wyświetleń bezpośrednio na stronie wyników wyszukiwania w YouTube.

  • WATCH – dane dotyczą wyświetleń filmu na stronie odtwarzania filmu lub w oficjalnej aplikacji YouTube, na przykład w aplikacji YouTube na Androida.

  • YT_OTHER – dane opisują widoki, które nie zostały sklasyfikowane.

Szczegóły lokalizacji odtwarzania statystyk
Dane są agregowane na podstawie strony, na której znajduje się odtwarzacz. Ten raport jest obsługiwany tylko w przypadku wyświetleń, które wystąpiły w odtwarzaczach umieszczonych na stronach, i pozwala wskazać odtwarzacze, które wygenerowały najwięcej wyświetleń w przypadku danego filmu. Zapewnia to bardziej szczegółowy widok niż raport lokalizacji odtwarzania, identyfikując adresy URL i aplikacje powiązane z najpopularniejszymi odtwarzaczami.

Przykłady

Te przykładowe żądania używają 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 miejsc odtwarzania
      • 10 najpopularniejszych witryn – zewnętrzne witryny, które generują 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 w różnych miejscach odtwarzania

  • Przykłady właściciela 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 miejsc odtwarzania
      • 10 najpopularniejszych witryn – zewnętrzne witryny, które generują 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 w różnych miejscach odtwarzania

Szczegóły odtwarzania

creatorContentType
Ten wymiar określa typ treści powiązany z danymi o aktywności użytkownika w wierszu danych. Dane dotyczące tego wymiaru są dostępne od 1 stycznia 2019 r.

Poniższa tabela zawiera wartości wymiarów:
Wartości
LIVE_STREAM Wyświetlona treść była transmisją na żywo w YouTube.
SHORTS Obejrzane treści to filmy Short.
STORY Wyświetlona treść była relacją w YouTube.
VIDEO_ON_DEMAND Wyświetlony film to film w YouTube, który nie pasuje do żadnej innej wartości wymiaru.
UNSPECIFIED Typ treści wyświetlonej treści jest nieznany.
na żywo na żądanie
Ten wymiar wskazuje, czy dane o aktywności użytkownika w wierszu danych są powiązane z wyświetleniami transmisji na żywo. Dane dotyczące tego wymiaru są dostępne od 1 kwietnia 2014 r.

Ta tabela zawiera listę wartości wymiarów:
Wartości
LIVE Dane te zawierają opis działań użytkowników, które wystąpiły podczas transmisji na żywo.
ON_DEMAND Dane te zawierają opis działań użytkowników, które nie miały miejsca podczas transmisji na żywo.
subscribedStatus
Ten wymiar wskazuje, czy dane o aktywności użytkownika w wierszu danych są powiązane z widzami, którzy zasubskrybowali kanał filmu lub playlisty. Możliwe wartości to SUBSCRIBED i UNSUBSCRIBED.

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, ogląda jeden z filmów na tym kanale, a potem tego samego dnia subskrybuje kanał i ogląda kolejny. Raport kanału wskazuje, że jeden widok ma wartość subscribedStatus SUBSCRIBED, a jeden widok ma wartość subscribedStatus UNSUBSCRIBED.
youtubeProduct
Ten wymiar identyfikuje usługę YouTube, w której miała miejsce aktywność użytkownika. Dane dotyczące tego wymiaru są dostępne od 18 lipca 2015 r.

Ta tabela zawiera listę wartości wymiarów:
Wartości
CORE Aktywność użytkowników, która nie miała miejsca w żadnej ze specjalnych aplikacji YouTube (YouTube Gaming, YouTube Kids czy YouTube Music). Wyjątek: aktywność użytkowników w YouTube Music sprzed 1 marca 2021 r. jest uwzględniona w CORE.
GAMING Aktywność użytkownika miała miejsce w YouTube Gaming.
KIDS Aktywność użytkownika miała miejsce w YouTube Kids.
MUSIC Aktywność użytkowników miała miejsce w YouTube Music 1 marca 2021 r. lub później. Dane sprzed 1 marca 2021 r. są uwzględnione w danych 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 strony odsyłającej, która opisuje sposób, w jaki użytkownicy dotarli do filmu. Możliwe wartości tego wymiaru:
  • ADVERTISING – widz skierował film na reklamę. Jeśli filtrujesz wyniki na podstawie tego źródła wizyt, pole insightTrafficSourceDetail wskazuje typ reklamy.
  • ANNOTATION – widzowie obejrzeli film, klikając adnotację w innym filmie.
  • CAMPAIGN_CARD – wyświetlenia, które pochodzą z filmów przesłanych przez użytkowników, które zostały objęte roszczeniem, i zostały użyte przez właściciela treści do promowania oglądanych treści; To źródło wizyt jest obsługiwane tylko w raportach właściciela treści.
  • END_SCREEN – wyświetlenia pochodzą z ekranu końcowego innego filmu.
  • EXT_URL – wyświetlenia filmu, do którego prowadzi link, pochodzi z innej witryny. Jeśli filtrujesz wyniki 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, które pochodzą ze stron hashtagu VOD lub stron z hashtagami Shorts.
  • LIVE_REDIRECT – wyświetlenia filmu, do którego odwołują się przekierowania na żywo.
  • NO_LINK_EMBEDDED – film był umieszczony w innej witrynie podczas oglądania
  • NO_LINK_OTHER – YouTube nie określił strony odsyłającej dla ruchu; Kategoria ta obejmuje wizyty bezpośrednie oraz filmy w aplikacjach mobilnych.
  • NOTIFICATION – wyświetlenia filmów, do których odwołują się e-maile lub powiadomienia z YouTube,
  • PLAYLIST – wyświetlenia filmu miały miejsce podczas odtwarzania tej playlisty. Pamiętaj, że to źródło wizyt różni się od źródła YT_PLAYLIST_PAGE, które oznacza, że wyświetlenia pochodzą ze strony, która wyświetla listę wszystkich filmów na playliście.
  • PRODUCT_PAGE – wyświetlenia filmów, do których doszło na stronie produktu.
  • PROMOTED – wyświetlenia filmów pochodzą z bezpłatnej promocji w YouTube, np. strony „Wyróżnione filmy” w YouTube;
  • RELATED_VIDEO – wyświetlenia filmu, do którego zgłoszono film, pochodzą z podobnej pozycji na innej stronie odtwarzania filmu. W przypadku filtrowania na podstawie tego źródła wizyt pole insightTrafficSourceDetail określa identyfikator filmu.
  • SHORTS – widz skorzystał z funkcji przesuwania w pionie względem poprzedniego filmu w filmach Short.
  • SOUND_PAGE – wyświetlenia, które pochodzą ze stron z dźwiękiem Shorts.
  • SUBSCRIBER – wyświetlenia filmu pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji w YouTube. Jeśli filtrujesz wyniki na podstawie tego źródła wizyt, w polu insightTrafficSourceDetail widać elementy kanału na stronie głównej lub inne strony, z których pochodziły wyświetlenia.
  • YT_CHANNEL – wyświetlenia filmu pojawiły się na stronie kanału. W przypadku filtrowania na podstawie tego źródła wizyt pole insightTrafficSourceDetail określa identyfikator tego kanału.
  • YT_OTHER_PAGE – wyświetlenia filmu pochodzą z linków innych niż wyniki wyszukiwania lub podobne filmy, które pojawiły się na stronie w YouTube. Jeśli filtrujesz wyniki na podstawie tego źródła wizyt, pole insightTrafficSourceDetail wskazuje stronę.
  • YT_PLAYLIST_PAGE – wyświetlenia filmów, których źródłem jest strona z listą wszystkich filmów na playliście. Zauważ, że to źródło wizyt różni się od źródła PLAYLIST, które wskazuje, że wyświetlenia miały miejsce podczas odtwarzania filmu w ramach playlisty.
  • YT_SEARCH – wyświetlenia filmu pochodzą z wyników wyszukiwania w YouTube. Jeśli filtrujesz wyniki na podstawie tego źródła wizyt, w polu insightTrafficSourceDetail znajdziesz wyszukiwane hasło.
  • VIDEO_REMIXES – wyświetlenia filmów pochodzą z linku do zremiksowanych treści w odtwarzaczu do filmów Short. Jeśli filtrujesz wyniki na podstawie tego źródła wizyt, w polu insightTrafficSourceDetail znajdziesz film, z którego użytkownik został przekierowany.
insightTrafficSourceDetails
Dane w raporcie są agregowane na podstawie stron odsyłających, które przyniosły najwięcej wyświetleń dla określonego filmu i typu źródła wizyt. Ta lista zawiera źródła wizyt, dla których dostępny jest ten raport. W przypadku każdego źródła wizyt lista zawiera informacje dostarczone przez wymiar insightTrafficSourceDetail.
  • ADVERTISING – typ reklamy, która doprowadziła do wyświetlenia filmu. Możliwe wartości:
    • Reklama angażująca typu „kliknij, aby odtworzyć”
    • Reklama angażująca
    • Reklamy w wyszukiwarce Google
    • Reklama wideo na stronie głównej
    • Zarezerwowane reklamy In-Stream możliwe do pominięcia
    • 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 spowodował wyświetlenie filmu zidentyfikowanego w raporcie;
  • EXT_URL – strona, która odesłała widzów do filmu.
  • HASHTAGS – hashtag, który doprowadził do wyświetleń.
  • NOTIFICATION – e-mail lub powiadomienie o ruchu.
  • RELATED_VIDEO – podobny film, który doprowadził widzów do filmu objętego raportem.
  • SOUND_PAGE – film, który doprowadził do wyświetlenia.
  • SUBSCRIBER – element strony głównej lub funkcja subskrypcji YouTube, które doprowadziły widzów do filmu objętego raportem. Prawidłowe wartości to:
    • activity – wyświetlenia elementów na kanałach subskrypcji na stronie głównej, które są wynikiem innych działań (np. polubień, ulubionych, postów w biuletynie lub dodania playlisty), i nieaktywności w mediach społecznościowych.
    • blogged – wyświetlenia elementów z kanałów subskrypcji na stronie głównej, które pochodziły z linków najpopularniejszych blogów.
    • mychannel – wyświetlenia elementów z innych kanałów wymienionych na stronie głównej, takich jak „Polubienia”, „Historia oglądania” czy „Do obejrzenia”.
    • podcasts – wyświetlenia pochodzące z elementów na stronie docelowej Podcastów.
    • sdig – wyświetlenia pochodzące z e-maili z aktualizacjami subskrypcji.
    • uploaded – wyświetlenia elementów (uploaded) w kanałach subskrypcji na stronie głównej.
    • / – inne wyświetlenia na stronie 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 skierowani do filmu;
  • YT_SEARCH – wyszukiwane hasło, które przyciągnęło widzów do filmu.
  • VIDEO_REMIXES – film, który doprowadził do wyświetlenia.

Przykłady

Te przykładowe żądania używają wymiarów źródła wizyt:

  • Przykłady kanałów

    • Źródło wizyt
      • Liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt w danym kraju
      • Dzienna liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt
      • 10 najpopularniejszych filmów – wyszukiwane w YouTube słowa, które generują największy ruch w przypadku danego filmu
      • 10 najpopularniejszych – wyszukiwane w Google słowa, które generują największy ruch w przypadku filmu
      • Liczba wyświetleń i czas oglądania playlisty z różnych źródeł wizyt w danym kraju
      • Dzienna liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

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

    • Źródło wizyt
      • Liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt
      • Dzienna liczba wyświetleń i czas oglądania pochodzące z różnych źródeł wizyt
      • 10 najpopularniejszych filmów – wyszukiwane w YouTube słowa, które generują największy ruch w przypadku danego filmu
      • 10 najpopularniejszych – wyszukiwane w Google słowa, które generują największy ruch w przypadku filmu
      • Liczba wyświetleń i czas oglądania playlisty z różnych źródeł wizyt w danym kraju
      • Dzienna liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

Urządzenia

deviceType,
Ten wymiar określa formę fizyczną urządzenia, na którym nastąpiło wyświetlenie. Poniższa lista zawiera typy urządzeń, dla których interfejs API zwraca dane. Wymiaru deviceType możesz też użyć jako filtra, aby ograniczyć raport o systemie operacyjnym do danych tylko na urządzeniach określonego typu.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
System operacyjny
Ten wymiar określa system oprogramowania urządzenia, na którym wyświetlono widok. Poniższa lista zawiera systemy operacyjne, dla których interfejs API zwraca dane. Możesz też użyć filtra operatingSystem, aby ograniczyć raport o typach urządzeń tylko do danych z konkretnego 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

Te przykładowe żądania używają wymiarów urządzenia:

  • Przykłady kanałów

    • Urządzenie/OS
      • Dzienne dane typu urządzenia z systemem operacyjnym Android
      • Dzienne dane systemu operacyjnego na urządzenia mobilne
      • Dzienne wskaźniki systemu operacyjnego i typu urządzenia
      • Dzienne dane typu urządzenia w przypadku wyświetleń playlisty w systemie operacyjnym Android
      • Dzienne dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych

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

    • Urządzenie/OS
      • Dzienne dane typu urządzenia w przypadku filmów objętych roszczeniem
      • Dzienne dane systemu operacyjnego dotyczące filmów objętych roszczeniem wyświetlonych na urządzeniach mobilnych
      • Dzienne wskaźniki systemu operacyjnego i typu urządzenia
      • Dzienne dane typu urządzenia w przypadku wyświetleń playlisty w systemie operacyjnym Android
      • Dzienne dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych

Dane demograficzne

Wymiary demograficzne pomagają poznać przedział wiekowy i płeć odbiorców. Centrum pomocy YouTube zawiera dodatkowe informacje o danych demograficznych w raportach YouTube Analytics.

ageGroup (wymiar podstawowy)
Ten wymiar określa grupę wiekową zalogowanych użytkowników powiązanych z danymi w raporcie. Interfejs API wykorzystuje te grupy wiekowe:
  • 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.
płeć (wymiar podstawowy)
Ten wymiar pozwala określić płeć zalogowanych użytkowników powiązanych z danymi w raporcie. 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 używają wymiarów demograficznych:

  • Przykłady kanałów

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

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

    • Dane demograficzne
      • Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)
      • Dane demograficzne użytkownikó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óra została użyta do udostępnienia filmów. Filmy można udostępniać w YouTube (lub za pomocą odtwarzacza YouTube) przy użyciu przycisku „Udostępnij”. This is a core dimension and is subject to the Deprecation Policy.

W tej tabeli znajdziesz prawidłowe wartości wymiarów:
Platforma Wartość interfejsu API
Ameba AMEBA
Poczta e-mail w Androidzie ANDROID_EMAIL
Messenger na Androidzie ANDROID_MESSENGER
Wiadomości na Androida ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
Kopiuj do schowka COPY_PASTE
Cyjan CYWORLD
Digg DIGG
Dropbox DROPBOX
Umieść EMBED
Wysyłając e-mailem MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Strony na Facebooku FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+. GOOGLEPLUS
Wyślij SMS-a GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC – SMS HTC_MMS
Odebrane Google INBOX
Okno aktywności systemu iOS IOS_SYSTEM_ACTIVITY_DIALOG
Historia KAKAO KAKAO_STORY
kakao (kakao talk) KAKAO
kik KIK
E-mail LGE LGE_EMAIL
Liniowy LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Korzystając z Udostępniania w pobliżu NEARBY_SHARE
Nowy Rok NUJIJ
Odnoklasniki ODNOKLASSNIKI
Inny OTHER
Pinterest PINTEREST
Rakuten (楽天Landing場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skała SKYBLOG
Rozmowy Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Wysyłając SMS-a TEXT_MESSAGE
turecki TUENTI
Tumblr. TUMBLR
Twitter TWITTER
Brak informacji UNKNOWN
Wiadomości Verizon VERIZON_MMS
Viber VIBER
Vkontakte (УКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Przenoszenie linków do podstron 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 używają wymiarów społecznościowych:

  • Przykłady kanałów

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

Utrzymanie uwagi odbiorców

elapsedVideoTimeRatio
Ten wymiar określa stosunek długości filmu do długości filmu. Wymiary i dane dotyczące wykorzystania są wykorzystywane do mierzenia utrzymania uwagi odbiorców w czasie, a wymiar elapsedVideoTimeRatio to pomiar czasu. Na przykład wartość 0.4 wskazuje, że odpowiednie dane raportu zawierają dane na temat utrzymania uwagi po upływie 40% filmu.

Interfejs API zwraca 100 punktów danych dla każdego filmu o wartościach od 0.01 do 1.0. Czas, w jakim dane są mierzone podczas odtwarzania filmu, jest w równym stopniu rozmieszczony. Oznacza to, że w przypadku 2-minutowych filmów odstęp między punktami danych wynosi 1,2 sekundy. W przypadku 2-godzinnego filmu odstęp między punktami danych wynosi 72 sekundy. Wartość wymiaru oznacza wyłączny koniec przedziału czasu.
audienceType (tylko filtr)
Wartość wymiaru określa typ ruchu powiązanego z danymi w raporcie. Obsługiwane wartości to ORGANIC, AD_INSTREAM i AD_INDISPLAY. Wyjaśnienie typów źródeł wizyt znajdziesz w Centrum pomocy YouTube.

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

Przykłady

Te przykładowe żądania używają wymiarów utrzymania uwagi odbiorców:

Skuteczność reklamy

typ reklamy
Wymiar adType jest używany w raportach skuteczności reklam i agreguje żądane dane na podstawie typów reklam wyświetlanych podczas odtwarzania filmów. Możliwe wartości wymiarów znajdziesz na liście poniżej. Więcej informacji o formatach reklam w YouTube znajdziesz w Centrum pomocy YouTube.

  • auctionBumperInstream – reklamy niemożliwe do pominięcia, sprzedawane na aukcji, trwające do 6 sekund, które należy obejrzeć przed wyświetleniem filmu.

  • auctionDisplay – reklama multimedialna lub graficzna, która wyświetla się w formie nakładki u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub w obu tych formach. Nakładka jest zamykana automatycznie po upływie określonego czasu, a użytkownik może ją zamknąć. Jeśli nakładka i baner są widoczne razem, każda reklama jest liczona jako osobne wyświetlenie.

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

  • auctionTrueviewInslate – widz wybiera jedną z kilku opcji reklamy wyświetlanych przed filmem. See the TrueView documentation for more information.

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

  • auctionUnknown – reklama kupiona w ramach aukcji AdWords, która nie została zaklasyfikowana do żadnego z pozostałych typów reklam.

  • reservedBumperInstream – reklamy wideo niemożliwe do pominięcia, sprzedawane na zasadzie rezerwacji, o długości do 6 sekund, które należy obejrzeć przed wyświetleniem 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 zainicjował odtwarzanie. Są one kupowane na zasadzie rezerwacji.

  • reservedDisplay – reklama multimedialna lub graficzna, która wyświetla się w formie nakładki u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub w obu tych formach. Nakładka jest zamykana automatycznie po upływie określonego czasu, a użytkownik może ją zamknąć. Jeśli nakładka i baner są widoczne razem, każda reklama jest liczona jako osobne wyświetlenie.

  • reservedInstream – reklamy wideo niemożliwe do pominięcia, które są wstawiane przed głównym filmem, w jego trakcie lub po nim

  • reservedInstreamSelect

  • reservedMasthead – duża reklama zawierająca elementy graficzne i wideo, która pojawia się na stronie głównej.

  • reservedUnknown – reklama, która została sprzedana na zasadzie rezerwacji i nie można jej zaklasyfikować do żadnego z pozostałych typów reklam.

  • unknown – nie można sklasyfikować tego typu reklamy.

Przykłady

Te przykładowe raporty pobierają dane o skuteczności reklamy lub przychodach:

  • Przykłady kanałów

    • Przychody/reklamy
      • Dane o przychodach kanału i skuteczności reklam
      • Dzienne dane o przychodach i skuteczności reklam
      • Dane o przychodach i skuteczności reklam w poszczególnych krajach
      • 10 najpopularniejszych filmów – największe przychody
      • Dane o skuteczności różnych typów reklam

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

    • Przychody/reklamy
      • Dane o przychodach i skuteczności reklam w treściach objętych roszczeniem
      • Dzienne dane o przychodach i skuteczności reklam
      • Dane o przychodach i skuteczności reklam w poszczególnych krajach
      • 10 najpopularniejszych filmów – największe przychody
      • Dane o skuteczności różnych typów reklam

w playlistach.

wygenerowany (tylko filtr)
Ten filtr wskazuje, że żądanie pobiera dane o wyświetleniach filmów, które wystąpiły w kontekście playlisty. Ten filtr jest wymagany w przypadku każdego raportu dotyczącego playlisty, a jego wartość musi być ustawiona na 1.

Przykłady

Wszystkie przykładowe żądania, które pobierają raporty o playlistach, korzystają z filtra isCurated.

Wymiary właściciela treści

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

Ważne: żądania API dotyczące pobierania raportów o właścicielu treści muszą filtrować dane za pomocą jednego z tych wymiarów:
  • video
  • channel
  • Obsługiwane kombinacje wymiarów claimedStatus i uploaderType, jak określono poniżej.
statusstatus (tylko w raportach właściciela treści),
Ten wymiar wskazuje, że odpowiedź interfejsu API powinna zawierać tylko dane dotyczące treści objętych roszczeniem. Jedyna prawidłowa wartość to claimed. Jeśli parametr filters ogranicza zapytanie do claimedStatus==claimed, interfejs API pobierze tylko dane dotyczące treści objętych roszczeniem. Tabela w definicji wymiaru uploaderType zawiera więcej informacji o tym, jak go używać.
przesyłającType (wymiar podstawowy) (używany tylko w raportach właściciela treści)
Ten wymiar pozwala określić, czy odpowiedź interfejsu API powinna zawierać dane dotyczące treści przesłanych przez właściciela treści i/lub treści innych firm, takich jak filmy przesłane przez użytkowników. Prawidłowe wartości to self i thirdParty. To jest wymiar podstawowy i podlega Zasadom wycofywania.

Poniższa tabela zawiera obsługiwane kombinacje wymiarów claimedStatus i uploaderType, które są używane w parametrze filters:

Wartość: claimedStatus Wartość: uploaderType Opis
[Nie wybrano] sobie Pobiera dane ze Statystyk YouTube dotyczące treści objętych roszczeniem i treści nieobjętych roszczeniem, które zostały przesłane przez właściciela treści.
objęte roszczeniem [Nie wybrano] Pobiera dane dla treści objętych roszczeniem przesłanych przez właściciela treści lub osobę trzecią.
objęte roszczeniem sobie Pobiera dane dla treści przesłanych przez właściciela treści.
objęte roszczeniem osoba trzecia Pobiera dane dotyczące treści objętych roszczeniem przesłanych przez osoby trzecie.

Przykłady

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