W tym dokumencie opisujemy podobieństwa i różnice w sposobie, w jaki interfejsy YouTube Analytics API i YouTube Reporting API zapewniają dostęp do danych w Statystykach YouTube. Ten dokument ma pomóc Ci w wyborze odpowiedniego interfejsu API do Twojej aplikacji.
Oba interfejsy API umożliwiają programistom pobieranie danych Statystyk YouTube. Oba interfejsy API obsługują dodatkowo właścicieli kanałów i treści w 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żytkowników w określonym kanale.
-
Właściciel treści w raporcie zawiera 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 połączone statystyki kanałów YouTube wszystkich wykonawców tej wytwórni. Niektóre raporty właścicieli treści zawierają dane o aktywności użytkowników, a inne dane dotyczące przychodów i skuteczności reklam.
Interfejs Reporting API umożliwia też niektórym właścicielom treści dostęp do raportów o przychodach z reklam zarządzanych przez system. Dane z raportów zarządzanych przez system można pobierać tylko przy użyciu interfejsu Reporting API.
Wszystkie żądania dotyczące Statystyk YouTube i interfejsu YouTube Reporting API muszą być autoryzowane przez kanał lub właściciela treści, do którego należą żądane dane.
Zgłoś treści
Raporty pobierane przez interfejsy API zawierają 2 typy danych:
-
Wymiary to typowe kryteria używane do agregacji danych, np. data wystąpienia aktywności użytkownika lub kraj, w którym się znajdują.
Każdy wiersz danych w raporcie ma unikalną kombinację wartości wymiarów. W związku z tym kombinacja wartości wymiarów w poszczególnych wierszach pełni rolę klucza podstawowego dla danego wiersza.
-
Dane to indywidualne pomiary aktywności użytkowników, skuteczności reklam lub szacunkowych przychodów. Dane o aktywności użytkowników obejmują liczbę wyświetleń filmów oraz oceny (oceny pozytywne i negatywne).
Wybór odpowiedniego interfejsu API dla swojej aplikacji
- YouTube Analytics API
- YouTube Analytics API obsługuje kierowane zapytania w czasie rzeczywistym, które pozwalają generować niestandardowe raporty Statystyk YouTube. Interfejs API udostępnia parametry filtrowania i sortowania, dzięki czemu aplikacja wywołująca nie musi ich natywnie obsługiwać.
Każde żądanie do interfejsu API określa zakres dat, z którego będą zwracane dane. Interfejs API umożliwia też pobieranie tygodniowych i miesięcznych zbiorów danych. W związku z tym aplikacja wywołująca nie musi przechowywać pobranych zbiorów danych ani zbiorczych statystyk z różnych zakresów dat. - Interfejs API YouTube do raportowania
- YouTube Reporting API pobiera raporty zbiorcze zawierające dane Statystyk YouTube dotyczące kanału lub właściciela treści. Została ona opracowana z myślą o aplikacjach mogących importować duże zbiory danych oraz udostępniających narzędzia do filtrowania, sortowania i wydobywania tych danych.
Każdy raport zawiera wstępnie zdefiniowany zestaw pól. Deweloperzy korzystają z tego interfejsu API, aby planować zadania raportowania. Każde z tych zadań identyfikuje raport, który powinien wygenerować YouTube. YouTube generuje raport dzienny, który można pobrać asynchronicznie. Każdy raport zawiera dane z unikalnego okresu 24 godzin.
Oprócz tego YouTube automatycznie generuje zestaw raportów zarządzanych przez system dla właścicieli treści, którzy mają dostęp do odpowiednich 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 w playlistach
- Raporty o szacunkowych przychodach dla 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 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. Docelowe zapytania są dostępne w interfejsie YouTube Analytics API, a raporty zbiorcze – przez interfejs YouTube Reporting API.
Dane dostępne w jednym interfejsie API mogą nie być dostępne w drugim. Na przykład interfejs YouTube Analytics API umożliwia pobieranie danych o aktywności użytkownika co tydzień lub co miesiąc, ale interfejs YouTube Reporting API wymaga, aby te dane były zbierane przez Ciebie. Z drugiej strony interfejs YouTube Reporting API obsługuje raporty o zasobach dla właścicieli treści, ale te dane nie są dostępne przez YouTube Analytics API.
| Typy raportów | |
|---|---|
| Raporty na temat filmów | Obsługiwane w przypadku kanałów (zapytanie lub zbiorcze) i właścicieli treści (zapytanie lub zbiorczo). Raporty o filmach zawierają statystyki całej aktywności użytkownika związanej z filmami na kanale lub właścicielem treści. Te raporty zawierają na przykład liczbę wyświetleń Twoich filmów. W interfejsie YouTube Analytics API niektóre raporty o filmach właścicieli treści zawierają również dane o szacunkowych przychodach i skuteczności reklam. |
| Raporty dotyczące playlist | Obsługiwane w przypadku kanałów (zapytanie lub zbiorcze) i właścicieli treści (zapytanie lub zbiorczo). Raporty dotyczące playlist zawierają statystyki bezpośrednio związane z wyświetleniami filmów w kontekście playlisty. Interfejs YouTube Reporting API obsługuje raporty dotyczące utrzymania 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 (za pomocą zapytania lub zbiorczego). Raporty skuteczności reklam zawierają dane oparte na wyświetleniach reklam, które były wyświetlane podczas odtwarzania filmów. Dane te uwzględniają każde wyświetlenie reklamy, a każde odtworzenie filmu może spowodować wyświetlenie wielu wyświetleń. |
| Raporty o szacunkowych przychodach | Obsługiwany dla właścicieli treści (zbiorczo). Raporty o szacunkowych przychodach podają łączne szacunkowe przychody z filmów ze źródeł reklam sprzedawanych przez Google oraz ze źródeł innych niż reklamy. Raporty te zawierają też niektóre dane o skuteczności reklam. Pamiętaj, że raporty zarządzane przez system zawierają rzeczywiste przychody. |
| Raporty o zasobach | Obsługiwany dla właścicieli treści (zbiorczo). Raporty o zasobach zawierają dane o aktywności użytkowników związane z filmami, które zostały połączone 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 do niego roszczenie na podstawie dopasowania do 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 | Dostępne dla 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 zawierają rzeczywiste dane o przychodach uzyskane z zasobów i filmów. Dodatkowy raport zawiera listę filmów objętych roszczeniem i zasobów, do których te filmy pasowały. 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 odpowiednich raportów w Studiu twórców. W związku z tym proces pobierania tych raportów różni się od procesu w przypadku pozostałych typów raportów występujących na tej liście. Więcej informacji znajdziesz w dokumentacji raportów zarządzanych przez system. |
Główne różnice
W tabeli poniżej opisujemy istotne różnice między interfejsami YouTube Analytics a Reporting API.
| Funkcja | YouTube Analytics API | Interfejs API YouTube do raportowania |
|---|---|---|
| Proces pobierania danych | Każde żądanie do interfejsu API określa wymiary i dane, które mają zostać zwrócone, a także okres, z którego dane zostaną zwrócone. | Aplikacje planują zadania raportowania. W przypadku każdego zadania YouTube generuje raporty dzienne, które można pobierać asynchronicznie. |
| Zakresy dat | Niektóre raporty dotyczące interfejsu API określają datę wystąpienia aktywności użytkownika. Niektóre z tych raportów obsługują wymiary do agregowania danych o aktywności użytkowników według miesiąca. | Wszystkie raporty dotyczące interfejsu API określają dzień, w którym miała miejsce aktywność użytkownika. Aplikacje korzystające z tego interfejsu API mogą implementować funkcje agregujące dane w określonych odstępach czasu. |
| Filtrowanie danych | Raporty możesz filtrować, aby uwzględniać tylko te wiersze, w których wymiar ma określoną wartość. Niektóre wymiary (np. kontynent i subContinent) są używane tylko jako filtry. | Umożliwia on zbiorcze pobieranie kompletnych zbiorów danych. Nie obsługuje filtrowania ani zwracania danych w przypadku wymiarów zawierających tylko filtr. Aplikacja kliencka przechowuje pobrane dane i implementuje własne funkcje filtrowania danych. |
| Sortowanie | Raporty można sortować na podstawie zwróconych wartości wskaźników. Niektóre raporty obsługują tylko ograniczoną liczbę wyników. Na przykład raport zawierający najczęściej oglądane filmy na kanale zawiera maksymalnie 200 wierszy. | Ten interfejs API umożliwia zbiorcze pobieranie kompletnych zbiorów danych. Aplikacje klienckie mogą implementować własne funkcje sortowania pobieranych danych. |
| Wyliczenia | Raporty interfejsu API zawierają wartości tekstowe, np. „ANDROID” lub „CHANNEL”, które identyfikują wyliczane wartości wymiarów. | Raporty interfejsu 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ć koszt związany z limitem. Bardziej szczegółowe omówienie metodologii znajduje się w sekcji dotyczącej limitu. | Wykorzystanie limitu nie jest problemem, ponieważ dane są pobierane tylko raz, a potem filtrowane, sortowane i odpowiadane na zapytania w aplikacji. |
| Unikalne raporty |
|
|
| Unikalne wymiary | group (wymiar tylko z filtrem) kontynent (wymiar tylko z filtrem) subkontynent (wymiar tylko z filtrem) miesiąc isCurated==1 (wymiar tylko z filtrem) viewsPerPlaylistStart averageTimeInPlaylist |
adnotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Unikalne dane | unikalni użytkownicy relativeSupportPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_Zwiastun_click_rate card_Zwiastun_clicks card_Zwiastun_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue18 |
Różnice w nazwach interfejsów API
Oba interfejsy API używają obecnie różnych konwencji nazewnictwa do identyfikowania wymiarów i danych. Obecnie w nazwach interfejsów API YouTube Analytics stosowana jest nazwa CamlCase, a w interfejsie YouTube Reporting API nazwy rozdzielane znakami podkreślenia.
W tabelach poniżej znajdziesz nazwy różnych interfejsów API służące do identyfikowania tych samych danych i wymiarów. W niektórych przypadkach różnica między tymi dwoma nazwami jest większa niż ta, którą można uzyskać po przekształceniu nazwy z CamlCase na podkreślenia. Na przykład wymiar video w YouTube Analytics API ma nazwę video_id w interfejsie YouTube Reporting API.