In diesem Dokument werden die Messwerte definiert, die von der YouTube Reporting API abgerufen werden. Mit dieser API können Bulk-Datenberichte mit YouTube Analytics-Daten für einen Kanal oder Rechteinhaber abgerufen werden.
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 Reporting API unterliegt der in den Nutzungsbedingungen definierten Richtlinie zur Einstellung von Diensten. Nicht zentrale Messwerte und 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. Alle diese Messwerte, die auch in der YouTube Analytics API verwendet werden, sind auch dort Kernmesswerte.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
Weitere Informationen finden Sie in der Liste der YouTube-APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
Messwerte aufrufen
- engaged_views (Kernmesswert)
- Die Anzahl der Aufrufe von Videos auf dem Kanal, die über die ersten Sekunden hinausgehen.
- Aufrufe (Hauptmesswert)
- Die Häufigkeit, mit der ein Video aufgerufen wurde. In einem Playlist-Bericht gibt der Messwert an, wie oft ein Video im Kontext einer Playlist angesehen wurde. In der YouTube-Hilfe findest du weitere Informationen dazu, wie Aufrufe gemeldet 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 (wichtiger Messwert)
- 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
- watch_time_minutes (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.
- red_watch_time_minutes
- Die Anzahl der Minuten, die YouTube Premium-Mitglieder (ehemals YouTube Red) ein Video angesehen haben.
- average_view_duration_seconds (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.
- average_view_duration_percentage
- 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
Sharegeteilt haben. Weitere Informationen findest du in der YouTube-Hilfe. This is a core metric and is subject to the Deprecation Policy. - subscribers_gained (wichtiger Messwert)
- 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. Um die Anzahl der neuen Kanalabonnenten zu ermitteln, die nicht über die Wiedergabeseite eines Videos abonniert haben, enthält ein einfacher Bericht zur Nutzeraktivität eine Zeile, in der kein Dimensionswert für video_id angegeben ist. In dieser Zeile wird auch ein Wert für den MesswertsubscribersLostangegeben, aber keine Werte für andere Messwerte. - subscribers_lost (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 Messwertsubscribers_gainederfasst. Um die Anzahl der Nutzer zu ermitteln, die sich abgemeldet haben, aber nicht auf einer Videowiedergabeseite, enthält ein einfacher Nutzeraktivitätsbericht eine Zeile, in der kein Dimensionswert für video_id angegeben ist. In dieser Zeile wird auch ein Wert für den Messwertsubscribers_gainedangegeben, aber keine Werte für andere Messwerte. - videos_added_to_playlists
- 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. - videos_removed_from_playlists
- 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.
- playlist_starts
- Gibt an, wie häufig Zuschauer die Wiedergabe einer Playlist gestartet haben. Dieser Messwert umfasst nur Playlist-Aufrufe, die im Web erfolgt sind.
- playlist_saves_added (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 um zwei Playlist-Speicherungen erhöht.
- playlist_saves_removed (wird nur in der YouTube Reporting API unterstützt)
- Gibt an, wie oft Nutzer die Playlist aus ihren Listen gespeicherter 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 wieder speichert und sie wieder entfernt, spiegelt der Messwert zwei entfernte Playlist-Speicherungen wider.
Messwerte für Annotationen
- annotation_impressions
- Die Gesamtzahl der Anmerkungsimpressionen.
- annotation_clickable_impressions
- Die Anzahl der Anmerkungen, die angezeigt wurden und angeklickt werden konnten.
- annotation_clicks
- Die Anzahl der angeklickten Anmerkungen.
- annotation_click_through_rate (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.
- annotation_closable_impressions
- Die Anzahl der Anmerkungen, die angezeigt und geschlossen werden konnten.
- annotation_closes
- Die Anzahl der geschlossenen Anmerkungen.
- annotation_close_rate (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.
- card_impressions
- Gibt an, wie oft Infokarten angezeigt wurden. Wenn das Kartenfeld geöffnet wird, wird für jede Infokarte des Videos eine Infokarten-Impression erfasst.
- card_clicks
- Gibt an, wie oft Infokarten angeklickt wurden.
- card_click_rate
- 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.
Abspannmesswerte
Abspanne sind Elemente, die in den letzten 5 bis 20 Sekunden eines Videos angezeigt werden, um deine Inhalte, deinen Kanal und deine Websites zu bewerben. In der YouTube-Hilfe findest du eine detailliertere Anleitung zum Hinzufügen von Abspannen zu deinen Videos und zum YouTube Analytics-Bericht zu Abspannen.
- end_screen_element_impressions
- Die Anzahl der eingeblendeten Abspannelemente. 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
- Die Klickrate für Abspannelemente, die als Verhältnis von Klicks auf Abspannelemente zu Impressionen von Abspannelementen berechnet wird.
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.
- estimated_partner_revenue (Kernmesswert)
- 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.
- estimated_partner_ad_revenue
- 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. - estimated_partner_ad_auction_revenue (wird nur in der YouTube Reporting API unterstützt)
- Der geschätzte Gesamterlös (Nettoumsatz) aus Anzeigen, die über AdSense im Rahmen von Auktionen 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)
- Die geschätzten Gesamteinnahmen (Nettoumsatz) aus reservierungsbasierten Anzeigenverkäufen über DoubleClick (DCLK) und andere YouTube-Werbequellen. Dieser Messwert hieß zuvor
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (wird nur in der YouTube Reporting API unterstützt)
- Die geschätzten Gesamteinnahmen (Nettoumsatz) aus YouTube Premium-Mitgliedschaften (vormals YouTube Red).
- estimated_partner_transaction_revenue (wird nur in der YouTube Reporting API unterstützt)
- Der geschätzte Gesamtumsatz aus Transaktionen, z. B. Zahlungen für kostenpflichtige Inhalte und Zahlungen im Rahmen der Finanzierung durch Fans, wobei alle dem Partner in Rechnung gestellten Erstattungen abgezogen werden.
Messwerte zur Anzeigenleistung
- estimated_youtube_ad_revenue
- 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.
- estimated_cpm
- Die geschätzten Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.
- ad_impressions
- Die Anzahl der ausgelieferten Impressionen, die überprüft wurden.
- estimated_monetized_playbacks
- 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%.
- estimated_playback_based_cpm
- Der geschätzte Bruttoumsatz pro 1.000 Wiedergaben.