Dimensions

W tym dokumencie zdefiniowane są wymiary obsługiwane przez interfejs YouTube Analytics API. Ten interfejs API obsługuje kierowane zapytania w czasie rzeczywistym, co pozwala generować niestandardowe raporty 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 wyszukiwań określa obsługiwane wymiary. Na przykład podczas pobierania aktywności użytkownika według czasu wybierz okres, za który dane będą raportowane: dzień lub miesiąc. W każdym raporcie każdy wiersz danych zawiera niepowtarzalną kombinację wartości wymiarów.

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

Wymiary podstawowe

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

Podstawowe wymiary interfejsu API są opisane na poniższej liście.

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ą 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ć dane tylko dla określonego kraju.

W żądaniu pobrania raportu z zapytania 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żytkownika dotyczące Europy, 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, korzystając z jednego z wymiarów jednostki raportowania lub z obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

Wymiary

Poniższe sekcje określają wymiary używane w raportach zapytań interfejsu YouTube Analytics API. O ile nie wskazano inaczej, te wymiary są używane zarówno w raportach kanałów, jak i właścicieli treści. Wskazane 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, gdy są one używane jako filtry. Aby to zrobić, jako wartość parametru filters podaj rozdzieloną przecinkami listę identyfikatorów filmów, playlist lub kanałów, w przypadku 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) (używany 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 używany w raportach właścicieli treści, ponieważ zazwyczaj zawierają one dane zbiorcze z wielu kanałów.
grupa (tylko filtr)
Identyfikator grupy w YouTube Analytics. Aby pobrać tę wartość, użyj 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 danej grupie.

Przykłady

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

  • Przykłady kanałów

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

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

    • Podstawowe statystyki
      • 10 najpopularniejszych filmów właściciela treści
      • 10 – najczęściej oglądane filmy właściciela treści
      • 10 – najczęściej oglądane filmy na kanale właściciela treści
      • Top 10 – 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 – najczęściej oglądane filmy w Europie przez właściciela treści
      • Top 10 – najczęściej odtwarzane playlisty w Stanach Zjednoczonych

Obszary geograficzne

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

kraj (wymiar podstawowy)
Kraj powiązany z danymi w wierszu raportu. Wartością wymiaru jest 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ć kraju powiązanego. This is a core dimension and is subject to the Deprecation Policy.
province
Stan lub terytorium w 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, żądanie musi też 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 identyfikują obszary odległe ze Stanów Zjednoczonych, ponieważ te terytoria również mają własne kody ISO 3166-1. Nie można jej też używać do dzielenia się krajami z innymi krajami.

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 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 listy powyżej.
subContinent (tylko filtr)
Statystyczny kod regionu ONZ, który określa podregion geograficzny. Dział Statystyki ONZ zawiera listę podregionów, a także 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, wskazując wartość REGION_CODE z listy ONZ.

Przykłady

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

  • Przykłady kanałów

    • Podstawowe statystyki: liczba wyświetleń kanału w poszczególnych krajach (i nie tylko).
    • Zgodnie z danymi geograficznymi
      • 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 prowincji dotyczące stanów USA i Waszyngtonu
      • Dane o czasie oglądania playlist kanału w poszczególnych krajach
      • Top 10 – najczęściej odtwarzane 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 filmów – najczęściej oglądane filmy w danym kraju
      • Top 10 – najczęściej oglądane filmy w Europie

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

    • Podstawowe statystyki: liczba wyświetleń wszystkich przesłanych przez siebie filmów w danym kraju i więcej informacji.
    • Zgodnie z danymi geograficznymi
      • Dane o czasie oglądania treści przesłanych przez siebie w poszczególnych krajach
      • Dane dotyczące adnotacji w poszczególnych krajach dotyczące treści przesłanych przez siebie
      • Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu
      • Dane o czasie oglądania na playlistach właściciela treści w poszczególnych krajach
      • Top 10 – najczęściej odtwarzane 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

Te wymiary wskazują, że raport powinien agregować dane według przedziału czasu, takiego jak dzień, tydzień lub miesiąc. 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 w momencie utworzenia zapytania. Daty w raportach są podane w formacie YYYY-MM-DD.

Ważne: wszystkie daty dotyczą okresu od 00:00 czasu pacyficznego (UTC-7 lub UTC-8) do 23:59 czasu pacyficznego w danym dniu, miesiącu i roku. W efekcie daty, w przypadku których zegary są dostosowywane do czasu letniego, mają okres 23-godzinny, a daty, w których zegary są przesunięte do tyłu, oznaczają okres 25-godzinny.

Wymiar miesiąc odnosi się do okresu zaczynającego się o 00:00 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 uzyskać bardziej szczegółowe rozbicie danych, możesz użyć innych wymiarów. Na przykład raport źródła wizyt może zawierać 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żywać innych filtrów, aby jeszcze dokładniej segmentować dane. Daty w raporcie są podane w formacie YYYY-MM.

Uwaga: jeśli zapytanie w interfejsie 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ą wymiary lub filtry czasowe:

  • 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
      • Dzienne wyświetlenia playlisty na kanale
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych lokalizacjach 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 na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia

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

    • Ograniczony czasowo
      • Statystyki dziennego czasu oglądania treści przesłanych przez siebie
      • Dane adnotacji dotyczące treści objętych roszczeniem
      • Wyświetlenia playlisty dziennie 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: dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Dzienne dane o typie urządzeń 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 przychodach dziennych i skuteczności reklam.

Miejsca odtwarzania

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

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

  • BROWSE – dane opisują wyświetlenia, które miały miejsce na stronie głównej lub ekranie głównym YouTube, na karcie subskrypcji użytkownika lub 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 za pomocą umieszczonego elementu <iframe> lub <object>.

  • EXTERNAL_APP – dane opisują wyświetlenia, które miały miejsce w aplikacji innej firmy, w wyniku których film został odtworzony w inny sposób niż za pomocą umieszczonego elementu <iframe> lub <object>. Na przykład odtworzenia w aplikacjach, które korzystają z interfejsu YouTube Android Player API, zostaną skategoryzowane za pomocą tej wartości.

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

    Od 10 września 2013 r. odtworzenia nie są już zaliczane do kategorii odtworzeń MOBILE w raportach Statystyk YouTube. Wartość może pozostać w raportach, ponieważ do tej kategorii nadal należą starsze dane. Po tej dacie odtworzenia na urządzeniach mobilnych są klasyfikowane jako odtworzenia WATCH, EMBEDDED lub EXTERNAL_APP, w zależności od typu aplikacji, w której zostały odtworzenia.

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

  • WATCH – dane przedstawiają 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ą wyświetlenia, które nie są sklasyfikowane w inny sposób.

insightPlaybackLocationDetail
Dane są zbierane na podstawie strony, na której znajduje się odtwarzacz. Pamiętaj, że ten raport jest obsługiwany tylko w przypadku wyświetleń w odtwarzaczach umieszczonych na stronach. Zawiera on informacje o odtwarzaczach, które wygenerowały najwięcej wyświetleń dla określonego filmu. Dzięki temu uzyskujesz bardziej szczegółowy widok niż raport o miejscach odtwarzania, identyfikując adresy URL lub aplikacje powiązane z najczęściej umieszczonymi odtwarzaczami.

Przykłady

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

  • Przykłady kanałów

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

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

    • Miejsce odtwarzania
      • Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania
      • Dzienne liczby wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania
      • Top 10 – witryny innych firm, które generują najwięcej wyświetleń dla umieszczonego filmu
      • liczby wyświetleń playlisty i czas oglądania w różnych miejscach 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 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świetlone treści to YouTube Short.
STORY Wyświetlone treści to relacja w YouTube.
VIDEO_ON_DEMAND Wyświetlone treści to film w YouTube, którego żadna z wartości wymiarów nie pasuje do żadnej z pozostałych wartości.
UNSPECIFIED Typ 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 poniższej tabeli:
Wartości
LIVE Dane w tym wierszu opisują aktywność użytkownika 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 chwili wystąpienia aktywności użytkownika. Załóżmy na przykład, że użytkownik nie zasubskrybował kanału i oglądał jeden z filmów na tym kanale, a następnie zasubskrybował kanał i obejrzał kolejny film – wszystko to tego samego dnia. Raport kanału wskazuje, że 1 wyświetlenie ma wartość subscribedStatus wynoszącą SUBSCRIBED, a 1 – wartość UNSUBSCRIBED wynoszącą subscribedStatus.
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 roku.

Wartości wymiarów znajdziesz w poniższej tabeli:
Wartości
CORE Aktywność użytkownika, która nie miała miejsca w żadnej ze specjalnych aplikacji YouTube (Gry YouTube, YouTube Kids 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 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 w YouTube Music miała miejsce 1 marca 2021 r. lub później. Dane sprzed 1 marca 2021 r. są uwzględniane w raporcie 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ą zbierane 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 trafił do filmu przez reklamę. W przypadku filtrowania na podstawie tego źródła wizyt pole insightTrafficSourceDetail wskazuje typ reklamy.
  • ANNOTATION – widzowie przeszli do filmu, klikając adnotację 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 raportach właściciela treści.
  • END_SCREEN – wyświetlenia pochodzą z ekranu końcowego innego filmu.
  • EXT_URL – wyświetlenia filmu były uzyskiwane za pomocą 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ące ze stron z hashtagami VOD lub ze stron z hashtagami Shorts.
  • LIVE_REDIRECT – wyświetlenia filmów pochodzą z funkcji Live Redirect.
  • NO_LINK_EMBEDDED – film został umieszczony w innej witrynie podczas wyświetlania.
  • NO_LINK_OTHER – YouTube nie znalazł strony odsyłającej dla tego ruchu. Ta kategoria obejmuje bezpośredni ruch z filmu oraz ruch w aplikacjach mobilnych.
  • NOTIFICATION – wyświetlenia filmu pochodzą z e-maila lub powiadomienia z YouTube.
  • PLAYLIST – wyświetlenia filmu miały miejsce podczas odtwarzania go w ramach playlisty. Uwzględnia też ruch ze strony playlisty.
  • PRODUCT_PAGE – wyświetlenia filmów pochodziły ze strony produktu.
  • PROMOTED – wyświetlenia filmu pochodziły z bezpłatnej promocji w YouTube, np. ze strony „Wyróżnione filmy” w YouTube.
  • RELATED_VIDEO – wyświetlenia filmów 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ł odesłany, przesuwając palcem w pionie od poprzedniego filmu w interfejsie do oglądania filmów Short.
  • SOUND_PAGE – wyświetlenia pochodzące ze stron z powiązanymi dźwiękami Shorts.
  • SUBSCRIBER – wyświetlenia filmów pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji YouTube. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail wskazuje elementy kanału na stronie głównej lub inną stronę, z której pochodzą wyświetlenia.
  • YT_CHANNEL – wyświetlenia filmu miały miejsce na stronie kanału. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail zawiera identyfikator tego kanału.
  • YT_OTHER_PAGE – wyświetlenia filmów były odsyłane za pomocą linku innego niż wynik wyszukiwania lub link do podobnego filmu na stronie YouTube. Jeśli filtrujesz wyniki 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 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 określa film, z którego widz został odesłany.
insightTrafficSourceDetail
Dane w tym raporcie są zagregowane na podstawie stron odsyłających, które wygenerowały najwięcej wyświetleń dla określonego filmu, oraz na podstawie określonego typu źródła wizyt. Poniższa lista zawiera źródła wizyt, dla których dostępny jest ten raport. Lista zawiera informacje dostarczane przez wymiar insightTrafficSourceDetail w przypadku każdego źródła wizyt.
  • ADVERTISING – typ reklamy, która doprowadziła do 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
    • Reklama 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ł widzów 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 którego pochodzi ruch.
  • RELATED_VIDEO – podobny film, który trafił do filmu uwzględnionego w raporcie.
  • SOUND_PAGE – film, który przyczynił się do wyświetleń.
  • SUBSCRIBER – element aktywności 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, dodanie biuletynu do playlisty lub dodanie go do playlisty.
    • blogged – wyświetlenia z elementów w kanałach subskrypcji na stronie głównej, które wynikają z linków z najpopularniejszych blogów.
    • mychannel – wyświetlenia z elementów w innych kanałach wymienionych na stronie głównej, takich jak „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 pochodzące ze strony głównej YouTube.
    • /my_subscriptions – wyświetlenia pochodzące ze stron Moje subskrypcje użytkowników 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 przyczynił się do wyświetleń.

Przykłady

W tych przykładowych żądaniach używane są wymiary związane ze źródłami 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;
      • Dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt
      • 10 najpopularniejszych – słowa 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ł wizyt w danym kraju;
      • Dzienne liczby wyświetleń playlist i czas oglądania z różnych źródeł wizyt

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

    • Źródło wizyt
      • liczby wyświetleń i czas oglądania z różnych źródeł wizyt;
      • Dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt
      • 10 najpopularniejszych – słowa 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ł wizyt w danym kraju;
      • Dzienne liczby wyświetleń playlist i czas oglądania z różnych źródeł wizyt

Urządzenia

deviceType
Ten wymiar określa typ urządzenia, na którym wyświetlono reklamę. Poniższa lista przedstawia 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 tylko do danych dotyczących określonego typu urządzeń.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Ten wymiar określa system oprogramowania urządzenia, na którym wystąpiło wyświetlenie. Poniższa lista przedstawia systemy operacyjne, 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 określonego systemu operacyjnego.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

Przykłady

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

  • Przykłady kanałów

    • Urządzenie/system operacyjny
      • Dzienne dane o typie urządzeń z systemem operacyjnym Android
      • Dzienne dane o systemie operacyjnym na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
      • Dzienne dane o typie urządzeń dotyczące wyświetleń playlist w systemie operacyjnym Android
      • Dzienne dane o systemie operacyjnym 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ądzeń 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 typie urządzeń dotyczące wyświetleń playlist w systemie operacyjnym Android
      • Dzienne dane o systemie operacyjnym dotyczące 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 (podstawowy wymiar)
Ten wymiar określa grupę wiekową zalogowanych użytkowników, którzy są powiązani z danymi w raporcie. Interfejs API używa tych grup wiekowych:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
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

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

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

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

Zaangażowanie i udostępnianie treści

sharingService (wymiar podstawowy)
Ten wymiar określa usługę, która została użyta 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
Poczta e-mail na Androida ANDROID_EMAIL
Komunikator Android ANDROID_MESSENGER
Wiadomości na Androida 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
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
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 (楽天mani場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Rozmowy Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Brak informacji UNKNOWN
Wiadomości Verizon VERIZON_MMS
Viber VIBER
Vkontakte (WriteКонтакте) 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

W tych przykładowych żądaniach używane są wymiary społecznościowe:

  • Przykłady kanałów

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

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

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

Utrzymanie uwagi odbiorców

elapsedVideoTimeRatio
Ten wymiar określa stosunek udzielonej 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 do pomiaru czasu. Na przykład wartość 0.4 oznacza, że w odpowiednich danych raportu pojawiają się dane o utrzymaniu użytkowników po upływie 40% filmu.

Interfejs API zwraca 100 punktów danych dla każdego filmu o wartościach współczynnika od 0.01 do 1.0. Czasy pomiaru danych podczas odtwarzania są równe dla każdego filmu. Oznacza to, że w przypadku 2-minutowego 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 wskazuje 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. 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 w przypadku zapytań, które używają filtra do próby pobrania danych z wcześniejszych dat. Zapytania, które nie korzystają z tego filtra, nie działają w przypadku dat 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 łączy żą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 wideo niemożliwe do pominięcia, wyświetlane na aukcji, trwające do 6 sekund, które muszą być wyświetlone, zanim rozpocznie się odtwarzanie filmu.

  • auctionDisplay – reklama multimedialna lub graficzna, która wyświetlana jest jako nakładka u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie tych elementów. Po uruchomieniu nakładki zamyka się automatycznie po wyświetleniu jej przez określony czas. Użytkownik może też ją zamknąć. Jeśli nakładka i baner wyświetlają się jednocześnie, każda reklama jest liczona jako osobne wyświetlenie.

  • auctionInstream – reklamy wideo bez możliwości 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 z kilku dostępnych opcji wyświetlanych przed filmem. See the TrueView documentation for more information.

  • auctionTrueviewInstream – reklamy wideo z możliwością 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 na 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, które trwają do 6 sekund i 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 rozpocznie odtwarzanie. Są one sprzedawane na zasadzie rezerwacji.

  • reservedDisplay – reklama multimedialna lub graficzna, która wyświetlana jest jako nakładka u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie tych elementów. Po uruchomieniu nakładki zamyka się automatycznie po wyświetleniu jej przez określony czas. Użytkownik może też ją zamknąć. Jeśli nakładka i baner wyświetlają się jednocześnie, każda reklama jest liczona jako osobne wyświetlenie.

  • reservedInstream – reklamy wideo niemożliwe do pominięcia, które są umieszczane 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 sprzedana na zasadzie rezerwacji, której nie można zaklasyfikować do żadnego z pozostałych typów reklam.

  • unknown – nie mogliśmy 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 dotyczące przychodów i skuteczności reklam w poszczególnych krajach
      • 10 najlepszych – filmy z najwyższymi przychodami
      • 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 dotyczące przychodów i skuteczności reklam w poszczególnych krajach
      • 10 najlepszych – filmy z najwyższymi przychodami
      • 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 filmów, które miały miejsce w kontekście playlisty.

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 właściciela treści.

Ważne: żądania do interfejsu API umożliwiające pobranie 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 zdefiniowano poniżej.
objętych roszczeniem (używany tylko w raportach właściciela 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ść dla tego wymiaru to claimed. Jeśli parametr filters ogranicza zapytanie do claimedStatus==claimed, interfejs API będzie pobierać dane tylko dla treści objętych roszczeniem. Więcej informacji o korzystaniu z tego wymiaru znajdziesz w tabeli w definicji wymiaru uploaderType.
przesyłającyType (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 wskazanego właściciela treści lub treści przesłanych przez osoby trzecie, takich jak filmy przesłane przez użytkowników. Prawidłowe wartości to self i thirdParty. Jest to wymiar podstawowy, który podlega zasadom wycofywania.

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

Wartość: claimedStatus Wartość: uploaderType Opis
[Nie wybrano] 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 przez inny podmiot.
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 przesłanych przez osoby trzecie treści objętych roszczeniem.

Przykłady

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