In diesem Dokument werden die Gemeinsamkeiten und Unterschiede beim Zugriff auf YouTube Analytics-Daten über die YouTube Analytics API und die YouTube Reporting API erläutert. So können Sie die richtige API für Ihre Anwendung auswählen.
Mit beiden APIs können Sie YouTube Analytics-Daten abrufen. Außerdem werden sowohl YouTube-Kanalinhaber als auch YouTube-Rechteinhaber von beiden APIs unterstützt. Jeder von ihnen kann auf eine bestimmte Gruppe von Berichten zugreifen:
-
Channel-Berichte enthalten Messwerte zur Nutzeraktivität für einen bestimmten Channel.
-
In Berichten zu YouTube-Rechteinhabern werden Messwerte für alle Kanäle zusammengefasst, die mit einem bestimmten YouTube-Rechteinhaber verknüpft sind. Ein Musiklabel könnte beispielsweise einen Bericht mit kombinierten Statistiken für die YouTube-Kanäle aller Künstler des Labels abrufen. Einige Berichte für Rechteinhaber enthalten Messwerte zur Nutzeraktivität, andere Messwerte zu Umsatz und Anzeigenleistung.
Über die Reporting API können einige Rechteinhaber auch auf von YouTube verwaltete Berichte zum Anzeigenumsatz zugreifen. Die Daten in den vom System verwalteten Berichten können nur mit der Reporting API abgerufen werden.
Alle YouTube Analytics- und YouTube Reporting API-Anfragen 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 Arten von Daten:
-
Dimensionen sind gängige Kriterien, mit denen Daten aggregiert werden, z. B. das Datum, an dem die Nutzeraktivität stattgefunden hat, oder das Land, in dem sich die Nutzer befanden.
In einem Bericht hat jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Die Kombination der Dimensionswerte in jeder Zeile dient also als Primärschlüssel für diese Zeile.
-
Messwerte sind einzelne Messungen von Nutzeraktivitäten, Anzeigenleistung oder geschätzten Einnahmen. Zu den Messwerten für Nutzeraktivitäten gehören unter anderem die Anzahl der Videoaufrufe und Bewertungen („Mag ich“ und „Mag ich nicht“).
Die richtige API für Ihre Anwendung auswählen
- YouTube Analytics API.
- Die YouTube Analytics API unterstützt gezielte Echtzeitabfragen, über die 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 auch wöchentliche und monatliche Datensätze abrufen. Daher muss die aufrufende Anwendung keine abgerufenen Datasets speichern oder Statistiken über Zeiträume hinweg aggregieren. - YouTube Reporting API.
- Mit der YouTube Reporting API können Bulk-Berichte mit YouTube Analytics-Daten für einen Kanal oder Rechteinhaber abgerufen werden. Sie ist für Anwendungen konzipiert, mit denen große Datasets importiert werden können und die Tools zum Filtern, Sortieren und Mining dieser Daten bieten.
Jeder Bericht enthält eine vordefinierte Gruppe von Feldern. Mit der API planen Sie Berichtsjobs, mit denen jeweils ein Bericht angegeben wird, der von YouTube generiert werden soll. YouTube generiert dann einen täglichen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen 24-Stunden-Zeitraum.
Außerdem generiert YouTube automatisch eine Reihe von systemverwalteten Berichten für Rechteinhaber, die in YouTube Creator Studio auf die entsprechenden Berichte zugreifen können. Diese Berichte bieten programmatischen Zugriff auf Daten zum Werbeumsatz.
Unterstützte Berichte
In der folgenden Tabelle sind die verschiedenen Arten von Berichten aufgeführt, die Sie mit den APIs abrufen können. Gezielte Abfragen 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 nicht in der anderen verfügbar. Mit der YouTube Analytics API können Sie beispielsweise Messwerte zur Nutzeraktivität wöchentlich oder monatlich abrufen. Bei der YouTube Reporting API müssen Sie diese Daten jedoch selbst zusammenfassen. Die YouTube Reporting API unterstützt hingegen Berichte zu Inhalten für Rechteinhaber, diese Daten sind aber nicht über die YouTube Analytics API verfügbar.
| Berichtarten | |
|---|---|
| Videoberichte | Wird für Kanäle (query oder bulk) und Rechteinhaber (query 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 Ihre Videos erzielt haben. In der YouTube Analytics API enthalten einige Videoberichte für Rechteinhaber auch Messwerte zu geschätzten Einnahmen und zur Anzeigenleistung. |
| Playlist-Berichte | Wird für Kanäle (query oder bulk) und Rechteinhaber (query oder bulk) unterstützt. Playlist-Berichte enthalten Statistiken zu Videoaufrufen, die im Kontext einer Playlist erfolgen. Die YouTube Reporting API unterstützt Berichte zur Zuschauerbindung für Playlists, die YouTube Analytics API jedoch nicht. |
| Berichte „Anzeigenleistung“ | Wird für Rechteinhaber unterstützt (query oder bulk). Leistungsberichte für Anzeigen enthalten impressionsbasierte Messwerte für Anzeigen, die während der Videowiedergabe ausgeliefert wurden. Diese Messwerte berücksichtigen jede Anzeigenimpression. Bei jeder Videowiedergabe können mehrere Impressionen erzielt werden. |
| Berichte zum geschätzten Umsatz | Für Rechteinhaber unterstützt (Bulk). In Berichten zum geschätzten Umsatz wird der geschätzte Gesamtumsatz für Videos aus von Google verkauften Werbequellen und aus nicht werbebezogenen Quellen angegeben. Diese Berichte enthalten auch einige Messwerte zur Anzeigenleistung. Vom System verwaltete Berichte enthalten tatsächliche Umsätze. |
| Asset-Berichte | Für Rechteinhaber unterstützt (Bulk). Asset-Berichte enthalten Messwerte zur Nutzeraktivität im Zusammenhang mit Videos, die mit den Assets eines Rechteinhabers verknüpft sind. Ein Video wird im Bericht eines Rechteinhabers aufgeführt, wenn der Rechteinhaber Anspruch auf das Video als Übereinstimmung mit einem seiner Inhalte erhoben hat. Das Video könnte vom Rechteinhaber oder von einem anderen YouTube-Nutzer hochgeladen worden sein. |
| Vom System verwaltete Berichte | Unterstützt für Rechteinhaber, die im Menü „Berichte“ von YouTube Studio Zugriff auf die entsprechenden Berichte haben. Systemverwaltete Berichte enthalten tatsächliche Daten zu Umsätzen von Assets und Videos. In einem zusätzlichen Bericht werden Videos mit Ansprüchen und die Assets aufgeführt, mit denen diese Videos übereinstimmen. Nicht alle Creator Studio-Berichte sind in der API verfügbar. Hinweis:YouTube generiert automatisch systemverwaltete Berichte für Rechteinhaber, die in Creator Studio Zugriff auf die entsprechenden Berichte haben. Daher unterscheidet sich das Verfahren zum Abrufen dieser Berichte von dem für die anderen Berichtstypen in dieser Liste. Weitere Informationen finden Sie in der Dokumentation zu systemverwalteten Berichten. |
Wichtige Unterschiede
In der folgenden Tabelle werden wichtige Unterschiede zwischen der YouTube Analytics API und der YouTube Reporting API hervorgehoben.
| Funktion | YouTube Analytics API. | YouTube Reporting API. |
|---|---|---|
| Prozess zum Abrufen von Daten | In jeder API-Anfrage werden die Dimensionen und Messwerte angegeben, die zurückgegeben werden sollen, sowie der Zeitraum, für den Daten zurückgegeben werden. | Anwendungen planen Berichtsjobs. Für jeden Job generiert YouTube tägliche Berichte, die asynchron heruntergeladen werden können. |
| Zeiträume | In einigen API-Berichten wird das Datum angegeben, an dem die Nutzeraktivität stattgefunden hat. Einige dieser Berichte unterstützen Dimensionen, mit denen Messwerte zur Nutzeraktivität nach Monat zusammengefasst werden können. | In allen API-Berichten wird der Tag angegeben, an dem die Nutzeraktivität stattgefunden hat. Anwendungen, die die API verwenden, können Funktionen implementieren, um Daten für regelmäßige Intervalle zu aggregieren. |
| Daten filtern | Sie können Berichte filtern, damit nur Zeilen berücksichtigt werden, in denen eine Dimension einen bestimmten Wert hat. Die API unterstützt auch einige Dimensionen, z. B. continent und subContinent, die nur als Filter verwendet werden. | Die API unterstützt den Bulk-Download vollständiger Datensätze. Das Filtern oder Zurückgeben von Daten für Nur-Filter-Dimensionen wird nicht unterstützt. Die Clientanwendung speichert die heruntergeladenen Daten und implementiert eigene 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. Der Bericht mit den meistaufgerufenen Videos eines Kanals enthält beispielsweise maximal 200 Zeilen. | Diese API unterstützt den Bulk-Download vollständiger Datensätze. Clientanwendungen können eigene 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 Anfrage aus, um die Kontingentkosten zu ermitteln. Die Methodik wird im Abschnitt Kontingentnutzung genauer erläutert. | Die Kontingentnutzung ist kein Problem, da Daten einmal abgerufen und dann in der Anwendung gefiltert, sortiert und abgefragt werden. |
| Eindeutige Berichte |
|
|
| Eindeutige Dimensionen | group (Nur-Filter-Dimension) continent (Nur-Filter-Dimension) subContinent (Nur-Filter-Dimension) month 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 playlist_saves_added playlist_saves_removed |
Unterschiede bei der Namensgebung zwischen APIs
Die beiden APIs verwenden unterschiedliche Namenskonventionen zum Identifizieren von Dimensionen und Messwerten. Bei Namen in der YouTube Analytics API wird CamelCase verwendet, z. B. adType. Namen in der YouTube Reporting API werden in Kleinbuchstaben geschrieben und enthalten Unterstriche, z. B. ad_type.
In den folgenden Tabellen sind die unterschiedlichen Namen aufgeführt, die in den beiden APIs verwendet werden, um dieselben Messwerte und Dimensionen zu identifizieren. In einigen Fällen ist der Unterschied zwischen den beiden Namen größer als das, was Sie nach der Konvertierung eines Namens von CamelCase in Unterstriche erhalten würden. Die Dimension video in der YouTube Analytics API heißt beispielsweise video_id in der YouTube Reporting API.