Introduction

W tym dokumencie opisujemy podobieństwa i różnice w sposobie, w jaki interfejs YouTube Analytics API i interfejs YouTube Reporting API dają dostęp do danych ze Statystyk YouTube. Celem dokumentu jest dobór odpowiedniego interfejsu API dla Twojej aplikacji.

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

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

  • Raporty właściciela 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 pobierać raporty zawierające łączne statystyki kanałów YouTube wszystkich 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 pobierać tylko za pomocą interfejsu API do raportowania.

Wszystkie żądania do YouTube Analytics oraz interfejsu YouTube Reporting API muszą zostać autoryzowane przez kanał lub właściciela treści, który jest właścicielem żądanych danych.

Treść raportu

Raporty pobierane przez interfejsy API zawierają 2 rodzaje danych:

  • Wymiary to typowe kryteria używane do agregacji danych, takie jak data wystąpienia aktywności użytkownika lub kraj, w którym się oni znajdują.

    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 tego wiersza.

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

Wybieranie odpowiedniego interfejsu API dla swojej aplikacji

YouTube Analytics API
Interfejs YouTube Analytics API obsługuje zapytania kierowane 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 od razu obsługiwać tych funkcji.

każde żądanie API określa zakres dat, z którego dane zostaną zwrócone. Interfejs API umożliwia też pobieranie tygodniowych i miesięcznych zbiorów danych. Aplikacja do wykonywania połączeń nie musi więc zapisywać pobranych zbiorów danych ani zbierać zbiorczych statystyk z różnych zakresów dat.
Interfejs API YouTube do raportowania
YouTube Reporting API pobiera raporty zbiorcze zawierające dane ze Statystyk YouTube kanału i właściciela treści. Jest ona przeznaczona dla aplikacji, które mogą importować duże zbiory danych oraz oferują narzędzia do filtrowania, sortowania i wydobywania danych.

Każdy raport zawiera wstępnie zdefiniowany zestaw pól. Deweloperzy używają tego interfejsu do planowania zadań związanych z raportowaniem, z których każde oznacza raport, który YouTube powinien wygenerować. Następnie YouTube generuje raport dzienny, który można asynchronicznie pobierać. 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ą zautomatyzowany 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ć przy użyciu interfejsów API. Zapytania objęte kierowaniem są dostępne przez interfejs YouTube Analytics API, natomiast raporty zbiorcze – przez interfejs YouTube Reporting API.

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

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

Raporty dotyczące filmów zawierają statystyki wszystkich działań użytkowników związanych z filmami na kanale lub filmami właściciela treści. Te raporty zawierają na przykład liczbę wyświetleń Twoich filmów. W interfejsie YouTube Analytics API niektóre raporty dotyczące filmów właścicieli treści uwzględniają również szacunkowe dane o przychodach i skuteczności reklam.
Raporty dotyczące playlist Obsługiwany przez kanały (zapytanie lub zbiorcze) i właścicieli treści (zapytanie lub zbiorcze).

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

Raporty skuteczności reklam zawierają dane dotyczące wyświetleń reklam, które wyświetlały się podczas odtwarzania filmu. Te dane uwzględniają każde wyświetlenie reklamy, a każde odtworzenie filmu może wygenerować wiele wyświetleń.
Raporty o szacunkowych przychodach Obsługiwany przez właścicieli treści (zbiorczo).

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

Raporty dotyczące zasobów zawierają dane o aktywności użytkowników związane z filmami powiązanymi z zasobami właściciela treści. Film jest uwzględniany w raporcie właściciela treści, jeśli właściciel treści zgłosił roszczenie do filmu na podstawie jednego z zasobów właściciela treści. Film mógł zostać przesłany przez właściciela treści lub innego użytkownika YouTube.
Raporty zarządzane przez system Ta opcja jest dostępna dla właścicieli treści, którzy mają dostęp do odpowiadających im raportów w sekcji Raporty w Studiu twórców YouTube.

Raporty zarządzane przez system zawierają rzeczywiste dane o przychodach uzyskanych z zasobów i filmów. Dodatkowy raport zawiera listę filmów objętych roszczeniem oraz zasobów, do których te filmy pasują. Pamiętaj, że nie wszystkie raporty 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 Studio twórców. W związku z tym proces pobierania tych raportów wygląda inaczej niż w przypadku pozostałych typów raportów z tej listy. Więcej informacji znajdziesz w dokumentacji dotyczącej raportów zarządzanych przez system.

Główne różnice

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

Funkcja YouTube Analytics API Interfejs API YouTube do raportowania
Procedura pobierania danych Każde żądanie API określa wymiary i dane do zwrócenia, a także okres, za który mają być zwracane dane. Aplikacje planują zadania raportowania. Dla każdego zadania YouTube generuje raporty dzienne, które można asynchronicznie pobierać.
Zakresy dat Niektóre raporty interfejsu API określają datę aktywności użytkownika. Niektóre z tych raportów obsługują wymiary, według których agregujesz dane o aktywności użytkowników według miesiąca. Wszystkie raporty interfejsu API określają dzień, w którym miała miejsce aktywność użytkownika. Aplikacje używające interfejsu API mogą wdrażać funkcje do agregowania danych w określonych odstępach czasu.
Filtrowanie danych Możesz filtrować raporty, aby uwzględnić tylko te wiersze, w 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 dotyczących tylko wymiarów filtra. Aplikacja kliencka przechowuje pobrane dane i implementuje własne funkcje do filtrowania danych.
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 obsługuje zbiorcze pobieranie całych zbiorów danych. Aplikacje klienckie mogą implementować własne funkcje, aby sortować pobrane dane.
Wyliczenia Raporty interfejsu API zawierają wartości tekstowe, takie jak „ANDROID” lub „KANAŁ”, które służą do identyfikowania wyliczonych wartości wymiarów. Raporty w interfejsie API zawierają liczby całkowite, które można zmapować na wartości tekstowe.
Limit Serwer interfejsu API ocenia każde zapytanie w celu określenia jego limitu. Więcej informacji o metodologii znajdziesz w sekcji dotyczącej limitu. Wykorzystanie limitu nie stanowi problemu, ponieważ dane są pobierane raz, a potem filtrowane, sortowane i wysyłane zapytania w aplikacji.
Unikalne raporty
  • Aktywność użytkowników związana z napisami
  • Dane dotyczące utrzymania uwagi odbiorców playlist
  • raporty o szacunkowych przychodach dla właścicieli treści (dostępne są 2 różne raporty).
  • Raporty o zasobach dla właścicieli treści (dostępnych jest 11 różnych raportów)
Unikalne wymiary grupa (wymiar tylko do filtrowania)
kontynent (tylko wymiar filtra)
subContinent (wymiar tylko do filtrowania)
miesiąc
wyselekcjonowany==1 (wymiar tylko do filtrowania)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
Unikalne dane unikalni użytkownicy
relativeUtrzymaniePerformance
viewsPerPlaylistStart
averageTimeInPlaylist
card_click_rate
card_clicks
card_impressions
card_buster_click_rate
card_Zwiastun_clicks
card_buster_impressions
estimated_partner_adsense_przychody1}}}

Różnice w nazwach interfejsów API

Dwa interfejsy API obecnie używają różnych konwencji nazewnictwa do identyfikowania wymiarów i danych. Obecnie nazwy interfejsów API YouTube Analytics korzystają z nazwy ComelCase, a nazwy interfejsów YouTube Reporting API używają podkreśleń.

W tabelach poniżej znajdziesz różne nazwy używane przez te interfejsy API w celu identyfikowania tych samych danych i wymiarów. W niektórych przypadkach różnica między tymi 2 nazwami różni się od wartości uzyskanej po przekonwertowaniu nazwy z commelCase na podkreślenia. 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 YouTube Reporting API
adType, typ_reklamy
ageGroup, age_group [grupa_wiekowa]
komponent asset_id (identyfikator zasobu)
audienceType (typ odbiorców) typ_odbiorców
kanał identyfikator_kanału
claimedStatus. claimed_status,
właściciel treści identyfikator_właściciela_treści
country kod_kraju
dzień data
deviceType, device_type
Format poklatkowy eexpirationd_video_time_percentage
gender [płeć] gender [płeć]
Szczegóły lokalizacji insightPlay szczegóły_odtworzenia lokalizacji
insightplayLocationType playback_location_type
insightTrafficSourceDetails szczegóły_źródła_ruchu
insightTrafficSourceType traffic_source_type
LiveOrOnRequest na_żywo_lub_na żądanie
System operacyjny system operacyjny
playlista identyfikator_playlisty
province kod_prowincji
UdostępnianieUsług fragment_usługi
subscribedStatus, subscribed_status,
subtitleLanguage, language_language
typ przesyłający typ_przesyłającego
wideo identyfikator_filmu

Dane

Nazwa interfejsu API YouTube Analytics Nazwa interfejsu YouTube Reporting API
Zarobki z reklam szacowane_przychody_z_reklam
wyświetlenia adnotacji adnotation_impressions,
adnotationClickableImpressions, adnotation_clickable_impressions,
kliknięcia adnotacji kliknięcia_adnotacji
Współczynnik klikalności adnotacji współczynnik_klikalności_adnotacji
adnotationClosableImpressions liczba_zamkniętych_wyświetleń_adnotacji
zamknięcie adnotacji zamknięcie_adnotacji
Współczynnik zamykania adnotacji stawka_zamknięcia_adnotacji
AudienceWatchRatio, audience_retention_percentage
averageViewDuration średni_wyświetlony_czas trwania_sekundy
averageViewPercentage average_view_duration_percentage
współczynnik klikalności częstotliwość_kliknięcia_karty
cardClicks, card_clicks,
cardimpression, card_impressions,
Współczynnik klikalności karty współczynnik_klikania_karty
KartaTeaserClicks card_buster_clicks,
KartaTeTesery Karta_Zwiastun_wyświetlenia
komentarze komentarze
głosy na nie głosy na nie
zarobki szacowane_przychody_partnera
estimatedMinutes watch_time_minutes
szacowane przychodyPartnerAdSense szacowane_przychody_partnera
szacowanePartnerPartner DoubleClick szacunkowy_przychod_na_partnerze
bruttoprzychody szacunkowe_przychody_w_YouTube
impressionBasedCpm szacunkowy_CPM
wyświetlenia ad_impressions,
polubienia polubienia
Odtworzenia generujące przychody szacunkowe_przychody_szacunkowe
playbackBasedCpm estimated_playback_based_cpm,
playlistyrozpoczęcia playlisty_początków,
savesDodano playlista_zapisana_dodana
savesRemoved usunięta_zapisana_playlista
udostępnienia udostępnienia
liczba pozyskanych subskrybentów subscribers_gaeded
subscribersLost subskrybenci zagubieni
videosAddToPlaylisty videos_added_to_playlists,
videosRemovedFromPlaylisty filmy_usunięte_z_playlisty
odsetek widzów views_percentage
wyświetlenia wyświetlenia