Introduction

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

W tym dokumencie opisano podobieństwa i różnice w sposobie, w jaki interfejs YouTube Analytics API i interfejs YouTube Reporting API zapewniają dostęp do danych z YouTube Analytics. Zadaniem tego dokumentu jest pomoc w wyborze odpowiedniego interfejsu API dla Twojej aplikacji.

Oba interfejsy API umożliwiają deweloperom pobieranie danych Statystyk YouTube. Dodatkowo oba interfejsy API obsługują właścicieli kanałów YouTube i właścicieli treści YouTube. Każdy z nich ma dostęp do określonego zestawu raportów:

  • Raporty dotyczące kanałów zawierają dane o aktywności użytkownika w przypadku określonego kanału.

  • Raporty właścicieli treści zawierają zbiorcze dane dotyczące wszystkich kanałów powiązanych z określonym właścicielem treści w YouTube. Na przykład wytwórnia płytowa może pobrać raport zawierający łączne statystyki kanałów YouTube wszystkich jej wykonawców. Niektóre raporty właściciela treści zawierają dane o aktywności użytkowników, a inne dane o przychodach i skuteczności reklam.

Interfejs API do raportowania umożliwia też niektórym właścicielom treści dostęp do raportów o przychodach z reklam zarządzanych przez system. Dane w raportach zarządzanych przez system można pobrać tylko za pomocą interfejsu API do raportowania.

Wszystkie żądania dotyczące YouTube Analytics i interfejsu YouTube Reporting API muszą zostać zatwierdzone przez kanał lub właściciela treści, do którego należą żądane dane.

Zgłoś zawartość

Raporty pobierane przez interfejsy API zawierają 2 rodzaje danych:

  • Wymiary to typowe kryteria używane do agregowania danych, takie jak data aktywności użytkownika lub kraj zamieszkania.

    W każdym wierszu danych w raporcie występuje unikalna kombinacja wartości wymiaru. W związku z tym kombinacja wartości wymiarów w każdym wierszu działa jako klucz podstawowy w tym wierszu.

  • Dane to indywidualne pomiary aktywności użytkowników, skuteczności reklam lub szacunkowych przychodów. Dane dotyczące aktywności użytkowników obejmują liczbę wyświetleń filmów i oceny (oceny pozytywne i negatywne).

Wybierz odpowiedni interfejs API dla swojej aplikacji

YouTube Analytics API
Interfejs YouTube Analytics API obsługuje wybrane zapytania w czasie rzeczywistym, aby generować niestandardowe raporty YouTube Analytics. Interfejs API udostępnia parametry filtrowania i sortowania, dzięki czemu aplikacja wywołująca nie musi natywnie obsługiwać tych funkcji.

Każde żądanie API określa zakres dat, z którego dane będą zwracane. Interfejs API umożliwia także pobieranie tygodniowych i miesięcznych zbiorów danych. W związku z tym aplikacja do wykonywania połączeń nie musi przechowywać pobranych zbiorów danych ani danych zbiorczych w zakresach dat.
Interfejs API YouTube do raportowania
Interfejs YouTube Reporting API pobiera raporty zbiorcze, które zawierają dane z YouTube Analytics dotyczące kanału lub właściciela treści. Jest ona przeznaczona dla aplikacji, które mogą importować duże zbiory danych oraz udostępniać narzędzia do filtrowania, sortowania i wydobywania informacji.

Każdy raport zawiera wstępnie zdefiniowany zestaw pól. Programiści używają tego interfejsu do planowania zadań raportowania, z których każdy identyfikuje raport, który powinien wygenerować YouTube. Następnie YouTube generuje raport dzienny, który można pobrać asynchronicznie. Każdy raport zawiera dane z unikalnego okresu 24-godzinnego.

Dodatkowo YouTube automatycznie generuje zestaw raportów zarządzanych przez system dla właścicieli treści, którzy mają dostęp do odpowiadających im raportów w YouTube Studio. Raporty te zapewniają automatyczny dostęp do danych o przychodach z reklam.

Obsługiwane raporty

W tabeli poniżej opisujemy różne typy raportów, które można pobierać za pomocą interfejsów API. Zapytania kierowane są dostępne za pomocą interfejsu YouTube Analytics API, a raporty zbiorcze są dostępne za pomocą interfejsu YouTube Reporting API.

Dane dostępne w jednym interfejsie API mogą być niedostępne w drugim. Na przykład interfejs YouTube Analytics API pozwala pobierać dane o aktywności użytkowników co tydzień lub co miesiąc, ale interfejs YouTube Reporting API wymaga samodzielnego agregowania tych danych. Z kolei interfejs YouTube Reporting API obsługuje raporty o zasobach dla właścicieli treści, ale nie są one dostępne w YouTube Analytics API.

Typy raportów
Raporty na temat filmów Obsługiwana w przypadku kanałów (zapytanie lub zbiorcze) i właścicieli treści (zapytanie lub zbiorcze).

Raporty dotyczące filmów zawierają statystyki dotyczące wszystkich działań użytkowników związanych z filmami na kanale lub filmami właściciela treści. Na przykład te raporty zawierają liczbę wyświetleń filmów. Niektóre raporty wideo właściciela treści w interfejsie YouTube Analytics API zawierają też szacunkowe dane o przychodach i skuteczności reklam.
Raporty dotyczące playlist Obsługiwana w przypadku kanałów (zapytanie lub zbiorcze) i właścicieli treści (zapytanie lub zbiorcze).

Raporty dotyczące playlist zawierają statystyki dotyczące wyświetleń filmów, które mają miejsce w kontekście playlisty. YouTube Reporting API obsługuje raporty o utrzymaniu uwagi odbiorców w przypadku playlist, ale YouTube Analytics API nie obsługuje podobnego raportu.
Raport skuteczności reklam Obsługiwane w przypadku właścicieli treści (zapytanie lub zbiorcze).

Raporty skuteczności reklam zawierają dane związane z wyświetleniami reklam, które były wyświetlane podczas odtwarzania filmów. Dane te odpowiadają za każde wyświetlenie reklamy, a każde odtworzenie filmu może przynieść kilka wyświetleń.
Raporty o szacunkowych przychodach Obsługiwane w przypadku właścicieli treści (zbiorczo).

Raporty Szacunkowe przychody zawierają łączne szacunkowe przychody z filmów pochodzących ze źródeł reklamowych sprzedawanych przez Google oraz źródeł innych niż reklamy. Raporty te zawierają również dane o skuteczności reklam. Pamiętaj, że raporty zarządzane przez system zawierają rzeczywiste przychody.
Raporty o zasobach Obsługiwane w przypadku właścicieli treści (zbiorczo).

Raport o zasobach zawiera dane o aktywności użytkowników związane z filmami połączonymi z zasobami właściciela treści. Film zostaje uwzględniony w raporcie, jeśli właściciel treści zgłosił roszczenie do filmu na podstawie jednego z zasobów właściciela. Film mógł zostać przesłany przez właściciela treści lub innego użytkownika YouTube.
Raporty zarządzane przez system Obsługiwane w przypadku właścicieli treści, którzy mają dostęp do odpowiednich raportów w sekcji Raporty w Studiu twórców YouTube.

Raporty zarządzane przez system dostarczają rzeczywistych danych o przychodach uzyskanych z zasobów i filmów. Dodatkowy raport zawiera listę filmów objętych roszczeniem i zasoby, do których te filmy pasują. Pamiętaj, że nie wszystkie raporty ze Studia twórców są obecnie dostępne w interfejsie API.

Uwaga: YouTube automatycznie generuje raporty zarządzane przez system dla właścicieli treści, którzy mają dostęp do odpowiadających im raportów w Studiu twórców. W efekcie proces pobierania tych raportów przebiega inaczej niż w przypadku innych typów raportów. Więcej informacji znajdziesz w dokumentacji raportów zarządzanych przez system.

Główne różnice

W tabeli poniżej znajdziesz ważne różnice między YouTube Analytics a interfejsami API do raportowania.

Funkcja YouTube Analytics API Interfejs API YouTube do raportowania
Proces pobierania danych Każde żądanie API określa wymiary i dane, które zostaną zwrócone, a także okres, za który zostaną zwrócone dane. Aplikacje planują zadania raportowania. Dla każdego zadania YouTube generuje raporty dzienne, które można pobrać asynchronicznie.
Zakresy dat Niektóre raporty API określają datę aktywności użytkownika. Niektóre z tych raportów obsługują wymiary pozwalające agregować dane o aktywności użytkowników według miesiąca. Wszystkie raporty interfejsu API określają dzień wystąpienia aktywności użytkownika. Aplikacje używające tego interfejsu API mogą wdrażać funkcje służące do gromadzenia danych w regularnych odstępach czasu.
Filtrowanie danych Możesz filtrować raporty, aby uwzględnić tylko wiersze, dla których wymiar ma określoną wartość. Interfejs API obsługuje też niektóre wymiary, takie jak kontynent i subkontynent, które są używane tylko jako filtry. Interfejs API obsługuje zbiorcze pobieranie całych zbiorów danych. Nie obsługuje ono filtrowania ani zwracania danych przeznaczonych tylko do filtrowania. Aplikacja kliencka przechowuje pobrane dane i implementuje własne funkcje do ich filtrowania.
Sortowanie Raporty można sortować na podstawie zwróconych wartości danych. Niektóre raporty obsługują tylko ograniczoną liczbę wyników. Na przykład raport zawierający listę najczęściej oglądanych filmów na kanale zwraca maksymalnie 200 wierszy. Ten interfejs API umożliwia zbiorcze pobieranie całych zbiorów danych. Aplikacje klienckie mogą wdrożyć własne funkcje w celu sortowania pobranych danych.
Wyliczenia Raporty interfejsu API zawierają wartości tekstowe, takie jak „ANDROID” lub „KANAŁ”, aby identyfikować wyliczane wartości wymiarów. Raporty API zawierają liczby całkowite, które można zmapować na wartości tekstowe.
Limit Serwer interfejsu API ocenia każde zapytanie, aby określić jego limit. Dokument Użycie limitu szczegółowo wyjaśnia metodologię. Wykorzystanie limitu nie stanowi problemu, ponieważ dane są pobierane raz, a następnie filtrowane, sortowane i zapytane w aplikacji.
Unikalne raporty
  • Aktywność użytkowników związana z napisami
  • Dane utrzymania uwagi odbiorców w przypadku playlist
  • Szacunkowe raporty o przychodach właścicieli treści (dostępne są 2 różne raporty)
  • Raporty dotyczące zasobów dla właścicieli treści (dostępnych jest 11 różnych raportów)
Unikalne wymiary grupa (wymiar tylko z filtrem)
kontynent (wymiar tylko filtra)
subkontynent (wymiar tylko filtra)
miesiąc
wysłany==1 (wymiar tylko filtra)
liczba obejrzeńna PlayPlayList
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
Unikalne dane unikalni użytkownicy
relativeStoragePerformance
viewsPerPlaylistStart
averageTimeInPlaylist
card_click_rate
card_clicks
card_impression
card_buster_click_rate
card_Zwiastun_clicks
card_insights_impression
dane_partnera_przychodów_}

Różnice w nazwach interfejsów API

Dwa interfejsy API obecnie używają różnych konwencji nazewnictwa do określania wymiarów i danych. Obecnie nazwy interfejsów YouTube Analytics API używają nazwy ComelCase, a nazwy interfejsów YouTube Reporting API używają nazw rozdzielanych znakami podkreślenia.

W tabelach poniżej znajdziesz różne nazwy używane przez te interfejsy API do identyfikowania tych samych danych i wymiarów. W niektórych przypadkach różnica między tymi nazwami jest wyższa niż w przypadku zamiany nazwy z camlCase na podkreślenie. Na przykład wymiar video w interfejsie YouTube Analytics API ma nazwę video_id w interfejsie YouTube Reporting API.

Wymiary

Nazwa interfejsu API YouTube Analytics Nazwa interfejsu API do raportowania YouTube
adType, typ_reklamy
grupa wiekowa [age_group]
zasób asset_id
audienceType. typ_odbiorców_retencji
kanał identyfikator_kanału
claimedStatus. claimed_status,
właściciel treści content_owner_id
country kod_kraju
dzień data
deviceType, device_type
elapsedVideoTimeRatio elapsed_video_time_percentage
gender [płeć] gender [płeć]
Szczegóły lokalizacji odtwarzania statystyk informacje_o_lokalizacji_odtworzenia
insightplayLocationType play_location_type
insightTrafficSourceDetails [traffic_source_detail]
insightTrafficSourceType traffic_source_type
na żywo na żądanie na żywo lub na żądanie
System operacyjny System operacyjny
playlista identyfikator_playlisty
province kod_regionu
UdostępnianieUsług usługa_fragmentacja
subscribedStatus subscribed_status (stan subskrybenta)
subtitleLanguage (Język napisów) language_subtitle
Typ przesyłania typ_przesyłania
wideo identyfikator_filmu

Dane

Nazwa interfejsu API YouTube Analytics Nazwa interfejsu API do raportowania YouTube
zarobki z reklam szacowane_przychody_partnera_reklam
adnotacjaWyświetlenia adnotacja_wyświetlenia
adnotationClickableImpressions adnotacja_klikalne_wyświetlenia
adnotacjaClicks adnotacja_kliknięcia
Współczynnik klikalności adnotacji współczynnik_klikalności_adnotacji
adnotacjaClosableImpressions adnotacja_zamknięcia_wyświetleń
adnotacjaZamknij zamknięcie_adnotacji
współczynnik zamykania adnotacji stawka_zamknięcia_adnotacji
odbiorcyobejrzenia protokół_retencji_odbiorców
średni czas oglądania średni_odsłony_czasu_wyświetlania
averageViewPercentage, średni_odsłony_odsetka_wyświetleń
współczynnik klikalności karty współczynnik_kliknięcia_karty
cardClicks card_clicks,
wyświetlenia miniatur card_impressions
współczynnik klikalności karty współczynnik_klikalności_karty
CardTeaserClicks, karty_zwiastuna_kliknięć
cardTeaserImpressions karty_zwiastuna_wyświetleń
komentarze komentarze
nie podoba mi się nie podoba mi się
zarobki szacowane_przychody_partnera
szacowane minuty watch_time_minutes
szacowanePartnerPartnerAdSense szacowane_przychody_partnera
szacowanePartnerPrzychody DoubleClick szacowane_przychody_partnera
bruttoPrzychody szacowane_youtube_ad_przychody
liczba wyświetleń – CPM szacunkowy_cpm
wyświetlenia ad_impressions
polubienia polubienia
odtworzenia generujące przychody Szacowane_odtworzenia_szacunkowe
odtwarzaniena podstawie stopy play-off estimated_playback_based_cpm,
PlayStarty start_playlist
savesAdd dodane_playlisty_dodane
savesRemoved usunięta_playlista_usunięta
udostępnienia udostępnienia
Liczba subskrybentów subskrybenci_odbiorców
subscribersLost subskrybenci_zagubieni
videosAddToPlaylisty. Filmy_dodane_do_playlisty
videosRemovedFromPlaylisty Filmy_usunięte_z_playlisty
odsetek widzów odsłona
obejrzenia obejrzenia