Metrics

In diesem Dokument werden die Messwerte definiert, die du mithilfe der YouTube Analytics API abrufen kannst. Diese API unterstützt Echtzeitabfragen, mit denen benutzerdefinierte YouTube Analytics-Berichte erstellt werden können.

Messwerte sind einzelne Messungen der Nutzeraktivität, der Anzeigenleistung oder des geschätzten Umsatzes. Die Messwerte zur Nutzeraktivität umfassen beispielsweise die Anzahl der Videoaufrufe und Bewertungen wie „Mag ich“- und „Mag ich nicht“-Bewertungen.

Kernmesswerte

Die YouTube Analytics API unterliegt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen definiert ist. Messwerte, die nicht zum Kernbereich gehören, und Dimensionen, die nicht zu den Kernmesswerten gehören, sind davon nicht betroffen. In den Definitionen auf dieser Seite werden alle Messwerte, die einen wichtigen Messwert darstellen, explizit als solche angegeben.

In der folgenden Liste sind die wichtigsten Messwerte der API aufgeführt.

Hinweis: Die folgenden Kernmesswerte wurden vollständig eingestellt:
  • Der Hauptmesswert „earnings“ wurde am 4. August 2016 eingestellt und in estimatedRevenue umbenannt. Gemäß der in den Nutzungsbedingungen definierten Richtlinie zur Einstellung von Produkten und Diensten wurden die Messwerte earnings und estimatedRevenue bis zum 10. August 2017 gleichzeitig unterstützt.
  • Die Kernmesswerte favoritesAdded und favoritesRemoved wurden am 31. März 2015 eingestellt. Diese Messwerte konnten nur über die YouTube Analytics API abgerufen werden.

Weitere Informationen findest du in der Liste der YouTube APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.

Messwerte aufrufen

Aufrufe (Hauptmesswert)
Dieser Messwert stellt verschiedene Zahlen in verschiedenen Berichtstypen dar:
  • In Videoberichten gibt dieser Messwert an, wie oft ein Video angesehen wurde.
  • In Playlist-Berichten, in denen die Dimension isCurated nicht verwendet wird, gibt dieser Messwert die Gesamtzahl der Aufrufe von Videos in der Playlist an. Dabei spielt es keine Rolle, ob diese Aufrufe im Kontext der Playlist erfolgt sind. Beachte, dass der Messwert nur Aufrufe der Videos des Kanalinhabers enthält.

    In diesen Berichten gibt der Messwert playlistViews an, wie oft die Playlist-Videos im Kontext einer bestimmten Playlist angesehen wurden.
  • In Playlist-Berichten, in denen die Dimension isCurated verwendet wird, gibt dieser Messwert an, wie oft Videos im Kontext einer bestimmten Playlist angesehen wurden. Der Messwert playlistViews wird für diese Berichte nicht unterstützt.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Dieser Messwert wird im Abschnitt Playlist-Messwerte festgelegt.
redViews
Wie oft ein Video von YouTube Premium-Mitgliedern (früher YouTube Red) angesehen wurde.
uniques (eingestellt am 27. September 2016)
Die Anzahl an einzelnen Zuschauern, die sich ein Video angesehen haben. Diese Berechnung basiert auf der Anzahl der einzelnen Cookies und zählt daher zu viele Nutzer, die mehrere Geräte oder Browser verwenden.
Der Messwert uniques wurde am 27. September 2016 eingestellt. Er ist kein zentraler Messwert und wird bis zum 31. Oktober 2016 unterstützt.
viewerPercentage (Hauptmesswert)
Der Prozentsatz der Zuschauer, die beim Ansehen des Videos oder der Playlist angemeldet waren. This is a core metric and is subject to the Deprecation Policy.

Messwerte zur Wiedergabezeit

estimatedMinutesWatched (Hauptmesswert)
Die Anzahl der Minuten, die 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.
estimatedRedMinutesWatched
Die Anzahl der Minuten, in denen YouTube Premium-Mitglieder (früher YouTube Red) ein Video angesehen haben.
averageViewDuration (Hauptmesswert)
Die durchschnittliche Dauer von Videowiedergaben in Sekunden. Seit dem 13. Dezember 2021 werden bei diesem Messwert Zugriffe in Schleifen nicht berücksichtigt. In einem Playlist-Bericht gibt der Messwert die durchschnittliche Dauer der Videowiedergaben in Sekunden an, die im Kontext einer Playlist stattfanden. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Der durchschnittliche Prozentsatz eines Videos, der während der Wiedergabe angesehen wurde. Seit dem 13. Dezember 2021 werden bei diesem Messwert Zugriffe in Schleifen nicht berücksichtigt.

Engagement-Messwerte

Kommentare (Hauptmesswert)
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.
Gefällt mir (Kernmesswert)
Wie oft Nutzer durch eine positive Bewertung ein Video mit „Mag ich“ bewertet haben. This is a core metric and is subject to the Deprecation Policy.
Mag ich nicht (Hauptmesswert)
Wie oft Nutzer durch eine negative Bewertung ein Video negativ bewertet haben. This is a core metric and is subject to the Deprecation Policy.
Anteile (Hauptmesswert)
Wie oft Nutzer ein Video über die Schaltfläche „Share“ geteilt haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy.
subscribersGained (Hauptmesswert)
Wie oft Nutzer einen Kanal abonniert haben. This is a core metric and is subject to the Deprecation Policy.

Kanäle können an verschiedenen Stellen Abonnenten gewinnen oder verlieren, z. B. über die Wiedergabeseite eines Videos, die Kanalseite und die Übersicht auf der YouTube-Startseite. In Kanalberichten werden bei diesem Messwert auch Abonnenten berücksichtigt, die über diese Kanäle gewonnen wurden. In Berichten, in denen die Dimension video oder der Parameter filter verwendet wird, um die Antwort auf Daten für ein bestimmtes Video zu beschränken, enthält der Messwert subscribersGained jedoch nur Statistiken von der Wiedergabeseite des entsprechenden Videos.
subscribersLost (Hauptmesswert)
Wie oft Nutzer das Kanalabo eines Nutzers beendet 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 Messwert subscribersGained erfasst. In Kanalberichten werden bei diesem Messwert Abonnenten berücksichtigt, die durch einen beliebigen Mechanismus verloren wurden, über den Nutzer ein Abo für einen Kanal beenden können. In Berichten, in denen die Dimension video oder der Parameter filter verwendet wird, um die Antwort auf Daten für ein bestimmtes Video einzuschränken, werden bei diesem Messwert nur Nutzer berücksichtigt, die das entsprechende Video nicht mehr abonniert haben.
videosAddedToPlaylists
So oft wurden Videos beliebigen YouTube-Playlists hinzugefügt. Die Videos könnten der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt worden sein.

Der Messwert gibt an, wie oft Videos Standardplaylists wie der Playlist „Später ansehen“ hinzugefügt wurden. Er berücksichtigt jedoch keine Playlists, denen ein Video automatisch hinzugefügt wird, z. B. die Upload-Playlist eines Kanals oder der Wiedergabeverlauf eines Nutzers.

Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer ein Video einer Playlist hinzufügt, entfernt und dann noch einmal hinzufügt, spiegelt der Messwert das Video wider, das einer Playlist zweimal hinzugefügt wurde. Für diesen Messwert sind keine Daten für Zeiträume vor dem 1. Oktober 2014 verfügbar.
videosRemovedFromPlaylists
Wie oft Videos aus YouTube-Playlists entfernt wurden. Die Videos konnten möglicherweise aus der Playlist des Videoinhabers oder aus den Playlists anderer Kanäle entfernt worden sein.

Der Messwert gibt an, wie oft Videos aus Standardplaylists wie der Playlist „Später ansehen“ entfernt wurden.

Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer ein Video einer Playlist hinzufügt, entfernt, wieder hinzufügt und dann wieder entfernt, spiegelt der Messwert das Video wider, das aus einer Playlist entfernt wurde. Für diesen Messwert sind keine Daten für Zeiträume vor dem 1. Oktober 2014 verfügbar.

Eingestellte Engagement-Messwerte

Die folgenden Messwerte waren beide wichtige Messwerte, die am 31. März 2015 eingestellt wurden.

favoritesAdded (Kernmesswert) (am 31. März 2015 eingestellt)
Wie oft Nutzer ein Video als Favorit markiert haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (Hauptmesswert) (am 31. März 2015 eingestellt)
Wie oft Nutzer ein Video aus ihren Favoritenlisten entfernt haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy.

Playlist-Messwerte

Playlist-Berichte enthalten zwei Arten von Messwerten, die Aufschluss darüber geben, wie Zuschauer mit den Videos in einer Playlist interagieren:

  • Zusammengefasste Videomesswerte bieten Messwerte zur Nutzeraktivität und zu Impressionen. Diese werden für alle Videos in der Playlist zusammengefasst, die auch dem Kanal gehören, zu dem die Playlist gehört. Messwerte für Videos, die anderen Kanälen gehören, werden in der Aggregation nicht berechnet. Wenn auf einem Kanal also eine Playlist erstellt wird, 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 in Playlists spiegeln Nutzeraktivität und -interaktionen im Kontext der Playlist-Seite wider. Diese Messwerte umfassen die Aufrufe aller Videos in der Playlist, unabhängig davon, welcher Kanal der Inhaber ist. Es werden aber nur Aufrufe gezählt, die im Kontext der Playlist stattgefunden haben.

Bei den meisten der unten aufgeführten Messwerte handelt es sich um In-Playlist-Messwerte. Bei den restlichen Messwerten in der Liste, wie der Messwert playlistSaves, geht es um Nutzerinteraktionen mit der Playlist selbst und nicht mit Videos in der Playlist. Diese Messwerte werden daher weder als zusammengefasste Videomesswerte noch als Messwerte für Playlists in der Playlist bezeichnet.

averageTimeInPlaylist
Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer nach dem Start der Playlist Videos in einer Playlist angesehen hat. Dieser Messwert umfasst nur Playlist-Aufrufe, die im Web erfolgt sind.
playlistAverageViewDuration
Die geschätzte durchschnittliche Wiedergabedauer in Sekunden pro Playlist-Aufruf. Dieser Messwert stellt die durchschnittliche Länge der Aufrufe einzelner Videos in einer Playlist dar. Der Messwert averageTimeInPlaylist hingegen gibt die durchschnittliche Zeit an, die ein Zuschauer die Playlist insgesamt ansieht. Dieser Messwert enthält Daten für Playlist-Videos, die anderen Kanälen gehören.
playlistEstimatedMinutesWatched
Die Anzahl der Minuten, die Nutzer als Teil der Playlist angesehen haben. Wiedergabezeiten aus anderen Kontexten, z. B. Wiedergabezeit aus Aufrufen, wenn Zuschauer dasselbe Video als Teil einer anderen Playlist angesehen haben, wird nicht gezählt. Dieser Messwert enthält Daten für Playlist-Videos, die anderen Kanälen gehören.
playlistSaves
Die Nettohäufigkeit, die Nutzer eine Playlist gespeichert haben. Weitere Informationen zu gespeicherten Playlists findest du in der YouTube-Hilfe. Dieser Messwert gibt eine Nettoänderungszahl zurück. Wenn ein Nutzer also eine Playlist speichert, sie aus der Liste der gespeicherten Playlists entfernt und noch einmal speichert, spiegelt der Messwert eine hinzugefügte Playlist wider.
playlistStarts
Wie oft die Wiedergabe einer Playlist durch Zuschauer gestartet wurde. Dieser Messwert umfasst nur Playlistaufrufe, die im Web stattgefunden haben.
playlistViews
Wie oft Videos in der Playlist im Kontext dieser Playlist angesehen wurden. Dieser Messwert enthält Daten für Playlist-Videos, die anderen Kanälen gehören.
viewsPerPlaylistStart
Die durchschnittliche Anzahl der Videoaufrufe, die nach dem Start einer Playlist erfolgten. Dieser Messwert umfasst nur Playlistaufrufe, die im Web stattgefunden haben.

Messwerte für Anmerkungen

Hinweis: YouTube Analytics API-Berichte enthalten nur Daten für die Messwerte annotationClickThroughRate und annotationCloseRate, die seit dem 10. Juni 2012 verfügbar sind. Außerdem enthalten die Berichte der YouTube Analytics API nur Daten für die übrigen Messwerte zu Anmerkungen ab dem 16. Juli 2013.

annotationImpressions
Die Gesamtzahl der Anmerkungsimpressionen.
annotationClickableImpressions
Die Anzahl der Anmerkungen, die angezeigt wurden und angeklickt werden konnten.
annotationClicks
Die Anzahl der angeklickten Anmerkungen.
annotationClickThroughRate (Hauptmesswert)
Das Verhältnis von Anmerkungen, die Zuschauer angeklickt haben, zur Gesamtzahl der anklickbaren Anmerkungsimpressionen. 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 Verwenden von Linkanmerkungen.
annotationClosableImpressions
Die Anzahl der Anmerkungen, die angezeigt wurden und geschlossen werden konnten.
annotationCloses
Die Anzahl der geschlossenen Anmerkungen.
annotationCloseRate (Hauptmesswert)
Das Verhältnis von Anmerkungen, die Zuschauer geschlossen haben, zur Gesamtzahl der Anmerkungsimpressionen. This is a core metric and is subject to the Deprecation Policy.

Kartenmesswerte

In der YouTube-Hilfe findest du eine ausführlichere Anleitung zum Hinzufügen von Infokarten zu Videos und zum YouTube Analytics-Infokarten-Bericht.

cardImpressions
Wie oft Karten angezeigt wurden. Wird der Kartenbereich geöffnet, wird für jede Infokarten des Videos eine Infokartenimpression erfasst.
cardClicks
Gibt an, wie oft Infokarten angeklickt wurden.
cardClickRate
Die Klickrate für Infokarten, die als Verhältnis der Klicks zu den Impressionen für Infokarten berechnet wird.
cardTeaserImpressions
Gibt an, wie oft Infokarten-Teaser zu sehen waren. Ein Videoaufruf kann mehrere Teaser-Impressionen generieren.
cardTeaserClicks
Die Anzahl der Klicks auf Infokartenteaser. Klicks auf das Kartensymbol werden dem letzten Teaser zugeordnet, der dem Nutzer angezeigt wurde.
cardTeaserClickRate
Die Klickrate für Infokartenteaser. Sie ergibt sich aus dem Verhältnis der Klicks auf Infokartenteaser zur Gesamtzahl der Impressionen für Infokartenteaser.

Messwerte zur Zuschauerbindung

audienceWatchRatio
Das absolute Verhältnis der Nutzer, die sich das Video an einer bestimmten Stelle im Video ansehen. Das Verhältnis wird berechnet, indem die Häufigkeit, mit der ein Teil eines Videos angesehen wurde, mit der Gesamtzahl der Aufrufe des Videos verglichen wird. Die Dimension elapsedVideoTimeRatio gibt den Teil des Videos an, dem der Messwert entspricht.

Es kann vorkommen, dass ein Teil eines Videos während eines bestimmten Videoaufrufs mehrmals oder gar nicht angesehen wird. Wenn Nutzer beispielsweise zurückspulen und denselben Teil eines Videos mehrmals ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als 1 sein.

Die folgenden Beispiele veranschaulichen, wie der Wert berechnet wird:
  • Ein einminütiges Video wird 100 Mal angesehen. Die Hälfte der Zuschauer bricht nach 15 Sekunden ab, die anderen sehen sich das gesamte Video an. Keiner der Zuschauer sieht sich Teile des Videos mehr als einmal an. In diesem Fall wäre der Wert dieses Messwerts 1 für Zeitgruppen im ersten Viertel des Videos und 0.50 für den Rest des Videos.
  • Ein einminütiges Video wird 100 Mal angesehen. Alle Zuschauer sehen sich das gesamte Video an. 20 der Zuschauer sehen es sich jedoch bis zur 45-Sekunden-Marke des Videos an, springen dann zurück zur 30-Sekunden-Marke und sehen sich dann den Rest des Videos an. In diesem Fall wäre der Messwert des Messwerts 1 für Zeitbereiche in der ersten Hälfte oder im letzten Viertel des Videos. Der Wert wäre jedoch 1.2 für Zeitbereiche im dritten Viertel des Videos, da 100 % der Zuschauer sich diesen Abschnitt des Videos angesehen haben, aber 20 % von ihnen sich das Segment zweimal angesehen haben.
relativeRetentionPerformance
Ein Messwert, der angibt, wie gut die Zuschauerbindung eines Videos im Vergleich zu allen YouTube-Videos ähnlicher Länge abschneidet. Der Messwert hat einen Wert zwischen 0 und 1, der die relative Zuschauerbindungsleistung des Videos zu einem bestimmten Zeitpunkt im Video angibt. Der Punkt im Video wird durch die Dimension elapsedVideoTimeRatio angegeben.

Ein Wert von 0 gibt an, dass das Video die Zuschauerbindung stärker anspricht als jedes andere Video ähnlicher Länge. Ein Wert von 1 gibt an, dass das Video die Zuschauerbindung besser einspart als jedes andere Video ähnlicher Länge. Ein Medianwert von 0.5 gibt an, dass die Hälfte der Videos ähnlicher Länge Zuschauer besser anspricht und die Hälfte schlechter anspricht.

Das folgende hypothetische Beispiel zeigt, wie die Werte in einem Bericht aussehen könnten. Im Durchschnitt sehen sich 90 % der Zuschauer, die sich Videos mit einer Länge von 10 Minuten ansehen, diese auch nach drei Minuten noch einmal an. 70 % sehen sie sich auch nach acht Minuten noch an. Bei einem bestimmten 10-minütigen Video sehen sich nur noch 80 % der Zuschauer nach drei Minuten das Video an. Alle diese Zuschauer sehen es sich aber nach acht Minuten noch an.
  • An dem Wert elapsedVideoTimeRatio, der dem dreiminütigen Videoabschnitt entspricht, hätte der Messwert relativeRetentionPerformance einen Wert unter 0.5, da die Leistung des Videos zu diesem Zeitpunkt schlechter als das durchschnittliche Video ist.
  • Beim Wert elapsedVideoTimeRatio, der dem achtminütigen Videozeitpunkt entspricht, hätte der Messwert relativeRetentionPerformance einen höheren Wert als 0.5, da das Video zu diesem Zeitpunkt besser abschneidet als andere Videos ähnlicher Länge.

Messwerte zum geschätzten Umsatz

Hinweis: Die Messwerte zum geschätzten Umsatz unterliegen Änderungen am Monatsende und enthalten keine von Partnern verkaufte und ausgelieferte Werbung. Weitere Informationen und Hinweise zu den geschätzten Umsatzzahlen findest du in der YouTube-Hilfe.

Standardmäßig werden alle geschätzten Umsatzzahlen in US-Dollar angegeben. Die YouTube Analytics API unterstützt jedoch den Parameter currency für einige Messwerte zum geschätzten Umsatz und zur Anzeigenleistung, sodass du geschätzte Umsatzdaten in anderen Währungen abrufen kannst.
estimatedRevenue (Hauptmesswert) (früher earnings)
Der geschätzte Gesamtnettoumsatz aus allen von Google verkauften Werbequellen sowie aus anderen Quellen für den ausgewählten Zeitraum und die ausgewählte Region. This is a core metric and is subject to the Deprecation Policy.

Die Messwerte zum geschätzten Umsatz werden am Monatsende angepasst und enthalten keine von Partnern verkaufte und ausgelieferte Werbung.
estimatedAdRevenue (bisher adEarnings)
Der geschätzte Gesamtnettoumsatz aus allen von Google verkauften Werbequellen für den ausgewählten Zeitraum und die ausgewählte Region.

Die Messwerte zum geschätzten Umsatz werden am Monatsende angepasst und enthalten keine von Partnern verkaufte und ausgelieferte Werbung.
estimatedRedPartnerRevenue (bisher redPartnerRevenue)
Der geschätzte Gesamtumsatz aus YouTube Premium-Abos (früher YouTube Red) mit den ausgewählten Berichtsdimensionen. Der Wert des Messwerts spiegelt den Umsatz sowohl aus Musik- als auch anderen Inhalten ohne Musik wider und wird am Monatsende angepasst.

Messwerte zur Anzeigenleistung

grossRevenue
Der geschätzte Bruttoumsatz in US-Dollar aus aller Werbung, die von Google oder DoubleClick-Partnern verkauft wurde, im ausgewählten Zeitraum und in der ausgewählten Region. Sie werden am Monatsende korrigiert und umfassen keine von Partnern geschalteten Werbeanzeigen. Die Bruttoeinnahmen dürfen nicht mit dem geschätzten Umsatz oder dem Nettoumsatz verwechselt werden, bei dem deine Vereinbarungen zur Umsatzbeteiligung und zur Umsatzbeteiligung berücksichtigt werden.
cpm (bisher impressionBasedCpm)
Die geschätzten Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.
adImpressions (früher impressions)
Die Anzahl der bestätigten Anzeigenimpressionen, die erzielt wurden.
monetizedPlaybacks
Die Häufigkeit, mit der ein Nutzer Ihr Video angesehen und mindestens eine Anzeigenimpression gesehen hat. Eine monetarisierte Wiedergabe wird gezählt, wenn einem Nutzer eine Pre-Roll-Anzeige eingeblendet wird, die Wiedergabe aber vor dem Start des Videos beendet. Der erwartete geschätzte Fehler für diese Zahl beträgt ±2,0%.
playbackBasedCpm
Die geschätzten Bruttoeinnahmen pro 1.000 Wiedergaben.