Introduction

In diesem Dokument werden Ähnlichkeiten und Unterschiede im Hinblick darauf erläutert, wie die YouTube Analytics API und die YouTube Reporting API Zugriff auf YouTube Analytics-Daten ermöglichen. Das Dokument soll Ihnen bei der Auswahl der richtigen API für Ihre Anwendung helfen.

Mit beiden APIs können Entwickler YouTube Analytics-Daten abrufen. Außerdem unterstützen beide APIs YouTube-Kanalinhaber und YouTube-Rechteinhaber, die jeweils auf eine bestimmte Gruppe von Berichten zugreifen können:

  • Kanalberichte enthalten Messwerte zur Nutzeraktivität für einen bestimmten Kanal.

  • In Rechteinhaberberichten werden Messwerte für alle Kanäle zusammengefasst, die mit einem bestimmten YouTube-Rechteinhaber verknüpft sind. Ein Musiklabel könnte beispielsweise einen Bericht abrufen, der kombinierte Statistiken für die YouTube-Kanäle aller Künstler des Labels enthält. Einige Berichte zu Rechteinhabern enthalten Messwerte zur Nutzeraktivität, während andere Messwerte zu Umsatz und Anzeigenleistung enthalten.

Über die Reporting API können einige Rechteinhaber auch auf vom System verwaltete Berichte zu Werbeeinnahmen zugreifen. Die Daten in den vom System verwalteten Berichten können nur mit der Reporting API abgerufen werden.

Alle Anfragen an YouTube Analytics und die YouTube Reporting API müssen vom Kanal- oder Rechteinhaber autorisiert werden, dem die angeforderten Daten gehören.

Inhalt des Berichts

Die Berichte, die von den APIs abgerufen werden, enthalten zwei Datentypen:

  • Dimensionen sind gängige Kriterien, die zum Aggregieren von Daten verwendet werden, z. B. das Datum, an dem die Nutzeraktivität stattgefunden hat, oder das Land, in dem sich die Nutzer befanden.

    In einem Bericht enthält jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Daher dient die Kombination aus Dimensionswerten in jeder Zeile als Primärschlüssel für diese Zeile.

  • Messwerte sind individuelle Messungen der Nutzeraktivität, der Anzeigenleistung oder des geschätzten Umsatzes. Die Messwerte zur Nutzeraktivität umfassen beispielsweise die Anzahl der Videoaufrufe und Bewertungen (positive und negative Bewertungen).

Die richtige API für Ihre Anwendung auswählen

YouTube Analytics API.
Die YouTube Analytics API unterstützt gezielte Anfragen in Echtzeit, mit denen benutzerdefinierte YouTube Analytics-Berichte erstellt werden können. Die API bietet Filter- und Sortierparameter, sodass die aufrufende Anwendung diese Funktionen nicht nativ unterstützen muss.

In jeder API-Anfrage wird der Zeitraum angegeben, für den Daten zurückgegeben werden. Mit der API können Sie außerdem wöchentliche und monatliche Datasets abrufen. Daher muss die aufrufende Anwendung keine abgerufenen Datensätze speichern oder Statistiken über mehrere Zeiträume hinweg zusammenfassen.
YouTube Reporting API.
Die YouTube Reporting API ruft Bulk-Berichte mit YouTube Analytics-Daten für einen Kanal oder einen Rechteinhaber ab. Es wurde für Anwendungen entwickelt, die große Datasets importieren und Tools zum Filtern, Sortieren und Mining dieser Daten bereitstellen können.

Jeder Bericht enthält vordefinierte Felder. Entwickler verwenden die API, um Berichterstellungsjobs zu planen. Jeder Job identifiziert einen Bericht, der von YouTube generiert werden soll. YouTube erstellt dann einen täglichen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen 24-Stunden-Zeitraum.

Außerdem erstellt YouTube automatisch eine Reihe von vom System verwalteten Berichten für Rechteinhaber, die Zugriff auf die entsprechenden Berichte in YouTube Studio haben. Diese Berichte bieten programmatischen Zugriff auf Daten zum Werbeumsatz.

Unterstützte Berichte

In der folgenden Tabelle sind die verschiedenen Berichtstypen aufgeführt, die Sie mithilfe der APIs abrufen können. Gezielte Anfragen sind über die YouTube Analytics API und Bulk-Berichte über die YouTube Reporting API verfügbar.

Daten, die in einer API verfügbar sind, sind möglicherweise in der anderen nicht verfügbar. Mit der YouTube Analytics API kannst du beispielsweise Messwerte zur Nutzeraktivität wöchentlich oder monatlich abrufen, für die YouTube Reporting API musst du diese Daten jedoch selbst zusammenfassen. Andererseits unterstützt die YouTube Reporting API Inhaltsberichte für Rechteinhaber, diese Daten sind aber nicht über die YouTube Analytics API verfügbar.

Berichtstypen
Videoberichte Wird für Kanäle (Suchanfrage oder Bulk-Verarbeitung) und Rechteinhaber (Anfrage oder Bulk) unterstützt.

Videoberichte enthalten Statistiken zu allen Nutzeraktivitäten im Zusammenhang mit den Videos eines Kanals oder eines Rechteinhabers. Diese Berichte enthalten beispielsweise die Anzahl der Aufrufe, die deine Videos erzielt haben. In der YouTube Analytics API enthalten einige Berichte zu Videos von Rechteinhabern auch Messwerte zum geschätzten Umsatz und zur Anzeigenleistung.
Playlist-Berichte Wird für Kanäle (Suchanfrage oder Bulk-Verarbeitung) und Rechteinhaber (Anfrage oder Bulk) unterstützt.

Playlist-Berichte enthalten Statistiken, die sich speziell auf Videoaufrufe im Zusammenhang mit einer Playlist beziehen. Die YouTube Reporting API unterstützt Berichte zur Zuschauerbindung für Playlists. Die YouTube Analytics API unterstützt einen ähnlichen Bericht jedoch nicht.
Berichte "Anzeigenleistung" Wird für Rechteinhaber unterstützt (Abfrage oder Bulk).

Berichte zur Anzeigenleistung enthalten impressionsbasierte Messwerte für Anzeigen, die während der Videowiedergabe ausgeliefert wurden. In diesen Messwerten wird jede Anzeigenimpression berücksichtigt und jede Videowiedergabe kann zu mehreren Impressionen führen.
Berichte zum geschätzten Umsatz Wird für Rechteinhaber unterstützt (Bulk-Verarbeitung).

Die Berichte zum geschätzten Umsatz enthalten den geschätzten Gesamtumsatz für Videos aus von Google verkauften Werbequellen und aus anderen Quellen als Werbequellen. Diese Berichte enthalten auch einige Messwerte zur Anzeigenleistung. Beachten Sie, dass vom System verwaltete Berichte den tatsächlichen Umsatz enthalten.
Asset-Berichte Wird für Rechteinhaber unterstützt (Bulk-Verarbeitung).

Asset-Berichte enthalten Messwerte zur Nutzeraktivität in Bezug auf Videos, die mit den Assets eines Rechteinhabers verknüpft sind. Ein Video wird in den Bericht eines Rechteinhabers aufgenommen, wenn der Rechteinhaber Anspruch auf dieses Video als Übereinstimmung mit einem der Inhalte des Rechteinhabers erhoben hat. Das Video kann vom Rechteinhaber oder von einem anderen YouTube-Nutzer hochgeladen worden sein.
Vom System verwaltete Berichte Diese Option wird für Rechteinhaber unterstützt, die Zugriff auf die entsprechenden Berichte im Menü "Berichte" von YouTube Studio haben.

Vom System verwaltete Berichte liefern tatsächliche Umsatzdaten für Assets und Videos. In einem zusätzlichen Bericht werden Videos, auf die Anspruch erhoben wurde, sowie die Assets aufgelistet, mit denen diese Videos übereinstimmen. Beachte, dass nicht alle Creator Studio-Berichte derzeit in der API verfügbar sind.

Hinweis: YouTube erstellt automatisch vom System verwaltete Berichte für Rechteinhaber, die Zugriff auf die entsprechenden Berichte in Creator Studio haben. Daher unterscheidet sich der Prozess zum Abrufen dieser Berichte von dem für die anderen Berichtstypen in dieser Liste. Weitere Informationen finden Sie in der Dokumentation zu vom System verwalteten Berichten.

Wichtige Unterschiede

In der folgenden Tabelle sind die wichtigsten Unterschiede zwischen der YouTube Analytics API und der Reporting API aufgeführt.

Funktion YouTube Analytics API. YouTube Reporting API.
Datenabruf verarbeiten In jeder API-Anfrage werden Dimensionen und Messwerte sowie der Zeitraum angegeben, für den Daten zurückgegeben werden sollen. Anwendungen planen Berichtsjobs. YouTube generiert für jeden Job tägliche Berichte, die asynchron heruntergeladen werden können.
Zeiträume In einigen API-Berichten wird das Datum angegeben, an dem die Nutzeraktivität aufgetreten ist. In einigen dieser Berichte werden Dimensionen unterstützt, mit denen sich Messwerte zur Nutzeraktivität nach Monat zusammenfassen lassen. Alle API-Berichte geben den Tag an, an dem die Nutzeraktivität aufgetreten ist. Anwendungen, die die API verwenden, können Funktionen zum Aggregieren von Daten für regelmäßige Intervalle implementieren.
Daten filtern Sie können Berichte so filtern, dass nur Zeilen enthalten sind, für die eine Dimension einen bestimmten Wert hat. Die API unterstützt auch einige Dimensionen wie continent und subContinent, die nur als Filter verwendet werden. Die API unterstützt Bulk-Downloads vollständiger Datensätze. Für Dimensionen vom Typ „Nur Filter“ können keine Daten gefiltert oder zurückgegeben werden. Die Clientanwendung speichert die heruntergeladenen Daten und implementiert ihre eigenen Funktionen zum Filtern der Daten.
Sortieren Berichte können anhand der zurückgegebenen Messwerte sortiert werden. Einige Berichte unterstützen nur eine begrenzte Anzahl von Ergebnissen. Beispielsweise enthält der Bericht, der die meistgesehenen Videos eines Kanals auflistet, maximal 200 Zeilen. Diese API unterstützt Bulk-Downloads vollständiger Datensätze. Client-Anwendungen können ihre eigenen Funktionen zum Sortieren heruntergeladener Daten implementieren.
Aufzählungen API-Berichte enthalten Textwerte wie „ANDROID“ oder „CHANNEL“, um aufgezählte Dimensionswerte zu identifizieren. API-Berichte enthalten Ganzzahlen, die Textwerten zugeordnet werden können.
Kontingent Der API-Server wertet jede Abfrage aus, um die Kontingentkosten zu ermitteln. Im Abschnitt Kontingentnutzung wird die Methodik ausführlicher erläutert. Die Kontingentnutzung ist kein Problem, da Daten einmal abgerufen und dann innerhalb der Anwendung gefiltert, sortiert und abgefragt werden.
Einzelne Berichte
  • Nutzeraktivität im Zusammenhang mit Untertiteln
  • Daten zur Zuschauerbindung für Playlists
  • Berichte zum geschätzten Umsatz für Rechteinhaber (zwei verschiedene Berichte sind verfügbar)
  • Asset-Berichte für Rechteinhaber (11 verschiedene Berichte sind verfügbar)
Eindeutige Dimensionen group (reine Filter-Dimension)
Continent (reine Filter-Dimension)
subContinent (reine Filter-Dimension)
month
isCurated==1 (reine Filter-Dimension)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
Eindeutige Messwerte 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{17/save_playlistplaylist_saves_addedplaylist_saves_removed

Namensunterschiede zwischen APIs

Die beiden APIs verwenden derzeit unterschiedliche Namenskonventionen, um Dimensionen und Messwerte zu identifizieren. Derzeit werden in den Namen der YouTube Analytics API die CamelCase-Schreibweise verwendet, während für die Namen der YouTube Reporting API Unterstriche verwendet werden.

In den folgenden Tabellen sind die verschiedenen Namen aufgeführt, mit denen die beiden APIs dieselben Messwerte und Dimensionen identifizieren. In einigen Fällen ist der Unterschied zwischen den beiden Namen größer als der Unterschied, den Sie nach der Umwandlung eines Namens von „CamelCase“ in Unterstriche erhalten würden. Die Dimension video in der YouTube Analytics API heißt in der YouTube Reporting API beispielsweise video_id.

Abmessungen

Name der YouTube Analytics API Name der YouTube Reporting API
adType ad_type
ageGroup age_group
Asset asset_id
audienceType audience_retention_type
channel channel_id
claimedStatus claimed_status
contentOwner content_owner_id
Land country_code
Tag Datum
deviceType device_type
elapsedVideoTimeRatio elapsed_video_time_percentage
Geschlecht Geschlecht
insightPlaybackLocationDetail playback_location_detail
insightPlaybackLocationType playback_location_type
insightTrafficSourceDetail traffic_source_detail
insightTrafficSourceType traffic_source_type
liveOrOnDemand live_or_on_demand
operatingSystem operating_system
Playlist playlist_id
bundesland province_code
sharingService sharing_service
subscribedStatus subscribed_status
subtitleLanguage subtitle_language
uploaderType uploader_type
Video video_id

Messwerte

Name der YouTube Analytics API Name der 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
comments comments
Mag ich nicht Mag ich nicht
Einnahmen 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
Impressionen ad_impressions
„Gefällt mir“-Angaben „Gefällt mir“-Angaben
monetizedPlaybacks estimated_monetized_playbacks
playbackBasedCpm estimated_playback_based_cpm
playlistStarts playlist_starts
savesAdded playlist_saves_added
savesRemoved playlist_saves_removed
Anteile Anteile
subscribersGained subscribers_gained
subscribersLost subscribers_lost
videosAddedToPlaylists videos_added_to_playlists
videosRemovedFromPlaylists videos_removed_from_playlist
viewerPercentage views_percentage
Aufrufe Aufrufe