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. - 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)
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 |
|
|
| 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.