Introduction

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.

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

Wymiary

Nazwa interfejsu YouTube Analytics API Nazwa interfejsu YouTube Reporting API
adType ad_type
ageGroup age_group
zasób asset_id
audienceType audience_retention_type
channel channel_id
claimedStatus claimed_status
contentOwner content_owner_id
country country_code
dzień data
deviceType device_type
elapsedVideoTimeRatio elapsed_video_time_percentage
gender [płeć] gender [płeć]
insightPlaybackLocationDetail playback_location_detail
insightPlaybackLocationType playback_location_type
insightTrafficSourceDetail traffic_source_detail
insightTrafficSourceType traffic_source_type
liveOrOnDemand live_or_on_demand
operatingSystem operating_system
playlista playlist_id
province province_code
sharingService sharing_service
subscribedStatus subscribed_status
subtitleLanguage subtitle_language
uploaderType uploader_type
wideo video_id

Wskaźniki

Nazwa interfejsu YouTube Analytics API Nazwa interfejsu YouTube Reporting API
adEarnings estimated_partner_ad_revenue
annotationImpressions annotation_impressions
annotationClickableImpressions annotation_clickable_impressions
annotationClicks annotation_clicks
annotationClickThroughRate annotation_click_through_rate
annotationClosableImpressions annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate annotation_close_rate
audienceWatchRatio audience_retention_percentage
averageViewDuration average_view_duration_seconds
averageViewPercentage average_view_duration_percentage
cardClickRate card_click_rate
cardClicks card_clicks
cardImpressions card_impressions
cardTeaserClickRate card_teaser_click_rate
cardTeaserClicks card_teaser_clicks
cardTeaserImpressions card_teaser_impressions
komentarze komentarze
głosów na nie głosów na nie
zarobki estimated_partner_revenue
estimatedMinutesWatched watch_time_minutes
estimatedPartnerAdSenseRevenue estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue estimated_partner_doubleclick_revenue
grossRevenue estimated_youtube_ad_revenue
impressionBasedCpm estimated_cpm
wyświetlenia ad_impressions
polubienia polubienia
monetizedPlaybacks estimated_monetized_playbacks
playbackBasedCpm estimated_playback_based_cpm
playlistStarts playlist_starts
savesAdded playlist_saves_added
savesRemoved playlist_saves_removed
udostępnienia udostępnienia
subscribersGained subscribers_gained
subscribersLost subscribers_lost
videosAddedToPlaylists videos_added_to_playlists
videosRemovedFromPlaylists videos_removed_from_playlist
viewerPercentage views_percentage
wyświetlenia wyświetlenia