Dimensions

Ten dokument zawiera definicje wymiarów obsługiwanych w interfejsie YouTube Analytics API. Ten interfejs API obsługuje kierowane zapytania w czasie rzeczywistym w celu generowania niestandardowych raportów Statystyk YouTube.

Wymiary to typowe kryteria stosowane do gromadzenia danych, takie jak data aktywności użytkownika lub kraj, w którym się oni znajdują.

Każdy raport o zapytaniach wskazuje wymiary, które obsługuje. Na przykład podczas pobierania aktywności użytkownika według czasu wybierasz okres, dla 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 z zapytania, wywołaj metodę reports.query interfejsu YouTube Analytics API. W swoim żądaniu użyj parametru dimensions, aby określić wymiary, których YouTube będzie używać do obliczania wartości danych w raportach.

Podstawowe wymiary

Chociaż interfejs YouTube Analytics API podlega zasadom wycofywania określonym Warunki korzystania z usługi. Wymiary inne niż podstawowe (oraz inne dane) nie są dozwolone zgodnie z zasadami. W definicjach na tej stronie każdy wymiar, który jest wymiarem podstawowym, wyraźnie określonych jako takie.

Na liście poniżej znajdziesz podstawowe wymiary interfejsu API.

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

Filtry

Wszystkie raporty zapytań obsługują filtry. Filtry identyfikują wartości wymiarów, które muszą być obecne w pobranym zbiorze danych. W związku z tym ograniczają one odpowiedź interfejsu API do uwzględniania tylko 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, by pobrać tylko dane dla konkretnego kraju.

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

Ważne: żądania do interfejsu API umożliwiające pobieranie raportów właściciela treści muszą filtrować dane za pomocą jednego z wymiarów jednostki raportowania lub obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

Wymiary

W poniższych sekcjach znajdziesz wymiary używane w raportach dotyczących zapytań w interfejsie YouTube Analytics API. O ile nie zaznaczono inaczej, te wymiary są używane zarówno w raportach dotyczących kanału, jak i właściciela treści. Wskazano także 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, jeśli są one używane jako filtry. Aby to zrobić, jako wartość parametru filters ustaw rozdzieloną przecinkami listę identyfikatorów filmów, playlist lub kanałów, według których odpowiedź interfejsu API ma być filtrowana. Wartość parametru może zawierać maksymalnie 500 identyfikatorów.

wideo (wymiar podstawowy)
Identyfikator filmu w YouTube. W interfejsie YouTube Data API jest to wartość elementu video. właściwości id zasobu. 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.
channel (wymiar podstawowy) (używany tylko w raportach właścicieli treści)
Identyfikator kanału 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ż zwykle zbierają one dane z wielu kanałów.
grupa (tylko filtr)
Identyfikator grupy w YouTube Analytics. Tę wartość można pobrać za pomocą metody groups.list interfejsu YouTube Analytics API. Jeśli używasz filtra group, odpowiedź interfejsu API zawiera dane dotyczące wszystkich filmów, playlist lub kanałów w danej grupie.

Przykłady

Te przykładowe żądania używają wymiarów lub filtrów encji raportujących:

  • Przykłady kanałów

    • Podstawowe statystyki
      • 10 najpopularniejszych – najczęściej oglądanych filmów na kanale
      • Top 10 – współczynniki klikalności adnotacji najczęściej oglądanych filmach na kanale
      • Statystyki konkretnej playlisty
      • 10 – najczęściej oglądane playlisty na kanale
    • Położenie geograficzne
      • 10 najpopularniejszych – najczęściej oglądanych filmów w danym kraju
      • 10 najpopularniejszych filmów w Europie

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

    • Podstawowe statystyki
      • 10 najpopularniejszych – najczęściej oglądanych filmów przez właściciela treści
      • 10 najpopularniejszych – najczęściej oglądanych filmów przez właściciela treści
      • 10 najpopularniejszych – najczęściej oglądanych filmów na kanale właściciela treści
      • Top 10 – współczynniki klikalności adnotacji najczęściej oglądanych filmach na kanale
      • 10 – najczęściej oglądane playlisty właściciela treści
    • Położenie geograficzne
      • 10 najpopularniejszych – najczęściej oglądanych filmów w Europie przez właściciela treści
      • 10 – najczęściej słuchane playlisty w Stanach Zjednoczonych

Obszary geograficzne

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

kraj (wymiar podstawowy)
Kraj powiązany z danymi w wierszu raportu. Wartością wymiaru jest dwuliterowy kod kraju zgodny ze standardem 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 terytorium USA powiązane z danymi w wierszu raportu. Wartością wymiaru jest kod ISO 3166-2, który identyfikuje stan w 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 w USA. Jeśli żądanie interfejsu API zawiera w wartości parametru dimensions wartość province, żądanie musi też ograniczać dane do Stanów Zjednoczonych przez uwzględnienie country==US w wartości parametru filters.

Uwaga: ten wymiar nie obsługuje wartości ISO 3166-2, które identyfikują obszary oddalone o USA, ponieważ te terytoria mają też własne kody krajów w formacie ISO 3166-1. Nie obsługuje ona również podziałów krajów innych niż Stany Zjednoczone.

dma
3-cyfrowy identyfikator używany przez firmę Nielsen do identyfikowania rynku docelowego (DMA) powiązane ze zdarzeniami wyświetlania opisanymi w wierszu danych.
city
Szacunkowe miasto powiązane z danymi w wierszu raportu. Dane dotyczące tego wymiaru są dostępne dla dat od 1 stycznia 2022 r.
kontynent (tylko filtr)
Kod regionu statystycznego ONZ. Interfejs API obsługuje następujące wartości:
Wartości
002 Afryka
019 Ameryka Północna i Południowa (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żywać tego wymiaru, ustaw wartość parametru filters parametr do continent==REGION_CODE, określając wartość REGION_CODE z tabeli.
subContinent (tylko filtr)
Kod statystyczny ONZ identyfikujący podregion geograficzny. Wydział Statystyczny ONZ wyświetla listę podregionów i krajów, które z nimi są powiązane.

Tego wymiaru można używać tylko do filtrowania danych. Aby używać 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 używają wymiarów lub filtrów geograficznych:

  • Przykłady kanałów

    • Podstawowe statystyki: liczba wyświetleń kanału w poszczególnych krajach i inne informacje.
    • Położenie geograficzne
      • Dane o czasie oglądania filmów na kanale w poszczególnych krajach
      • Dane dotyczące adnotacji do filmów na kanale w poszczególnych krajach
      • Dane dotyczące poszczególnych prowincji w Stanach Zjednoczonych i Waszyngtonie
      • Dane o czasie oglądania playlist z kanału w zależności od kraju
      • 10 – najczęściej słuchane playlisty w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Źródło wizyt: liczba wyświetleń i czas oglądania 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 – najczęściej oglądanych filmów w danym kraju
      • 10 najpopularniejszych filmów w Europie

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

    • Podstawowe statystyki: liczba wyświetleń (i inne) w poszczególnych krajach liczba wyświetleń wszystkich filmów przesłanych przez Ciebie
    • Położenie geograficzne
      • Dane o czasie oglądania treści przesłanych samodzielnie w poszczególnych krajach
      • Dane dotyczące adnotacji związanych z krajem w przypadku treści przesyłanych przez siebie
      • Dane dotyczące poszczególnych prowincji w Stanach Zjednoczonych i Waszyngtonie
      • Dane o czasie oglądania w poszczególnych krajach dotyczące playlist właściciela treści
      • 10 – najczęściej słuchane 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: 10 najpopularniejszych – najczęściej oglądanych filmów w Europie przez właściciela treści
    • Przychody/skuteczność reklam: dane o przychodach i skuteczności reklam w poszczególnych krajach.

Okresy

Wymiary te wskazują, że raport powinien gromadzić dane z określonego przedziału czasu, np. dnia, tygodnia lub miesiąca. Parametry żądania startDate i endDate określają okres, z którego raport zawiera dane. Zwróć uwagę, że raport zwraca dane maksymalnie do ostatniego dnia, dla którego są dostępne wszystkie dane określone w żądaniu w momencie wykonania zapytania. Daty w raportach są podawane w formacie YYYY-MM-DD.

Ważne: wszystkie daty odnoszą się do okresu rozpoczynającego się o 00:00 czasu pacyficznego (UTC-7 lub UTC-8) i kończącego o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W związku z tym daty, dla których zegary są przesuwane do przodu w stosunku do czasu letniego, przedstawiają okres 23 godzin, a daty cofnięcia zegarów przedstawiają okres 25 godzin.

Wymiar miesiąc odnosi się do okresu rozpoczynającego się o 00:00 czasu pacyficznego (UTC-7 lub UTC-8) pierwszego dnia określonego 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 jednego dnia. Możesz użyć innych wymiarów, aby jeszcze bardziej uszczegółowić dane. Raport o źródłach wizyt może na przykład łączyć dzienne statystyki wyświetleń na podstawie 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 segmentować dane. Daty w raporcie są podane 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 używają wymiarów lub filtrów czasowych:

  • Przykłady kanałów

    • Ograniczony czasowo
      • Dane dotyczące dziennego czasu oglądania filmów na kanale
      • Dzienne dane o adnotacjach do filmów na kanale
      • Dzienna liczba wyświetleń playlisty na kanale
    • 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 z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Dzienne dane o typie urządzeń z systemem operacyjnym Android
      • Dzienne dane o systemie operacyjnym urządzeń mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia

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

    • Na bazie czasu
      • Dane o dziennym czasie oglądania treści przesłanych przez siebie
      • Dane dotyczące adnotacji do treści objętych roszczeniem
      • Dzienna liczba wyświetleń playlisty 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 z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Dzienne dane o typie 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 dane dotyczące systemu operacyjnego i typu urządzenia
    • Przychody/skuteczność reklam: dane dotyczące dziennych przychodów i skuteczności reklam.

Miejsca odtwarzania

Wymiary te zapewniają wgląd w informacje o stronie lub aplikacji, na której miała miejsce aktywność użytkownika.

insightPlaybackLocationType
Dane w raporcie są agregowane na podstawie typu strony lub aplikacji, w której doszło do odtworzenia filmu. Możliwe wartości tego wymiaru to:

  • BROWSE – dane opisują wyświetlenia, 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 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ą umieszczonego na stronie <iframe> lub <object>.

  • EXTERNAL_APP – dane opisują wyświetlenia, które miały miejsce w aplikacji innej firmy, w przypadku której film został odtworzony przy użyciu metody innej niż osadzona za pomocą <iframe> lub <object>. Na przykład odtworzenia w aplikacjach, które korzystają z interfejsu YouTube Android Player API, będą klasyfikowane za pomocą tej wartości.

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

    Od 10 września 2013 r. w raportach YouTube Analytics odtworzenia nie są już zaliczane do MOBILE odtworzeń. Ta wartość może pozostać w raportach, ponieważ do tej kategorii należą nadal starsze dane. Jednak po tej dacie odtworzenia na urządzeniu mobilnym będą klasyfikowane jako WATCH, EMBEDDED lub EXTERNAL_APP, w zależności od typu aplikacji, w której mają miejsce.

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

  • WATCH – dane opisują wyświetlenia, które miały miejsce na stronie odtwarzania filmu w YouTube lub w oficjalnej aplikacji YouTube, np. w aplikacji YouTube na Androida.

  • YT_OTHER – dane opisują widoki, które nie są sklasyfikowane w inny sposób.

insightPlaybackLocationDetail
Dane są agregowane na podstawie strony, na której znajduje się odtwarzacz. Pamiętaj, że ten raport jest obsługiwany wyłącznie w przypadku wyświetleń filmów w odtwarzaczach umieszczonych na stronach i wskazuje odtwarzacze, które wygenerowały najwięcej wyświetleń dla określonego filmu. Zapewnia więc bardziej szczegółowy widok niż raport o miejscach odtwarzania, ponieważ identyfikuje adresy URL lub aplikacje powiązane z najpopularniejszymi odtwarzaczami umieszczonymi na stronie.

Przykłady

Poniższe przykładowe żądania używają wymiarów miejsca 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 – witryny zewnętrzne, które generują najwięcej wyświetleń umieszczonego filmu
      • liczbę wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;
      • dziennej liczby wyświetleń playlisty i czasu oglądania w różnych miejscach 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 miejsc odtwarzania
      • 10 – witryny zewnętrzne, które generują najwięcej wyświetleń umieszczonego filmu
      • liczbę wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;
      • dziennej liczby wyświetleń playlisty i czasu oglądania w różnych miejscach odtwarzania;

Szczegóły odtwarzania

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

Poniższa tabela zawiera wartości wymiarów:
Wartości
LIVE_STREAM Oglądane treści były transmisją na żywo w YouTube.
SHORTS Wyświetlony materiał to YouTube Short.
STORY Wyświetlone treści były prezentowane w ramach relacji w YouTube.
VIDEO_ON_DEMAND Wyświetlona treść to film w YouTube, który nie pasuje do żadnej z pozostałych wartości wymiaru.
UNSPECIFIED Typ treści wyświetlanych treści jest nieznany.
liveOrOnDemand
Ten wymiar wskazuje, czy dane o aktywności użytkownika zawarte w wierszu danych są powiązane z wyświetleniami transmisji na żywo. Dane dotyczące tego wymiaru są dostępne dla dat rozpoczynających się 1 kwietnia 2014 r.

Poniższa tabela zawiera wartości wymiarów:
Wartości
LIVE Dane w tym wierszu opisują aktywność użytkownika, która miała miejsce podczas transmisji na żywo.
ON_DEMAND Dane w tym wierszu opisują aktywność użytkowników, która nie miała miejsca podczas transmisji na żywo.
subscribedStatus
Ten wymiar wskazuje, czy zawarte w wierszu danych dane o aktywności użytkowników są powiązane z widzami, którzy zasubskrybowali kanał z filmem lub playlistą. Możliwe wartości to SUBSCRIBED i UNSUBSCRIBED.

Pamiętaj, że wartość wymiaru jest poprawna w chwili wystąpienia działania użytkownika. Załóżmy na przykład, że użytkownik nie subskrybuje kanału i ogląda filmy z tego kanału, a następnie tego samego dnia zasubskrybuje kanał i ogląda kolejny film. Raport z kanału wskazuje, że jeden widok ma subscribedStatus wartość SUBSCRIBED, a jeden widok ma subscribedStatus wartość UNSUBSCRIBED.
youtubeProduct
Ten wymiar określa usługę YouTube, w której wystąpiła aktywność użytkownika. Dane dotyczące tego wymiaru są dostępne od 18 lipca 2015 r.

Poniższa tabela zawiera wartości wymiarów:
Wartości
CORE Aktywność użytkowników, która nie miała miejsca w żadnej ze specjalistycznych aplikacji YouTube (YouTube Gaming, YouTube dla dzieci czy YouTube Music). Wyjątek: aktywność użytkownika, która miała miejsce w YouTube Music przed 1 marca 2021 r., jest uwzględniona w CORE.
GAMING Aktywność użytkowników miała miejsce w YouTube Gaming.
KIDS Aktywność użytkownika miała miejsce w YouTube Kids.
MUSIC Aktywność użytkownika miała miejsce w YouTube Music 1 marca 2021 r. lub później. Dane sprzed 1 marca 2021 r. są uwzględnione w 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 tym 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 został odesłany do filmu przez reklamę. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa typ reklamy.
  • ANNOTATION – widzowie dotarli do filmu, klikając adnotację w innym filmie.
  • CAMPAIGN_CARD – wyświetlenia pochodzą z filmów przesłanych przez użytkowników, które są objęte roszczeniem, i których właściciel treści użył do promowania wyświetlonej treści. To źródło wizyt jest obsługiwane tylko w przypadku raportów dla 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 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ą ze stron z hashtagami VOD lub stron z powiązanymi hashtagami Shorts.
  • LIVE_REDIRECT – wyświetlenia filmu pochodzą z Live Redirect.
  • NO_LINK_EMBEDDED – film był umieszczony w innej witrynie podczas jego wyświetlania.
  • NO_LINK_OTHER – YouTube nie zidentyfikował strony odsyłającej dla ruchu. Ta kategoria obejmuje bezpośredni ruch związany z filmem oraz ruch z aplikacji mobilnych.
  • NOTIFICATION – liczba wyświetleń filmu pochodzi z e-maila lub powiadomienia z YouTube.
  • PLAYLIST – wyświetlenia filmu miały miejsce podczas odtwarzania go w ramach playlisty. Uwzględnia też wizyty ze strony playlisty.
  • PRODUCT_PAGE – wyświetlenia filmu pochodzą ze strony produktu.
  • PROMOTED – wyświetlenia filmu pochodzą z bezpłatnej promocji w YouTube, np. „Wyróżnione filmy” w YouTube stronę.
  • RELATED_VIDEO – wyświetlenia filmu pochodzą z listy podobnych filmów na stronie odtwarzania innego filmu. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa identyfikator tego filmu.
  • SHORTS – widz został odesłany, przesuwając palcem w pionie od poprzedniego filmu w oknie Shorts.
  • SOUND_PAGE – wyświetlenia pochodzą ze stron z powiązanymi Shorts dotyczącymi dźwięku.
  • SUBSCRIBER – wyświetlenia filmu pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji w YouTube. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa elementy kanału na stronie głównej lub inną stronę, z której pochodziły odwołania.
  • YT_CHANNEL – wyświetlenia filmu miały miejsce na stronie kanału. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa identyfikator tego kanału.
  • YT_OTHER_PAGE – wyświetlenia filmu pochodzą z linku innego niż wynik wyszukiwania lub link do podobnego filmu, który wyświetlił się na stronie YouTube. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail wskazuje stronę.
  • YT_SEARCH – wyświetlenia filmów pochodzą z wyników wyszukiwania w YouTube. Jeśli filtrujesz na podstawie 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 na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa film, z którego trafił użytkownik.
insightTrafficSourceDetail
Dane w raporcie są agregowane na podstawie stron odsyłających, które wygenerowały najwięcej wyświetleń określonego filmu, oraz 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. Lista zawiera informacje dostarczane przez wymiar insightTrafficSourceDetail w przypadku poszczególnych źródeł wizyt.
  • ADVERTISING – typ reklamy, który doprowadził do wyświetlenia. Możliwe wartości to:
    • Reklama angażująca typu „kliknij, aby odtworzyć”
    • Reklama angażująca
    • Reklamy w wyszukiwarce Google
    • Reklama wideo na stronie głównej
    • Zarezerwowana reklama In-Stream możliwa 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 raporcie.
  • EXT_URL – witryna, która odesłała widzów do filmu.
  • HASHTAGS – hashtag, który doprowadziły do wyświetlenia filmu.
  • NOTIFICATION – e-mail lub powiadomienie, z których pochodzi odesłanie ruchu.
  • RELATED_VIDEO – podobny film, który doprowadził widzów do filmu omawianego w raporcie.
  • SOUND_PAGE – film, który doprowadził do wyświetleń.
  • SUBSCRIBER – element na stronie głównej lub funkcja subskrypcji w YouTube, która doprowadziła widzów do filmu uwzględnionego w raporcie. Prawidłowe wartości to:
    • activity – wyświetlenia z elementów na kartach subskrypcji na stronie głównej, niezwiązane z przesyłaniem filmów ani kontaktowaniem się z innymi użytkownikami. Obejmuje to polubienia, dodawanie do ulubionych, posty w biuletynach i dodawanie playlist.
    • blogged – wyświetlenia z elementów w kanałach subskrypcji na stronie głównej, które pochodzą z linków z najpopularniejszych blogów.
    • mychannel – wyświetlenia z elementów w innych kanałach wymienionych na stronie głównej, np. „polubienia”, „Historia oglądania”, i „Do obejrzenia”.
    • podcasts – wyświetlenia pochodzące z elementów na stronie docelowej Podcastów.
    • sdig – wyświetlenia pochodzące z e-maili z powiadomieniami o subskrypcjach.
    • uploaded – wyświetlenia z uploaded elementów w kanałach subskrypcji na stronie głównej.
    • / – inne wyświetlenia pochodzące ze strony głównej YouTube.
    • /my_subscriptions – wyświetlenia, które pochodzą od użytkowników Strony 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 doprowadziło widzów do filmu.
  • VIDEO_REMIXES – film, który doprowadził do wyświetleń.

Przykłady

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

  • Przykłady kanałów

    • Źródło wizyt
      • liczbę wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju;
      • Dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt
      • 10 najpopularniejszych – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla filmu
      • 10 najpopularniejszych – wyszukiwane w Google hasła, które generują najwięcej ruchu dla filmu
      • liczbę wyświetleń playlisty i czas oglądania z różnych źródeł wizyt w danym kraju;
      • Liczba wyświetleń playlisty 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
      • Dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt
      • 10 najpopularniejszych – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla filmu
      • 10 najpopularniejszych – wyszukiwane w Google hasła, które generują najwięcej ruchu dla filmu
      • liczbę wyświetleń playlisty i czas oglądania z różnych źródeł wizyt w danym kraju;
      • Liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

Urządzenia

deviceType
Ten wymiar określa format urządzenia, na którym film został wyświetlony. Poniższa lista zawiera typy urządzeń, w przypadku których interfejs API zwraca dane. Możesz też użyć wymiaru deviceType jako filtra, aby w raporcie o systemie operacyjnym znajdowały się tylko dane o urządzeniach określonego typu.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Ten wymiar określa system oprogramowania urządzenia, na którym wyświetlono reklamę. Poniższa lista zawiera systemy operacyjne, w przypadku których interfejs API zwraca dane. Możesz też użyć parametru operatingSystem jako filtra, aby w raporcie o typie urządzenia znalazły się tylko dane o konkretnym systemie operacyjnym.
  • 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 związanych z urządzeniami:

  • Przykłady kanałów

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

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

    • Urządzenie/system operacyjny
      • Dzienne dane o typie 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 dane dotyczące systemu operacyjnego i typu urządzenia
      • Dzienne dane o typie urządzenia w przypadku wyświetleń playlist 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ć Twoich 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 z raportu. Interfejs API wykorzystuje następujące 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 określa płeć zalogowanych użytkowników powiązanych z danymi z 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

W tych przykładowych żądaniach używane są wymiary demograficzne:

  • Przykłady kanałów

    • Dane demograficzne
      • Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)
      • Dane demograficzne widzó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 widzów playlisty w Kalifornii (grupa wiekowa i płeć)

Zaangażowanie i udostępnianie treści

sharingService (wymiar podstawowy)
Ten wymiar określa usługę używaną do udostępniania filmów. Filmy można udostępniać w YouTube (lub za pomocą odtwarzacza YouTube) za pomocą linku „Udostępnij” Przycisk This is a core dimension and is subject to the Deprecation Policy.

Poniższa tabela zawiera prawidłowe wartości wymiarów:
Platforma Wartość interfejsu API
Ameba AMEBA
E-mail dotyczący Androida ANDROID_EMAIL
Czat na Androida ANDROID_MESSENGER
Wiadomości na Androidzie ANDROID_MMS
Komunikator BlackBerry 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
Wyślij SMS-a GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
SMS HTC HTC_MMS
Skrzynka odbiorcza Google INBOX
Okno aktywności systemu iOS IOS_SYSTEM_ACTIVITY_DIALOG
Historia KAKAO KAKAO_STORY
kakao (kakao Talk) KAKAO
Kik KIK
Adres e-mail LGE 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 (楽天 zalogowany場) 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 używają wymiarów społecznościowych:

  • Przykłady kanałów

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

Utrzymanie uwagi odbiorców

elapsedVideoTimeRatio
Ten wymiar określa stosunek długości fragmentu filmu do jego długości. Wymiary i dane dotyczące utrzymania służą do pomiaru utrzymania uwagi odbiorców na przestrzeni czasu, a wymiar elapsedVideoTimeRatio to pomiar czasu. Na przykład wartość 0.4 oznacza, że odpowiednie dane do raportu zawierają dane dotyczące utrzymania uwagi odbiorców po upłynięciu 40% filmu.

Interfejs API zwraca po 100 punktów danych dla każdego filmu o współczynnikach proporcji z zakresu od 0.01 do 1.0. Czasy pomiaru danych podczas odtworzeń filmów są w równych odstępach czasu. Oznacza to, że w przypadku 2-minutowego filmu odstęp między punktami danych wynosi 1,2 sekundy. Jednak w przypadku 2-godzinnego filmu odstęp między punktami danych wynosi 72 sekundy. Wartość wymiaru wskazuje wyłączny koniec przedziału.
audienceType (tylko filtr)
Wartość wymiaru określa typ ruchu powiązanego z danymi z raportu. Obsługiwane wartości to ORGANIC, AD_INSTREAM oraz AD_INDISPLAY. Informacje 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 dla zapytań, które korzystają z filtra w celu pobrania danych z wcześniejszych dat. Zapytania bez filtra działają po 1 lipca 2008 roku.

Przykłady

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

Transmisje na żywo

livestreamPosition
Ten wymiar określa konkretną minutę podczas transmisji na żywo. Dane raportu wskazują, ilu użytkowników oglądało transmisję w tym czasie.

Anulowanie subskrypcji

membershipsCancellationSurveyReason
Liczba ankiet wypełnionych przez użytkowników YouTube, którzy anulowali wspieranie kanału wybranego kanału w okresie raportowania. Prawidłowe wartości wymiaru są wymienione w tej tabeli:
Wartość interfejsu API Wyjaśnienie
UNKNOWN Użytkownik nie wypełnił ankiety.
DISLIKE_PERKS Użytkownikowi nie podobają się bonusy dostępne w ramach wspierania.
PERKS_NOT_DELIVERED Użytkownik obiecał, że bonusy dla wspierających nie zostały dostarczone.
CANNOT_ACCESS_PERKS Użytkownik nie miał dostępu do bonusów.
NO_LONGER_INTERESTED Użytkownik przestaje być zainteresowany wspieraniem kanału.
FEEL_UNAPPRECIATED Użytkownik poczuł się niedoceniany jako wspierający kanał.
FINANCIAL_REASONS Użytkownik anulował subskrypcję z przyczyn finansowych.
JOIN_LIMITED_TIME Użytkownik zamierzał dołączyć tylko przez ograniczony czas.
OTHER Użytkownik miał inny powód anulowania subskrypcji.

Skuteczność reklamy

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

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

  • auctionDisplay – reklama multimedialna lub graficzna, która wyświetla się jako nakładka u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych opcji. Po uruchomieniu nakładka zamyka się automatycznie po upływie określonego czasu, a użytkownik może ją zamknąć. Jeśli nakładka i baner wyświetlają się 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 reklam wideo spośród kilku opcji dostępnych 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 zakupiona na aukcji AdWords, która nie została zaklasyfikowana do żadnego z pozostałych typów reklamy.

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

  • reservedDisplay – reklama multimedialna lub graficzna, która wyświetla się jako nakładka u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych opcji. Po uruchomieniu nakładka zamyka się automatycznie po upływie określonego czasu, a użytkownik może ją zamknąć. Jeśli nakładka i baner wyświetlają się 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, która może zawierać film i elementy graficzne, wyświetlana na stronie głównej.

  • reservedUnknown – reklama sprzedana na zasadzie rezerwacji, której nie udało się zaklasyfikować do żadnego innego typu reklamy.

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

Przykłady

Te przykładowe raporty zawierają dane o skuteczności reklam lub przychodach:

  • Przykłady kanałów

    • Przychody/reklamy
      • Dane dotyczące przychodów kanału i skuteczności reklam
      • Dane o dziennych przychodach i skuteczności reklam
      • Dane o przychodach i skuteczności reklam w poszczególnych krajach
      • 10 najlepszych – filmy z najwyższymi przychodami
      • Dane o skuteczności różnych typów reklam

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

    • Przychody/reklamy
      • Dane o przychodach i skuteczności reklam dotyczące treści objętych roszczeniem
      • Dane o dziennych przychodach i skuteczności reklam
      • Dane o przychodach i skuteczności reklam w poszczególnych krajach
      • 10 najlepszych – filmy z najwyższymi przychodami
      • Dane o skuteczności różnych typów reklam

Playlisty

isCurated (tylko filtr)
Ten filtr wskazuje, że żądanie pobiera dane o wyświetleniach filmów, które wystąpiły w w kontekście playlisty.

Przykłady

Wszystkie przykładowe żądania, które pobierają raporty dotyczące playlist, używają filtra isCurated.

Wymiary właściciela treści

Podane niżej wymiary są obsługiwane tylko w przypadku raportów dla właścicieli treści.

Ważne: żądania do interfejsu API umożliwiające pobieranie raportów właściciela treści muszą filtrować dane za pomocą jednego z tych wymiarów:
  • video
  • channel
  • Obsługiwana kombinacja wymiarów claimedStatus i uploaderType, jak określono poniżej.
claimStatus (używany tylko w raportach właściciela treści);
Ten wymiar pozwala wskazać, ż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 będzie pobierać dane tylko o treściach objętych roszczeniem. Więcej informacji o korzystaniu z tego wymiaru znajdziesz w tabeli w definicji wymiaru uploaderType.
UploadType (wymiar podstawowy) (używany tylko w raportach właścicieli treści)
Ten wymiar umożliwia wskazanie, czy odpowiedź interfejsu API powinna zawierać dane dotyczące treści przesłanych przez określonego właściciela treści lub treści przesłanych przez osoby trzecie, np. filmów przesłanych przez użytkowników. Prawidłowe wartości to self i thirdParty. To jest podstawowy wymiar, który podlega Zasadom wycofywania.

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

Wartość: claimedStatus Wartość: uploaderType Opis
[Nie wybrano] ja Pobiera dane ze 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 objętych roszczeniem przesłanych przez ich właściciela lub osobę trzecią.
objęte roszczeniem ja Pobiera dane dotyczące treści objętych roszczeniem, które zostały przesłane 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ń do interfejsu API używanych w raportach właścicieli treści korzysta z obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.