W tym dokumencie wyjaśniamy podobieństwa i różnice w sposobach, w jakie interfejs API YouTube Analytics i interfejs API YouTube do raportowania 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 kanale zawierają dane o aktywności użytkowników na wybranym 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 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 w raportach zarządzanych przez system można pobierać tylko za pomocą interfejsu Reporting API.
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, w której wystąpiła aktywność 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ń filmów 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 z tygodnia i miesiąca. 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 unikalnego 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 API YouTube do raportowania 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 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 działań 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 interfejsie YouTube Analytics API niektóre raporty o filmach właściciela treści zawierają też szacunkowe przychody i dane o skuteczności reklam. |
| 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 dotyczące utrzymania uwagi odbiorców w przypadku playlist, ale interfejs API Statystyk YouTube 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ł reklamowych sprzedawanych przez Google i ze źródeł niepochodzących z reklam. Raporty te zawierają też niektóre dane o skuteczności reklam. Pamiętaj, że raporty sporządzane przez system zawierają rzeczywiste przychody. |
| Raporty o komponentach | 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 są one 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 YouTube Analytics 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 odstępach 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 typu „tylko filtr”. 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 interfejsu 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 |
|
|
| Wymiary unikalne | 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 interfejsu YouTube Analytics API są zapisywane w formacie camelCase, np. adType. Nazwy interfejsu YouTube Reporting API 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 notację z podkreśleniami. Na przykład wymiar video w YouTube Analytics API ma w interfejsie API YouTube do raportowania nazwę video_id.