In diesem Dokument werden die Messwerte definiert, die von der YouTube Reporting API abgerufen werden. Mit dieser API werden Bulk-Datenberichte mit YouTube Analytics-Daten für einen Kanal oder Rechteinhaber abgerufen.
Messwerte sind einzelne Messungen der Nutzeraktivität, der Anzeigenleistung oder des geschätzten Umsatzes. Zu den Messwerten zur Nutzeraktivität gehören beispielsweise die Anzahl der Videoaufrufe und Bewertungen (Likes und Dislikes).
Wichtigste Messwerte
Die YouTube Reporting API unterliegt der in den Nutzungsbedingungen definierten Richtlinie zur Einstellung von Diensten. Nicht zu den wichtigsten Messwerten gehörende Messwerte (und Dimensionen) unterliegen dieser Richtlinie nicht. In den Definitionen auf dieser Seite wird jeder Messwert, der zu den wichtigsten Messwerten gehört, ausdrücklich als solcher gekennzeichnet.
In der folgenden Liste sind die wichtigsten Messwerte der API aufgeführt. Alle diese Messwerte, die auch in der YouTube Analytics API verwendet werden, sind auch in dieser API wichtige Messwerte.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
Weitere Informationen findest du in der Liste der YouTube APIs, die der Richtlinie zur Einstellung von Diensten unterliegen.
Messwerte zu Aufrufen
- engaged_views (wichtigster Messwert)
- Gibt an, wie oft die Videos des Kanals nach dem ersten Frame angesehen wurden oder wie oft Nutzer auf „Abspielen“ geklickt oder getippt haben.
- views (wichtigster Messwert)
- Gibt an, wie oft ein Video aufgerufen wurde. In einem Playlist-Bericht gibt der Messwert an, wie oft ein Video im Kontext einer Playlist aufgerufen wurde. In der
YouTube-Hilfe
findest du weitere Informationen dazu, wie Aufrufe erfasst werden.
This is a core metric and is subject to the Deprecation Policy.
- red_views
- Gibt an, wie oft ein Video von YouTube Premium-Mitgliedern (ehemals YouTube Red) aufgerufen wurde.
- views_percentage (wichtigster Messwert)
- Gibt an, wie viel Prozent der Zuschauer beim Ansehen des Videos oder der Playlist angemeldet waren. This is a core metric and is subject to the Deprecation Policy.
Messwerte zur Reichweite
- video_thumbnail_impressions
- Gibt an, wie oft Videothumbnails Zuschauern angezeigt wurden. Impressionen werden gezählt, wenn ein Thumbnail länger als eine Sekunde eingeblendet wird und mindestens 50% des Thumbnails auf dem Bildschirm sichtbar sind. Weitere Informationen findest du in der YouTube-Hilfe.
- video_thumbnail_impressions_ctr
- Gibt an, wie viel Prozent der Impressionen zu einem Klick geführt haben, mit dem das Video angesehen wurde. Dieser Wert wird berechnet, indem die Anzahl der Klicks durch die Anzahl der Impressionen geteilt wird.
Messwerte zur Wiedergabezeit
- watch_time_minutes (wichtigster Messwert)
- Gibt an, wie viele Minuten Nutzer Videos des angegebenen Kanals, Rechteinhabers, Videos oder der angegebenen Playlist angesehen haben. This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes
- Gibt an, wie viele Minuten YouTube Premium-Mitglieder (ehemals YouTube Red) ein Video angesehen haben.
- average_view_duration_seconds (wichtigster Messwert)
- Gibt die durchschnittliche Wiedergabedauer von Videos in Sekunden an. Seit dem 13. Dezember 2021 werden bei diesem Messwert keine Daten zu Wiedergaben von Videos in Schleife berücksichtigt. In einem Playlist-Bericht gibt der Messwert die durchschnittliche Wiedergabedauer von Videos in Sekunden an, die im Kontext einer Playlist wiedergegeben wurden. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- Gibt den durchschnittlichen Prozentsatz eines Videos an, der während der Videowiedergabe angesehen wurde. Seit dem 13. Dezember 2021 werden bei diesem Messwert keine Daten zu Wiedergaben von Videos in Schleife berücksichtigt.
Engagement-Messwerte
- Kommentare (wichtigster Messwert)
- Gibt an, wie oft Nutzer ein Video kommentiert haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy.
- likes (wichtigster Messwert)
- Gibt an, wie oft Nutzer ein Video positiv bewertet haben. This is a core metric and is subject to the Deprecation Policy.
- dislikes (wichtigster Messwert)
- Gibt an, wie oft Nutzer ein Video negativ bewertet haben. This is a core metric and is subject to the Deprecation Policy.
- Gibt an, wie oft Nutzer ein Video über die Schaltfläche
Sharegeteilt haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy. - subscribers_gained (wichtigster Messwert)
- Gibt an, wie oft Nutzer einen Kanal abonniert haben. This is a core metric and is subject to the Deprecation Policy.
Nutzer können Kanäle an verschiedenen Stellen abonnieren oder deabonnieren, z. B. auf der Videowiedergabeseite, der Kanalseite und im Guide auf der YouTube-Startseite. Um die Anzahl der neuen Kanalabonnenten zu ermitteln, die den Kanal nicht über eine Videowiedergabeseite abonniert haben, enthält ein Bericht zur Nutzeraktivität eine Zeile, in der kein Wert für die Dimension „video_id“ angegeben ist. In dieser Zeile ist auch ein Wert für den MesswertsubscribersLostangegeben, aber keine Werte für andere Messwerte. - subscribers_lost (wichtigster Messwert)
- Gibt an, wie oft Nutzer einen Kanal deabonniert haben. This is a core metric and is subject to the Deprecation Policy.
Die Daten für diesen Messwert werden ähnlich wie für den Messwertsubscribers_gainederfasst. Um die Anzahl der Nutzer zu ermitteln, die einen Kanal deabonniert haben, dies aber nicht auf einer Videowiedergabeseite getan haben, enthält ein Bericht zu grundlegenden Nutzeraktivitäten eine Zeile, in der kein Wert für die Dimension „video_id“ angegeben ist. In dieser Zeile ist auch ein Wert für den Messwertsubscribers_gainedangegeben, aber keine Werte für andere Messwerte. - videos_added_to_playlists
- Gibt an, wie oft Videos zu YouTube-Playlists hinzugefügt wurden. Die Videos können der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt worden sein.
Der Messwert enthält auch die Anzahl der Male, die Videos zu Standardplaylists wie der Playlist „Später ansehen“ hinzugefügt wurden. Playlists, denen ein Video automatisch hinzugefügt wird, werden jedoch nicht berücksichtigt, z. B. die Playlist mit den Uploads eines Kanals oder der Wiedergabeverlauf eines Nutzers.
Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer also ein Video zu einer Playlist hinzufügt, es wieder entfernt und dann noch einmal hinzufügt, wird der Messwert so erfasst, als wäre das Video zweimal zu einer Playlist hinzugefügt worden. Daten für diesen Messwert sind für Daten vor dem 1. Oktober 2014 nicht verfügbar. - videos_removed_from_playlists
- Gibt an, wie oft Videos aus YouTube-Playlists entfernt wurden. Die Videos können aus der Playlist des Videoinhabers oder aus den Playlists anderer Kanäle entfernt worden sein.
Der Messwert enthält auch die Anzahl der Male, die Videos aus Standardplaylists wie der Playlist „Später ansehen“ entfernt wurden.
Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer also ein Video zu einer Playlist hinzufügt, es wieder entfernt, es noch einmal hinzufügt und es dann wieder entfernt, wird der Messwert so erfasst, als wäre das Video zweimal aus einer Playlist entfernt worden. Daten für diesen Messwert sind für Daten vor dem 1. Oktober 2014 nicht verfügbar.
Playlist-Messwerte
Playlist-Berichte enthalten zwei Arten von Messwerten, die Aufschluss darüber geben, wie Zuschauer mit den Videos in einer Playlist interagieren:
-
Aggregierte Videomesswerte enthalten Messwerte zur Nutzeraktivität und zu Impressionen, die für alle Videos in der Playlist aggregiert werden, die auch dem Kanal gehören, der Inhaber der Playlist ist. Messwerte für Videos, die anderen Kanälen gehören, werden bei der Aggregation nicht berücksichtigt. Wenn ein Kanal also eine Playlist erstellt, die nur Videos enthält, die anderen Kanälen gehören, enthalten Berichte für diese Playlists keine Werte für diese Messwerte.
Definitionen der unterstützten aggregierten Videomesswerte findest du in den Abschnitten Messwerte zu Aufrufen und Messwerte zur Wiedergabezeit in diesem Dokument.
-
Messwerte für die Playlist geben Aufschluss über die Nutzeraktivität und das Engagement im Kontext der Playlist-Seite. Diese Messwerte umfassen Aufrufe für alle Videos in der Playlist, unabhängig davon, welchem Kanal sie gehören. Es werden jedoch nur Aufrufe gezählt, die im Kontext der Playlist erfolgt sind.
Die meisten der folgenden Messwerte sind Messwerte für die Playlist. Die übrigen Messwerte in der Liste, z. B. der Messwert playlistSaves, beziehen sich auf Nutzerinteraktionen mit der Playlist selbst und nicht mit Videos in der Playlist. Daher können diese Messwerte weder als
aggregierte Videomesswerte noch als Messwerte für die Playlist bezeichnet werden.
- playlist_starts
- Gibt an, wie oft Zuschauer die Wiedergabe einer Playlist gestartet haben. Dieser Messwert
umfasst nur Playlist-Aufrufe, die im Web erfolgt sind.
- playlist_saves_added (wird nur in der YouTube Reporting API unterstützt)
- Gibt an, wie oft Nutzer eine Playlist gespeichert haben. Weitere Informationen zu gespeicherten Playlists findest du in der YouTube-Hilfe. Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer also eine Playlist speichert, sie aus der Liste der gespeicherten Playlists entfernt und sie dann noch einmal speichert, wird der Messwert so erfasst, als wären zwei Playlist-Speicherungen hinzugefügt worden.
- playlist_saves_removed (wird nur in der YouTube Reporting API unterstützt)
- Gibt an, wie oft Nutzer die Playlist aus ihren Listen der gespeicherten Playlists entfernt haben. Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer also eine Playlist speichert, sie aus der Liste der gespeicherten Playlists entfernt, sie noch einmal speichert und sie dann wieder entfernt, wird der Messwert so erfasst, als wären zwei Playlist-Speicherungen entfernt worden.
Messwerte zu Anmerkungen
- annotation_impressions
- Gibt die Gesamtzahl der Anmerkungsimpressionen an.
- annotation_clickable_impressions
- Gibt an, wie viele Anmerkungen angezeigt wurden und angeklickt werden konnten.
- annotation_clicks
- Gibt an, wie oft Anmerkungen angeklickt wurden.
- annotation_click_through_rate (wichtigster Messwert)
- Gibt das Verhältnis zwischen der Anzahl der Anmerkungen, die Zuschauer angeklickt haben, und der Gesamtzahl der anklickbaren Anmerkungsimpressionen an. This is a core metric and is subject to the Deprecation Policy. In der YouTube-Hilfe findest du weitere Informationen zum Erstellen von Anmerkungen und zum Verwenden von Link-Anmerkungen.
- annotation_closable_impressions
- Gibt an, wie viele Anmerkungen angezeigt wurden und geschlossen werden konnten.
- annotation_closes
- Gibt an, wie oft Anmerkungen geschlossen wurden.
- annotation_close_rate (wichtigster Messwert)
- Gibt das Verhältnis zwischen der Anzahl der Anmerkungen, die Zuschauer geschlossen haben, und der Gesamtzahl der Anmerkungsimpressionen an. This is a core metric and is subject to the Deprecation Policy.
Messwerte zu Infokarten
In der YouTube-Hilfe findest du eine detaillierte Anleitung zum Hinzufügen von Infokarten zu deinen Videos und zum Bericht „Infokarten“ in YouTube Analytics.
- card_impressions
- Gibt an, wie oft Infokarten eingeblendet wurden. Wenn das Infokartenfeld geöffnet wird, wird für jede Infokarte des Videos eine Infokartenimpression erfasst.
- card_clicks
- Gibt an, wie oft Infokarten angeklickt wurden.
- card_click_rate
- Gibt die Klickrate für Infokarten an, die als Verhältnis von Klicks zu Impressionen berechnet wird.
- Gibt an, wie oft Infokartenteaser eingeblendet wurden. Ein Videoaufruf kann mehrere Teaserimpressionen generieren.
- Gibt an, wie oft Infokartenteaser angeklickt wurden. Klicks auf das Kartensymbol werden dem zuletzt angezeigten Teaser zugeordnet.
- Gibt die Klickrate für Infokartenteaser an, die als Verhältnis von Klicks auf Infokartenteaser zur Gesamtzahl der Infokartenteaser-Impressionen berechnet wird.
Messwerte zu Abspannen
Abspanne sind Elemente, die in den letzten fünf bis 20 Sekunden eines Videos eingeblendet werden, um für deine Inhalte, deinen Kanal und deine Websites zu werben. In der YouTube-Hilfe findest du eine detaillierte Anleitung zum Hinzufügen von Abspannen zu deinen Videos und zum Bericht „Abspanne“ in YouTube Analytics.
- end_screen_element_impressions
- Gibt an, wie viele Abspannelemente eingeblendet wurden. Für jedes eingeblendete Abspannelement wird eine Impression erfasst.
- end_screen_element_clicks
- Gibt an, wie oft Abspannelemente angeklickt wurden.
- end_screen_element_click_rate
- Gibt die Klickrate für Abspannelemente an, die als Verhältnis von Klicks auf Abspannelemente zu Impressionen von Abspannelementen berechnet wird.
Messwerte zu Kündigungen von Mitgliedschaften
- membershipsCancellationSurveyResponses
- Gibt an, wie viele Umfragen von YouTube-Nutzern ausgefüllt wurden, die ihre Kanalmitgliedschaft für den angegebenen Kanal im Berichtszeitraum gekündigt haben.
Messwerte zum geschätzten Umsatz
Hinweis:Die Messwerte zum geschätzten Umsatz werden am Monatsende angepasst und enthalten keine Einnahmen aus Anzeigen, die von Partnern verkauft oder ausgeliefert wurden. Weitere Informationen und Hinweise zu den Zahlen zum geschätzten Umsatz findest du in der YouTube-Hilfe.
- estimated_partner_revenue (wichtigster Messwert)
- Gibt den geschätzten Nettogesamtumsatz aus allen von Google verkauften Werbequellen sowie aus nicht werbebasierten Quellen für den ausgewählten Zeitraum und die ausgewählte Region an.
- estimated_partner_ad_revenue
- Gibt den geschätzten Nettogesamtumsatz aus allen von Google verkauften Werbequellen für den ausgewählten Zeitraum und die ausgewählte Region an.
Die Messwerte zum geschätzten Umsatz werden am Monatsende angepasst und enthalten keine Einnahmen aus Anzeigen, die von Partnern verkauft oder ausgeliefert wurden. - estimated_partner_ad_auction_revenue (wird nur in der YouTube Reporting API unterstützt)
- Gibt die geschätzten Gesamteinnahmen (Nettoumsatz) aus Anzeigen an, die über die Anzeigenauktion über AdSense verkauft wurden, für den ausgewählten Zeitraum und die ausgewählte Region. Dieser Messwert hieß zuvor
estimated_partner_ad_sense_revenue. - estimated_partner_ad_reserved_revenue (wird nur in der YouTube Reporting API unterstützt)
- Gibt die geschätzten Gesamteinnahmen (Nettoumsatz) aus Anzeigen an, die über DoubleClick (DCLK) und andere von YouTube verkaufte Quellen verkauft wurden. Dieser Messwert hieß zuvor
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (wird nur in der YouTube Reporting API unterstützt)
- Gibt die geschätzten Gesamteinnahmen (Nettoumsatz) aus YouTube Premium-Abos (ehemals YouTube Red) an.
- estimated_partner_transaction_revenue (wird nur in der YouTube Reporting API unterstützt)
- Gibt den geschätzten Gesamtumsatz aus Transaktionen an, z. B. Zahlungen für kostenpflichtige Inhalte und Zahlungen im Rahmen der Finanzierung durch Fans, abzüglich aller dem Partner in Rechnung gestellten Erstattungen.
Messwerte zur Anzeigenleistung
- estimated_youtube_ad_revenue
- Gibt den geschätzten Bruttoumsatz in US-Dollar aus allen von Google oder DoubleClick-Partnern verkauften Anzeigen für den ausgewählten Zeitraum und die ausgewählte Region an. Der Bruttoumsatz wird am Monatsende angepasst und enthält keine Einnahmen aus Anzeigen, die von Partnern ausgeliefert wurden. Der Bruttoumsatz sollte nicht mit dem geschätzten Umsatz oder dem Nettoumsatz verwechselt werden, bei denen dein Eigentumsanteil und Vereinbarungen zur Umsatzbeteiligung berücksichtigt werden.
- estimated_cpm
- Die geschätzten Bruttoeinnahmen pro tausend Anzeigenimpressionen.
- ad_impressions
- Gibt die Anzahl der bestätigten ausgelieferten Anzeigenimpressionen an.
- estimated_monetized_playbacks
- Gibt an, wie oft ein Zuschauer dein Video angesehen hat und mindestens eine Anzeigenimpression gesehen hat. Eine monetarisierte Wiedergabe wird gezählt, wenn ein Zuschauer eine Pre-Roll-Anzeige sieht, die Wiedergabe der Anzeige aber beendet, bevor dein Video startet. Der erwartete geschätzte Fehler für diese Zahl beträgt ±2,0%.
- estimated_playback_based_cpm
- Die geschätzten Bruttoeinnahmen pro tausend Wiedergaben.