W tym dokumencie opisujemy podobieństwa i różnice w sposobie, w jaki YouTube Analytics API i YouTube Reporting API zapewniają dostęp do danych w Statystykach YouTube. Ten dokument ma pomóc Ci wybrać odpowiedni interfejs API do Twojej aplikacji.
Oba interfejsy API umożliwiają programistom pobieranie danych Statystyk YouTube. Dodatkowo oba interfejsy API obsługują właścicieli kanałów i treści w YouTube, a 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 określonym kanale.
-
Raport Właściciel treści zawiera dane zbiorcze o wszystkich kanałach powiązanych z określonym właścicielem treści w YouTube. Na przykład wytwórnia może pobrać raport zawierający połączone statystyki kanałów YouTube wszystkich wykonawców 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 zarządzanych przez system raportów o przychodach z reklam. Dane z raportów zarządzanych przez system można pobierać tylko za pomocą interfejsu API do raportowania.
Wszystkie żądania YouTube Analytics i 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 zbierania danych, takie jak data aktywności użytkownika lub kraj, w którym znajdują się użytkownicy.
Każdy wiersz danych w raporcie zawiera unikalną kombinację wartości wymiarów. Kombinacja wartości wymiarów w każdym wierszu funkcjonuje jako klucz podstawowy dla danego wiersza.
-
Dane to indywidualne pomiary aktywności użytkowników, skuteczności reklam i szacowanych przychodów. Dane o aktywności użytkowników obejmują m.in. liczbę wyświetleń filmów oraz oceny (głosy pozytywne i negatywne).
Wybór odpowiedniego interfejsu API dla swojej aplikacji
- YouTube Analytics API
- Interfejs API YouTube Analytics obsługuje zapytania kierowane w czasie rzeczywistym, co pozwala na generowanie niestandardowych raportów Statystyk YouTube. 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 do interfejsu API określa zakres dat, z którego zostaną zwrócone dane. Interfejs API umożliwia też pobieranie zbiorów danych z tygodnia i miesiąca. W związku z tym aplikacja wywołująca nie musi przechowywać pobranych zbiorów danych ani zbiorczych statystyk w zakresach 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ł on opracowany z myślą o aplikacjach umożliwiających importowanie dużych zbiorów danych i udostępniających narzędzia do filtrowania, sortowania i wydobywania tych danych.
Każdy raport zawiera wstępnie zdefiniowany zestaw pól. Programiści używają interfejsu API do planowania zadań raportowania. Każde z nich określa raport, który powinien zostać wygenerowany przez YouTube. YouTube generuje następnie raport dzienny, który można pobrać asynchronicznie. Każdy raport zawiera dane z unikatowego 24-godzinnego okresu.
Oprócz tego YouTube automatycznie generuje zestaw zarządzanych przez system raportów dla właścicieli treści, którzy mają dostęp do odpowiednich raportów w YouTube Studio. Te raporty zapewniają automatyczny 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 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 kierowane są dostępne poprzez interfejs YouTube Analytics API, a raporty zbiorcze – przez interfejs YouTube Reporting API.
Dane dostępne w jednym interfejsie API mogą być niedostępne w drugim. Na przykład interfejs YouTube Analytics API umożliwia pobieranie danych o aktywności użytkowników co tydzień lub co miesiąc, ale interfejs YouTube Reporting API wymaga samodzielnego agregowania tych danych. Z drugiej strony interfejs YouTube Reporting API obsługuje raporty o zasobach właścicieli treści. Te dane są niedostępne w 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 na temat filmów zawierają statystyki dotyczące całej aktywności użytkownika związanej z filmami na kanale lub właścicielu treści. Raporty te 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ą też szacunkowe dane o 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 odnoszące się do wyświetleń filmów w kontekście playlisty. YouTube Reporting API obsługuje raporty dotyczące utrzymania uwagi odbiorców dotyczące playlist, ale YouTube Analytics API nie obsługuje podobnego raportu. |
| Raport skuteczności reklam | Obsługiwane dla właścicieli treści (zapytanie lub zbiorcze). 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ługiwane dla właścicieli treści (zbiorcze). Raporty o szacunkowych przychodach podają łączne szacunkowe przychody z filmów ze źródeł reklamowych sprzedawanych przez Google oraz ze źródeł innych niż reklamy. Raporty te zawierają również niektóre dane dotyczące skuteczności reklam. Pamiętaj, że raporty zarządzane przez system zawierają rzeczywiste przychody. |
| Raporty o zasobach | Obsługiwane dla właścicieli treści (zbiorcze). Raporty o zasobach zawierają dane o aktywności użytkowników związane z filmami, które są 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 | Opcja dostępna dla właścicieli treści, którzy mają dostęp do odpowiednich raportów w menu Raporty w Studiu twórców YouTube. Raporty zarządzane przez system zawierają rzeczywiste dane o przychodach z zasobów i filmów. Dodatkowy raport zawiera listę filmów objętych roszczeniem i zasobów pasujących do tych filmów. 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 odpowiednich raportów w Studiu twórców. W związku z tym proces pobierania tych raportów różni się od procesu pobierania pozostałych typów raportów 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 API Statystyk YouTube i do raportowania.
| 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, oraz okres, z którego dane mają zostać 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 interfejsu API mogą wdrażać funkcje do agregacji danych w okresowych przedziałach czasu. |
| Filtrowanie danych | Raporty możesz filtrować tak, aby zawierały tylko wiersze, w których wymiar ma określoną wartość. Interfejs API obsługuje też niektóre wymiary, np. kontynent i subContinent, które są używane tylko jako filtry. | Interfejs API umożliwia zbiorcze pobieranie kompletnych zbiorów danych. Nie można w nim filtrować ani zwracać danych w przypadku wymiarów związanych tylko z filtrowaniem. Aplikacja kliencka przechowuje pobrane dane i stosuje 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, który zawiera najczęściej oglądane filmy na kanale, zawiera maksymalnie 200 wierszy. | Ten interfejs API obsługuje 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 umożliwiają identyfikację wyliczonych 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 przydziału. Szczegółowa metodologia została opisana w sekcji dotyczącej wykorzystania limitu. | Wykorzystanie limitu nie jest problemem, ponieważ dane są pobierane jednorazowo, a następnie filtrowane, sortowane i wysyłane do aplikacji zapytania. |
| Unikalne raporty |
|
|
| Unikalne wymiary | grupa (wymiar tylko z filtrem) kontynent (wymiar tylko z filtrem) subContinent (wymiar tylko z filtrem) miesiąc isCurated==1 (wymiar tylko z filtrem) 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 relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenueusunięta playlist_saves_addedplaylist_saves_removed |
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 używane są nazwy CamlCase, a w przypadku interfejsu YouTube Reporting API – rozdzielone podkreśleniami.
W tabelach poniżej znajdziesz różne nazwy używane przez oba interfejsy API do identyfikowania tych samych danych i wymiarów. W niektórych przypadkach różnica między tymi dwoma nazwami może być większa niż możliwa po przekształceniu nazwy z CamlCase na podkreślenia. Na przykład wymiar video w interfejsie YouTube Analytics API nosi nazwę video_id w interfejsie YouTube Reporting API.