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