YouTube Analytics API: Content Owner Reports

Hinweis: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

Auf dieser Seite findest du Berichte, die Rechteinhaber über die YouTube Analytics API abrufen können. Berichte zu Rechteinhabern enthalten Messwerte für Kanäle, die mit einem bestimmten YouTube-Rechteinhaber verknüpft sind. Messwerte sind einzelne Messungen der Nutzeraktivität, der Anzeigenleistung oder des geschätzten Umsatzes.

  • Videoberichte enthalten Messwerte zur Nutzeraktivität, zur Anzeigenleistung und zum geschätzten Umsatz für Videos auf den Kanälen eines Rechteinhabers.

  • Playlist-Berichte enthalten Statistiken zu Videoaufrufen, die im Zusammenhang mit einer Playlist erfolgen. Für Playlist-Berichte werden größtenteils dieselben Dimensionen und Filter wie für Videoberichte verwendet.

  • Berichte zur Anzeigenleistung enthalten Messwerte zu Umsatz und Anzeigenleistung. Mit der Dimension adType werden Messwerte nach den Anzeigentypen gruppiert, die während der Videowiedergabe ausgeliefert wurden. Im Abschnitt Berichte zur Anzeigenleistung werden die zwei Arten von Messwerten zur Anzeigenleistung erläutert, die von der API unterstützt werden.

Bericht abrufen

Wenn du einen Rechteinhaberbericht abrufen möchtest, rufe die reports.query-Methode der API auf und setze den Parameterwert ids in der API-Anfrage auf contentOwner==OWNER_NAME, wobei OWNER_NAME die ID des Rechteinhabers angibt. Wenn Sie sich bezüglich des Mehrwerts nicht sicher sind, wenden Sie sich an Ihren Partnermanager.

Autorisierung

Alle Anfragen an die YouTube Analytics API müssen autorisiert werden. Im Autorisierungsleitfaden wird erläutert, wie mithilfe des OAuth 2.0-Protokolls Autorisierungstokens abgerufen werden.

YouTube Analytics API-Anfragen verwenden die folgenden Autorisierungsbereiche:

Ebenen
https://www.googleapis.com/auth/yt-analytics.readonly Sieh dir YouTube Analytics-Berichte für deine YouTube-Inhalte an. Über diesen Bereich erhalten Sie Zugriff auf Messwerte zur Nutzeraktivität, z. B. die Anzahl der Aufrufe und Bewertungen.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube Analytics-Finanzberichte für deine YouTube-Inhalte abrufen. So erhalten Sie Zugriff auf Messwerte zur Nutzeraktivität sowie auf Messwerte zum geschätzten Umsatz und zur Anzeigenleistung.
https://www.googleapis.com/auth/youtube Verwalte dein YouTube-Konto. In der YouTube Analytics API verwenden Kanalinhaber diesen Bereich, um Gruppen und Gruppenelemente in YouTube Analytics zu verwalten.
https://www.googleapis.com/auth/youtubepartner YouTube-Assets und zugehörige Inhalte auf YouTube abrufen und verwalten. In der YouTube Analytics API können Rechteinhaber diesen Bereich nutzen, um Gruppen und Gruppenelemente in YouTube Analytics zu verwalten.

Hinweis:Messwerte, die mit einem Sternchen (*) gekennzeichnet sind, benötigen ein Autorisierungstoken, das Zugriff auf den Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly gewährt.

Filter

In allen API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder nach der Dimension video, channel, isCurated oder einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType gefiltert werden. Unterstützte Kombinationen sind in der Definition der Dimension uploaderType aufgeführt.

In den Tabellen, in denen die unterstützten Berichte erläutert werden, sind die Filter aufgeführt, die für jeden Bericht verwendet werden können. In den Beschreibungen sind Filter in Klammern optional. Wenn in einem Bericht beispielsweise video(,country) als Filteroption aufgeführt wird, kann der Bericht so gefiltert werden, dass nur Daten für ein bestimmtes Video oder nur Daten für ein bestimmtes Video in einem bestimmten Land berücksichtigt werden.

Die API unterstützt auch die Möglichkeit, mehrere Werte für die Filter video, playlist und channel anzugeben. Wenn Sie mehrere Werte für einen dieser Filter angeben, können Sie den Filter auch der Liste der Dimensionen hinzufügen, die Sie für die Anfrage angeben. Das gilt auch dann, wenn der Filter für einen bestimmten Bericht nicht als unterstützte Dimension aufgeführt ist.

In der Parameterdefinition filters finden Sie eine vollständige Erklärung zum Filtern von API-Ergebnissen nach einem bestimmten Wert oder einer Gruppe von Werten.

Informationen zu Berichtstabellen

In diesem Abschnitt werden die Formatierung und die Terminologie erläutert, die in den Tabellen zur Definition von Berichten verwendet werden, die von der API unterstützt werden. In der folgenden Tabelle sind die Dimensionen, Messwerte und Filter aufgeführt, die für den Videobericht zu Wiedergabedetails mithilfe der Zeitdimension und des Messwerts averageViewPercentage unterstützt werden.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
„0“ oder „1“ verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
„0“ oder „1“ verwenden Video, Gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct

Die Tabelle enthält zwei Zeilen für Dimensionen, eine Zeile für Messwerte und drei Zeilen für Filter. Bei Dimensionen und Filtern können Werte aus jeder Zeile in einer API-Anfrage kombiniert werden, sofern die Kombination den Nutzungsregeln in der Tabelle folgt. Gültige dimensions-Parameterwerte für diesen Bericht sind beispielsweise:

  • dimensions=day
  • dimensions=day,liveOrOnDemand
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Der Parameterwert day,month ist jedoch ungültig, da er zwei zeitbasierte Dimensionen verwendet. Für die Anfrage kann jedoch entweder 0 oder 1 verwendet werden. In diesem Fall gibt der Parameterwert subscribedStatus,youtubeProduct zwar einen Bericht zurück, aber die Messwerte werden nicht nach Tag, Woche, Monat usw. zusammengefasst. Dieser Bericht ist in der Dokumentation separat dokumentiert.

Terminologie der Berichtstabelle

In Tabellen wird anhand der folgenden Terminologie angegeben, ob Dimensionen erforderlich oder optional sind:

  • Diese Begriffe bedeuten, dass ein Wert erforderlich ist:
    • Erforderlich:Sie müssen den Wert angeben.
    • Genau 1 verwenden:Es muss ein Wert aus der Gruppe angegeben werden.
    • Einen oder mehrere verwenden:Sie können einen oder alle Werte aus der Gruppe angeben, müssen aber mindestens einen angeben.
  • Diese Begriffe bedeuten, dass ein Wert optional ist:
    • Optional:Sie haben die Möglichkeit, den Wert anzugeben.
    • „0“ oder „1“ verwenden: Sie haben die Möglichkeit, einen Wert aus der Gruppe zu verwenden.
    • 0 oder mehr verwenden:Sie können einen oder alle Werte aus der Gruppe einschließen.
Wichtig:Bei allen API-Anfragen zum Abrufen von Berichten zu Videos von Rechteinhabern müssen die Daten entweder nach der Dimension Video, Kanal, Gruppe oder einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType gefiltert werden. Einige Berichte unterstützen nicht alle diese Optionen. Folgende Kombinationen werden auch in der Definition der Dimension uploaderType aufgeführt:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

Videoberichte

Grundlegende Statistiken

Grundlegende Statistiken (einschließlich Abonnentenzahlen)

Dieser Bericht enthält Statistiken zu Nutzeraktionen auf allen Kanälen eines Rechteinhabers. Du kannst den Bericht so filtern, dass nur Daten für ein bestimmtes Video oder Land angezeigt werden. Außerdem kannst du damit nur Statistiken für Inhalte abrufen, auf die Anspruch erhoben wurde. Dazu gehören Inhalte, auf die Anspruch erhoben wurde, die vom Rechteinhaber, von Dritten oder von beidem hochgeladen wurden.

Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens 1 verwenden view*annotations,redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent

Grundlegende Statistiken für US-Bundesstaaten

Dieser Bericht enthält Statistiken für einen bestimmten US-Bundesstaat oder den District of Columbia. Dieser Bericht unterstützt nur einen Teil der Messwerte, die im oben beschriebenen länderspezifischen Bericht verfügbar sind.

Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressions, annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich bundesland

Zeitbasiert

Aktivität für Zeiträume

Dieser Bericht enthält Statistiken zu Nutzeraktionen auf allen Kanälen eines Rechteinhabers für bestimmte Zeiträume. Du kannst den Bericht so filtern, dass nur Daten für ein bestimmtes Video oder Land angezeigt werden.

Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden videosRemovedFromPlaylists, estimatedMinutesAnnotationsWatched, estimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent

Nutzeraktivitäten in US-Bundesstaaten für bestimmte Zeiträume

Dieser Bericht enthält Statistiken für einen bestimmten US-Bundesstaat oder den District of Columbia. Dieser Bericht unterstützt nur einen Teil der Messwerte, die im oben beschriebenen länderspezifischen Bericht verfügbar sind.

Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressions, annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich bundesland

Standort des Nutzers

Nutzeraktivitäten nach Land

Dieser Bericht enthält Statistiken zu Nutzeraktivitäten in den einzelnen Ländern für alle Kanäle eines Rechteinhabers. Du kannst den Bericht so filtern, dass nur Daten für ein bestimmtes Video oder einen bestimmten Kanal zurückgegeben werden.

Inhalt
Abmessungen:
Erforderlich Land
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden view*annotations,redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Continent (Kontinent), subContinent (Kontinent)

Nutzeraktivität nach Bundesland

Dieser Bericht enthält Statistiken zur Nutzeraktivität für US-Bundesstaaten und den District of Columbia. Für diesen Bericht müssen Sie den Parameterwert filters auf country==US setzen.

Inhalt
Abmessungen:
Erforderlich bundesland
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressions, annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich country==US

Nutzeraktivitäten nach Stadt (<= 250 Ergebnisse)

Hinweis: Für diesen Bericht muss für den Parameter maxResults eine Ganzzahl von maximal 250 festgelegt werden. Anders als bei den meisten anderen Berichten müssen Sie bei diesem Bericht außerdem einen Wert für den Anfrageparameter sort angeben.

Dieser Bericht enthält Statistiken zur Nutzeraktivität nach Stadt.

Inhalt
Abmessungen:
Erforderlich Ort
0 oder mehr verwenden creatorContentType, country, territory, subscribedStatus

Hinweis:Wenn Sie die Dimension Region hinzufügen, müssen Sie auch den Filter country==US verwenden.
„0“ oder „1“ verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched

Wiedergabedetails

Berichte zu Wiedergabedetails enthalten Statistiken zu folgenden Wiedergabeattributen:

  • Gab es den Aufruf eines Live-Videos oder eines On-Demand-Videos?
  • Hat der Zuschauer den Kanal abonniert, dem das Video gehört?
  • Über welches YouTube-Produkt wurde der Aufruf erzielt?

Technisch gesehen sind die Dimensionen für Wiedergabedetails, die in diesen Berichten unterstützt werden, alle optional. Wenn Sie keine Dimensionen zu Wiedergabedetails in Ihre Anfrage aufnehmen, ähnelt der zurückgegebene Bericht einem der grundlegenden Statistiken, einem zeitbasierten oder einem Bericht nach Nutzerregion.

Hinweis:Die Dimension liveOrOnDemand und der Filter können nicht in Verbindung mit dem Messwert averageViewPercentage verwendet werden. Daher sind in den folgenden Unterabschnitten zwei Berichte aufgeführt. Ein Bericht unterstützt die Dimension liveOrOnDemand und den Filter, der andere den Messwert averageViewPercentage.

Nutzeraktivitäten nach Abostatus

Dieser Bericht enthält Messwerte zur Nutzeraktivität von Zuschauern mit und ohne Abo. Die Statistiken können nach Zeitraum (Tag oder Monat) gruppiert und nach Land, Kontinent oder subContinent gefiltert werden.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, subscribedStatus
„0“ oder „1“ verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, redViews, Mag ich,, Mag ich}, Mag ich,Mag ich nicht, videosAddedToPlaylists, videosRemovedFromPlaylists, sharesWatched, estimatedRedMinutesWatched, averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent
Optional subscribedStatus

Nutzeraktivitäten nach Abostatus für Provinzen

Dieser Bericht enthält Messwerte zur Nutzeraktivität von Zuschauern mit und ohne Abo in US-Bundesstaaten und im District of Columbia. Dieser Bericht unterstützt weniger Messwerte als der vorherige Bericht.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, subscribedStatus
„0“ oder „1“ verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich bundesland
Optional subscribedStatus

Wiedergabedetails mit optionaler Zeitdimension

Die Zeitdimension – Tag oder Monat – ist für diese Berichte optional, weil Sie die Anfrageparameter startDate und endDate verwenden müssen, um den Zeitraum anzugeben, den der Bericht abdecken soll. Die Dimension (falls vorhanden) gibt an, dass die Daten im Bericht nach Tag, Monat usw. zusammengefasst werden sollen.

Wiedergabedetails mit optionaler Zeitdimension und liveOrOnDemand-Statistiken

Dieser Bericht enthält Wiedergabe-Detailstatistiken für bestimmte Zeitintervalle. Die Dimension liveOrOnDemand und der Filter werden unterstützt.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
„0“ oder „1“ verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Wiedergabedetails mit optionaler Zeitdimension und averageViewPercentage

Dieser Bericht enthält Wiedergabe-Detailstatistiken für bestimmte Zeitintervalle.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
„0“ oder „1“ verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden subscribedStatus, youtubeProduct

Wiedergabedetails nach Land

Wiedergabedetails nach Land mit liveOrOnDemand-Statistiken

Dieser Bericht enthält Statistiken zur Wiedergabe in den einzelnen Ländern. Die Dimension liveOrOnDemand und der Filter werden unterstützt.

Inhalt
Abmessungen:
Optional Land
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Continent (Kontinent), subContinent (Kontinent)
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Wiedergabedetails nach Land mit dem Messwert averageViewPercentage

Der folgende Bericht ähnelt dem vorherigen. Außerdem wird der Messwert averageViewPercentage unterstützt, liveOrOnDemand wird jedoch nicht als Dimension oder Filter unterstützt.

Inhalt
Abmessungen:
Optional Land
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Continent (Kontinent), subContinent (Kontinent)
0 oder mehr verwenden subscribedStatus, youtubeProduct

Wiedergabedetails nach Provinz

Wiedergabedetails nach Provinz mit liveOrOnDemand-Statistiken

Dieser Bericht enthält Wiedergabe-Detailstatistiken für US-Bundesstaaten und den District of Columbia. Die Dimension liveOrOnDemand und der Filter werden unterstützt.

Inhalt
Abmessungen:
Optional bundesland
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich Land==US
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Wiedergabedetails nach Provinz mit dem Messwert averageViewPercentage

Der folgende Bericht ähnelt dem vorherigen. Außerdem wird der Messwert averageViewPercentage unterstützt, liveOrOnDemand wird jedoch nicht als Dimension oder Filter unterstützt.

Inhalt
Abmessungen:
Optional bundesland
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich Land==US
0 oder mehr verwenden subscribedStatus, youtubeProduct

Wiedergabeorte

Bericht zum Wiedergabeort von Videos

Dieser Bericht enthält Statistiken zur Art der Seite oder Anwendung, auf der die Videowiedergabe erfolgte.

Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationType
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus

Details zum Wiedergabeort (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht muss für den Parameter maxResults eine Ganzzahl von maximal 25 festgelegt werden. Anders als bei den meisten anderen Berichten müssen Sie bei diesem Bericht außerdem einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden die eingebetteten Videoplayer angegeben, die für die Inhalte eines Rechteinhabers die meisten Aufrufe oder die längsten Wiedergabezeit generiert haben. Beim Abrufen dieses Berichts müssen Sie den insightPlaybackLocationType-Filter auf EMBEDDED setzen.

Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationDetail
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich insightPlaybackLocationType==EMBEDDED
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched

Zugriffsquellen

Zugriffsquelle

In diesem Bericht werden Statistiken zu Aufrufen zusammengefasst. Diese basieren darauf, wie Nutzer auf Ihren Videocontent gestoßen sind. Beispielsweise ist die Anzahl der Aufrufe angegeben, die auf eine Google-Suche oder einen Link zu einem ähnlichen Video zurückzuführen sind.

Inhalt
Abmessungen:
Erforderlich insightTrafficSourceType
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus

Details zur Zugriffsquellen (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht muss für den Parameter maxResults eine Ganzzahl von maximal 25 festgelegt werden. Anders als bei den meisten anderen Berichten müssen Sie bei diesem Bericht außerdem einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden Statistiken zu Aufrufen zusammengefasst, die auf den Verweis-URLs basieren, die die meisten Aufrufe für den Content des Rechteinhabers generiert haben. Verweis-URLs werden nach der Art der Besucherquellen kategorisiert. In der Definition der Dimension insightTrafficSourceDetail werden die Besucherquellen angegeben, für die der Bericht verfügbar ist. Wenn du beispielsweise den Filter insightTrafficSourceType auf ADVERTISING setzt, werden im Bericht die Anzeigentypen aufgelistet, die für die Inhalte des Rechteinhabers die meisten Aufrufe oder die meisten Aufrufe generiert haben.

Inhalt
Abmessungen:
Erforderlich insightTrafficSourceDetail
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich insightTrafficSourceType (siehe Hinweis unten)
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched

Hinweis:Dieser Bericht wird nur für bestimmte Besucherquellen unterstützt. Für die Besucherquelle „NO_LINK_EMBEDDED“ gibt es beispielsweise keine zusätzlichen Details und wird daher diesen Bericht nicht unterstützt. Weitere Informationen dazu, von welchen Besucherquellen dieser Bericht unterstützt wird, findest du in der Definition von insightTrafficSourceType.

Gerätetyp und Betriebssystem

Gerätetyp

In diesem Bericht werden Statistiken zu Aufrufen zusammengefasst, die auf dem Gerätetyp basieren, mit dem die Zuschauer deine Inhalte angesehen haben. Beispielsweise wird damit die Anzahl der Aufrufe ermittelt, die auf Tablets oder Spielekonsolen erfolgten.

Inhalt
Abmessungen:
Erforderlich deviceType
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Betriebssystem

In diesem Bericht werden Statistiken zu Aufrufen basierend auf dem Betriebssystem der Betrachter zusammengefasst. Beispielsweise wird die Anzahl der Aufrufe ermittelt, die auf Android-Geräten oder PlayStations erfolgt sind.

Inhalt
Abmessungen:
Erforderlich operatingSystem
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Betriebssystem und Gerätetyp

In diesem Bericht werden Statistiken zu Aufrufen basierend auf dem Betriebssystem und Gerätetyp der Zuschauer zusammengefasst. Beispielsweise wird damit die Anzahl der Aufrufe ermittelt, die auf Android-Tablets oder Windows-Desktop-Geräten erfolgt sind.

Inhalt
Abmessungen:
Erforderlich operatingSystem,deviceType
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct

Demografische Merkmale des Zuschauers

In diesem Bericht werden Statistiken zu Aufrufen basierend auf der Altersgruppe und dem Geschlecht der Zuschauer zusammengefasst.

Inhalt
Abmessungen:
Mindestens 1 verwenden ageGroup, gender
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus
Messwerte:
Mindestens 1 verwenden viewerPercentage
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus
Hinweis:Die Werte für viewerPercentage in diesem Bericht sind nicht für unterschiedliche Werte der Dimension subscribedStatus für die Wiedergabedetails normalisiert.

Wenn in einem Bericht beispielsweise die Dimension subscribedStatus verwendet wird, werden die Daten zu viewerPercentage für abonnierte Aufrufe von 100 % und viewerPercentage für Aufrufe ohne Abo zurückgegeben. (Der Gesamtwert aller viewerPercentage-Felder im Bericht beträgt 200 %.)

Mithilfe von Filtern können Sie dafür sorgen, dass der Bericht nur viewerPercentage-Daten für einen Wert der Dimension subscribedStatus enthält.

Interaktionen und Teilen von Inhalten

Dieser Bericht enthält Statistiken, aus denen hervorgeht, wie oft die Videos des Kanals auf verschiedenen sozialen Plattformen geteilt wurden.

Inhalt
Abmessungen:
Erforderlich sharingService
Optional creatorContentType, subscribedStatus
Messwerte:
Mindestens 1 verwenden geteilt
Filter:
Genau 1 verwenden Video, Kanal, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent
Optional subscribedStatus

Zuschauerbindung

In diesem Bericht wird die Fähigkeit eines Videos bewertet, sein Publikum zu binden. Die Dimension elapsedVideoTimeRatio misst die Zeitspanne des Videos, die für die entsprechenden Messwerte verstrichen ist. Die Messwerte audienceWatchRatio und relativeRetentionPerformance bieten zwei Messwerte, die zeigen, wie gut das Video die Zuschauer fesselt. Der erste Wert ist ein absoluter Wert, während der zweite Wert angibt, wie das Video im Vergleich zu anderen YouTube-Videos ähnlicher Länge abschneidet.

Hinweis: Bei Berichten zur Zuschauerbindung kann für den Filter video keine durch Kommas getrennte Liste von Werten angegeben werden. Im Wert muss eine einzelne Video-ID angegeben werden.

Inhalt
Abmessungen:
Erforderlich elapsedVideoTimeRatio
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden audienceWatchRatio, relativeRetentionPerformance
Filter:
Erforderlich Video
0 oder mehr verwenden audienceType, subscribedStatus, youtubeProduct

Top-Videos

Hinweis: Für diese Berichte muss der Parameter maxResults auf eine Ganzzahl von maximal 200 festgelegt werden. Für den Zeitraum vor dem 1. Januar 2013 sind nur Daten für die 10 erfolgreichsten Videos verfügbar. Anders als bei den meisten anderen Berichten müssen Sie bei diesen Berichten außerdem einen Wert für den Anfrageparameter sort angeben.

Top-Videos insgesamt, nach Land, nach Kontinent oder nach Subkontinent (<= 200 Ergebnisse)

In diesem Bericht werden die Top-Videos des Rechteinhabers basierend auf den festgelegten Filter- und Sortierkriterien aufgelistet.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden view* VideoAnmerkungen,redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filter:
Genau 1 verwenden channel oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent
Sortieroptionen: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

Top-Videos insgesamt nach US-Bundesstaat (<= 200 Ergebnisse)

Dieser Bericht listet die Top-Videos des Rechteinhabers in einem bestimmten US-Bundesstaat oder im District of Columbia auf. Dieser Bericht unterstützt nur einen Teil der Messwerte, die im oben beschriebenen länderspezifischen Bericht verfügbar sind.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationImpressions, annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden channel oder eine unterstützte Kombination aus uploaderType und claimedStatus
Erforderlich bundesland
Sortieroptionen: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Top-Videos für Zuschauer mit oder ohne Abo(<= 200 Ergebnisse)

In diesem Bericht werden die Top-Videos von Zuschauern mit oder ohne Abo aufgeführt. Der Bericht kann so gefiltert werden, dass die Top-Videos nach Land, Kontinent oder subContinent aufgelistet werden. Im vorherigen Bericht kannst du die Top-Videos in einem bestimmten US-Bundesstaat für Abonnenten oder Zuschauer ohne Abo abrufen. Er enthält aber weniger Messwerte als dieser Bericht.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden views, redViews, Mag ich,, Mag ich – Mag ich nicht, Mag ich, Mag ich nicht,, videosAddedToPlaylists, videosRemovedFromPlaylists, sharesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filter:
Genau 1 verwenden channel oder eine unterstützte Kombination aus uploaderType und claimedStatus
Optional subscribedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent
Sortieroptionen: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Top-Videos nach YouTube-Produkt (<= 200 Ergebnisse)

In diesem Bericht sind die Top-Videos aufgeführt. Außerdem werden Wiedergabedetails und geografische Filter unterstützt. Dieser Bericht ähnelt dem vorherigen, unterstützt aber weniger Messwerte und den Filter youtubeProduct.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Genau 1 verwenden channel oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden subscribedStatus, youtubeProduct
Sortieroptionen: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Top-Videos mit Filtern für Wiedergabedetails (<= 200 Ergebnisse)

In diesem Bericht werden die Top-Videos des Rechteinhabers aufgelistet. Dabei wird nach mindestens einer Wiedergabedetaildimension gefiltert: liveOrOnDemand, subscribedStatus und youtubeProduct. Der Bericht unterstützt auch das Filtern nach Region.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Genau 1 verwenden channel oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Sortieroptionen: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Playlist-Berichte

Playlist-Berichte enthalten Messwerte zu Nutzeraktivitäten mit Videos in den Playlists des Kanalinhabers. Es sind zwei Versionen dieser Berichte verfügbar. Für jeden verfügbaren Bericht werden in den folgenden Abschnitten die einzelnen Versionen beschrieben:

  • Auf dem Tab Empfohlen in jedem Abschnitt wird das bevorzugte Format für API-Anfragen zum Abrufen des entsprechenden Berichts beschrieben. Die empfohlenen Berichte unterstützen eine erweiterte Gruppe von Messwerten, die sowohl zusammengefasste Videomesswerte als auch Messwerte in Playlists umfassen. In diesem Anfrageformat wird die Dimension isCurated nicht verwendet.
  • Auf dem Tab isCurated verwenden in jedem Abschnitt wird ein älteres API-Anfrageformat beschrieben, in dem die Dimension isCurated erforderlich ist. Diese Berichte unterstützen nur In-Playlist-Messwerte. Die Dimension isCurated wurde für alle Berichte eingestellt. In der folgenden Warnung wird der Zeitplan für die Einstellung erläutert.

In der folgenden Warnung werden die Änderungen zwischen den beiden Berichtversionen ausführlicher erläutert.

Zusammengefasste Videomesswerte

Diese Messwerte enthalten Messwerte zur Nutzeraktivität und zu Impressionen, die für alle Videos in der Playlist zusammengefasst wurden, die auch zu 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 deshalb 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.

Im Abschnitt Unterstützte Playlist-Messwerte findest du eine Liste zusammengefasster Videomesswerte, die von YouTube unterstützt werden.

Messwerte für Playlists

Diese Messwerte spiegeln die Nutzeraktivität und -interaktionen im Kontext der Playlist-Seite wider. Diese Messwerte umfassen die Aufrufe aller Videos in der Playlist, unabhängig davon, zu welchem Kanal sie gehören. Es werden aber nur Aufrufe gezählt, die im Kontext der Playlist stattgefunden haben.

Unterstützte Playlist-Messwerte

Grundlegende Statistiken

Dieser Bericht enthält Statistiken zu den Interaktionen von Nutzern mit den Videos in den Playlists auf den Kanälen eines Rechteinhabers. Der Bericht enthält keine erforderlichen Dimensionen.

Empfohlen
Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel
isCurated verwenden
Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated = 1
„0“ oder „1“ verwenden Kanal, Playlist, Gruppe
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden subscribedStatus, youtubeProduct

Zeitbasiert

Dieser Bericht enthält Statistiken zu den Interaktionen von Nutzern mit den Videos in Playlists für die Kanäle eines Rechteinhabers über bestimmte Zeiträume. Du kannst den Bericht so filtern, dass nur Daten für eine bestimmte Playlist oder einen bestimmten Kanal zurückgegeben werden.

Empfohlen
Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel
isCurated verwenden
Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
0 oder mehr verwenden subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated = 1
„0“ oder „1“ verwenden Kanal, Playlist, Gruppe
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden subscribedStatus, youtubeProduct

Standort des Nutzers

Dieser Bericht enthält Statistiken zu Interaktionen von Nutzern in einem bestimmten Land mit den Videos in den Playlists des Kanals.

In diesem Bericht findest du Playlist-Statistiken nach Land.

isCurated verwenden
Inhalt
Abmessungen:
Erforderlich Land
0 oder mehr verwenden subscribedStatus, youtubeProduct
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated = 1
„0“ oder „1“ verwenden Continent (Kontinent), subContinent (Kontinent)
„0“ oder „1“ verwenden Playlist, Kanal, Gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct

Playlist-Aktivitäten nach Provinz

Dieser Bericht enthält Playlist-Aktivitätsstatistiken für US-Bundesstaaten und den District of Columbia. Bei diesem Bericht nehmen Sie country==US in den Parameterwert filters auf.

Wiedergabeorte

Dieser Bericht enthält Statistiken zum Seiten- oder Anwendungstyp, auf dem die Playlist-Wiedergaben stattgefunden haben.

Empfohlen
Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationType
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel

Details zum Wiedergabeort (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht muss für den Parameter maxResults eine Ganzzahl von maximal 25 festgelegt werden. Anders als bei den meisten anderen Berichten müssen Sie bei diesem Bericht außerdem einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden die eingebetteten Videoplayer aufgeführt, die die meisten Aufrufe oder die längsten Wiedergabezeiten für die Playlists eines Rechteinhabers generiert haben.

Empfohlen
Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationDetail
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Erforderlich insightPlaybackLocationType==EMBEDDED
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel
Sortieroptionen: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Zugriffsquellen

In diesem Bericht werden Statistiken zu Aufrufen zusammengefasst. Diese basieren darauf, wie Zuschauer auf deine Playlist-Inhalte gestoßen sind. Beispielsweise wird die Anzahl der Aufrufe ermittelt, die auf eine Google-Suche oder eine Kanalseite zurückzuführen sind.

Empfohlen
Inhalt
Abmessungen:
Erforderlich insightTrafficSourceType
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel

Details zur Zugriffsquellen (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht muss für den Parameter maxResults eine Ganzzahl von maximal 25 festgelegt werden. Anders als bei den meisten anderen Berichten müssen Sie bei diesem Bericht außerdem einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden Statistiken zu Aufrufen zusammengefasst, die auf den Verweis-URLs basieren, die die meisten Aufrufe für die Playlists des Rechteinhabers generiert haben. Verweis-URLs werden nach der Art der Besucherquellen kategorisiert. In der Definition der Dimension insightTrafficSourceDetail werden die Besucherquellen angegeben, für die der Bericht verfügbar ist. Wenn du beispielsweise den Filter insightTrafficSourceType auf ADVERTISING setzt, werden im Bericht die Anzeigentypen aufgelistet, die die meisten Aufrufe oder die meisten Aufrufe für die Playlists des Rechteinhabers generiert haben.

Empfohlen
Inhalt
Abmessungen:
Erforderlich insightTrafficSourceDetail
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Erforderlich insightTrafficSourceType
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel
Sortieroptionen: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Hinweis:Dieser Bericht wird nur für bestimmte Besucherquellen unterstützt. Für die Besucherquelle „NO_LINK_EMBEDDED“ gibt es beispielsweise keine zusätzlichen Details und wird daher diesen Bericht nicht unterstützt. Weitere Informationen dazu, von welchen Besucherquellen dieser Bericht unterstützt wird, findest du in der Definition von insightTrafficSourceType.

Gerätetyp und Betriebssystem

Gerätetyp für Playlists

In diesem Bericht werden Statistiken zu Aufrufen basierend auf dem Gerätetyp zusammengefasst, mit dem Zuschauer deine Playlist-Inhalte angesehen haben. Beispielsweise wird die Anzahl der Aufrufe ermittelt, die auf Mobilgeräten oder Spielekonsolen erfolgten.

Empfohlen
Inhalt
Abmessungen:
Erforderlich deviceType
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel

Betriebssystem für Playlists

In diesem Bericht werden Statistiken zu Aufrufen basierend auf dem Betriebssystem der Betrachter zusammengefasst. Er ermittelt beispielsweise die Anzahl der Playlist-Aufrufe, die auf Android-Geräten oder PlayStations stattgefunden haben.

Empfohlen
Inhalt
Abmessungen:
Erforderlich operatingSystem
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel

Betriebssystem und Gerätetyp für Playlists

In diesem Bericht werden Statistiken zu Aufrufen basierend auf dem Betriebssystem und Gerätetyp der Zuschauer zusammengefasst. Beispielsweise wird die Anzahl der Playlist-Aufrufe auf Android-Tablets oder Windows-Desktop-Geräten ermittelt.

Empfohlen
Inhalt
Abmessungen:
Erforderlich deviceType, operatingSystem
Messwerte:
Mindestens 1 verwenden views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Verwenden Sie „0“ oder „1“* playlist, group

Hinweis:Wenn im Bericht einer der Messwerte für Aufrufe, estimatedMinutesWatched oder averageViewDuration angefordert wird, muss genau einer dieser Filter angegeben werden.
Optional channel

Demografische Merkmale des Zuschauers

In diesem Bericht werden Statistiken zu Aufrufen basierend auf der Altersgruppe und dem Geschlecht der Zuschauer zusammengefasst.

Hinweis: Die Werte für viewerPercentage in diesem Bericht werden nicht für unterschiedliche Werte oder Wertekombinationen für Wiedergabedetaildimensionen (subscribedStatus und youtubeProduct) normalisiert.

Beispiel: In einem Bericht mit der Dimension subscribedStatus werden viewerPercentage-Daten zurückgegeben, die zusammen eine Summe von 100 % für Aufrufe mit abonnierten Aufrufen ergeben und für Aufrufe mit abonnierten Aufrufen eine Summe von 100 % ergeben und für Aufrufe mit Aboaufrufen {110%.viewerPercentage (Der Gesamtwert aller viewerPercentage-Felder im Bericht beträgt 200 %.)

Mithilfe von Filtern können Sie dafür sorgen, dass der Bericht nur viewerPercentage-Daten für einen Wert (oder eine Kombination von Werten) für Dimensionen für Wiedergabedetails enthält.

Top-Playlists

Hinweis: Für diese Berichte muss der Parameter maxResults auf eine Ganzzahl von maximal 200 festgelegt werden. Daten für den Zeitraum vor dem 1. Januar 2013 sind nur für die Top-10-Playlists verfügbar. Anders als bei den meisten anderen Berichten müssen Sie bei diesen Berichten außerdem einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden die Top-Playlists des Rechteinhabers basierend auf den angegebenen Filter- und Sortierkriterien aufgeführt.

isCurated verwenden
Inhalt
Abmessungen:
Erforderlich Playlist
Messwerte:
Mindestens 1 verwenden views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated = 1
„0“ oder „1“ verwenden Playlist, Kanal
„0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
0 oder mehr verwenden subscribedStatus, youtubeProduct
Sortieroptionen: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Berichte "Anzeigenleistung"

Hinweis: Für Berichte zur Anzeigenleistung ist ein Autorisierungstoken erforderlich, mit dem Zugriff auf den Gültigkeitsbereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly gewährt wird.

Berichte zur Anzeigenleistung enthalten impressionsbasierte Messwerte für Anzeigen, die während der Videowiedergabe geschaltet wurden. Bei diesen Messwerten wird jede Anzeigenimpression berücksichtigt und jede Videowiedergabe kann zu mehreren Impressionen führen.

Die leistungsbasierten Messwerte für Impressionen sind:

Darüber hinaus werden in einigen Videoberichten die folgenden wiedergabebasierten Messwerte zur Anzeigenleistung unterstützt. Diese Messwerte sind jedoch nicht in Berichten zur Anzeigenleistung enthalten.

Anzeigenleistung nach Anzeigentyp

Inhalt
Abmessungen:
Erforderlich adType
Optional Tag
Messwerte:
Mindestens 1 verwenden grossRevenue, adImpressions, cpm
Filter:
Genau 1 verwenden Video, Gruppe oder eine unterstützte Kombination aus uploaderType und claimedStatus
„0“ oder „1“ verwenden Land, Kontinent, subContinent