YouTube Analytics API: Channel Reports

Die Dimensionen 7DayTotals und 30DayTotals werden eingestellt. Weitere Informationen finden Sie im Überarbeitungsverlauf.

Auf dieser Seite sind Berichte aufgeführt, die Kanalinhaber mit der YouTube Analytics API abrufen können. Kanalberichte bieten Messwerte zur Nutzeraktivität für einen bestimmten Kanal und können Dinge wie Videoaufrufe, Bewertungen und Abozahlen messen.

  • Videoberichte enthalten Statistiken zu allen Nutzeraktivitäten in Verbindung mit den Videos eines Kanals.
  • Playlist-Berichte enthalten Statistiken, die sich speziell auf die Aufrufe einer Playlist beziehen.
  • Berichte zur Anzeigenleistung enthalten Messwerte, die sich auf den Umsatz und die Anzeigenleistung beziehen. Mit der Dimension adType werden Messwerte basierend auf den Anzeigentypen gruppiert, die während der Videowiedergabe ausgeliefert wurden. Im Abschnitt Berichte zur Anzeigenleistung werden die beiden Arten von Messwerten zur Anzeigenleistung erläutert, die von der API unterstützt werden.

Bericht abrufen

Zum Abrufen eines Channel-Berichts müssen Sie für den Parameter ids in Ihrer API-Anfrage einen der folgenden Werte festlegen:

  • channel==MINE: Die API gibt Daten für den YouTube-Kanal des authentifizierten Nutzers zurück.

  • channel==CHANNEL_ID: Setze CHANNEL_ID auf die eindeutige Kanal-ID des Kanals, für den du Daten abrufen möchtest. Der Nutzer, der die Anfrage autorisiert, muss der Inhaber des Kanals sein.

    Die Kanal-ID ist derzeit ein String, der mit den Buchstaben UC beginnt. Das Format kann sich jedoch ändern. Die Kanal-ID finden Sie auf der Seite Erweiterte Kontoeinstellungen für Ihren YouTube-Kanal. Sie können die ID auch programmatisch über die Methode YouTube Data API's channels.list abrufen.

Autorisierung

Alle Anfragen an die YouTube Analytics API müssen autorisiert werden. Im Autorisierungsleitfaden wird erläutert, wie Sie Autorisierungstokens mit dem OAuth 2.0-Protokoll abrufen.

YouTube Analytics API-Anfragen verwenden die folgenden Autorisierungsbereiche:

Sucher
https://www.googleapis.com/auth/yt-analytics.readonly Sieh dir YouTube Analytics-Berichte für deine YouTube-Inhalte an. Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität, wie Anzahl der Aufrufe und Anzahl der Bewertungen.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Sieh dir die YouTube Analytics-Finanzberichte für deine YouTube-Inhalte an. Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität sowie auf geschätzte Umsatz- und Anzeigenleistungsmesswerte.
https://www.googleapis.com/auth/youtube YouTube-Konto verwalten In der YouTube Analytics API können Kanalinhaber mit diesem Bereich YouTube-Gruppen und ‐Gruppen verwalten.
https://www.googleapis.com/auth/youtubepartner YouTube-Assets und zugehörige Inhalte auf YouTube ansehen und verwalten In der YouTube Analytics API können Rechteinhaber diesen Bereich verwenden, um YouTube Analytics-Gruppen und -Gruppenelemente zu verwalten.

Hinweis: Messwerte zu geschätzten Umsätzen und zur Anzeigenleistung werden für Channelberichte derzeit nicht unterstützt. Daher wird im Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly derzeit kein Zugriff auf monetäre Daten in diesen Berichten gewährt.

Filter

In den Tabellen mit den unterstützten Berichten sind die Filter aufgeführt, die für jeden Bericht verwendet werden können. In den Tabellen sind in Klammern angezeigte Filter optional. Für die Filteroption video(,country) ist beispielsweise der Filter Video erforderlich und der Filter Land optional.

Die API unterstützt auch die Angabe mehrerer Werte für die Filter video und playlist. Wenn Sie für einen dieser Filter mehrere Werte angeben, können Sie diesen 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.

Eine ausführliche Erläuterung, wie API-Ergebnisse nach einem bestimmten Wert oder einer Gruppe von Werten gefiltert werden, finden Sie in der Parameterdefinition filters.

Informationen zu Berichtstabellen

In diesem Abschnitt werden die Formatierung und Terminologie der Tabellen erläutert, die von der API unterstützte Berichte definieren. In der folgenden Tabelle sind die Dimensionen, Messwerte und Filter aufgeführt, die für zeitbasierte Berichte zu Kanalplaylists unterstützt werden:

Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
0 oder mehr verwenden subscribedStatus, youtubeProduct.
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

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

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

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

Terminologie für Berichttabellen

In Tabellen wird die folgende Terminologie verwendet, um anzugeben, ob Dimensionen erforderlich oder optional sind:

  • Diese Begriffe bedeuten, dass ein Wert erforderlich ist:
    • Erforderlich:Sie müssen den Wert angeben.
    • Genau 1 verwenden:Sie müssen einen Wert aus der Gruppe angeben.
    • Mindestens einen verwenden:Sie können einen oder alle Werte aus der Gruppe verwenden, aber mindestens einen.
  • Diese Begriffe bedeuten, dass ein Wert optional ist:
    • Optional: Sie können den Wert angeben.
    • 0 oder 1 verwenden:Sie können einen Wert aus der Gruppe einschließen.
    • 0 oder mehr verwenden: Sie können einen oder alle Werte aus der Gruppe einschließen.

Videoberichte

Grundlegende Statistiken

Grundlegende Statistiken zur Nutzeraktivität

Dieser Bericht enthält Statistiken zu den Aktionen von Nutzern auf einem Kanal. Du kannst den Bericht so filtern, dass nur Daten für ein bestimmtes Video oder Land angezeigt werden.

Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens eine verwenden Die Anzeige wird auf
Filter:
0 oder 1 verwenden country, continent, subContinent
0 oder 1 verwenden Video, Gruppe

Grundlegende Nutzeraktivitätsstatistiken 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 im oben beschriebenen länderspezifischen Bericht.

Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions
Filter:
Erforderlich bundesland
0 oder 1 verwenden Video, Gruppe

Zeitbasiert

Nutzeraktivität nach Land für bestimmte Zeiträume

Dieser Bericht enthält Statistiken zu Nutzeraktionen auf einem Kanal für bestimmte Zeitintervalle. 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 eine verwenden Die Anzeige wurde im
Filter:
0 oder 1 verwenden country, continent, subContinent
0 oder 1 verwenden Video, Gruppe

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

Dieser Bericht stellt Statistiken zur Nutzeraktivität für einen bestimmten US-Bundesstaat oder den District of Columbia bereit. Dieser Bericht unterstützt nur einen Teil der Messwerte im oben beschriebenen länderspezifischen Bericht.

Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions
Filter:
Erforderlich bundesland
0 oder 1 verwenden Video, Gruppe

Region des Nutzers

Nutzeraktivität nach Land

Dieser Bericht bietet Statistiken zu Nutzeraktivitäten für die einzelnen Länder. Du kannst den Bericht so filtern, dass nur Daten für ein bestimmtes Video zurückgegeben werden.

Inhalt
Abmessungen:
Erforderlich Land
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Die Anzeige wird auf
Filter:
0 oder 1 verwenden continent, subContinent
0 oder 1 verwenden Video, Gruppe

Nutzeraktivität nach Bundesland

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

Inhalt
Abmessungen:
Erforderlich bundesland
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions
Filter:
Erforderlich country==USA
0 oder 1 verwenden Video, Gruppe

Nutzeraktivität nach Stadt (<= 250 Ergebnisse)

Hinweis: Für diesen Bericht musst du den Parameter maxResults auf eine Ganzzahl von maximal 250 festlegen. Anders als bei den meisten anderen Berichten müssen Sie für diesen Bericht auch einen Wert für den Anfrageparameter sort angeben.

Dieser Bericht bietet Statistiken zu Nutzeraktivitäten nach Stadt.

Inhalt
Abmessungen:
Erforderlich ort
0 oder mehr verwenden creatorContentType, country, province, subscribedStatus

Hinweis: Wenn Sie die Dimension province verwenden, müssen Sie auch den Filter country==US verwenden.
0 oder 1 verwenden Tag, Monat
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched

Wiedergabedetails

Berichte zu Wiedergabedetails enthalten Statistiken zu folgenden Wiedergabeattributen:

  • Wurden dir Livevideos oder On-Demand-Videos angesehen?
  • Hat der Zuschauer den Kanal abonniert, zu dem das Video gehört?
  • Bei welchem YouTube-Produkt wurde der Aufruf durchgeführt?

Hinweis: Die Dimension und der Filter liveOrOnDemand können nicht in Verbindung mit dem Messwert averageViewPercentage verwendet werden. Somit umfasst jeder der folgenden Unterabschnitte zwei Berichte. In einem Bericht werden die Dimension und der Filter liveOrOnDemand und im anderen Messwert averageViewPercentage unterstützt.

Nutzeraktivität nach Status „Abonniert“

Dieser Bericht enthält Messwerte zur Nutzeraktivität für Zuschauer mit und ohne Abo. Statistiken lassen sich nach Zeitraum (Tag oder Monat) gruppieren und der Bericht kann auch nach Land, Kontinent oder Subkontinent gefiltert werden.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, subscribedStatus.
0 oder 1 verwenden Tag, Monat
Messwerte:
Mindestens eine verwenden
Filter:
0 oder 1 verwenden country, continent, subContinent
0 oder 1 verwenden Video, Gruppe
Optional Abostatus

Nutzeraktivität nach Status „Abonniert“ für Provinzen

Dieser Bericht enthält Messwerte zur Nutzeraktivität für Zuschauer in den USA und im District of Columbia in den USA. 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 eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions
Filter:
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden province (Provinz), subscribedStatus

Wiedergabedetails mit optionaler Zeitdimension

Die Zeitdimension day oder month ist für diese Berichte optional, da Sie unabhängig davon die Anfrageparameter startDate und endDate verwenden müssen, um den Zeitraum für den Bericht anzugeben. 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 Statistiken zu Wiedergabedetails für bestimmte Zeitintervalle. Die Dimension und der Filter liveOrOnDemand werden unterstützt.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
0 oder 1 verwenden Tag, Monat
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Wiedergabedetails mit optionaler Zeitdimension und dem Messwert averageViewPercentage

Dieser Bericht enthält Statistiken zu Wiedergabedetails für bestimmte Zeitintervalle. Der Messwert averageViewPercentage wird unterstützt.

Inhalt
Abmessungen:
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
0 oder 1 verwenden Tag, Monat
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Wiedergabedetails nach Land

Wiedergabedetails nach Land mit liveOrOnDemand-Statistiken

Dieser Bericht bietet Statistiken zu Wiedergabedetails nach Land. Die Dimension und der Filter liveOrOnDemand werden unterstützt.

Inhalt
Abmessungen:
Erforderlich Land
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
0 oder 1 verwenden continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Wiedergabedetails nach Land mit averageViewPercentage-Messwert

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

Inhalt
Abmessungen:
Erforderlich Land
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
0 oder 1 verwenden continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Wiedergabedetails nach Bundesland

Wiedergabedetails nach Region mit liveOrOnDemand-Statistiken

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

Inhalt
Abmessungen:
Erforderlich bundesland
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Erforderlich Land==US
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Wiedergabedetails nach Bundesland mit dem Messwert averageViewPercentage

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

Inhalt
Abmessungen:
Erforderlich bundesland
0 oder mehr verwenden creatorContentType, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Erforderlich Land==US
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Wiedergabeorte

Bericht zum Standort der Videowiedergabe

Dieser Bericht enthält Statistiken zum Typ der Seite oder Anwendung, auf der Videowiedergaben erfolgt sind.

Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationType
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus

Details zum Wiedergabeort (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht musst du den Parameter maxResults auf eine Ganzzahl von maximal 25 festlegen. Anders als bei den meisten anderen Berichten müssen Sie für diesen Bericht auch einen Wert für den Anfrageparameter sort angeben.

Dieser Bericht ermittelt die eingebetteten Videoplayer, die die meisten Aufrufe oder die höchste Wiedergabezeit für die Videos eines Kanals generiert haben.

Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationDetails
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
Erforderlich insightPlaybackLocationType==EMBEDDED
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched

Zugriffsquellen

Zugriffsquelle

In diesem Bericht werden Aufrufstatistiken basierend auf der Art und Weise zusammengefasst, wie Zuschauer deine Videoinhalte erreicht haben. Beispielsweise gibt es die Anzahl der Aufrufe an, die auf eine Google Suche oder einen Link zu einem ähnlichen Video zurückzuführen sind.

Inhalt
Abmessungen:
Erforderlich inightTrafficSourceType
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus

Zugriffsquellendetails (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht musst du den Parameter maxResults auf eine Ganzzahl von maximal 25 festlegen. Anders als bei den meisten anderen Berichten müssen Sie für diesen Bericht auch einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden Aufrufstatistiken basierend auf den Verweis-URLs zusammengefasst, die die meisten Aufrufe für den Kanalcontent generiert haben. Verweis-URLs werden nach Zugriffsquellentyp kategorisiert und die Definition der Dimension insightTrafficSourceDetail gibt die Besucherquellen an, für die der Bericht verfügbar ist. Wenn du beispielsweise den Filter insightTrafficSourceType auf ADVERTISING setzt, werden im Bericht die Arten von Anzeigen aufgeführt, die die meisten Aufrufe oder die höchste Wiedergabezeit für die Inhalte des Kanals generiert haben.

Inhalt
Abmessungen:
Erforderlich insightTrafficSourceDetail
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
Erforderlich insightTrafficSourceType (siehe Hinweis unten)
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched

Hinweis: Dieser Bericht wird nur für bestimmte Besucherquellen unterstützt. Beispielsweise gibt es für die Zugriffsquelle NO_LINK_EMBEDDED keine zusätzlichen Details und der Bericht wird daher nicht unterstützt. Weitere Informationen dazu, welche Besucherquellen diesen Bericht unterstützen, findest du in der Definition von insightTrafficSourceType.

Gerätetyp und Betriebssystem

Gerätetyp

In diesem Bericht werden Aufrufstatistiken basierend auf der Art und Weise zusammengefasst, wie Zuschauer deine Videoinhalte erreicht haben. Beispielsweise wird damit die Anzahl der Aufrufe auf Mobilgeräten oder Spielekonsolen erfasst.

Inhalt
Abmessungen:
Erforderlich Gerätetyp
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Betriebssystem

In diesem Bericht werden Aufrufstatistiken nach Betriebssystem des Nutzers zusammengefasst. Beispielsweise wird damit die Anzahl der Aufrufe von Android-Geräten oder PlayStations angegeben.

Inhalt
Abmessungen:
Erforderlich Betriebssystem
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Betriebssystem und Gerätetyp

In diesem Bericht werden Aufrufstatistiken basierend auf dem Betriebssystem und dem Gerätetyp der Zuschauer zusammengefasst. Beispielsweise wird damit die Anzahl der Aufrufe auf Android-Tablets oder Windows-Desktopgeräten erfasst.

Inhalt
Abmessungen:
Erforderlich Gerätetyp, operatingSystem
0 oder mehr verwenden creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct

Demografische Merkmale des Zuschauers

In diesem Bericht werden Aufrufstatistiken basierend auf der Altersgruppe und dem Geschlecht der Zuschauer zusammengefasst.

Inhalt
Abmessungen:
Mindestens eine verwenden ageGroup, gender
0 oder mehr verwenden creatorContentType, liveOrOnDemand, subscribedStatus
Messwerte:
Mindestens eine verwenden viewerPercentage
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden Video, Gruppe
0 oder mehr verwenden liveOrOnDemand, subscribedStatus
Hinweis: Die viewerPercentage-Werte in diesem Bericht werden für verschiedene Werte oder Kombinationen von Werten für Wiedergabedetaildimensionen (subscribedStatus, liveOrOnDemand oder youtubeProduct) nicht normalisiert.

Beispiel: Ein Bericht mit der Dimension subscribedStatus gibt viewerPercentage-Daten von bis zu 160 % und 160 % für 100 % Aufrufe. Der Gesamtwert aller viewerPercentage-Felder im Bericht beträgt 200 %.

Sie können Filter verwenden, damit der Bericht nur viewerPercentage-Daten für einen Wert (oder eine Kombination von Werten) für Wiedergabedetaildimensionen enthält.

Interaktionen und Teilen von Inhalten

Dieser Bericht enthält Statistiken zur Häufigkeit, mit der die Videos des Kanals auf verschiedenen sozialen Plattformen geteilt wurden.

Inhalt
Abmessungen:
Erforderlich sharingService
0 oder mehr verwenden creatorContentType, subscribedStatus.
Messwerte:
Mindestens eine verwenden Geteilt
Filter:
0 oder 1 verwenden country, continent, subContinent
0 oder 1 verwenden Video, Gruppe
Optional Abostatus

Zuschauerbindung

In diesem Bericht wird die Fähigkeit eines Videos gemessen, seine Zielgruppe zu halten. Mit der Dimension elapsedVideoTimeRatio wird der Anteil des Videos gemessen, der für die entsprechenden Messwerte verstrichen ist. Die Messwerte audienceWatchRatio und relativeRetentionPerformance bieten zwei Messwerte, die Aufschluss darüber geben, wie gut das Video die Zielgruppe hält. Die erste Spalte ist ein absoluter Wert, die zweite gibt die Leistung des Videos im Vergleich zu anderen YouTube-Videos ähnlicher Länge an.

Hinweis: In Berichten zur Zuschauerbindung ist keine durch Kommas getrennte Liste von Werten für den Filter video möglich. Der Wert muss eine einzelne Video-ID enthalten.

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

Top-Videos

Hinweis: Bei diesen Berichten müssen Sie den Parameter maxResults auf eine Ganzzahl von maximal 200 festlegen. Vor dem 1. Januar 2013 sind nur die 10 Videos mit den meisten Daten verfügbar. Anders als in den meisten anderen Berichten muss bei diesen Berichten ein Wert für den Anfrageparameter sort angegeben werden.

Top-Videos mit optionalen regionalen Filtern (<= 200 Ergebnisse)

In diesem Bericht werden die Top-Videos des Kanals aufgeführt. Im Bericht lassen sich die besten Videos nach Land, Kontinent oder Subkontinent auflisten.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Die Anzeige wird auf
Filter:
0 oder 1 verwenden country, continent, subContinent
Sortieroptionen: -Aufrufe
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribeGainGained
-subscriberLost

Top-Videos nach Bundesstaat (<= 200 Ergebnisse)

In diesem Bericht werden die Top-Videos des Kanals in einem bestimmten US-Bundesstaat oder dem District of Columbia aufgeführt. Dieser Bericht unterstützt nur einen Teil der Messwerte im oben beschriebenen länderspezifischen Bericht.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions
Filter:
Erforderlich bundesland
Optional Abostatus
Sortieroptionen: -Aufrufe
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

In diesem Bericht werden die besten Videos des Kanals für Zuschauer ohne Abo aufgeführt. Im Bericht lassen sich die besten Videos nach Land, Kontinent oder Subkontinent auflisten. Im vorherigen Bericht kannst du die Top-Videos in einem bestimmten US-Bundesstaat für Zuschauer mit und ohne Abo abrufen. Es werden jedoch weniger Messwerte unterstützt als in diesem Bericht.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens eine verwenden
Filter:
Optional Abostatus
0 oder 1 verwenden country, continent, subContinent
Sortieroptionen: -Aufrufe
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

Dieser Bericht listet die Top-Videos des Kanals auf und unterstützt Wiedergabedetails sowie geografische Filter. Dieser Bericht ähnelt dem vorherigen Bericht, allerdings enthält er weniger Messwerte und unterstützt den Filter youtubeProduct.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder mehr verwenden subscribedStatus, youtubeProduct.
Sortieroptionen: -Aufrufe
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

In diesem Bericht werden die Top-Videos des Kanals aufgeführt und nach einer oder allen Dimensionen der Wiedergabedetails gefiltert: liveOrOnDemand, subscribedStatus und youtubeProduct. Im Gegensatz zum vorherigen Bericht unterstützt dieser Filter den Filter liveOrOnDemand und nicht den Messwert averageViewPercentage.

Inhalt
Abmessungen:
Erforderlich Video
Optional creatorContentType
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
0 oder 1 verwenden country, province, continent, subContinent
0 oder mehr verwenden liveOrOnDemand, subscribedStatus, youtubeProduct
Sortieroptionen: -Aufrufe
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Playlist-Berichte

Grundlegende Statistiken

Dieser Bericht enthält Statistiken zu den Interaktionen der Nutzer mit den Playlists eines Kanals. Du kannst den Bericht so filtern, dass nur Daten für eine bestimmte Playlist oder ein bestimmtes Land angezeigt werden.

Inhalt
Abmessungen:
[Keine Angabe]
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Zeitbasiert

Dieser Bericht enthält Statistiken zu den Interaktionen der Nutzer mit den Playlists eines Kanals. Du kannst den Bericht so filtern, dass nur Daten für eine bestimmte Playlist oder ein bestimmtes Land angezeigt werden.

Inhalt
Abmessungen:
Genau 1 verwenden Tag, Monat
0 oder mehr verwenden subscribedStatus, youtubeProduct.
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Region des Nutzers

Playlist-Aktivitäten nach Land

Dieser Bericht enthält Statistiken zu den Interaktionen der Nutzer mit den Playlists eines Kanals. Du kannst den Bericht so filtern, dass nur Daten für eine bestimmte Playlist, eine Gruppe von Playlists oder ein Land angezeigt werden.

Inhalt
Abmessungen:
Erforderlich Land
0 oder mehr verwenden subscribedStatus, youtubeProduct.
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Playlist-Aktivitäten nach Bundesland

Dieser Bericht stellt Playlist-Aktivitätsstatistiken für die US-Bundesstaaten und den District of Columbia bereit. Für diesen Bericht nehmen Sie country==US in den Parameterwert filters auf.

Inhalt
Abmessungen:
Erforderlich bundesland
0 oder mehr verwenden subscribedStatus, youtubeProduct.
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated==1;Land==US
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Wiedergabeorte

Dieser Bericht enthält Statistiken zum Typ der Seite oder Anwendung, auf der die Playlist wiedergegeben wurde.

Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationType
0 oder mehr verwenden day, subscribedStatus.
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
Optional Abostatus

Details zum Wiedergabeort (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht musst du den Parameter maxResults auf eine Ganzzahl von maximal 25 festlegen. Anders als bei den meisten anderen Berichten müssen Sie für diesen Bericht auch einen Wert für den Anfrageparameter sort angeben.

Dieser Bericht gibt die eingebetteten Videoplayer an, die die meisten Aufrufe oder die höchste Wiedergabezeit für die Playlists eines Kanals erzielt haben.

Inhalt
Abmessungen:
Erforderlich insightPlaybackLocationDetails
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1, insightPlaybackLocationType==EMBEDDED
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
Optional Abostatus
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched
-playlistStarts

Zugriffsquellen

In diesem Bericht werden Aufrufstatistiken basierend auf der Art und Weise zusammengefasst, wie Zuschauer deine Playlist-Inhalte erreicht haben. So wird beispielsweise die Anzahl der Aufrufe ermittelt, die auf eine Google-Suche zurückzuführen sind.

Inhalt
Abmessungen:
Erforderlich inightTrafficSourceType
0 oder mehr verwenden day, subscribedStatus.
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
Optional Abostatus

Zugriffsquellendetails (<= 25 Ergebnisse)

Hinweis: Für diesen Bericht musst du den Parameter maxResults auf eine Ganzzahl von maximal 25 festlegen. Anders als bei den meisten anderen Berichten müssen Sie für diesen Bericht auch einen Wert für den Anfrageparameter sort angeben.

In diesem Bericht werden Aufrufstatistiken basierend auf den Verweis-URLs zusammengefasst, die die meisten Aufrufe für die Playlists des Kanals generiert haben. Verweis-URLs werden nach Zugriffsquellentyp kategorisiert. In der Definition der Dimension insightTrafficSourceDetail sind die Besucherquellen angegeben, für die der Bericht verfügbar ist.

Wenn Sie beispielsweise den Filter insightTrafficSourceType auf ADVERTISING setzen, werden im Bericht die Anzeigentypen aufgeführt, die die meisten Aufrufe oder die höchste Wiedergabezeit für die Playlists des Kanals generiert haben.

Inhalt
Abmessungen:
Erforderlich insightTrafficSourceDetail
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1, insightTrafficSourceType
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
Optional Abostatus
Sortieroptionen: -Aufrufe
-estimatedMinutesWatched
-playlistStarts

Hinweis: Dieser Bericht wird nur für bestimmte Besucherquellen unterstützt. Beispielsweise gibt es für die Zugriffsquelle NO_LINK_EMBEDDED keine zusätzlichen Details und der Bericht wird daher nicht unterstützt. Weitere Informationen dazu, welche Besucherquellen diesen Bericht unterstützen, findest du in der Definition von insightTrafficSourceType.

Gerätetyp und Betriebssystem

Gerätetyp

In diesem Bericht werden Aufrufstatistiken basierend auf der Art und Weise zusammengefasst, wie Zuschauer deine Playlist-Inhalte erreicht haben. Beispielsweise wird damit die Anzahl der Aufrufe auf Mobilgeräten oder Spielekonsolen erfasst.

Inhalt
Abmessungen:
Erforderlich Gerätetyp
0 oder mehr verwenden day, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated = = 1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden operatingSystem, subscribedStatus, youtubeProduct

Betriebssystem

In diesem Bericht werden Aufrufstatistiken nach Betriebssystem des Nutzers zusammengefasst. Beispielsweise wird damit die Anzahl der Playlist-Aufrufe auf Android-Geräten oder PlayStations angegeben.

Inhalt
Abmessungen:
Erforderlich Betriebssystem
0 oder mehr verwenden day, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden deviceType, subscribedStatus, youtubeProduct

Betriebssystem und Gerätetyp

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

Inhalt
Abmessungen:
Erforderlich Gerätetyp, operatingSystem
0 oder mehr verwenden day, subscribedStatus, youtubeProduct
Messwerte:
Mindestens eine verwenden Aufrufe, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
0 oder mehr verwenden subscribedStatus, youtubeProduct.

Demografische Merkmale des Zuschauers

Inhalt
Abmessungen:
Mindestens eine verwenden ageGroup, gender
0 oder mehr verwenden Abostatus
Messwerte:
Erforderlich viewerPercentage
Filter:
Erforderlich isCurated = = 1
0 oder 1 verwenden country, province, continent, subContinent
0 oder 1 verwenden playlist, gruppe
Optional Abostatus
Hinweis: Die viewerPercentage-Werte in diesem Bericht werden für verschiedene Werte oder Kombinationen von Werten für Wiedergabedetaildimensionen (subscribedStatus und youtubeProduct) nicht normalisiert.

Beispiel: Ein Bericht mit der Dimension subscribedStatus gibt viewerPercentage und somit 100 % für abonnierte Aufrufe und zuschauer Der Gesamtwert aller viewerPercentage-Felder im Bericht beträgt 200 %.

Sie können Filter verwenden, damit der Bericht nur viewerPercentage-Daten für einen Wert (oder eine Kombination von Werten) für Wiedergabedetaildimensionen enthält.

Top-Playlists

Hinweis:Bei diesen Berichten müssen Sie den Parameter maxResults auf eine Ganzzahl von maximal 200 festlegen. Vor dem 1. Januar 2013 sind nur die 10 Top-Playlists verfügbar. Anders als in den meisten anderen Berichten muss bei diesen Berichten ein Wert für den Anfrageparameter sort angegeben werden.

In diesem Bericht werden die Top-Playlists des Kanals anhand der angegebenen Filter- und Sortierkriterien aufgeführt.

Inhalt
Abmessungen:
Erforderlich playlist
Messwerte:
Mindestens eine verwenden Aufrufe, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Erforderlich isCurated ==1
0 oder 1 verwenden country, province, continent, subContinent
0 oder mehr verwenden playlist, subscribedStatus, youtubeProduct
Sortieroptionen: -Aufrufe
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Berichte "Anzeigenleistung"

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

Die Berichte zur Anzeigenleistung enthalten impressionsbasierte Messwerte für Anzeigen, die während der Videowiedergabe ausgeliefert wurden. Bei diesen Messwerten wird jede Anzeigenimpression berücksichtigt. Bei jeder Videowiedergabe können also mehrere Impressionen erzielt werden.

Die impressionsbasierten Messwerte für die Anzeigenleistung sind:

Darüber hinaus unterstützen einige Videoberichte die folgenden wiedergabebasierten Messwerte zur Anzeigenleistung. Diese Messwerte sind jedoch nicht in den Berichten zur Anzeigenleistung enthalten.

Anzeigenleistung nach Anzeigentyp

Inhalt
Abmessungen:
Erforderlich Anzeigentyp
Optional Tag
Messwerte:
Mindestens eine verwenden Bruttoumsatz, Anzeigenimpressionen, CPM
Filter:
0 oder 1 verwenden Video, Gruppe
0 oder 1 verwenden country, continent, subContinent