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 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 fungiert als Primärschlüssel für diese Zeile.
-
Messwerte sind einzelne Messungen von Nutzeraktivitäten, Anzeigenleistung oder geschätztem Umsatz. Zu den Messwerten für Nutzeraktivitäten gehören unter anderem die Anzahl der Videoaufrufe und Bewertungen (Likes und Dislikes).
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. Die aufrufende Anwendung muss daher keine abgerufenen Datasets speichern oder Statistiken über Zeiträume hinweg zusammenfassen. - 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 können Sie Berichtsjobs planen. Jeder Job gibt einen Bericht an, der von YouTube generiert werden soll. YouTube generiert dann einen Tagesbericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen 24-Stunden-Zeitraum.
Außerdem werden für Rechteinhaber, die in YouTube Creator Studio Zugriff auf die entsprechenden Berichte haben, automatisch eine Reihe von systemverwalteten Berichten erstellt. 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 Asset-Berichte 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. |
| Berichte zur Reichweite | Wird für Kanäle (bulk) und Rechteinhaber (bulk) unterstützt. Messwerte zur Reichweite sind auch in Videoberichten für gezielte Anfragen verfügbar. Reichweitenberichte enthalten Statistiken zu Impressionen von Video-Thumbnails und Klickraten. |
| Playlist-Berichte | Wird für Kanäle (query oder bulk) und Rechteinhaber (query oder bulk) unterstützt. Playlist-Berichte enthalten Statistiken zu Videoaufrufen im Kontext einer Playlist. 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 | Wird 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 | Wird 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“ in 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 Nutzermesswerte 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 nach der Konvertierung eines Namens von CamelCase in Unterstriche. Die Dimension video in der YouTube Analytics API heißt in der YouTube Reporting API beispielsweise video_id.