W tym dokumencie wyjaśniamy podobieństwa i różnice w sposobach, w jakie interfejs API YouTube Analytics i interfejs API YouTube Reporting zapewniają dostęp do danych Statystyk YouTube. Dzięki temu możesz wybrać odpowiedni interfejs API do swojej aplikacji.
Oba interfejsy API umożliwiają pobieranie danych Statystyk YouTube. Oba interfejsy API obsługują właścicieli kanałów i treści w YouTube, z których każdy ma dostęp do określonego zestawu raportów:
-
Raporty o kanałach zawierają dane o aktywności użytkowników na określonym kanale.
-
Raporty właścicieli treści zawierają zbiorcze dane dla 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, z którymi współpracuje. Niektóre raporty właścicieli treści zawierają dane o aktywności użytkowników, a inne – dane związane z przychodami 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 interfejsów API Statystyk YouTube i YouTube do raportowania muszą być autoryzowane przez właściciela kanału lub treści, do którego należą żądane dane.
Treść raportu
Raporty pobierane przez interfejsy API zawierają 2 rodzaje danych:
-
Wymiary to typowe kryteria używane do agregowania danych, np. data wystąpienia aktywności użytkownika lub kraj, w którym znajdowali się użytkownicy.
W raporcie każdy wiersz danych ma unikalną kombinację wartości wymiarów. Dlatego kombinacja wartości wymiarów w każdym wierszu pełni funkcję klucza podstawowego tego 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ą m.in. liczbę wyświetleń filmu i oceny (polubienia i kliknięcia przycisku „To mi się nie podoba”).
Wybieranie odpowiedniego interfejsu API dla aplikacji
- YouTube Analytics API
- YouTube Analytics API obsługuje kierowane zapytania w czasie rzeczywistym, co umożliwia generowanie raportów niestandardowych Statystyk YouTube. Interfejs API udostępnia parametry filtrowania i sortowania, więc aplikacja wywołująca nie musi natywnie obsługiwać tych funkcji.
Każde żądanie do interfejsu API określa zakres dat, dla którego zostaną zwrócone dane. Interfejs API umożliwia też pobieranie zbiorów danych tygodniowych i miesięcznych. Dlatego aplikacja wywołująca nie musi przechowywać pobranych zbiorów danych ani agregować statystyk w zakresach dat. - Interfejs API YouTube do raportowania
- Interfejs API YouTube do raportowania pobiera raporty zbiorcze zawierające dane ze Statystyk YouTube dotyczące kanału lub właściciela treści. Jest on przeznaczony dla aplikacji, które mogą importować duże zbiory danych i zapewniać narzędzia do filtrowania, sortowania i wydobywania tych danych.
Każdy raport zawiera wstępnie zdefiniowany zestaw pól. Za pomocą interfejsu API możesz planować zadania raportowania. Każde z nich określa raport, który ma wygenerować YouTube. YouTube generuje wtedy dzienny raport, który można pobrać asynchronicznie. Każdy raport zawiera dane z niepowtarzalnego 24-godzinnego okresu.
Dodatkowo 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.
Obsługiwane raporty
W tabeli poniżej znajdziesz różne typy raportów, które możesz pobrać za pomocą interfejsów API. Kierowane zapytania są dostępne w interfejsie YouTube Analytics API, a raporty zbiorcze – w interfejsie API YouTube do raportowania.
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żytkowników w ujęciu tygodniowym lub miesięcznym, ale interfejs YouTube Reporting API wymaga samodzielnego agregowania tych danych. Z kolei interfejs YouTube Reporting API obsługuje raporty dotyczące zasobów dla właścicieli treści, ale te dane nie są dostępne w interfejsie YouTube Analytics API.
| Typy raportów | |
|---|---|
| Raporty na temat filmów | Obsługiwane w przypadku kanałów (query lub bulk) i właścicieli treści (query lub bulk). Raporty dotyczące filmów zawierają statystyki wszystkich aktywności użytkowników związanych z filmami na kanale lub filmami właściciela treści. Zawierają one na przykład liczbę wyświetleń Twoich filmów. W YouTube Analytics API niektóre raporty o filmach właściciela treści zawierają też szacunkowe przychody i dane o skuteczności reklam. |
| Raporty o zasięgu | Obsługiwane w przypadku kanałów (zbiorczo) i właścicieli treści (zbiorczo). Dane o zasięgu są też dostępne w raportach o filmach w przypadku kierowanych zapytań. Raporty dotyczące zasięgu zawierają statystyki wyświetleń miniatur filmów i współczynników klikalności. |
| Raporty dotyczące playlist | Obsługiwane w przypadku kanałów (query lub bulk) i właścicieli treści (query lub bulk). Raporty dotyczące playlist zawierają statystyki związane z wyświetleniami filmów, które mają miejsce w kontekście playlisty. Interfejs API YouTube do raportowania obsługuje raporty Utrzymanie uwagi odbiorców w przypadku playlist, ale interfejs 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 o reklamach wyświetlanych podczas odtwarzania filmów, które są oparte na liczbie wyświetleń. Te dane uwzględniają każde wyświetlenie reklamy, a każde odtworzenie filmu może generować wiele wyświetleń. |
| Raporty szacunkowych przychodów | Obsługiwane w przypadku właścicieli treści (zbiorczo). Raporty szacunkowych przychodów zawierają łączne szacunkowe przychody z filmów pochodzące ze źródeł reklam sprzedawanych przez Google i ze źródeł innych niż reklamowe. Raporty te zawierają też niektóre dane o skuteczności reklam. Pamiętaj, że raporty sporządzane przez system zawierają rzeczywiste przychody. |
| Raporty o zasobach | Obsługiwane w przypadku właścicieli treści (zbiorczo). 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 zgłosił on roszczenie do tego filmu na podstawie dopasowania do jednego z jego zasobów. 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 menu Raporty w Studio twórców YouTube. Raporty sporzą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 zasobów, z którymi te filmy są zgodne. Nie wszystkie raporty z Studio twórców są 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 Studio 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 dotyczącej raportów zarządzanych przez system. |
Najważniejsze różnice
W tabeli poniżej znajdziesz najważniejsze różnice między interfejsem Statystyk YouTube API a interfejsem YouTube 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, za który mają być zwracane dane. | Aplikacje planują zadania raportowania. W przypadku każdego zadania YouTube generuje dzienne raporty, które można pobrać asynchronicznie. |
| Zakresy dat | Niektóre raporty interfejsu API określają datę aktywności użytkownika. Niektóre z tych raportów obsługują wymiary, które umożliwiają agregowanie danych o aktywności użytkowników według miesiąca. | Wszystkie raporty interfejsu API określają dzień, w którym wystąpiła aktywność użytkownika. Aplikacje korzystające z interfejsu API mogą wdrażać funkcje agregowania 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, takie jak continent i subContinent, które są używane tylko jako filtry. | Interfejs API obsługuje pobieranie całych zbiorów danych. Nie obsługuje filtrowania ani zwracania danych w przypadku wymiarów „tylko pola z filtrem”. Aplikacja kliencka przechowuje pobrane dane i wdraża własne funkcje 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, który zawiera listę najczęściej oglądanych filmów na kanale, zwraca maksymalnie 200 wierszy. | Ten interfejs API obsługuje pobieranie zbiorcze pełnych zbiorów danych. Aplikacje klienckie mogą implementować własne funkcje sortowania pobranych danych. |
| Wyliczenia | Raporty API zawierają wartości tekstowe, np. „ANDROID” lub „CHANNEL”, które identyfikują wartości wymiarów wyliczeniowych. | Raporty API zawierają liczby całkowite, które można mapować na wartości tekstowe. |
| Limit | Serwer interfejsu API ocenia każde zapytanie, aby określić jego koszt w ramach limitu. Więcej informacji o metodologii znajdziesz w sekcji Wykorzystanie limitu. | Wykorzystanie limitu nie stanowi problemu, ponieważ dane są pobierane tylko raz, a następnie filtrowane, sortowane i przeszukiwane w aplikacji. |
| Raporty Unique |
|
|
| Unikalne wymiary | group (wymiar tylko do filtrowania) continent (wymiar tylko do filtrowania) subContinent (wymiar tylko do filtrowania) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Unikalne dane | uniques 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_revenue playlist_saves_added playlist_saves_removed |
Różnice w nazwach interfejsów API
Te 2 interfejsy API używają różnych konwencji nazewnictwa do identyfikowania wymiarów i danych. Nazwy interfejsów API Statystyk YouTube są zapisywane w formacie camelCase, np. adType. Nazwy interfejsu API do raportowania YouTube są pisane małymi literami i zawierają znaki podkreślenia, np. ad_type.
W tabelach poniżej znajdziesz różne nazwy, których te 2 interfejsy API używają do identyfikowania tych samych danych i wymiarów. W niektórych przypadkach różnica między tymi nazwami jest większa niż ta, która powstałaby po przekształceniu nazwy z notacji camelCase na podkreślenia. Na przykład wymiar video w YouTube Analytics API ma w interfejsie API YouTube do raportowania nazwę video_id.