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 (Likes und Dislikes).
Wichtigste Messwerte
Die YouTube Analytics API unterliegt der in den Nutzungsbedingungen definierten Richtlinie zur Einstellung von Funktionen. 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.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
Weitere Informationen finden Sie in der Liste der YouTube-APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
Messwerte aufrufen
- engagedViews (Kernmesswert)
- Gibt an, wie oft die Videos des Kanals nach dem ersten Frame angesehen wurden oder wie oft Nutzer auf „Wiedergabe“ geklickt oder getippt haben.
- Aufrufe (wichtiger Messwert)
- Dieser Messwert stellt in verschiedenen Berichtstypen unterschiedliche Zahlen dar.
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 in Dauerschleife in diesem Messwert nicht mehr berücksichtigt. In einem Playlist-Bericht gibt der Messwert die durchschnittliche Länge in Sekunden von 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 in Dauerschleife 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 den Button
Sharegeteilt haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy. - subscribersGained (wichtiger Messwert)
- Die Anzahl der Nutzer, die einen Kanal abonniert haben. This is a core metric and is subject to the Deprecation Policy.
Abonnenten können auf verschiedenen Seiten hinzukommen oder verloren gehen, z. B. auf der Videowiedergabeseite, der Kanalseite und im Guide auf der YouTube-Startseite. In Kanalberichten umfasst dieser Messwert Abonnenten, die du über diese Orte hinzugewonnen hast. In Berichten, in denen die Antwort mithilfe der Dimensionvideooder des Parametersfilterauf Daten für ein bestimmtes Video beschränkt wird, enthält der MesswertsubscribersGainedjedoch nur Statistiken von der Wiedergabeseite des angegebenen Videos. - subscribersLost (wichtiger Messwert)
- 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 MesswertsubscribersGainederfasst. In Kanalberichten umfasst dieser Messwert Abonnenten, die auf irgendeine Weise von einem Kanal abgemeldet wurden. In Berichten, in denen entweder die Dimensionvideooder der Parameterfilterverwendet wird, um die Antwort auf Daten für ein bestimmtes Video zu beschränken, enthält dieser Messwert jedoch nur Nutzer, 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önnen 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 wieder entfernt und dann noch einmal hinzufügt, wird das Video zweimal gezählt. Daten für diesen Messwert sind für Datumsangaben 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 Video zweimal als aus einer Playlist entfernt gezählt. Daten für diesen Messwert sind für Datumsangaben 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äten 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 für 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 sind Messwerte für Playlists. Die verbleibenden 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 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
averageTimeInPlaylistgibt 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. Wiedergabezeit, die in anderen Kontexten angefallen ist, z. B. Wiedergabezeit aus 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 enthält 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 Anmerkungen
Hinweis:In YouTube Analytics API-Berichten werden nur Daten für die Messwerte annotationClickThroughRate und annotationCloseRate ab dem 10. Juni 2012 zurückgegeben. Außerdem werden in YouTube Analytics API-Berichten nur noch Daten für die verbleibenden Anmerkungs-Messwerte ab dem 16. Juli 2013 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 Infokartenfeld geöffnet wird, wird für jede Infokarte des Videos eine Infokartenimpression erfasst.
- cardClicks
- Gibt an, wie häufig 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. Bei einem Videoaufruf können mehrere Teaser-Impressionen erzielt werden.
- 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 für Infokartenteaser berechnet wird.
Messwerte für Livestreams (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
averageConcurrentViewersdie durchschnittliche Anzahl der gleichzeitigen 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
peakConcurrentViewersdie höchste Anzahl gleichzeitiger Zuschauer während eines bestimmten Videosegments an.
Messwerte zur Zuschauerbindung
- audienceWatchRatio
- Das absolute Verhältnis der Zuschauer, die das Video an der jeweiligen Stelle 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
elapsedVideoTimeRatiowird der Teil des Videos angegeben, auf den sich der Messwert bezieht.
Ein Teil eines Videos kann bei einem Aufruf 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 als1sein.
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 sieht sich Teile des Videos mehr als einmal an. In diesem Fall wäre der Wert dieser Messgröße für Zeiträume im ersten Viertel des Videos
1und 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 der Messwert für Zeit-Buckets in der ersten Hälfte oder im letzten Viertel des Videos
1. Der Wert wäre jedoch1.2für Zeitabschnitte im dritten Viertel des Videos, da 100 % der Zuschauer dieses Segment des Videos angesehen haben, aber 20 % dieser Zuschauer das Segment zweimal angesehen haben.
- 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 sieht sich Teile des Videos mehr als einmal an. 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 im Vergleich zu allen YouTube-Videos ähnlicher Länge binden kann. Der Messwert hat einen Wert zwischen
0und1, der die relative Leistung der Zuschauerbindung des Videos an einem bestimmten Punkt im Video angibt. Der Punkt im Video wird durch die DimensionelapsedVideoTimeRatioangegeben.
Ein Wert von0bedeutet, dass die Zuschauerbindung bei diesem Video schlechter ist als bei allen anderen Videos mit ähnlicher Länge. Ein Wert von1bedeutet, dass die Zuschauerbindung bei diesem Video besser ist als bei allen anderen Videos mit ähnlicher Länge. Ein Medianwert von0.5bedeutet, dass bei der Hälfte der Videos mit ähnlicher Länge die Zuschauerbindung höher ist und bei der anderen Hälfte niedriger.
Das folgende hypothetische Beispiel zeigt, wie die Werte in einem Bericht aussehen könnten. Durchschnittlich 90 % der Zuschauer, die sich Videos mit einer Länge von 10 Minuten ansehen, sind nach 3 Minuten noch dabei. Nach 8 Minuten sind es noch 70 %. Bei einem bestimmten 10‑minütigen Video sehen sich nach drei Minuten jedoch nur noch 80 % der Zuschauer das Video an. Nach acht Minuten sind es aber immer noch alle Zuschauer, die nach drei Minuten noch dabei waren.- Beim
elapsedVideoTimeRatio-Wert, der dem Punkt entspricht, der drei Minuten nach Beginn des Videos liegt, hätte der MesswertrelativeRetentionPerformanceeinen Wert unter0.5, da das Video zu diesem Zeitpunkt schlechter als das durchschnittliche Video abschneidet. - Beim
elapsedVideoTimeRatio-Wert, der dem Punkt acht Minuten nach Beginn des Videos entspricht, hätte der MesswertrelativeRetentionPerformanceeinen Wert, der höher als0.5ist, 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 umfasst alle oder einen Teil der ersten 24 Segmente des Videos. Bei einem späteren YouTube-Besuch sieht sich der Zuschauer den Rest des Videos an. Die Wiedergabe wird in Segment 24 fortgesetzt und läuft bis Segment 100.
In diesem Beispiel werden die folgenden Werte für die Uhrenmesswerte generiert:- Der Wert des Messwerts
startedWatchingwäre für die Segmente 1 und 241und für alle anderen Segmente0. - Der Wert des Messwerts
stoppedWatchingwäre für die Segmente 24 und 1001und für alle anderen Segmente0. - Der Wert des Messwerts
totalSegmentImpressionswäre für Segment 242und für alle anderen Segmente1.
- Der Wert des Messwerts
- stoppedWatching
- Die Anzahl der Wiedergaben, 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 während 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 den 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 geschätzten Umsatzdaten findest du in der YouTube-Hilfe.
currency für einige Messwerte für geschätzte Einnahmen und Anzeigenleistung. So können Sie geschätzte Einnahmedaten 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 (vorher
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 zum Monatsende angepasst und enthalten keine von Partnern verkaufte und ausgelieferte Werbung. - estimatedRedPartnerRevenue (früher
redPartnerRevenue) - Der geschätzte Gesamtumsatz aus YouTube Premium-Mitgliedschaften (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. Der Bruttoumsatz wird am Monatsende angepasst und umfasst keine Einnahmen aus Anzeigen, die von Partnern ausgeliefert wurden. Bruttoeinnahmen dürfen nicht mit geschätzten Einnahmen oder Nettoumsatz verwechselt werden. Bei diesen werden dein Anteil am Eigentum und Vereinbarungen zur Umsatzbeteiligung berücksichtigt.
- 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
- Die geschätzten Bruttoeinnahmen pro 1.000 Wiedergaben.