In diesem Dokument werden die Messwerte definiert, die Sie mit der YouTube Analytics API abrufen können. Diese API unterstützt Echtzeitabfragen, über die benutzerdefinierte YouTube Analytics-Berichte erstellt werden können.
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 („Mag ich“ und „Mag ich nicht“).
Wichtigste Messwerte
Die YouTube Analytics API unterliegt der in den Nutzungsbedingungen definierten Richtlinie zur Einstellung von Diensten. Nicht zentrale Messwerte (und nicht zentrale Dimensionen) unterliegen dieser Richtlinie jedoch nicht. In den Definitionen auf dieser Seite wird jeder Messwert, der ein wichtiger Messwert ist, explizit als solcher gekennzeichnet.
In der folgenden Liste sind die wichtigsten Messwerte der API aufgeführt.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
engagedViews
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
Weitere Informationen finden Sie in der Liste der YouTube-APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
Messwerte aufrufen
- engagedViews (wichtiger Messwert)
- Die Anzahl der Aufrufe von Videos auf dem Kanal, die über die ersten Sekunden hinausgehen.
- Aufrufe (Hauptmesswert)
- Dieser Messwert steht in verschiedenen Berichtstypen für unterschiedliche Zahlen.
This is a core metric and is subject to the Deprecation Policy.
- playlistViews
- Dieser Messwert wird im Abschnitt Playlist-Messwerte definiert.
- redViews
- Gibt an, wie oft ein Video von YouTube Premium-Mitgliedern (ehemals YouTube Red) aufgerufen wurde.
- viewerPercentage (Kernmesswert)
- 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 (Kernmesswert)
- Die Anzahl der Minuten, die Nutzer sich 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, die YouTube Premium-Mitglieder (ehemals YouTube Red) ein Video angesehen haben.
- averageViewDuration (Kernmesswert)
- Die durchschnittliche Länge von Videowiedergaben in Sekunden. Seit dem 13. Dezember 2021 wird Traffic von Clips mit Wiederholung in diesem Messwert nicht mehr berücksichtigt. In einem Playlist-Bericht gibt der Messwert die durchschnittliche Länge in Sekunden der Videowiedergaben an, die im Kontext einer Playlist erfolgt sind. This is a core metric and is subject to the Deprecation Policy.
- averageViewPercentage
- Der durchschnittliche Prozentsatz eines Videos, der während der Videowiedergabe angesehen wurde. Seit dem 13. Dezember 2021 wird Traffic von Clips mit Wiederholung in diesem Messwert nicht mehr berücksichtigt.
Engagement-Messwerte
- Kommentare (Kernmesswert)
- Die Häufigkeit, mit der 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 (wichtiger Messwert)
- Die Anzahl der positiven Bewertungen, durch die Nutzer ausdrücken, dass ihnen ein Video gefallen hat. This is a core metric and is subject to the Deprecation Policy.
- Dislikes (wichtiger Messwert)
- Die Anzahl der negativen Bewertungen, durch die Nutzer ausdrücken, dass ihnen ein Video nicht gefallen hat. This is a core metric and is subject to the Deprecation Policy.
- Die Häufigkeit, mit der 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 (Kernmesswert)
- Die Anzahl der Nutzer, die 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. auf der Videowiedergabeseite, der Kanalseite und im Guide auf der YouTube-Startseite. In Kanalberichten umfasst dieser Messwert Abonnenten, die über einen dieser Orte gewonnen wurden. In Berichten, in denen die Antwort mithilfe der Dimensionvideo
oder des Parametersfilter
auf Daten für ein bestimmtes Video beschränkt wird, enthält der MesswertsubscribersGained
jedoch nur Statistiken von der Wiedergabeseite des angegebenen Videos. - subscribersLost (Kernmesswert)
- Die Häufigkeit, mit der Nutzer einen Kanal abbestellt 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 MesswertsubscribersGained
erfasst. In Kanalberichten umfasst dieser Messwert Abonnenten, die über einen beliebigen Mechanismus verloren gegangen sind, über den Nutzer einen Kanal abonnieren können. In Berichten, in denen die Antwort mit der Dimensionvideo
oder dem Parameterfilter
auf Daten für ein bestimmtes Video beschränkt wird, werden in diesem Messwert jedoch nur Nutzer berücksichtigt, die sich auf der Wiedergabeseite des angegebenen Videos abgemeldet haben. - videosAddedToPlaylists
- Die Häufigkeit, mit der Videos zu YouTube-Playlists hinzugefügt wurden. Die Videos könnten der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt worden sein.
Der Messwert umfasst auch die Anzahl der Videos, die Standardplaylists wie der Playlist „Später ansehen“ hinzugefügt wurden. Playlists, denen ein Video automatisch hinzugefügt wird, z. B. die Upload-Playlist eines Kanals oder der Wiedergabeverlauf eines Nutzers, werden jedoch nicht berücksichtigt.
Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer ein Video also einer Playlist hinzufügt, es entfernt und dann wieder hinzufügt, wird das Video zweimal in den Messwert einbezogen. Daten für diesen Messwert sind für Zeiträume vor dem 1. Oktober 2014 nicht verfügbar. - videosRemovedFromPlaylists
- Gibt an, wie oft Videos aus YouTube-Playlists entfernt wurden. Die Videos wurden möglicherweise aus der Playlist des Videoinhabers oder aus Playlists anderer Kanäle entfernt.
Der Messwert umfasst die Anzahl der Entfernungen von Videos aus Standardplaylists wie der Playlist „Später ansehen“.
Dieser Messwert gibt eine absolute Zahl zurück. Wenn ein Nutzer ein Video also einer Playlist hinzufügt, es entfernt, es wieder hinzufügt und es dann wieder entfernt, wird das Entfernen des Videos aus einer Playlist zweimal gezählt. Daten für diesen Messwert sind für Zeiträume 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 zu Nutzeraktivität und Impressionen, die für alle Videos in der Playlist zusammengefasst werden, die auch dem Kanal gehören, dem die Playlist gehört. Messwerte für Videos, die anderen Kanälen gehören, werden in der Aggregation nicht berechnet. Wenn ein Kanal eine Playlist erstellt, die nur Videos von anderen Kanälen enthält, sind in Berichten für diese Playlists keine Werte für diese Messwerte verfügbar.
Definitionen der unterstützten aggregierten Videomesswerte finden Sie in diesem Dokument in den Abschnitten Messwerte ansehen und Messwerte zur Wiedergabezeit.
-
Messwerte in Playlists geben die Nutzeraktivität und das Engagement im Kontext der Playlist-Seite an. Diese Messwerte umfassen Aufrufe aller Videos in der Playlist, unabhängig davon, zu welchem Kanal sie gehören. Es werden jedoch nur Aufrufe gezählt, die im Kontext der Playlist erfolgt sind.
Die meisten der folgenden Messwerte beziehen sich auf die Playlist. Die verbleibenden Messwerte in der Liste, z. B. playlistSaves
, beziehen sich auf Nutzerinteraktionen mit der Playlist selbst und nicht mit Videos in der Playlist. Daher werden diese Messwerte weder als aggregierte Videomesswerte noch als Messwerte für Playlists eingestuft.
- averageTimeInPlaylist
- Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer Videos in einer Playlist angesehen hat, nachdem die Playlist gestartet wurde. Dieser Messwert umfasst nur Playlist-Aufrufe, die im Web erfolgt sind.
- playlistAverageViewDuration
- Die geschätzte durchschnittliche Wiedergabedauer in Sekunden pro Playlistaufruf. Dieser Messwert gibt die durchschnittliche Länge der Aufrufe einzelner Videos in einer Playlist an. Der Messwert
averageTimeInPlaylist
gibt dagegen die durchschnittliche Zeit an, die jeder Zuschauer mit der Wiedergabe der gesamten Playlist verbringt. Dieser Messwert enthält Daten zu Playlist-Videos, die anderen Kanälen gehören. - playlistEstimatedMinutesWatched
- Die Anzahl der Minuten, die Nutzer sich die Inhalte der Playlist als Teil der Playlist angesehen haben. Die Wiedergabezeit in anderen Kontexten, z. B. die Wiedergabezeit von Aufrufen, die erfolgten, als Zuschauer dasselbe Video als Teil anderer Playlists angesehen haben, wird nicht berücksichtigt. Dieser Messwert enthält Daten zu Playlist-Videos, die anderen Kanälen gehören.
- playlistSaves
- Die Anzahl der Nutzer, die 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 sie dann wieder speichert, wird im Messwert ein zusätzliches Speichern der Playlist berücksichtigt.
- playlistStarts
- Gibt an, wie häufig Zuschauer die Wiedergabe einer Playlist gestartet haben. Dieser Messwert umfasst nur Playlist-Aufrufe, die im Web erfolgt sind.
- playlistViews
- Wie oft Videos in der Playlist im Kontext dieser Playlist angesehen wurden.
Dieser Messwert umfasst Daten zu Playlist-Videos, die anderen Kanälen gehören.
- viewsPerPlaylistStart
- Die durchschnittliche Anzahl der Videoaufrufe, die jedes Mal erzielt wurden, wenn eine Playlist gestartet wurde. Dieser Messwert umfasst nur Playlist-Aufrufe, die im Web erfolgt sind.
Messwerte für Annotationen
Hinweis:In Berichten der YouTube Analytics API werden nur Daten für die Messwerte annotationClickThroughRate
und annotationCloseRate
ab dem 10. Juni 2012 zurückgegeben. Außerdem werden in Berichten der YouTube Analytics API seit dem 16. Juli 2013 nur noch Daten für die verbleibenden Anmerkungs-Messwerte zurückgegeben.
- annotationImpressions
- Die Gesamtzahl der Anmerkungsimpressionen.
- annotationClickableImpressions
- Die Anzahl der Anmerkungen, die angezeigt wurden und angeklickt werden konnten.
- annotationClicks
- Die Anzahl der angeklickten Anmerkungen.
- annotationClickThroughRate (Kernmesswert)
- Das Verhältnis zwischen der Anzahl der Anmerkungen, die Zuschauer angeklickt haben, und der Gesamtzahl der Impressionen anklickbarer Anmerkungen. This is a core metric and is subject to the Deprecation Policy. Weitere Informationen zum Erstellen von Anmerkungen und zur Verwendung von Linkanmerkungen findest du in der YouTube-Hilfe.
- annotationClosableImpressions
- Die Anzahl der Anmerkungen, die angezeigt und geschlossen werden konnten.
- annotationCloses
- Die Anzahl der geschlossenen Anmerkungen.
- annotationCloseRate (Kernmesswert)
- Das Verhältnis zwischen der Anzahl der Anmerkungen, die Zuschauer geschlossen haben, und der Gesamtzahl der Anmerkungsimpressionen. This is a core metric and is subject to the Deprecation Policy.
Kartenmesswerte
In der YouTube-Hilfe findest du eine detailliertere Anleitung zum Hinzufügen von Infokarten zu deinen Videos und zum Infokarten-Bericht in YouTube Analytics.
- cardImpressions
- Gibt an, wie oft Infokarten angezeigt wurden. Wenn das Kartenfeld geöffnet wird, wird für jede Infokarte des Videos eine Infokarten-Impression erfasst.
- cardClicks
- Gibt an, wie oft Infokarten angeklickt wurden.
- cardClickRate
- Die Klickrate für Infokarten, die als Verhältnis von Klicks zu Impressionen berechnet wird.
- Gibt an, wie häufig Infokartenteaser angezeigt wurden. Ein Videoaufruf kann mehrere Teaser-Impressionen generieren.
- Die Anzahl der Klicks auf Infokartenteaser. Klicks auf das Kartensymbol werden dem zuletzt angezeigten Teaser zugeordnet.
- Die Klickrate für Infokartenteaser, die als Verhältnis von Klicks auf Infokartenteaser zur Gesamtzahl der Impressionen von Infokartenteasern berechnet wird.
Livestream-Messwerte (gleichzeitige Zuschauer)
- averageConcurrentViewers
- Die durchschnittliche Anzahl der gleichzeitigen Zuschauer für ein bestimmtes Video. Wenn die Dimension livestreamPosition für den Bericht angegeben ist, gibt der Wert
averageConcurrentViewers
die durchschnittliche Anzahl gleichzeitiger Zuschauer während eines bestimmten Segments an. - peakConcurrentViewers
- Die höchste Anzahl an gleichzeitigen Zuschauern für ein bestimmtes Video. Wenn die Dimension livestreamPosition für den Bericht angegeben ist, gibt der Wert
peakConcurrentViewers
die höchste Anzahl gleichzeitiger Zuschauer während eines bestimmten Videosegments an.
Messwerte zur Zuschauerbindung
- audienceWatchRatio
- Das absolute Verhältnis der Zuschauer, die das Video zu einem bestimmten Zeitpunkt ansehen. Das Verhältnis wird berechnet, indem die Anzahl der Aufrufe eines Videoteils mit der Gesamtzahl der Aufrufe des Videos verglichen wird. Mit der Dimension
elapsedVideoTimeRatio
wird der Teil des Videos angegeben, auf den sich der Messwert bezieht.
Hinweis: Ein Teil eines Videos kann bei einem bestimmten Videoaufruf mehrmals oder gar nicht angesehen werden. Wenn Nutzer beispielsweise ein Video zurückspulen und sich denselben Teil mehrmals ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als1
sein.
Die folgenden Beispiele veranschaulichen, wie der Wert berechnet wird:- Ein einminütiges Video wird 100-mal angesehen. Die Hälfte der Zuschauer hört nach 15 Sekunden auf, sich das Video anzusehen, die andere Hälfte sieht sich das gesamte Video an. Keiner der Zuschauer hat sich Teile des Videos mehr als einmal angesehen. In diesem Fall wäre der Wert dieser Messgröße für Zeiträume im ersten Viertel des Videos
1
und für den Rest des Videos0.50
. - Ein einminütiges Video wird 100-mal angesehen. Alle Zuschauer sehen sich das gesamte Video an. 20 Zuschauer sehen sich das Video bis zur 45-Sekunden-Marke an, springen dann zur 30-Sekunden-Marke zurück und sehen sich den Rest des Videos an. In diesem Fall wäre der Wert des Messwerts für Zeit-Buckets in der ersten Hälfte oder im letzten Viertel des Videos
1
. Der Wert wäre jedoch1.2
für Zeiträume im dritten Viertel des Videos, da sich 100 % der Zuschauer dieses Segment des Videos angesehen haben, 20 % davon jedoch zweimal.
- Ein einminütiges Video wird 100-mal angesehen. Die Hälfte der Zuschauer hört nach 15 Sekunden auf, sich das Video anzusehen, die andere Hälfte sieht sich das gesamte Video an. Keiner der Zuschauer hat sich Teile des Videos mehr als einmal angesehen. In diesem Fall wäre der Wert dieser Messgröße für Zeiträume im ersten Viertel des Videos
- relativeRetentionPerformance
- Ein Messwert, der angibt, wie gut ein Video Zuschauer während der Wiedergabe im Vergleich zu allen YouTube-Videos ähnlicher Länge binden kann. Der Messwert hat einen Wert zwischen
0
und1
, der die relative Leistung der Zuschauerbindung des Videos an einem bestimmten Punkt im Video angibt. Der Punkt im Video wird durch die DimensionelapsedVideoTimeRatio
angegeben.
Ein Wert von0
bedeutet, dass die Zuschauerbindung bei diesem Video schlechter ist als bei allen anderen Videos mit ähnlicher Länge. Ein Wert von1
bedeutet, dass die Zuschauerbindung bei diesem Video besser ist als bei allen anderen Videos mit ähnlicher Länge. Ein Medianwert von0.5
bedeutet, dass bei der Hälfte der Videos mit ähnlicher Länge die Zuschauerbindung besser ist und bei der anderen Hälfte schlechter.
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, das Video auch nach drei Minuten noch an. 70 % sehen sich das Video auch nach acht Minuten noch an. Bei einem bestimmten 10-minütigen Video sehen sich nach drei Minuten nur noch 80 % der Zuschauer das Video an. Nach acht Minuten sind es aber immer noch alle Zuschauer, die sich das Video bis dahin angesehen haben.- Beim
elapsedVideoTimeRatio
-Wert, der dem Punkt drei Minuten nach Beginn des Videos entspricht, hätte der MesswertrelativeRetentionPerformance
einen Wert unter0.5
, da das Video zu diesem Zeitpunkt schlechter abschneidet als das durchschnittliche Video. - Beim
elapsedVideoTimeRatio
-Wert, der dem Punkt acht Minuten nach Beginn des Videos entspricht, hätte der MesswertrelativeRetentionPerformance
einen Wert, der höher als0.5
ist, da das Video zu diesem Zeitpunkt besser abschneidet als andere Videos ähnlicher Länge.
- Beim
- startedWatching
- Die Anzahl der Wiedergaben, bei denen ein bestimmtes Segment des Videos das erste Segment war, das angesehen wurde.
Angenommen, Video X ist 5 Minuten lang. Für diesen Bericht teilt YouTube das Video in 100 3-Sekunden-Segmente auf, die mit der Dimension elapsedVideoTimeRatio identifiziert werden. Ein Nutzer besucht YouTube und sieht sich die ersten 70 Sekunden des Videos an. Das entspricht allen oder einem Teil der ersten 24 Segmente des Videos. Bei einem späteren YouTube-Besuch sieht sich der Nutzer den Rest des Videos an. Die Wiedergabe wird in Segment 24 fortgesetzt und bis Segment 100 abgespielt.
In diesem Beispiel werden die folgenden Werte für den Messwert „Beobachten“ generiert:- Der Wert des Messwerts
startedWatching
wäre für die Segmente 1 und 241
und für alle anderen Segmente0
. - Der Wert des Messwerts
stoppedWatching
wäre für die Segmente 24 und 1001
und für alle anderen Segmente0
. - Der Wert des Messwerts
totalSegmentImpressions
wäre für Segment 242
und für alle anderen Segmente1
.
- Der Wert des Messwerts
- stoppedWatching
- Die Anzahl der Aufrufe, bei denen ein bestimmtes Segment des Videos das zuletzt angesehene Segment war. Ein Beispiel für die Berechnung dieses Messwertes finden Sie in der Definition des Messwerts
startedWatching
. - totalSegmentImpressions
- Gibt an, wie oft ein bestimmtes Segment eines Videos aufgerufen wurde. Ein Beispiel für die Berechnung dieses Messwertes finden Sie in der Definition des Messwerts
startedWatching
. Zuschauer können sich dasselbe Segment eines Videos in derselben Wiedergabe mehrmals ansehen.
Messwerte zur Kündigung von Mitgliedschaften
- membershipsCancellationSurveyResponses
- Die Anzahl der Umfragen, die von YouTube-Nutzern ausgefüllt wurden, die ihre Kanalmitgliedschaft für den angegebenen Kanal im Berichtszeitraum gekündigt haben.
Messwerte für den geschätzten Umsatz
Hinweis:Die Messwerte für geschätzte Einnahmen werden am Monatsende angepasst und enthalten keine Einnahmen aus Anzeigen, die von Partnern verkauft oder ausgeliefert wurden. Weitere Informationen und Hinweise zu geschätzten Umsatzzahlen findest du in der YouTube-Hilfe.
currency
für einige Messwerte für geschätzte Einnahmen und Anzeigenleistung. So können Sie Daten zu geschätzten Einnahmen in anderen Währungen abrufen.- estimatedRevenue (Kernmesswert) (früher
earnings
) - Der geschätzte Nettogesamtumsatz aus allen von Google verkauften Werbequellen sowie aus nicht werbebezogenen Quellen für den ausgewählten Zeitraum und die ausgewählte Region.
This is a core metric and is subject to the Deprecation Policy.
Messwerte zum geschätzten Umsatz werden am Monatsende angepasst und enthalten keine Einnahmen aus Anzeigen, die von Partnern verkauft oder ausgeliefert wurden.
- estimatedAdRevenue (früher
adEarnings
) - Der geschätzte Nettogesamtumsatz aus allen von Google verkauften Werbequellen für den ausgewählten Zeitraum und die ausgewählte Region.
Messwerte für den geschätzten Umsatz werden am Monatsende angepasst und enthalten keine von Partnern verkaufte und ausgelieferte Werbung. - estimatedRedPartnerRevenue (früher
redPartnerRevenue
) - Der geschätzte Gesamtumsatz aus YouTube Premium-Abos (ehemals YouTube Red) für die ausgewählten Berichtsdimensionen. Der Wert des Messwerts spiegelt den Umsatz aus Musikinhalten und Inhalten ohne Musik wider und unterliegt einer Anpassung zum Monatsende.
Messwerte zur Anzeigenleistung
- grossRevenue
- Der geschätzte Bruttoumsatz in US-Dollar aus allen von Google oder DoubleClick-Partnern verkauften Werbeanzeigen für den ausgewählten Zeitraum und die ausgewählte Region. Sie werden am Monatsende korrigiert und umfassen keine von Partnern geschalteten Werbeanzeigen. Bruttoeinnahmen dürfen nicht mit geschätzten Einnahmen oder Nettoumsatz verwechselt werden, bei denen dein Anteil am Eigentum und Vereinbarungen zur Umsatzbeteiligung berücksichtigt werden.
- cpm (früher
impressionBasedCpm
) - Die geschätzten Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.
- adImpressions (früher
impressions
) - Die Anzahl der ausgelieferten Impressionen, die überprüft wurden.
- monetizedPlaybacks
- Die Anzahl der Fälle, in denen ein Zuschauer dein Video abgespielt und mindestens eine Anzeigenimpression gesehen hat. Eine monetarisierte Wiedergabe wird gezählt, wenn einem Zuschauer eine Pre-Roll-Anzeige präsentiert wird, er sich die Anzeige aber nicht bis zum Ende ansieht, bevor dein Video startet. Der erwartete geschätzte Fehler für diese Zahl beträgt ±2,0%.
- playbackBasedCpm
- Der geschätzte Bruttoumsatz pro 1.000 Wiedergaben.