Dimensions

W tym dokumencie opisujemy wymiary, które obsługuje 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 używane do zbierania danych, takie jak data aktywności użytkownika lub kraj, w którym znajdują się użytkownicy.

Każdy raport o zapytaniach określa obsługiwane wymiary. Na przykład podczas pobierania aktywności użytkownika według czasu możesz wybrać okres, za który dane będą raportowane: dzień lub miesiąc. W każdym raporcie każdy wiersz danych zawiera unikalną kombinację wartości wymiarów.

Aby pobrać raport zapytań, 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

Mimo że interfejs YouTube Analytics API podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, wymiary inne niż podstawowe (i dane spoza podstawowego zestawu) nie podlegają tym zasadom. W definicjach na tej stronie każdy wymiar będący wymiarem podstawowym jest wyraźnie wskazany jako taki.

Na poniższej liście wymieniono podstawowe wymiary interfejsu API.

Zobacz listę interfejsów API YouTube, które podlegają zasadom wycofywania, aby dowiedzieć się więcej.

Filtry

Wszystkie raporty zapytań obsługują filtry. Filtry identyfikują wartości wymiarów, które muszą być obecne w pobranym zbiorze danych. Dlatego 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, aby pobrać dane tylko dla określonego kraju.

W żądaniu pobrania raportu z zapytań opcjonalny parametr żądania filters określa wartości wymiarów, według których chcesz filtrować dane. Aby np. pobierać dane o aktywności użytkowników dla Europy, ustaw wartość parametru filters na continent==150.

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

Wymiary

Poniższe sekcje zawierają definicję wymiarów używanych w raportach zapytań interfejsu YouTube Analytics API. O ile nie wskazano inaczej, te wymiary są używane zarówno w raportach dotyczących kanałów, jak i właścicieli treści. Identyfikowane są też wymiary, których można używać tylko jako filtrów.

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, jeśli są one używane jako filtry. Aby to zrobić, jako wartość parametru filters podaj oddzieloną przecinkami listę identyfikatorów filmów, playlist lub kanałów, w przypadku których chcesz filtrować 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) (używany tylko w raportach dotyczących 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 zawierają one dane zbiorcze z wielu kanałów.
grupa (tylko filtr)
Identyfikator grupy w Statystykach YouTube. Możesz pobrać tę wartość, korzystając z metody groups.list w YouTube Analytics API. Gdy użyjesz filtra group, odpowiedź interfejsu API będzie zawierała dane dotyczące wszystkich filmów, playlist i kanałów w danej grupie.

Przykłady

Te przykładowe żądania używają wymiarów lub filtrów elementów raportowania:

  • Przykłady kanałów

    • Podstawowe statystyki
      • 10 najpopularniejszych filmów na kanale
      • 10 najpopularniejszych – współczynniki klikalności adnotacji dla najczęściej oglądanych filmów na kanale
      • Statystyki konkretnej playlisty
      • 10 najpopularniejszych playlist – najczęściej oglądane playlisty na kanale
    • Zgodnie z danymi geograficznymi
      • 10 najpopularniejszych – najczęściej oglądane filmy w konkretnym kraju
      • Top 10 – najczęściej oglądane filmy w Europie

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

    • Podstawowe statystyki
      • 10 najpopularniejszych filmów – najczęściej oglądane filmy 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 – współczynniki klikalności adnotacji dla najczęściej oglądanych filmów na kanale
      • 10 najpopularniejszych – najczęściej oglądane playlisty właściciela treści
    • Zgodnie z danymi geograficznymi
      • 10 najlepszych filmów – najczęściej oglądane filmy w Europie przez właściciela treści
      • Top 10 – najczęściej tworzone playlisty w Stanach Zjednoczonych

Obszary geograficzne

Te wymiary określają region geograficzny powiązany z aktywnością użytkowników, skutecznością reklam lub szacunkowymi 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 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 do interfejsu API zawiera w wartości parametru dimensions ciąg province, musi ono także ograniczać dane do Stanów Zjednoczonych, uwzględniając country==US w wartości parametru filters.

Uwaga: ten wymiar nie obsługuje wartości ISO 3166-2, które określają odległe obszary Stanów Zjednoczonych, ponieważ te terytoria również mają własne kody krajów w formacie ISO 3166-1. Narzędzie to nie obsługuje również podziałów w krajach 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 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, wskazując wartość REGION_CODE z powyższej listy.
subContinent (tylko filtr)
Kod regionu statystycznego ONZ, który określa podregion geograficzny. Dział Statystyczny ONZ zawiera listę podregionów oraz krajów, które są z nimi powiązane.

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 organizacji ONZ.

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 wiele innych.
    • Zgodnie z danymi geograficznymi
      • Dane o czasie oglądania filmów na kanale w poszczególnych krajach
      • Dane adnotacji dotyczące filmów na kanale dostosowane do poszczególnych krajów
      • Dane regionalne dotyczące stanów USA i Waszyngtonu.
      • Dane o czasie oglądania playlist kanału w poszczególnych krajach
      • Top 10 – najczęściej tworzone playlisty w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania.
    • Źródło wizyt: liczby 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ądane filmy w konkretnym kraju
      • Top 10 – najczęściej oglądane filmy w Europie

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

    • Podstawowe statystyki: liczby wyświetleń wszystkich przesłanych samodzielnie filmów w poszczególnych krajach i inne informacje.
    • Zgodnie z danymi geograficznymi
      • Dane o czasie oglądania treści przesłanych samodzielnie w poszczególnych krajach
      • Wskaźniki adnotacji dotyczące treści przesłanych samodzielnie zależnie od kraju
      • Dane regionalne dotyczące stanów USA i Waszyngtonu.
      • Dane o czasie oglądania playlist właściciela treści w poszczególnych krajach
      • Top 10 – najczęściej tworzone playlisty w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć).
    • Najpopularniejsze filmy: 10 najpopularniejszych 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 agregować dane według przedziału czasowego, np. dnia, tygodnia lub miesiąca. Parametry żądania startDate i endDate określają okres, z którego raport zawiera dane. Pamiętaj, że raport zwraca dane do ostatniego dnia, dla którego wszystkie dane określone w żądaniu są dostępne do momentu utworzenia zapytania. W raportach daty są podane w formacie YYYY-MM-DD.

Ważne: wszystkie daty oznaczają okres rozpoczynający się o 00:00 czasu pacyficznego (UTC-7 lub UTC-8) i kończący się o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W efekcie daty skorygowania zegara z czasem letnim odpowiadają okresowi 23-godzinnemu, a daty, w których przesunięto zegary wstecz, to okres 25-godzinny.

Wymiar miesiąc oznacza okres rozpoczynający się o 00:00 czasu pacyficznego (UTC-7 lub UTC-8) pierwszego dnia w danym miesiącu 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 dokładniej dzielić dane. Na przykład raport źródeł wizyt może zawierać dzienne statystyki wyświetleń na podstawie sposobu, w jaki użytkownicy trafiają na 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 stosować inne filtry, aby jeszcze bardziej dzielić dane na segmenty. Daty w raporcie są podane w formacie YYYY-MM.

Uwaga: jeśli zapytanie w interfejsie API używa wymiaru month, to 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

    • Ograniczony czasowo
      • Dane dotyczące dziennego czasu oglądania filmów na kanale
      • Dzienne wskaźniki adnotacji do filmów na kanale
      • Dzienna liczba wyświetleń playlisty na kanale
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania.
    • Źródło wizyt: dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Dzienne dane o typie urządzeń w systemie operacyjnym Android
      • Dzienne dane o systemie operacyjnym na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia

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

    • Ograniczony czasowo
      • Dane dotyczące dziennego czasu oglądania treści przesłanych przez siebie
      • Dane adnotacji dotyczące treści objętych roszczeniem
      • Dzienna liczba wyświetleń playlisty przez właściciela treści
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania.
    • Źródło wizyt: dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Dzienne dane o typie urządzenia dotyczące filmów objętych roszczeniem
      • Dzienne dane o systemie operacyjnym dotyczące filmów objętych roszczeniem wyświetlanych na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
    • Przychody/skuteczność reklam: dane o dziennych przychodach i skuteczności reklam.

Miejsca odtwarzania

Wymiary te dostarczają informacji o stronie lub aplikacji, w której wystąpiła aktywność użytkownika.

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

  • BROWSE – dane odnoszą się do wyświetleń na stronie głównej lub ekranie głównym YouTube, na karcie subskrypcji użytkownika i za pomocą 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 przy użyciu elementów <iframe> lub <object>.

  • EXTERNAL_APP – dane odnoszą się do wyświetleń w aplikacji innej firmy, w których film został odtworzony w inny sposób niż za pomocą umieszczonej strony <iframe> lub <object>. Na przykład odtworzenia w aplikacjach, które korzystają z interfejsu YouTube Android Player API, zostaną sklasyfikowane za pomocą tej wartości.

  • MOBILE – te dane opisują 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 będą już zaliczane do odtworzeń MOBILE. Wartość może pozostać w raportach, ponieważ do tej kategorii należą starsze dane. Po tej dacie odtworzenia na urządzeniach mobilnych będą jednak klasyfikowane jako WATCH, EMBEDDED lub EXTERNAL_APP, w zależności od typu aplikacji, w której są one odtwarzane.

  • SEARCH – dane odnoszą się do wyświetleń, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.

  • WATCH – dane odnoszą się do wyświetleń, 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ą wyświetlenia, które nie zostały sklasyfikowane w inny sposób.

insightPlaybackLocationDetail
Dane są agregowane na podstawie strony, na której znajduje się odtwarzacz. Ten raport jest obsługiwany tylko w przypadku wyświetleń w odtwarzaczach umieszczonych na stronach i wskazuje odtwarzacze, które wygenerowały najwięcej wyświetleń dla określonego filmu. Dostarcza on więc bardziej szczegółowy widok niż raport o miejscach odtwarzania, identyfikując adresy URL lub aplikacje powiązane z najczęściej umieszczonymi odtwarzaczami.

Przykłady

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

  • Przykłady kanałów

    • Miejsce odtwarzania
      • liczby wyświetleń i czas oglądania w różnych miejscach odtwarzania.
      • Dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania
      • 10 najlepszych – witryny innych firm, które generują najwięcej wyświetleń dla umieszczonego filmu
      • liczby wyświetleń playlisty i czasu oglądania w różnych lokalizacjach odtwarzania.
      • Dzienna liczba wyświetleń playlist i czas oglądania w różnych lokalizacjach odtwarzania

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

    • Miejsce odtwarzania
      • liczby wyświetleń i czas oglądania w różnych miejscach odtwarzania.
      • Dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania
      • 10 najlepszych – witryny innych firm, które generują najwięcej wyświetleń dla umieszczonego filmu
      • liczby wyświetleń playlisty i czasu oglądania w różnych lokalizacjach odtwarzania.
      • Dzienna liczba wyświetleń playlist i czas oglądania w różnych lokalizacjach 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 dla dat od 1 stycznia 2019 r.

Wartości wymiarów znajdziesz w tej tabeli:
Wartości
LIVE_STREAM Wyświetlone treści to transmisja na żywo w YouTube.
SHORTS Wyświetlony materiał to YouTube Short.
STORY Wyświetlone treści to relacja w YouTube.
VIDEO_ON_DEMAND Wyświetlone treści to film w YouTube, który nie pasuje do żadnej z pozostałych wartości wymiarów.
UNSPECIFIED Typ treści wyświetlanych treści jest nieznany.
liveOrOnDemand
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.

Wartości wymiarów znajdziesz w tej tabeli:
Wartości
LIVE Dane w tym wierszu opisują aktywność użytkowników, która miała miejsce 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
Ten wymiar wskazuje, czy dane o aktywności użytkownika w wierszu danych 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 dokładna w momencie, w którym zachodzi aktywność użytkownika. Załóżmy na przykład, że użytkownik nie zasubskrybował kanału i obejrzy jeden z filmów na tym kanale, a następnie zasubskrybuje kanał i obejrzy kolejny film – wszystko w tym samym dniu. Z raportu dotyczącego kanału wynika, że jedno wyświetlenie ma subscribedStatus wartość SUBSCRIBED, a jeden – subscribedStatus – 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.

Wartości wymiarów znajdziesz w tej tabeli:
Wartości
CORE Aktywność użytkownika, która nie miała miejsca w żadnej ze specjalistycznych aplikacji YouTube (YouTube Gaming, YouTube dla dzieci lub YouTube Music). Wyjątek: aktywność użytkowników, która miała miejsce w YouTube Music przed 1 marca 2021 r., jest uwzględniona w raporcie CORE.
GAMING Aktywność użytkownika 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ą zawarte w kolumnie 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ą sumowane na podstawie typu strony odsyłającej, który opisuje sposób, w jaki użytkownicy dotarli do filmu. Możliwe wartości tego wymiaru:
  • ADVERTISING – widz trafił do filmu przez reklamę. W przypadku filtrowania na podstawie tego źródła wizyt pole insightTrafficSourceDetail określa typ reklamy.
  • ANNOTATION – widzowie dotarli do filmu po kliknięciu adnotacji w innym filmie.
  • CAMPAIGN_CARD – wyświetlenia pochodzą z przesłanych przez użytkowników filmów objętych roszczeniem, które właściciel treści wykorzystał do promowania wyświetlanych treści. To źródło wizyt jest obsługiwane tylko w przypadku raportów na temat właściciela treści.
  • END_SCREEN – wyświetlenia pochodzą z ekranu końcowego innego filmu.
  • EXT_URL – wyświetlenia filmu pochodzą z linku w innej witrynie. 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 pochodzą ze stron z hashtagami VOD lub ze stron przestawnych z hashtagami Shorts.
  • LIVE_REDIRECT – wyświetlenia filmów pochodzą z funkcji Live Redirect.
  • NO_LINK_EMBEDDED – podczas wyświetlania film został umieszczony na innej stronie.
  • NO_LINK_OTHER – YouTube nie zidentyfikował strony odsyłającej dla danego ruchu. Ta kategoria obejmuje bezpośredni ruch z filmu oraz ruch w aplikacjach mobilnych.
  • NOTIFICATION – wyświetlenia filmów pochodzą z e-maila lub powiadomienia z YouTube.
  • PLAYLIST – wyświetlenia filmu miały miejsce podczas odtwarzania filmu z playlisty. Uwzględnia też ruch ze strony playlisty.
  • PRODUCT_PAGE – wyświetlenia filmu pochodziły ze strony produktu.
  • PROMOTED – wyświetlenia filmu pochodzą z bezpłatnej promocji w YouTube, np. ze strony „Wyróżnione filmy” w YouTube.
  • RELATED_VIDEO – wyświetlenia filmu pochodzą z listy podobnych filmów na stronie odtwarzania innego filmu. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail określa identyfikator filmu.
  • SHORTS – widz został przekierowany, przesuwając palcem w pionie z poprzedniego filmu podczas oglądania filmów Short.
  • SOUND_PAGE – wyświetlenia pochodzą ze stron przestawnych dźwięku w Shorts.
  • SUBSCRIBER – wyświetlenia filmów pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail wskazuje elementy kanału na stronie głównej lub inną stronę, z której zostały odesłane.
  • YT_CHANNEL – wyświetlenia filmu miały miejsce na stronie kanału. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail zawiera identyfikator tego kanału.
  • YT_OTHER_PAGE – wyświetlenia filmu pochodzą z innego linku niż wynik wyszukiwania lub link do podobnego filmu na stronie YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail wskazuje stronę.
  • YT_SEARCH – wyświetlenia filmu pochodzą z wyników wyszukiwania w YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail zawiera wyszukiwane hasło.
  • VIDEO_REMIXES – wyświetlenia filmów pochodziły z linku do zremiksowanego filmu w odtwarzaczu do filmów Short. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail wskazuje film, z którego pochodził widz.
insightTrafficSourceDetail
Dane w tym raporcie są łączone na podstawie stron odsyłających, które wygenerowały najwięcej wyświetleń w przypadku określonego filmu oraz określonego typu źródła wizyt. Poniższa lista zawiera listę źródeł wizyt, dla których dostępny jest ten raport. W przypadku każdego źródła wizyt lista zawiera informacje dostarczane przez wymiar insightTrafficSourceDetail.
  • ADVERTISING – typ reklamy, która wygenerowała wyświetlenia. 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
    • 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 prowadził do filmu wskazanego w raporcie.
  • END_SCREEN – film, który skłonił widzów do obejrzenia filmu wskazanego w raporcie.
  • EXT_URL – witryna, która odesłała widzów do filmu.
  • HASHTAGS – hashtag, który przyczynił się do wyświetleń.
  • NOTIFICATION – e-mail lub powiadomienie z odesłaniem do niego.
  • RELATED_VIDEO – podobny film, który prowadził do filmu uwzględnionego w raporcie.
  • SOUND_PAGE – film, który wygenerował wyświetlenia.
  • SUBSCRIBER – element na stronie głównej lub funkcja subskrypcji w YouTube, które doprowadziły widzów do filmu uwzględnionego w raporcie. Prawidłowe wartości to:
    • activity – wyświetlenia z elementów na kanałach subskrypcji na stronie głównej, niezwiązane z przesyłaniem filmów ani kontaktowaniem się ze społecznością. Może to być np. polubienie filmu, dodanie go do ulubionych, opublikowanie biuletynu lub dodanie playlisty.
    • 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 innych kanałów wymienionych na stronie głównej, np. „Polubione”, „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 aktualizacją subskrypcji.
    • uploaded – wyświetlenia z uploaded elementów w kanałach subskrypcji na stronie głównej.
    • / – inne wyświetlenia 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 oglądali film.
  • YT_OTHER_PAGE – strona 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 wygenerował wyświetlenia.

Przykłady

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

  • Przykłady kanałów

    • Źródło wizyt
      • liczby 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 – hasła wyszukiwane w YouTube, które generują największy ruch dla filmu
      • 10 najważniejszych – wyszukiwane w Google hasła, które generują największy ruch dla filmu
      • liczby wyświetleń playlisty i czasu oglądania z różnych źródeł w danym kraju;
      • Dzienna liczba wyświetleń playlist i czas oglądania z różnych źródeł wizyt

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

    • Źródło wizyt
      • liczby 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 – hasła wyszukiwane w YouTube, które generują największy ruch dla filmu
      • 10 najważniejszych – wyszukiwane w Google hasła, które generują największy ruch dla filmu
      • liczby wyświetleń playlisty i czasu oglądania z różnych źródeł w danym kraju;
      • Dzienna liczba wyświetleń playlist i czas oglądania z różnych źródeł wizyt

Urządzenia

deviceType
Ten wymiar określa rodzaj urządzenia, na którym obejrzano materiał. Na liście poniżej wymienione są typy urządzeń, w przypadku których interfejs API zwraca dane. Możesz też użyć wymiaru deviceType jako filtra, aby ograniczyć raport o systemie operacyjnym do danych dotyczących urządzeń określonego typu.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Ten wymiar określa system oprogramowania urządzenia, na którym obejrzano materiał. Poniższa lista określa systemy operacyjne, dla których interfejs API zwraca dane. Możesz też użyć filtra operatingSystem, aby ograniczyć raport o typie urządzeń, aby zawierał tylko dane dotyczące 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/system operacyjny
      • Dzienne dane o typie urządzeń w systemie operacyjnym Android
      • Dzienne dane o systemie operacyjnym na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
      • Dzienne dane o typach urządzeń dotyczące wyświetleń playlist w systemie operacyjnym Android
      • Dzienne dane dotyczące systemu operacyjnego w przypadku wyświetleń playlist na urządzeniach mobilnych

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

    • Urządzenie/system operacyjny
      • Dzienne dane o typie urządzenia dotyczące filmów objętych roszczeniem
      • Dzienne dane o systemie operacyjnym dotyczące filmów objętych roszczeniem wyświetlanych na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
      • Dzienne dane o typach urządzeń dotyczące wyświetleń playlist w systemie operacyjnym Android
      • Dzienne dane dotyczące systemu operacyjnego w przypadku wyświetleń playlist na urządzeniach mobilnych

Dane demograficzne

Wymiary demograficzne pomagają określić przedział wiekowy i podział według płci 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 raportu. 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 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 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ę wykorzystywaną do udostępniania filmów. Filmy można udostępniać w YouTube (lub za pomocą odtwarzacza YouTube) za pomocą przycisku „Udostępnij”. This is a core dimension and is subject to the Deprecation Policy.

Prawidłowe wartości wymiarów znajdziesz w poniższej tabeli:
Platforma Wartość interfejsu API
Ameba AMEBA
E-mail dotyczący Androida ANDROID_EMAIL
Komunikator Android ANDROID_MESSENGER
Wiadomości na Androidzie ANDROID_MMS
Komunikator BlackBerry BBM
Blogger BLOGGER
Kopiuj do schowka COPY_PASTE
Cyworld CYWORLD
Wpuszczane w ziemię DIGG
Dropbox DROPBOX
Umieszczona EMBED
Wyślij 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
Wiadomość tekstowa 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
Liniowy 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 (楽天 IDs場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Rozmowy Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Wysyłając SMS-a TEXT_MESSAGE
Tuenti 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 korzystają z wymiarów społecznościowych:

  • Przykłady kanałów

    • Społecznościowe: dane o udostępnianiu zebrane według usługi, w której udostępniono filmy.

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

    • Społecznościowe: dane o udostępnianiu zebrane według usługi, w której udostępniono filmy.

Utrzymanie uwagi odbiorców

elapsedVideoTimeRatio
Ten wymiar określa stosunek pozostałej części filmu do długości filmu. Wymiary i dane dotyczące utrzymania uwagi odbiorców służą do pomiaru utrzymania uwagi odbiorców na przestrzeni czasu, a wymiar elapsedVideoTimeRatio służy do pomiaru czasu. Na przykład wartość 0.4 oznacza, że odpowiednie dane raportu pokazują dane o utrzymaniu po czasie trwania 40% filmu.

Interfejs API zwraca 100 punktów danych dla każdego filmu o wartościach współczynnika z zakresu od 0.01 do 1.0. Czas pomiaru danych podczas odtwarzania filmu jest ustawiony w równym odstępie dla każdego filmu. Oznacza to, że w przypadku dwuminutowego filmu odstęp między punktami danych wynosi 1,2 sekundy. Jednak w przypadku dwugodzinnego filmu odstęp między punktami danych wynosi 72 sekundy. Wartość wymiaru oznacza wyłączny koniec przedziału.
audienceType (tylko filtr)
Wartość wymiaru określa typ ruchu powiązany z danymi z raportu. Obsługiwane wartości to ORGANIC, AD_INSTREAM i AD_INDISPLAY. Omówienie tych typów ź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 korzystają z filtra do pobierania danych z wcześniejszych dat. Zapytania, które nie korzystają z filtra, działają dla żadnej daty po 1 lipca 2008 roku.

Przykłady

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

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 odtwarzania filmu. 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 wideo niemożliwe do pominięcia, które są wyświetlane na aukcji, o długości do 6 sekund, które 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 wideo, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych typów. Po uruchomieniu nakładka automatycznie zamyka się po wyświetleniu przez określony czas. Użytkownik może też ją zamknąć. Jeśli nakładka i baner pojawiają się jednocześnie, 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 wielu dostępnych reklam. See the TrueView documentation for more information.

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

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

  • reservedBumperInstream – reklamy wideo niemożliwe do pominięcia, 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ą one sprzedawane na zasadzie rezerwacji.

  • reservedDisplay – reklama multimedialna lub graficzna, która wyświetla się jako nakładka u dołu odtwarzacza wideo, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych typów. Po uruchomieniu nakładka automatycznie zamyka się po wyświetleniu przez określony czas. Użytkownik może też ją zamknąć. Jeśli nakładka i baner pojawiają się jednocześnie, 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ć filmy i elementy graficzne, wyświetlana na stronie głównej.

  • reservedUnknown – reklama sprzedawana na zasadzie rezerwacji, której nie można zaklasyfikować do żadnego z pozostałych typów reklam.

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

Przykłady

Podane niżej przykładowe raporty podają dane o skuteczności reklam i przychodach:

  • Przykłady kanałów

    • Przychody/reklamy
      • Dane dotyczące przychodów z 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 o najwyższych przychodach
      • Dane o skuteczności reklam dla 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 o najwyższych przychodach
      • Dane o skuteczności reklam dla różnych typów reklam

Playlisty

isCurated (tylko filtr)
Ten filtr wskazuje, że żądanie pobiera dane o wyświetleniach filmu, które miały miejsce w kontekście playlisty. Ten filtr jest wymagany w przypadku każdego raportu o playlistach. 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 raportach dotyczących właścicieli treści.

Ważne: żądania do interfejsu API umożliwiające pobieranie raportów właścicieli treści muszą filtrować dane przy użyciu jednego z tych wymiarów:
  • video
  • channel
  • Obsługiwana kombinacja wymiarów claimedStatus i uploaderType, jak zdefiniowano poniżej.
stan roszczenia (używany tylko w raportach dotyczących właścicieli treści),
Ten wymiar pozwala określić, ż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ć tylko dane dotyczące treści objętych roszczeniem. Tabela w definicji wymiaru uploaderType zawiera więcej informacji o korzystaniu z tego wymiaru.
przesyłającyType (wymiar podstawowy) (używany tylko w raportach dotyczących właścicieli treści)
Ten wymiar pozwala określić, czy odpowiedź interfejsu API powinna zawierać dane dotyczące treści przesłanych przez określonego właściciela treści czy treści przesłanych przez osoby trzecie (np. filmów przesłanych przez użytkowników). Prawidłowe wartości to self i thirdParty. Jest to wymiar podstawowy, 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 przesłanych przez właściciela treści treści objętych i nieobjętych roszczeniami.
objęte roszczeniem [Nie wybrano] Pobiera dane dotyczące treści objętych roszczeniem, które zostały przesłane przez właściciela treści 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 związanych z raportami właścicieli treści używa do filtrowania danych obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.