Dimensions

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

Wymiary to typowe kryteria używane do agregowania danych, np. data aktywności użytkownika lub kraj, w którym się on znajdował.

Każdy raport z zapytania zawiera informacje o obsługiwanych wymiarach. Na przykład podczas pobierania aktywności użytkowników według czasu możesz wybrać okres, za który będą raportowane dane: 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 żą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

Interfejs API Statystyk YouTube podlega zasadom wycofywania określonym w Warunkach korzystania z usługi, ale wymiary (i dane) inne niż podstawowe nie podlegają tym zasadom. W definicjach na tej stronie każdy wymiar podstawowy jest wyraźnie oznaczony jako taki.

Poniższa lista zawiera podstawowe wymiary interfejsu API.

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

Filtry

Wszystkie raporty dotyczące zapytań obsługują filtry. Filtry identyfikują wartości wymiarów, które muszą być obecne w pobranym zbiorze danych. Ograniczają one odpowiedź interfejsu API do danych pasujących do określonej wartości lub zestawu wartości. Na przykład zamiast pobierać dane o aktywności użytkowników we wszystkich krajach, możesz użyć filtra, aby pobrać dane tylko z 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 na przykład pobrać dane o aktywności użytkowników w Europie, ustaw wartość parametru filters na continent==150.

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

Wymiary

W kolejnych sekcjach znajdziesz definicje wymiarów używanych w raportach zapytań interfejsu YouTube Analytics API. O ile nie zaznaczono inaczej, te wymiary są używane w raportach dotyczących kanału i właściciela treści. Wymiary, których można używać tylko jako filtrów, są również oznaczone.

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ślanie wielu wartości wymiarów video, playlist i channel, gdy są one używane jako filtry. Aby to zrobić, ustaw wartość parametru filters na rozdzieloną przecinkami listę identyfikatorów filmów, playlist lub kanałów, dla których ma być filtrowana odpowiedź interfejsu API. Wartość parametru może zawierać do 500 identyfikatorów.

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

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

Przykłady

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

  • Przykłady kanałów

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

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

    • Podstawowe statystyki
      • 10 najpopularniejszych filmów właściciela treści
      • 10 najpopularniejszych filmów właściciela treści
      • 10 najpopularniejszych filmów na kanale właściciela treści
      • 10 najpopularniejszych filmów – współczynniki klikalności adnotacji w najpopularniejszych filmach na kanale
      • 10 najpopularniejszych playlist właściciela treści
    • Położenie geograficzne
      • 10 najpopularniejszych filmów w Europie należących do właściciela treści
      • 10 najczęściej odtwarzanych playlist w Stanach Zjednoczonych

Obszary geograficzne

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

country (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 jest używany do raportowania danych, w przypadku których YouTube nie mógł zidentyfikować powiązanego kraju. This is a core dimension and is subject to the Deprecation Policy.
province
Stan lub terytorium Stanów Zjednoczonych powiązane z danymi w wierszu raportu. Wartość wymiaru to kod ISO 3166-2, który identyfikuje stan w USA lub Dystrykt Kolumbii, np. US-MI (Michigan) lub US-TX (Teksas). Kod prowincji US-ZZ jest używany do raportowania danych, w przypadku których YouTube nie mógł określić powiązanego stanu w USA. Jeśli żądanie interfejsu API zawiera province w wartości parametru dimensions, 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 zewnętrzne Stanów Zjednoczonych, ponieważ te terytoria mają też własne kody krajów ISO 3166-1. Nie obsługuje też podziałów administracyjnych innych krajów niż Stany Zjednoczone.

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

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

Przykłady

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

  • Przykłady kanałów

    • Podstawowe statystyki: liczba wyświetleń kanału w poszczególnych krajach (i inne dane).
    • Położenie geograficzne
      • Dane dotyczące czasu oglądania filmów na kanale w poszczególnych krajach
      • Dane dotyczące adnotacji w filmach na kanale w poszczególnych krajach
      • Dane dotyczące poszczególnych prowincji w stanach USA i Waszyngtonie.
      • Dane dotyczące czasu oglądania playlist na kanale w poszczególnych krajach
      • 10 najczęściej odtwarzanych playlist w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Źródło wizyt: liczba wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć).
    • Najpopularniejsze filmy
      • Pierwsza 10 – najczęściej oglądane filmy w określonym kraju
      • Top 10 – najczęściej oglądane filmy w Europie

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

    • Podstawowe statystyki: liczba wyświetleń w poszczególnych krajach (i inne dane) wszystkich przesłanych przez siebie filmów.
    • Położenie geograficzne
      • Dane dotyczące czasu oglądania w poszczególnych krajach w przypadku treści przesłanych samodzielnie
      • Dane dotyczące adnotacji w poszczególnych krajach w przypadku treści przesłanych samodzielnie
      • Dane dotyczące poszczególnych prowincji w stanach USA i Waszyngtonie.
      • Dane dotyczące czasu oglądania w poszczególnych krajach w przypadku playlist właściciela treści
      • 10 najczęściej odtwarzanych playlist w Stanach Zjednoczonych
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć).
    • Najpopularniejsze filmy: 10 najczęściej oglądanych filmów w Europie należących do właściciela treści.
    • Przychody/skuteczność reklam: dane o przychodach i skuteczności reklam w poszczególnych krajach.

Okresy

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

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

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

dzień (podstawowy wymiar)
Gdy używasz tego wymiaru, dane w raporcie są agregowane codziennie, a każdy wiersz zawiera dane z jednego dnia. Aby jeszcze bardziej szczegółowo podzielić dane, możesz użyć innych wymiarów. Na przykład raport Źródła wizyt może zawierać zbiorcze statystyki wyświetleń z danego dnia, które są podzielone według sposobu, w jaki użytkownicy trafiają na Twoje filmy. This is a core dimension and is subject to the Deprecation Policy.
miesiąc (podstawowy wymiar)
Dane w raporcie są agregowane według miesięcy kalendarzowych. Podobnie jak w przypadku raportów dziennych możesz używać innych filtrów, aby jeszcze bardziej podzielić dane na segmenty. W raporcie daty 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

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

  • Przykłady kanałów

    • Na okres
      • Dane dotyczące dziennego czasu oglądania filmów na kanale
      • dzienne dane dotyczące adnotacji w filmach na kanale;
      • Dzienna liczba wyświetleń playlist kanału
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach 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 dotyczące typu urządzenia 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

    • Na okres
      • Dzienne dane o czasie oglądania treści przesłanych przez Ciebie
      • Dane dotyczące adnotacji w przypadku treści, do których zgłoszono prawa
      • Dzienne wyświetlenia playlist właściciela treści
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania.
    • Źródło wizyt: dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Codzienne dane dotyczące typu urządzenia w przypadku filmów objętych roszczeniem
      • Dzienne dane dotyczące systemów operacyjnych w przypadku zgłoszonych filmów wyświetlanych na urządzeniach mobilnych
      • Dzienne dane dotyczące systemu operacyjnego i typu urządzenia
    • Przychody/skuteczność reklam: dzienne przychody i dane o skuteczności reklam.

Miejsca odtwarzania

Te wymiary dostarczają informacji o stronie lub aplikacji, na której wystąpiła aktywność użytkownika.

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

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

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

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

  • EXTERNAL_APP – dane opisują wyświetlenia, które miały miejsce w aplikacji innej firmy, w której film był odtwarzany inną metodą niż osadzanie za pomocą tagu <iframe> lub <object>. Na przykład odtworzenia w aplikacjach korzystających z interfejsu YouTube Android Player API będą kategoryzowane na podstawie tej wartości.

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

    Od 10 września 2013 r. odtworzenia nie są już klasyfikowane jako MOBILE odtworzenia w raportach Statystyk YouTube. Wartość może pozostać w raportach, ponieważ dane starszego typu nadal należą do tej kategorii. 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 występują.

  • 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ą wyświetlenia, które nie są 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 innych stronach. Zawiera informacje o odtwarzaczach umieszczonych na innych stronach, które wygenerowały najwięcej wyświetleń określonego filmu. Dzięki temu zapewnia bardziej szczegółowy widok niż raport Lokalizacja odtwarzania, ponieważ identyfikuje adresy URL lub aplikacje powiązane z najpopularniejszymi odtwarzaczami osadzonymi.

Przykłady

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

  • Przykłady kanałów

    • Miejsce odtwarzania
      • Liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania
      • Dzienne liczby wyświetleń i czas oglądania z różnych lokalizacji odtwarzania
      • 10 najpopularniejszych stron zewnętrznych, które generują najwięcej wyświetleń umieszczonego filmu
      • Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania
      • Dzienne liczby wyświetleń playlist i czas oglądania w różnych miejscach odtwarzania

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

    • Miejsce odtwarzania
      • Liczba wyświetleń i czas oglądania w różnych miejscach odtwarzania
      • Dzienne liczby wyświetleń i czas oglądania z różnych lokalizacji odtwarzania
      • 10 najpopularniejszych stron zewnętrznych, które generują najwięcej wyświetleń umieszczonego filmu
      • Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania
      • Dzienne liczby wyświetleń playlist i czas 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żytkowników w wierszu danych. Dane tego wymiaru są dostępne od 1 stycznia 2019 r.

W tej tabeli znajdziesz wartości wymiaru:
Wartości
LIVE_STREAM Oglądane treści to transmisja na żywo w YouTube.
SHORTS Oglądane treści to film Short w YouTube.
STORY Oglądane treści to film Short w YouTube.
VIDEO_ON_DEMAND Wyświetlane treści to film w YouTube, który nie należy 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żytkowników 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.

W tabeli poniżej znajdziesz wartości wymiaru:
Wartości
LIVE Dane w wierszu opisują aktywność użytkowników 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 dane o aktywności użytkowników w wierszu danych są powiązane z osobami oglądającymi, które subskrybowały kanał filmu lub playlisty. Możliwe wartości to SUBSCRIBED i UNSUBSCRIBED.

Pamiętaj, że wartość wymiaru jest dokładna w momencie wystąpienia aktywności użytkownika. Załóżmy na przykład, że użytkownik nie subskrybuje kanału, ale ogląda jeden z jego filmów, a potem subskrybuje kanał i ogląda kolejny film – wszystko tego samego dnia. Raport kanału wskazuje, że jedno wyświetlenie ma wartość subscribedStatus, a drugie – UNSUBSCRIBED.subscribedStatusSUBSCRIBED
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.

W tabeli poniżej znajdziesz wartości wymiaru:
Wartości
CORE Aktywność użytkownika, która nie miała miejsca w jednej z aplikacji specjalistycznych YouTube (YouTube Gaming, YouTube Kids lub YouTube Music). Wyjątek: aktywność użytkowników w YouTube Music przed 1 marca 2021 r. jest uwzględniana w sekcji 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ę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 raporcie są agregowane na podstawie typu witryny odsyłającej, który opisuje sposób, w jaki użytkownicy trafili na film. Możliwe wartości tego wymiaru:
  • ADVERTISING – widz został przekierowany do filmu przez reklamę. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail identyfikuje typ reklamy.
  • ANNOTATION – widzowie dotarli do filmu, klikając adnotację w innym filmie.
  • CAMPAIGN_CARD – Wyświetlenia pochodzące z filmów przesłanych przez użytkowników, które zostały objęte roszczeniem i wykorzystane przez właściciela treści do promowania oglądanych treści. To źródło wizyt jest obsługiwane tylko w przypadku raportów właściciela treści.
  • END_SCREEN – wyświetlenia pochodzą z ekranu końcowego innego filmu.
  • EXT_URL – wyświetlenia filmu pochodziły z linku w innej witrynie. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail identyfikuje stronę internetową. To źródło wizyt obejmuje odesłania z wyników wyszukiwania Google.
  • HASHTAGS – wyświetlenia pochodzące ze stron hashtagów VOD lub stron hashtagów Shorts.
  • LIVE_REDIRECT – wyświetlenia filmu pochodzą z Live Redirects.
  • NO_LINK_EMBEDDED – film był umieszczony w innej witrynie, gdy był wyświetlany.
  • NO_LINK_OTHER – YouTube nie zidentyfikował źródła odesłania. Ta kategoria obejmuje ruch bezpośredni do filmu, a także 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. Obejmuje on ruch pochodzący ze strony playlisty.
  • PRODUCT_PAGE – wyświetlenia filmu pochodzą ze strony produktu.
  • PROMOTED – wyświetlenia filmu pochodzą z bezpłatnej promocji w YouTube, np. ze strony „Filmy w centrum uwagi”.
  • RELATED_VIDEO – wyświetlenia filmu pochodziły z listy powiązanych filmów na innej stronie odtwarzania filmu. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail zawiera identyfikator filmu.
  • SHORTS – widz został przekierowany przez przesunięcie w pionie z poprzedniego filmu w odtwarzaczu filmów Short.
  • SOUND_PAGE – wyświetlenia pochodzące ze stron dźwięku w Shorts.
  • SUBSCRIBER – wyświetlenia filmu pochodzą z kart na stronie głównej YouTube lub z funkcji subskrypcji w YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail określa elementy karty głównej lub inną stronę, z której pochodzą wyświetlenia.
  • YT_CHANNEL – wyświetlenia filmu pochodzą ze strony kanału. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail określa identyfikator kanału.
  • YT_OTHER_PAGE – wyświetlenia filmu pochodziły z linku innego niż wynik wyszukiwania lub link do powiązanego filmu, który pojawił się na stronie YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail identyfikuje stronę.
  • YT_SEARCH – wyświetlenia filmu pochodzą z wyników wyszukiwania w YouTube. Jeśli filtrujesz dane według tego źródła wizyt, pole insightTrafficSourceDetail określa wyszukiwane hasło.
  • VIDEO_REMIXES – wyświetlenia filmu pochodziły z linku do zremiksowanego filmu w odtwarzaczu do filmów Short. Jeśli zastosujesz filtr na podstawie tego źródła wizyt, w polu insightTrafficSourceDetail znajdziesz film, z którego użytkownik został przekierowany.
insightTrafficSourceDetail
Dane w raporcie są agregowane na podstawie witryn odsyłających, które wygenerowały najwięcej wyświetleń określonego filmu i określonego typu źródła wizyt. Na liście poniżej znajdziesz źródła wizyt, dla których dostępny jest ten raport. W przypadku każdego źródła wizyt lista zawiera informacje, które podaje 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
    • 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, z której użytkownicy trafili do filmu.
  • HASHTAGS – hashtag, który doprowadził do wyświetleń;
  • NOTIFICATION – e-mail lub powiadomienie, które spowodowało odwiedziny.
  • RELATED_VIDEO – powiązany film, który doprowadził widzów do filmu objętego raportem.
  • SOUND_PAGE – film, który wygenerował wyświetlenia.
  • SUBSCRIBER – element na stronie głównej lub funkcja subskrypcji w YouTube, która przyciągnęła widzów do filmu objętego raportem. Prawidłowe wartości to:
    • activity – wyświetlenia treści na karcie „Subskrypcje” i stronie głównej, które nie są związane z przesłaniem filmu ani aktywnością na kanale społecznościowym, w tym polubienia, dodania do ulubionych, posty na tablicy i dodania do playlisty.
    • blogged – wyświetlenia treści na karcie Subskrypcje i stronie głównej, które pochodzą z linków z najpopularniejszych blogów.
    • mychannel – wyświetlenia z elementów na innych kartach na stronie głównej, takich jak „Polubione”, „Historia oglądania” i „Do obejrzenia”;
    • podcasts – wyświetlenia pochodzące z elementów na stronie docelowej Podcasty.
    • sdig – wyświetlenia pochodzące z e-maili z aktualizacjami subskrypcji.
    • uploaded – wyświetlenia treści uploaded na karcie Subskrypcje i stronie głównej.
    • / – inne wyświetlenia pochodzące ze strony głównej YouTube.
    • /my_subscriptions – wyświetlenia pochodzące ze stron Moje subskrypcje w YouTube.
  • YT_CHANNEL – strona kanału, na której widzowie obejrzeli film.
  • YT_OTHER_PAGE – strona w YouTube, z której widzowie trafili do filmu.
  • YT_SEARCH – wyszukiwane słowo, które przyciągnęło widzów do filmu.
  • VIDEO_REMIXES – film, który wygenerował wyświetlenia.

Przykłady

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

  • Przykłady kanałów

    • Źródło wizyt
      • Liczba wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju
      • Dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt
      • 10 najpopularniejszych wyszukiwanych słów w YouTube, które generują najwięcej ruchu w przypadku filmu.
      • 10 najpopularniejszych wyszukiwanych słów w Google, które generują najwięcej ruchu w przypadku filmu
      • Liczba wyświetleń i czas oglądania playlisty z różnych źródeł wizyt w danym kraju
      • dzienne liczby 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
      • Dzienne liczby wyświetleń i czas oglądania z różnych źródeł wizyt
      • 10 najpopularniejszych wyszukiwanych słów w YouTube, które generują najwięcej ruchu w przypadku filmu.
      • 10 najpopularniejszych wyszukiwanych słów w Google, które generują najwięcej ruchu w przypadku filmu
      • Liczba wyświetleń i czas oglądania playlisty z różnych źródeł wizyt w danym kraju
      • dzienne liczby wyświetleń playlisty i czas oglądania z różnych źródeł wizyt;

Urządzenia

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

Przykłady

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

  • Przykłady kanałów

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

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

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

Dane demograficzne

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

ageGroup (wymiar podstawowy)
Ten wymiar określa grupę wiekową zalogowanych użytkowników powiązanych 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.
gender (wymiar podstawowy)
Ten wymiar określa płeć zalogowanych użytkowników powiązanych z danymi w raporcie. Prawidłowe wartości to female, male i user_specified. This is a core dimension and is subject to the Deprecation Policy.

Przykłady

Te przykładowe żądania 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ę, która została użyta do udostępnienia 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.

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

Więcej informacji znajdziesz w dokumentacji pomocy.

Przykłady

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

  • Przykłady kanałów

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

Utrzymanie uwagi odbiorców

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

Interfejs API zwraca 100 punktów danych dla każdego filmu z wartościami współczynnika w zakresie od 0.01 do 1.0. Momenty, w których dane są mierzone podczas odtwarzania filmów, są równomiernie rozłożone w przypadku każdego filmu. Oznacza to, że w przypadku 2-minutowego filmu interwał między punktami danych wynosi 1,2 sekundy. W przypadku 2-godzinnego filmu interwał między punktami danych wynosi 72 sekundy. Wartość wymiaru oznacza koniec przedziału (wyłącznie).
audienceType (dotyczy tylko filtra)
Wartość wymiaru określa typ ruchu powiązanego z danymi w raporcie. Obsługiwane wartości to ORGANIC, AD_INSTREAM i AD_INDISPLAY. Wyjaśnienia 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 używają filtra do pobierania danych z wcześniejszych dat. Zapytania, które nie korzystają z tego filtra, działają w przypadku dowolnej daty po 1 lipca 2008 r.

Przykłady

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

Transmisje na żywo

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

anulowania subskrypcji,

membershipsCancellationSurveyReason
Liczba ankiet wypełnionych przez użytkowników YouTube, którzy anulowali wspieranie określonego kanału w okresie uwzględnionym w raporcie. W tabeli poniżej znajdziesz prawidłowe wartości wymiaru:
Wartość interfejsu API Wyjaśnienie
UNKNOWN Użytkownik nie wypełnił ankiety.
DISLIKE_PERKS Użytkownikowi nie podobały się korzyści wynikające z subskrypcji.
PERKS_NOT_DELIVERED Użytkownik twierdzi, że obiecane korzyści nie zostały mu przyznane.
CANNOT_ACCESS_PERKS Użytkownik nie miał dostępu do korzyści.
NO_LONGER_INTERESTED Użytkownik nie jest już zainteresowany członkostwem w kanale.
FEEL_UNAPPRECIATED Użytkownik poczuł się niedoceniony jako wspierający kanał.
FINANCIAL_REASONS Użytkownik anulował subskrypcję z powodów finansowych.
JOIN_LIMITED_TIME Użytkownik chciał wspierać kanał tylko przez określony czas.
OTHER Użytkownik miał inny powód anulowania.

Skuteczność reklamy

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

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

  • auctionDisplay – reklama rich media lub graficzna, która pojawia się jako nakładka u dołu odtwarzacza wideo, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych form. Gdy nakładka jest wyświetlana, automatycznie zamyka się po określonym czasie. Użytkownik może ją też zamknąć samodzielnie. Jeśli nakładka i baner są wyświetlane razem, każda reklama jest liczona jako osobne wyświetlenie.

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

  • auctionTrueviewInslate – widz wybiera jedną z kilku reklam wideo z wyświetlonej przed filmem listy. See the TrueView documentation for more information.

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

  • auctionUnknown – reklama kupiona na aukcji AdWords, ale niezaklasyfikowana do żadnego z innych typów reklam.

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

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

  • reservedDisplay – reklama rich media lub graficzna, która pojawia się jako nakładka u dołu odtwarzacza wideo, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych form. Gdy nakładka jest wyświetlana, automatycznie zamyka się po określonym czasie. Użytkownik może ją też zamknąć samodzielnie. Jeśli nakładka i baner są wyświetlane razem, każda reklama jest liczona jako osobne wyświetlenie.

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

  • reservedInstreamSelect

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

  • reservedUnknown – reklama sprzedana na zasadach rezerwacji, której nie można było zaklasyfikować do żadnego z innych typów reklam.

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

Przykłady

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

  • Przykłady kanałów

    • Przychody/reklamy
      • Dane o przychodach z kanału i skuteczności reklam
      • Dzienne dane o przychodach i skuteczności reklam
      • Dane o przychodach i skuteczności reklam w poszczególnych krajach
      • 10 najpopularniejszych filmów z najwyższymi przychodami
      • Dane o skuteczności reklam różnych typów

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

    • Przychody/reklamy
      • Dane o przychodach i skuteczności reklam w przypadku treści, do których zgłoszono roszczenie
      • Dzienne dane o przychodach i skuteczności reklam
      • Dane o przychodach i skuteczności reklam w poszczególnych krajach
      • 10 najpopularniejszych filmów z najwyższymi przychodami
      • Dane o skuteczności reklam różnych typów

Wymiary właściciela treści

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

Ważne: żądania do interfejsu API służące do pobierania 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 zdefiniowana poniżej.
claimedStatus (używany tylko w raportach właścicieli treści)
Ten wymiar umożliwia wskazanie, że odpowiedź interfejsu API powinna zawierać tylko dane o treściach, do których zgłoszono prawa. Jedyna prawidłowa wartość tego wymiaru to claimed. Jeśli parametr filters ogranicza zapytanie do claimedStatus==claimed, interfejs API pobierze tylko dane dotyczące treści, do których zgłoszono prawa. Więcej informacji o tym, jak używać tego wymiaru, znajdziesz w tabeli w definicji wymiaru uploaderType.
uploaderType (wymiar podstawowy) (używany tylko w raportach właścicieli treści)
Ten wymiar pozwala określić, czy odpowiedź interfejsu API ma zawierać dane o treściach przesłanych przez określonego właściciela treści lub przez osoby trzecie, np. filmy przesłane przez użytkowników. Prawidłowe wartości to self i thirdParty. Jest to wymiar podstawowy, który podlega zasadom wycofywania.

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

Wartość claimedStatus Wartość uploaderType Opis
[Nie wybrano] self Pobiera dane Statystyk YouTube dotyczące treści objętych i nieobjętych roszczeniami, które zostały przesłane przez właściciela treści.
objęte roszczeniem [Nie wybrano] Pobiera dane dotyczące treści, do których zgłoszono roszczenie, przesłanych przez właściciela treści lub osobę trzecią.
objęte roszczeniem self Pobiera dane dotyczące zgłoszonych treści przesłanych przez właściciela treści.
objęte roszczeniem thirdParty Pobiera dane dotyczące treści objętych roszczeniem przesłanych przez osobę trzecią.

Przykłady

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