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