Dimensions

Ten dokument zawiera definicje wymiarów obsługiwanych 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 służące do agregowania danych zbiorczych, np. data aktywności użytkownika lub kraj, w którym znajdowali się użytkownicy.

Każdy raport dotyczący zapytań określa wymiary, które obsługuje. Na przykład podczas pobierania aktywności użytkownika według czasu wybierasz 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.

Podstawowe wymiary

Chociaż interfejs YouTube Analytics API podlega zasadom wycofywania funkcji lub usług określonym w Warunkach korzystania z usługi, wymiary (i dane) inne niż podstawowe nie podlegają tym zasadom. W definicjach na tej stronie każdy wymiar, który jest wymiarem podstawowym, 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, które podlegają zasadom wycofywania.

Filtry

Wszystkie raporty kwerend obsługują filtry. Filtry określają wartości wymiarów, które muszą być obecne w pobranym zbiorze danych. Ograniczają one odpowiedź interfejsu API, tak aby zawierała tylko dane pasujące do określonej wartości lub zestawu wartości. Zamiast pobierać dane o aktywności użytkowników we wszystkich krajach, możesz np. użyć filtra, aby pobrać dane tylko dla konkretnego kraju.

W żądaniu pobrania raportu zapytań 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 do interfejsu API dotyczące pobierania raportów właściciela treści muszą filtrować dane za pomocą jednego z wymiarów podmiotu raportującego lub obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

Wymiary

W kolejnych sekcjach opisano wymiary używane w raportach zapytań YouTube Analytics API. O ile nie zaznaczono inaczej, te wymiary są używane zarówno w raportach kanału, jak 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ślenie wielu wartości wymiarów video, playlist i channel, gdy są one używane jako filtry. Aby to zrobić, ustaw wartość parametru filters na listę rozdzieloną przecinkami, zawierającą identyfikatory filmów, playlist lub identyfikatory kanałów, dla których odpowiedź interfejsu API powinna być filtrowana. Wartość parametru może zawierać maksymalnie 500 identyfikatorów.

video (wymiar podstawowy)
Identyfikator filmu na 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.
playlist
Identyfikator playlisty w YouTube. W interfejsie YouTube Data API jest to wartość właściwości id zasobu playlist.
channel (wymiar podstawowy) (używany tylko w raportach właściciela 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ściciela treści, ponieważ zwykle zawierają one dane zbiorcze z wielu kanałów.
group (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 dotyczące wszystkich filmów, playlist lub kanałów w tej grupie.

Przykłady

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

  • Przykłady kanałów

    • Podstawowe statystyki
      • Top 10 – najczęściej oglądane filmy na kanale
      • Pierwsza dziesiątka – współczynniki klikalności adnotacji w najczęściej oglądanych filmach na kanale
      • Statystyki konkretnej playlisty
      • Top 10 – najczęściej oglądane playlisty na kanale
    • Geograficzne
      • Top 10 – 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
      • Top 10 – najczęściej oglądane filmy właściciela treści
      • Top 10 – najczęściej oglądane filmy właściciela treści
      • Top 10 – najczęściej oglądane filmy na kanale właściciela treści
      • Pierwsza dziesiątka – współczynniki klikalności adnotacji w najczęściej oglądanych filmach na kanale
      • Top 10 – najczęściej oglądane playlisty właściciela treści
    • Geograficzne
      • Top 10 – najczęściej oglądane filmy w Europie dla właściciela treści
      • Top 10 – najczęściej odtwarzane playlisty w Stanach Zjednoczonych

Obszary geograficzne

Te wymiary określają region geograficzny powiązany z danymi o aktywności użytkownika, skuteczności reklam lub szacunkowych 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 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ść wymiaru to kod ISO 3166-2, który identyfikuje stan USA lub Dystrykt Kolumbii, np. US-MI (Michigan) lub US-TX (Teksas). Kod prowincji US-ZZ służy do raportowania danych, w przypadku których YouTube nie może zidentyfikować powiązanego stanu w USA. Gdy żądanie do interfejsu API zawiera wartość province w parametrze dimensions, musi ono również ograniczać dane do Stanów Zjednoczonych, uwzględniając wartość country==US w parametrze filters.

Uwaga: ten wymiar nie obsługuje wartości ISO 3166-2, które identyfikują terytoria zależne Stanów Zjednoczonych, ponieważ te terytoria mają też własne kody krajów ISO 3166-1. Nie obsługuje też podziału administracyjnego krajów innych niż Stany Zjednoczone.

dma
Trzycyfrowy identyfikator, którego Nielsen używa do identyfikacji rynku docelowego (DMA) powiązanego ze zdarzeniami wyświetlenia opisanymi w wierszu danych.
city
Szacunkowe miasto powiązane z danymi w wierszu raportu. Dane dotyczące tego wymiaru są dostępne od 1 stycznia 2022 r.
continent (tylko filtr)
Kod regionu statystycznego Organizacji Narodów Zjednoczonych (ONZ). Interfejs API obsługuje te wartości:
Wartość Opis
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, podając wartość REGION_CODE z tabeli.
subContinent (tylko filtr)
Kod regionu statystycznego ONZ, który identyfikuje subregion geograficzny. Wydział Statystyki Organizacji Narodów Zjednoczonych podaje listę subregionów oraz krajów powiązanych z każdym regionem.

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 używają wymiarów lub filtrów geograficznych:

  • Przykłady kanałów

    • Podstawowe statystyki: liczba wyświetleń kanału w poszczególnych krajach (i inne dane).
    • 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 stanów USA i Waszyngtonu.
      • Dane dotyczące czasu 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 z różnych miejsc odtwarzania.
    • Źródło wizyt: liczba wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju.
    • Dane demograficzne: dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć).
    • Najpopularniejsze filmy
      • Top 10 – 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ń w poszczególnych krajach (i inne dane) dla wszystkich przesłanych przez Ciebie filmów.
    • Geograficzne
      • Dane dotyczące czasu oglądania w poszczególnych krajach w przypadku treści przesłanych przez Ciebie
      • Dane dotyczące adnotacji w poszczególnych krajach w przypadku treści przesłanych przez użytkowników
      • Dane dotyczące poszczególnych stanów USA i Waszyngtonu.
      • Dane dotyczące czasu oglądania playlist 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 z różnych miejsc 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 zbiorcze na podstawie okresu, np. dnia, tygodnia lub miesiąca. Parametry żądania startDate i endDate określają okres, za który raport zawiera dane. Pamiętaj, że raport zawiera dane do ostatniego dnia, dla którego wszystkie dane określone w żądaniu są dostępne w momencie wysłania zapytania. 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 rezultacie daty, w których zegary są przestawiane do przodu na czas letni, 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.

day (wymiar podstawowy)
Gdy używasz tego wymiaru, dane w raporcie są agregowane codziennie, a każdy wiersz zawiera dane z jednego dnia. Możesz użyć innych wymiarów, aby jeszcze bardziej szczegółowo przeanalizować dane. Na przykład raport dotyczący źródeł wizyt może zawierać zbiorcze dzienne statystyki oglądalności oparte na sposobie, w jaki użytkownicy docierają do Twoich filmów. This is a core dimension and is subject to the Deprecation Policy.
month (wymiar podstawowy)
Dane w raporcie są agregowane według miesiąca kalendarzowego. Podobnie jak w przypadku raportów dziennych, możesz użyć innych filtrów, aby jeszcze bardziej podzielić dane na segmenty. W raporcie daty są podawane w formacie YYYY-MM.

Uwaga: jeśli zapytanie do interfejsu API używa wymiaru month, parametry start-date i end-date muszą być ustawione na pierwszy dzień miesiąca. This is a core dimension and is subject to the Deprecation Policy.

Przykłady

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

  • Przykłady kanałów

    • Czasowe
      • Dzienne dane dotyczące czasu oglądania filmów na kanale
      • Dzienne dane dotyczące adnotacji w filmach na kanale
      • Dzienna liczba wyświetleń playlist na kanale
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Źródło wizyt: dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Dzienne dane dotyczące typu urządzenia w systemie operacyjnym Android
      • Dzienne dane dotyczące systemów operacyjnych na urządzeniach mobilnych
      • Dzienne dane o systemie operacyjnym i typie urządzenia

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

    • Czasowe
      • Dzienne dane o czasie oglądania treści przesłanych przez Ciebie
      • Dane dotyczące adnotacji w treściach objętych roszczeniem
      • Dzienna liczba wyświetleń playlisty dla właściciela treści
    • Miejsce odtwarzania: dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania.
    • Źródło wizyt: dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt.
    • Urządzenie/system operacyjny
      • Codzienne dane dotyczące typu urządzenia w przypadku filmów objętych roszczeniem
      • Dzienne dane dotyczące systemów operacyjnych, na których odtwarzano objęte roszczeniem filmy na urządzeniach mobilnych.
      • Dzienne dane o systemie operacyjnym i typie urządzenia
    • Przychody / skuteczność reklam: dzienne przychody i wskaźniki skuteczności reklam.

Miejsca odtwarzania

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

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

  • 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, gdzie film został umieszczony za pomocą elementu <iframe> lub <object>.

  • EXTERNAL_APP – dane dotyczą wyświetleń, które miały miejsce w aplikacji innej firmy, gdzie film został odtworzony za pomocą metody innej niż umieszczenie w tagu <iframe> lub <object>. Na przykład odtworzenia w aplikacjach, które korzystają z interfejsu YouTube Android Player API, będą kategoryzowane za pomocą tej wartości.

  • IMMERSIVE_LIVE_FEED – dane opisują wyświetlenia, które miały miejsce na liście transmisji na żywo w pionie.

  • MOBILE – dane opisują wyświetlenia, które miały miejsce w witrynie mobilnej 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 odtworzenia MOBILE w raportach Statystyk YouTube. Wartość może pozostać w raportach, ponieważ starsze dane nadal należą do tej kategorii. Po tej dacie odtworzenia na urządzeniach mobilnych są klasyfikowane jako odtworzenia na urządzeniach WATCH, EMBEDDED lub EXTERNAL_APP, w zależności od typu aplikacji, w której nastąpiło odtworzenie.

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

  • SHORTS_FEED – dane opisują wyświetlenia, które miały miejsce na karcie YouTube Shorts.

  • WATCH – dane opisują wyświetlenia, które miały miejsce na stronie odtwarzania filmu w YouTube lub w oficjalnej aplikacji YouTube, np. aplikacji 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. Pamiętaj, że ten raport obsługuje tylko wyświetlenia, które miały miejsce w odtwarzaczach umieszczonych na stronach, i wskazuje odtwarzacze, które wygenerowały najwięcej wyświetleń danego filmu. Dzięki temu zapewnia bardziej szczegółowy widok niż raport dotyczący miejsca odtwarzania, ponieważ identyfikuje adresy URL lub aplikacje powiązane z najpopularniejszymi odtwarzaczami umieszczonymi na stronach.

Przykłady

Te przykładowe żądania używają wymiarów miejsca odtwarzania:

  • Przykłady kanałów

    • Miejsca odtwarzania
      • liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania;
      • dzienną liczbę wyświetleń i czas oglądania z różnych miejsc odtwarzania,
      • Top 10 – witryny innych firm, które generują najwięcej wyświetleń umieszczonego filmu.
      • Liczba wyświetleń i czas oglądania playlisty z różnych miejsc odtwarzania
      • Dzienna liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania.

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

    • Miejsca odtwarzania
      • liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania;
      • dzienną liczbę wyświetleń i czas oglądania z różnych miejsc odtwarzania,
      • Top 10 – witryny innych firm, które generują najwięcej wyświetleń umieszczonego filmu.
      • Liczba wyświetleń i czas oglądania playlisty z różnych miejsc odtwarzania
      • Dzienna liczba wyświetleń playlisty i czas oglądania z różnych miejsc 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 dla tego wymiaru są dostępne od 1 stycznia 2019 r.

W tabeli poniżej znajdziesz wartości wymiaru:
Wartość Opis
LIVE_STREAM Oglądane treści były transmisją na żywo w YouTube.
SHORTS Obejrzane treści były YouTube Short.
STORY Obejrzane treści były relacją na YouTube.
VIDEO_ON_DEMAND Oglądane treści były filmem na YouTube, który nie pasuje do żadnej z pozostałych wartości wymiaru.
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.

W tabeli poniżej znajdziesz wartości wymiaru:
Wartość Opis
LIVE Dane w wierszu opisują aktywność użytkownika podczas transmisji na żywo.
ON_DEMAND Dane w 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 subskrybowali kanał, na którym znajduje się film lub playlista. 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 i obejrzy jeden z filmów na tym kanale, a następnie zasubskrybuje kanał i obejrzy kolejny film, wszystko tego samego dnia. Raport kanału wskazuje, że jedno wyświetlenie ma wartość subscribedStatus równą SUBSCRIBED, a drugie – wartość subscribedStatus równą UNSUBSCRIBED.
youtubeProduct
Ten wymiar określa usługę YouTube, w której miała miejsce aktywność użytkownika. Dane dotyczące tego wymiaru są dostępne od 18 lipca 2015 r.

W tabeli poniżej znajdziesz wartości wymiaru:
Wartość Opis
CORE Aktywność użytkownika, która nie miała miejsca w jednej ze specjalnych aplikacji YouTube (YouTube Gaming, YouTube Kids lub YouTube Music). Wyjątek: aktywność użytkownika, która miała miejsce w YouTube Music przed 1 marca 2021 r., jest uwzględniona w: CORE.
GAMING Aktywność uż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ą uwzględnione w wymiarze CORE. Dane w czasie rzeczywistym nie są rejestrowane.
UNKNOWN Aktywność użytkownika miała miejsce przed 18 lipca 2015 r.

Źródła wizyt

insightTrafficSourceType
Dane w raporcie są agregowane na podstawie typu strony odsyłającej, który opisuje sposób, w jaki użytkownicy dotarli do filmu. Możliwe wartości tego wymiaru:
  • ADVERTISING – widz został przekierowany do filmu przez reklamę. Jeśli filtrujesz dane na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa typ reklamy.
  • ANNOTATION – widzowie dotarli do filmu, klikając adnotację w innym filmie.
  • CAMPAIGN_CARD – wyświetlenia pochodzące z filmów przesłanych przez użytkowników, które zostały objęte roszczeniem i 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 pochodzą z linku na innej stronie. Jeśli filtrujesz na podstawie tego źródła ruchu, 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 z powiązanymi Shorts.
  • LIVE_REDIRECT – wyświetlenia filmu pochodzą z Live Redirect.
  • NO_LINK_EMBEDDED – film został umieszczony w innej witrynie, gdy był oglądany.
  • NO_LINK_OTHER – YouTube nie zidentyfikował strony odsyłającej. 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, gdy film był odtwarzany 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 „Polecane 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 po przesunięciu palcem w pionie z poprzedniego filmu w odtwarzaczu Shorts.
  • SOUND_PAGE – wyświetlenia pochodzące ze stron z powiązanymi Shorts z dźwiękiem.
  • SUBSCRIBER – wyświetlenia filmu 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 określa elementy 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 dane na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa identyfikator kanału.
  • YT_OTHER_PAGE – wyświetlenia filmu pochodzą z linku innego niż wynik wyszukiwania lub link do podobnego filmu, który pojawił się na stronie YouTube. Jeśli filtrujesz na podstawie tego źródła ruchu, pole insightTrafficSourceDetail identyfikuje stronę.
  • YT_SEARCH – wyświetlenia filmu pochodzą z wyników wyszukiwania na YouTube. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail określa wyszukiwane słowo.
  • VIDEO_REMIXES – wyświetlenia filmu pochodzą 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ł przekierowany.
  • WATCH_WITH – wyświetlenia filmu pochodzą z transmisji z komentarzem twórcy lub z transmisji „Oglądaj z”. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail określa film, z którego widz został przekierowany.
insightTrafficSourceDetail
Dane w raporcie są agregowane na podstawie źródeł odesłań, które wygenerowały najwięcej wyświetleń danego filmu i określonego typu źródła wizyt. Poniżej znajdziesz listę źródeł wizyt, dla których dostępny jest ten raport. W przypadku każdego źródła wizyt lista zawiera informacje, które dostarcza wymiar insightTrafficSourceDetail.
  • ADVERTISING – typ reklamy, która doprowadziła do wyświetleń. 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
    • Z zarezerwowanej reklamy In-Stream, którą można pominąć
    • TrueView w wynikach wyszukiwania i TrueView na stronie
    • 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 widzowie zostali przekierowani do filmu.
  • HASHTAGS – hashtag, który doprowadził do wyświetleń.
  • NOTIFICATION – e-mail lub powiadomienie, które przekierowało ruch.
  • RELATED_VIDEO – podobny film, który doprowadził widzów do filmu, którego dotyczy raport.
  • SOUND_PAGE – film, który wygenerował wyświetlenia.
  • SUBSCRIBER – element na stronie głównej lub funkcja subskrypcji YouTube, która doprowadziła widzów do filmu uwzględnionego w raporcie. Prawidłowe wartości to:
    • activity – wyświetlenia z elementów na karcie Subskrypcje 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 newslettera lub dodanie czegoś do playlisty.
    • blogged – wyświetlenia z elementów w kanałach subskrypcji na stronie głównej, które wynikały z linków na najpopularniejszych blogach.
    • mychannel – wyświetlenia z elementów na innych kartach 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 powiadomieniami o 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 obejrzeli film.
  • YT_OTHER_PAGE – strona YouTube, z której widzowie zostali przekierowani do filmu.
  • YT_SEARCH – wyszukiwane hasło, które doprowadziło widzów do filmu.
  • VIDEO_REMIXES – film, który wygenerował wyświetlenia.
  • WATCH_WITH – film, który wygenerował wyświetlenia.

Przykłady

Te przykładowe żądania korzystają z wymiarów związanych ze źródłami 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
      • dzienną liczbę wyświetleń i czas oglądania z różnych źródeł wizyt,
      • Top 10 – wyszukiwane słowa w YouTube, które generują największy ruch w przypadku filmu.
      • Top 10 – wyszukiwane hasła w wyszukiwarce Google, które generują największy ruch w przypadku filmu.
      • Liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt w danym kraju
      • Dzienna liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

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

    • Źródło wizyt
      • liczba wyświetleń i czas oglądania z różnych źródeł wizyt;
      • dzienną liczbę wyświetleń i czas oglądania z różnych źródeł wizyt,
      • Top 10 – wyszukiwane słowa w YouTube, które generują największy ruch w przypadku filmu.
      • Top 10 – wyszukiwane hasła w wyszukiwarce Google, które generują największy ruch w przypadku filmu.
      • Liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt w danym kraju
      • Dzienna liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

Urządzenia

deviceType
Ten wymiar określa rodzaj urządzenia, na którym obejrzano materiał. 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 do danych o określonym typie urządzenia.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
Ten wymiar określa system oprogramowania urządzenia, na którym obejrzano materiał. Poniższa lista zawiera systemy operacyjne, dla których interfejs API zwraca dane. Możesz też użyć wymiaru operatingSystem jako filtra, aby ograniczyć raport o typie urządzenia do danych dotyczących 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 korzystają z wymiarów urządzenia:

  • Przykłady kanałów

    • Urządzenie/system operacyjny
      • Dzienne dane dotyczące typu urządzenia w systemie operacyjnym Android
      • Dzienne dane dotyczące systemów operacyjnych na urządzeniach mobilnych
      • Dzienne dane o systemie operacyjnym i typie urządzenia
      • Dzienne dane dotyczące typu urządzenia w przypadku wyświetleń playlisty 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
      • Codzienne dane dotyczące typu urządzenia w przypadku filmów objętych roszczeniem
      • Dzienne dane dotyczące systemów operacyjnych, na których odtwarzano objęte roszczeniem filmy na urządzeniach mobilnych.
      • Dzienne dane o systemie operacyjnym i typie urządzenia
      • Dzienne dane dotyczące typu urządzenia w przypadku wyświetleń playlisty w systemie operacyjnym Android
      • Dzienne dane dotyczące systemu operacyjnego w przypadku wyświetleń playlist na urządzeniach mobilnych

Dane demograficzne

Wymiary demograficzne pomagają poznać rozkład odbiorców według przedziału wiekowego i płci. W Centrum pomocy YouTube znajdziesz 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 do raportu i obejmuje użytkowników, którzy według szacunków YouTube nie ukończyli 18 lat. 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 do 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 używają 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 wymiarów:
Platforma Wartość interfejsu API
Allo ALLO
Ameba AMEBA
E-mail na Androidzie ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Wiadomości na Androidzie ANDROID_MMS
Okno udostępniania w systemie Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
Uzyskaj reakcję BLIND_REACT
Blogger BLOGGER
Kopiuj do schowka COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Okno aktywności systemu bezpośredniego DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
Wyświetlony kod QR DISPLAYED_QR_CODE
Dropbox DROPBOX
Umieść EMBED
E-mail MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Strony na Facebooku FACEBOOK_PAGES
Udostępnienie grupie na Facebooku FACEBOOK_SHARE_TO_GROUP
Relacje na Facebooku FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Aplikacja Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Skrzynka odbiorcza Google INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
SMS od HTC HTC_MMS
IMO IMO
Instagram INSTAGRAM
Instagram Stories INSTAGRAM_STORIES
Link z zaproszeniem (na urządzeniu z Androidem) INVITE_LINK_ANDROID
Link z zaproszeniem (na urządzeniu z iOS) INVITE_LINK_IOS
Zapraszanie współtwórców playlisty INVITE_PLAYLIST_COLLABORATORS
Okno aktywności systemu iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Wiadomości na KaiOS KAIOS_MESSAGES
Kik KIK
E-mail LGE LGE_EMAIL
Liniowy LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Kopiowanie i wklejanie w Mapach MAPS_COPY_PASTE
Udostępnianie na żywo w Meet MEET_LIVE_SHARING
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
Szybkie udostępnianie QUICK_SHARE
Szybkie udostępnianie (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Remiks REMIX
Wiadomości Samsung SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
Zapisz w zdjęciach na urządzeniu SAVE_TO_DEVICE_PHOTOS
Udostępnij bez reklam SHARE_AD_FREE
Udostępnij kamerze w aplikacji Snapchat SHARE_TO_SNAPCHAT_CAMERA
Udostępnianie dzieciom SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Rozmowy z Sony 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
Okno aktywności systemu internetowego WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! Japonia YAHOO
post na karcie Społeczność na YouTube YOUTUBE_COMMUNITY_POST
Ponowne opublikowanie na karcie Społeczność na YouTube YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
Podgląd udostępnienia z YouTube Music na Snapchacie YTM_SHARE_TO_SNAPCHAT_PREVIEW
Green Screen w YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
Oglądanie YouTube ze znajomymi YOUTUBE_WATCH_WITH_FRIENDS

Więcej informacji znajdziesz w dokumentacji.

Przykłady

Te przykładowe żądania korzystają z wymiarów społecznościowych:

  • Przykłady kanałów

    • Społecznościowe: dane dotyczące udostępniania, zagregowane według usługi, w której filmy zostały udostępnione.

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

    • Społecznościowe: dane dotyczące udostępniania, zagregowane według usługi, w której filmy zostały udostępnione.

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 mierzenia utrzymania uwagi odbiorców w czasie, a wymiar elapsedVideoTimeRatio jest miarą czasu. Na przykład wartość 0.4 wskazuje, że odpowiednie dane do raportu pokazują dane o utrzymaniu uwagi po upływie 40% filmu.

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

Przykłady

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

Transmisje na żywo

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

Anulowanie subskrypcji

membershipsCancellationSurveyReason
Liczba ankiet wypełnionych przez użytkowników YouTube, którzy anulowali wspieranie określonego kanału w okresie raportowania. W tabeli poniżej znajdziesz prawidłowe wartości wymiarów:
Wartość interfejsu API Wyjaśnienie
UNKNOWN Użytkownik nie wypełnił ankiety.
DISLIKE_PERKS Użytkownikowi nie podobały się bonusy dla wspierających.
PERKS_NOT_DELIVERED Użytkownik twierdzi, że obiecane bonusy dla wspierających nie zostały dostarczone.
CANNOT_ACCESS_PERKS Użytkownik nie mógł uzyskać dostępu do bonusów.
NO_LONGER_INTERESTED Użytkownik nie jest już zainteresowany wspieraniem kanału.
FEEL_UNAPPRECIATED Użytkownik nie czuł się doceniany 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 gromadzi żądane dane na podstawie typów reklam, które wyświetlały się podczas odtwarzania filmów. Poniższa lista zawiera możliwe wartości wymiarów. Więcej informacji o formatach reklam na YouTube znajdziesz w Centrum pomocy YouTube.

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

  • auctionDisplay – reklama rich media lub graficzna, która wyświetla się jako nakładka u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych formatów. Po wyświetleniu nakładka automatycznie zamyka się po upływie określonego czasu. Użytkownik może też zamknąć ją samodzielnie. Jeśli nakładka i baner wyświetlają się razem, każda reklama jest liczona jako osobne wyświetlenie.

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

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

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

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

  • reservedBumperInstream – reklamy wideo niemożliwe do pominięcia, sprzedawane na zasadzie rezerwacji, 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świetlana jest jednostka reklamowa typu „kliknij, aby odtworzyć”, niezależnie od tego, czy użytkownik rozpocznie odtwarzanie. Są one sprzedawane w ramach rezerwacji.

  • reservedDisplay – reklama rich media lub graficzna, która wyświetla się jako nakładka u dołu odtwarzacza, jako jednostka reklamowa 300 x 250 na stronie odtwarzania filmu lub jako połączenie obu tych formatów. Po wyświetleniu nakładka automatycznie zamyka się po upływie określonego czasu. Użytkownik może też zamknąć ją samodzielnie. Jeśli nakładka i baner wyświetlają się razem, każda reklama jest liczona jako osobne wyświetlenie.

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

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

Przykłady

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

  • Przykłady kanałów

    • Przychody/reklamy
      • Dane dotyczące przychodów kanału i wskaźników skuteczności reklam
      • Dane o dziennych przychodach i skuteczności reklam
      • Dane dotyczące przychodów i skuteczności reklam w poszczególnych krajach
      • Top 10 – filmy z najwyższymi przychodami
      • Wskaźniki 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 w przypadku 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
      • Top 10 – filmy z najwyższymi przychodami
      • Wskaźniki skuteczności reklam dla różnych typów reklam

Wymiary właściciela treści

Te wymiary są obsługiwane tylko w raportach właściciela treści.

Ważne: żądania do interfejsu API dotyczące 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, jak opisano poniżej.
claimedStatus (używane tylko w raportach właściciela treści)
Ten wymiar pozwala wskazać, że odpowiedź interfejsu API powinna zawierać tylko dane dotyczące treści objętych roszczeniem. Jedyną prawidłową wartością tego wymiaru jest claimed. Jeśli parametr filters ogranicza zapytanie do claimedStatus==claimed, interfejs API pobierze tylko dane dotyczące treści objętych roszczeniem. Tabela w definicji wymiaru uploaderType zawiera więcej informacji o tym, jak go używać.
uploaderType (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 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 funkcji lub usług.

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 roszczeniem, które zostały przesłane przez właściciela treści.
objęte roszczeniem [Nie wybrano] Pobiera dane dotyczące objętych roszczeniem treści przesłanych przez właściciela treści lub osobę trzecią.
objęte roszczeniem self Pobiera dane dotyczące treści objętych roszczeniem przesłanych przez właściciela treści.
objęte roszczeniem thirdParty Pobiera dane dotyczące treści objętych roszczeniem, które zostały przesłane przez osobę trzecią.

Przykłady

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