Auf dieser Seite sehen Sie Beispiele für YouTube Analytics API-Anfragen. In jedem Beispiel wird kurz der abgerufene Bericht beschrieben. Außerdem werden die entsprechenden Parameterwerte für dimensions
, metrics
, filters
und sort
angezeigt. In den Kanalberichten und Berichten zu Rechteinhabern sind die von der API unterstützten Berichte aufgeführt.
Jedes Beispiel ist mit dem Google APIs Explorer verknüpft und wird mit den angezeigten Werten gefüllt. In den Beispielen werden auch die standardmäßigen Start- und Enddaten (YYYY-MM-DD
) von 2023-09-01
und 2024-03-31
verwendet.
Nach der Verknüpfung mit APIs Explorer müssen Sie immer noch den Kanal oder Rechteinhaber angeben, für den Sie Berichte abrufen. Im APIs Explorer wird der Parameterwert ids
abhängig von der Abfrage, auf die Sie geklickt haben, mit channel==MINE
oder contentOwner==CONTENT_OWNER_ID
gefüllt. Für Channelberichte können Sie MINE
in die Kanal-ID des authentifizierten Nutzers ändern. In Berichten zu Rechteinhabern musst du CONTENT_OWNER_ID
durch deine Rechteinhaber-ID ersetzen.
Außerdem musst du als der angegebene Kanal oder Rechteinhaber authentifiziert sein, damit APIs Explorer deine API-Anfragen mit OAuth 2.0 autorisieren kann.
Anfragen nach mehreren Dimensionen/Messwerten sortieren
Die API unterstützt die Möglichkeit, Antwortdaten nach mehreren Dimensionen oder Messwerten zu sortieren. Mit der folgenden Anfrage werden beispielsweise tägliche Daten zu Zugriffsquellen für die Videos eines bestimmten Kanals abgerufen. Jede Zeile in der Ergebnismenge gibt die Anzahl der Aufrufe und die geschätzte Wiedergabezeit an, die von einer bestimmten Zugriffsquelle (z.B. EXT_URL
) an einem bestimmten Tag ausgingen.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
In der Antwort sind die Ergebnisse chronologisch sortiert. Innerhalb der Ergebnisse für die einzelnen Tage sind die Ergebnisse in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Die erste Zeile im Ergebnissatz enthält also Daten für die Besucherquelle, über die am ersten Tag im angeforderten Zeitraum die meisten Aufrufe generiert wurden. Die zweite Zeile enthält Daten für die Besucherquelle, über die am ersten Tag die nächsthöhere Anzahl an Aufrufen generiert wurde.
Channelberichte
Videoberichte
Gesamtzahl der Aufrufe, geschätzte Wiedergabezeit und mehr für einen Kanal
Mit dieser Abfrage werden aggregierte Messwerte für die Inhalte des Kanals abgerufen. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Länderspezifische Aufrufzahlen (und mehr) für einen Kanal
Diese Abfrage ruft Messwerte für ein bestimmtes Land für die Videos eines Kanals ab. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
Top 10 – Meistgesehene Videos eines Kanals
Diese Abfrage ruft die zehn am häufigsten angesehenen Videos eines Kanals ab, gemessen anhand der geschätzten Wiedergabezeit im angegebenen Zeitraum in Minuten. Die Ergebnisse werden nach den geschätzten angesehenen Minuten in absteigender Reihenfolge sortiert.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort
angeben und den Parameter maxResults
auf eine Ganzzahl von maximal 10
setzen.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
Top 10 – Klickraten für Anmerkungen zu den am häufigsten angesehenen Videos eines Kanals
Diese Anfrage ruft die Anzahl der Aufrufe, die Klickraten der Anmerkungen, die Abschlussraten für Anmerkungen und die Anmerkungsimpressionen für die zehn meistgesehenen Videos des Kanals ab. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Das bedeutet, dass das Video mit den meisten Aufrufen zuerst aufgeführt wird.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort
angeben und den Parameter maxResults
auf eine Ganzzahl von maximal 10
setzen.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Playlist-Berichte
Gesamtzahl der Playlist-Aufrufe für einen Kanal
Diese Anfrage ruft die Gesamtzahl der Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Aufrufe (aggregierter Videomesswert), die Playlist-Aufrufe (In-Playlist-Messwert) und die Aufrufe pro Playlist-Start für Playlists auf dem Kanal des authentifizierten Nutzers ab.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statistiken für eine bestimmte Playlist
Diese Anfrage ruft die Gesamtzahl der Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Aufrufe (aggregierter Videomesswert), die Playlist-Aufrufe (ein In-Playlist-Messwert) und die Aufrufe pro Playlist-Start für eine bestimmte Playlist ab. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String PLAYLIST_ID
im Parameterwert filters
durch die Playlist-ID für eine Playlist auf dem Kanal des authentifizierten Nutzers ersetzen.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Wenn du zusammengefasste Statistiken für mehrere Playlists abrufen möchtest, kannst du auch den String „PLAYLIST_ID
“ durch eine durch Kommas getrennte Liste von bis zu 500 Playlist-IDs für Playlists im Kanal des authentifizierten Nutzers ersetzen.
Top 10 – Meistgesehene Playlists eines Kanals
Diese Abfrage ruft die zehn am häufigsten angesehenen Playlists eines Kanals ab, gemessen anhand der Playlist-Aufrufe im angegebenen Zeitraum. Außerdem werden verschiedene andere Playlist-Messwerte abgerufen, z. B. die Häufigkeit, mit der die Wiedergabe der einzelnen Playlists gestartet wurde, oder die durchschnittliche Zeit, die sich ein Zuschauer Videos in der Playlist nach dem Start angesehen hat. Die Ergebnisse werden in absteigender Reihenfolge nach Playlistaufrufen sortiert.
Hinweis: Da in diesem Bericht die Dimension playlist
verwendet wird, müssen Sie einen Wert für den sort
-Anfrageparameter angeben. Außerdem müssen Sie für den Parameter maxResults
eine Ganzzahl von 10
oder weniger festlegen.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Videoberichte
Tägliche Messwerte zur Wiedergabezeit für Videos eines Kanals
Diese Abfrage ruft die tägliche Aufrufzahl, Messwerte zur Wiedergabezeit und die Anzahl neuer Abonnenten für die Videos eines Kanals ab. Der Bericht enthält eine Zeile mit Daten für jeden Tag im angeforderten Zeitraum. Zeilen werden in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Tägliche Messwerte zu Anmerkungen zu Videos eines Kanals
Mit dieser Anfrage werden die tägliche Aufrufzahl, die Klickrate für Anmerkungen, die Abbruchraten für Anmerkungen und die Anmerkungsimpressionen für die Inhalte des Kanals abgerufen. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Playlist-Berichte
Tägliche Playlistaufrufe für einen Kanal
Mit dieser Anfrage werden für den Kanal des authentifizierten Nutzers die tägliche Aufrufzahl (aggregierter Videomesswert), Playlist-Aufrufe (In-Playlist-Messwert), Playlist-Starts, die geschätzte Wiedergabezeit in Minuten und die Aufrufe pro Playlist-Start abgerufen. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Videoberichte
Länderspezifische Messwerte zur Wiedergabezeit für Videos eines Kanals
Diese Abfrage ruft länderspezifische Aufrufzahlen, Messwerte zur Wiedergabezeit und Abozahlen für die Videos eines Kanals ab. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Videos des Kanals angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
Länderspezifische Messwerte für Anmerkungen zu Videos auf einem Kanal
Mit dieser Anfrage werden die länderspezifischen Aufrufzahlen, die Klickraten von Anmerkungen, die Abschlussraten für Anmerkungen und die Anmerkungsimpressionen für die Videos des Kanals abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach der Klickrate der Anmerkungen sortiert. Das bedeutet, dass das Land mit der höchsten Klickrate für Anmerkungen zuerst aufgeführt wird.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.
Mit dieser Anfrage werden die Aufrufzahlen, die geschätzte Wiedergabezeit in Minuten und die durchschnittliche Wiedergabedauer der Videos nach Provinz nach Provinz aufgeschlüsselt. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Die Ergebnisse sind alphabetisch nach ISO 3166-2-Codes der Provinzen sortiert.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
Top 10 – Meistgesehene Videos in einem bestimmten Land
Diese Abfrage ruft die zehn meistgesehenen Videos des Kanals ab, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum in einem bestimmten Land. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort
angeben und den Parameter maxResults
auf eine Ganzzahl von maximal 10
setzen.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
Top 10 der Städte in den USA nach Aufrufen insgesamt
Diese Abfrage ruft eine Liste der zehn Städte in den USA ab, in denen im angegebenen Zeitraum die meisten Aufrufe der Kanalinhalte verzeichnet wurden. Die Abfrage könnte geändert werden, um Daten für ein anderes Land anzufordern, indem Sie einen anderen gültigen Wert für diesen Filter auswählen. In ähnlicher Weise könnte die Abfrage geändert werden, um Daten für einen Subkontinent wie Westeuropa oder Südostasien abzurufen, indem Sie den Filter subContinent und einen der gültigen Werte verwenden. Es werden auch andere Filter unterstützt. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city metrics=views filters=country==US maxResults=10 sort=-views
Top 10-Städte in den USA nach Aufrufen insgesamt für jeden Inhaltstyp
Diese Abfrage ruft eine Liste der zehn Städte in den USA ab, in denen im angegebenen Zeitraum für jeden unterstützten creatorContentType die meisten Aufrufe der Kanalinhalte verzeichnet wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views
Top 10 der US-Städte nach Wiedergabezeit insgesamt
Mit dieser Abfrage wird eine Liste der zehn Tage mit dem höchsten Wert im angegebenen Zeitraum abgerufen, an denen eine Stadt in den USA die längste tägliche Wiedergabezeit der Kanalinhalte insgesamt erzielt hat. Die Abfrageergebnisse geben die gesamte Wiedergabezeit, das Datum, an dem die Wiedergabezeit stattgefunden hat, und die Stadt an, in der die Inhalte laut Schätzung angesehen wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der gesamten Wiedergabezeit sortiert.
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
Top 10 – Meistgesehene Videos in Europa
Mit dieser Abfrage werden die zehn meistgesehenen Videos des Kanals in Europa abgerufen, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum. Die Abfrage könnte so geändert werden, dass Daten für einen anderen Kontinent angefordert werden. Wählen Sie dazu einen anderen gültigen Wert für diesen Filter aus. In ähnlicher Weise könnte die Abfrage geändert werden, um Daten für einen Subkontinent wie Westeuropa oder Südostasien abzurufen, indem Sie den Filter subContinent und einen der gültigen Werte verwenden. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort
angeben und den Parameter maxResults
auf eine Ganzzahl von maximal 10
setzen.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Playlist-Berichte
Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Kanals
Mit dieser Abfrage werden die Anzahl der länderspezifischen Aufrufe (aggregierter Videomesswert), Playlist-Aufrufe (ein Messwert in Playlist) und die Messwerte zur Wiedergabezeit für die Playlists eines Kanals abgerufen. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Playlists des Kanals angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
Top 10 – Playlists mit den meisten Aufrufen in den USA
Diese Abfrage ruft die zehn Playlists ab, die sich Zuschauer in den USA im angegebenen Zeitraum am häufigsten ansehen. Die Ergebnisse werden nach der Anzahl der Playlist-Starts in absteigender Reihenfolge sortiert.
Hinweis: Da in diesem Bericht die Dimension playlist
verwendet wird, müssen Sie einen Wert für den sort
-Anfrageparameter angeben. Außerdem müssen Sie für den Parameter maxResults
eine Ganzzahl von 10
oder weniger festlegen.
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
Videoberichte
Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für die Videos eines bestimmten Kanals abgerufen. Die Ergebnisse werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der die Videowiedergabe erfolgte, und die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Tägliche Aufrufzahlen und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die tägliche Aufrufzahl und die geschätzte Wiedergabezeit in den USA für die Videos eines bestimmten Kanals ab. Die Ergebnisse werden für jede Art von Seite oder Anwendung, in der Videowiedergaben stattfanden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
Top 10 – Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
Diese Abfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für ein bestimmtes Video oder eine Gruppe von Videos ab. Die Ergebnisse werden nach der Drittanbieterwebsite gruppiert, auf der das Video eingebettet wurde. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste mit einer oder mehreren Video-IDs für Ihre hochgeladenen Videos ersetzen.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Mit dieser Abfrage wird die Anzahl der Aufrufe (ein zusammengefasster Videomesswert), der Playlist-Aufrufe (ein In-Playlist-Messwert), der geschätzten Wiedergabezeit und der Playlist-Starts für die Playlists eines bestimmten Kanals abgerufen. Die Ergebnisse werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der bzw. in der die Videowiedergaben stattgefunden haben, und sie werden in absteigender Reihenfolge nach Playlist-Starts sortiert.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Tägliche Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die täglichen Playlist-Starts, die Anzahl der Aufrufe (ein zusammengefasster Videomesswert), Playlist-Aufrufe (ein In-Playlist-Messwert) und die geschätzte Wiedergabezeit in den USA für die Playlists eines bestimmten Kanals ab. Die Ergebnisse werden für jede Art von Seite oder Anwendung, in der Playlist-Aufrufe verzeichnet wurden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Videoberichte
„Mag ich“- und „Mag ich nicht“-Bewertungen nach Inhaltstyp
Diese Abfrage ruft die Anzahl der „Mag ich“- und „Mag ich nicht“-Bewertungen für alle Inhaltstypen auf einem Kanal ab.
dimensions=creatorContentType metrics=likes,dislikes
Videoberichte
Anzahl der Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
Mit dieser Anfrage werden die Anzahl der Aufrufe und die geschätzte Wiedergabezeit der Videos des Kanals in einem bestimmten Land abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst. Daran lässt sich erkennen, wie Nutzer auf das Video gestoßen sind.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Tägliche Aufrufzahlen und Wiedergabezeit von verschiedenen Zugriffsquellen
Mit dieser Anfrage werden die tägliche Aufrufzahl und die geschätzte tägliche Wiedergabezeit der Videos des Kanals abgerufen. Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
Top 10: YouTube-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
Mit dieser Abfrage werden die 10 Suchbegriffe abgerufen, die für ein oder mehrere bestimmte Videos die meisten Aufrufe aus den YouTube-Suchergebnissen generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs ersetzen.
Du könntest zum Beispiel die Suchanfrage für ein einzelnes Video ausführen oder VIDEO_ID
ersetzen, um die Suchbegriffe zu ermitteln, die die meisten Zugriffe für dieses Video generieren. Du kannst auch alle Videos in einer bestimmten Playlist auflisten, um festzustellen, welche Suchbegriffe die meisten Zugriffe für eines der Videos in dieser Playlist generieren.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Top 10: Externe Websites, die die meisten Zugriffe für ein Video generieren
Diese Abfrage ruft die zehn externen Websites ab, die für ein bestimmtes Video oder eine Gruppe von Videos die meisten Aufrufe generiert haben. Die Ergebnisse werden nach der geschätzten Wiedergabezeit in absteigender Reihenfolge sortiert. Zum Ausführen dieser Abfrage in APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für Ihre hochgeladenen Videos ersetzen.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
Mit dieser Anfrage werden die Anzahl der Aufrufe (ein zusammengefasster Videomesswert), die Playlist-Aufrufe (ein In-Playlist-Messwert), die Playlist-Starts und die geschätzte Wiedergabezeit für Playlist-Aufrufe in einem bestimmten Land abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst. So siehst du, wie Nutzer auf die Playlist gestoßen sind.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Tägliche Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen
Diese Anfrage ruft die täglichen Playlist-Aufrufe eines Kanals (ein Messwert vom Typ In-Playlist), die Playlist-Starts und die geschätzte Wiedergabezeit eines Kanals ab. Außerdem wird die Gesamtzahl der Aufrufe abgerufen (ein aggregierter Videomesswert). Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
Videoberichte
Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
Mit dieser Abfrage werden die tägliche Anzahl von Aufrufen und die geschätzte Wiedergabezeit auf Android-Geräten für die Videos eines bestimmten Kanals abgerufen. Die Ergebnisse werden für jeden Gerätetyp, auf dem Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Tägliche Betriebssystemmesswerte für Mobilgeräte
Diese Abfrage ruft die tägliche Aufrufzahl und die geschätzte Wiedergabezeit auf Mobilgeräten für die Videos eines bestimmten Kanals ab. Die Ergebnisse werden für jedes Betriebssystem, auf dem die Videowiedergabe erfolgte, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Tägliche Messwerte zu Betriebssystemen und Gerätetypen
Diese Abfrage ruft die tägliche Aufrufzahl und die geschätzte Wiedergabezeit für einen Kanal ab. Die Statistiken sind nach Betriebssystem und Gerätetyp gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Playlist-Berichte
Tägliche Messwerte zum Gerätetyp für Playlist-Aufrufe unter dem Android-Betriebssystem
Mit dieser Abfrage werden die täglichen Aufrufe (ein zusammengefasster Videomesswert), die Playlist-Aufrufe (ein In-Playlist-Messwert) und die geschätzte Wiedergabezeit auf Android-Geräten für die Playlists eines bestimmten Kanals abgerufen. Die Ergebnisse werden für jeden Gerätetyp, auf dem Playlist-Aufrufe verzeichnet wurden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Tägliche Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten
Mit dieser Abfrage werden die täglichen Aufrufe (ein zusammengefasster Videomesswert), die Playlist-Aufrufe (ein In-Playlist-Messwert) und die geschätzte Wiedergabezeit auf Mobilgeräten für die Playlists eines bestimmten Kanals abgerufen. Die Ergebnisse werden für jedes Betriebssystem, auf dem Playlist-Aufrufe erzielt wurden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Videoberichte
Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
Dieser Bericht ruft Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien ab, die sich die Videos des Kanals angesehen haben. Die Ergebnisse werden nach Geschlecht und dann nach Altersgruppe sortiert. Diese Abfrage könnte geändert werden, um dieselben Statistiken für alle Betrachter weltweit oder für alle Betrachter in einem Land, Kontinent, Subkontinent oder einem anderen US-Bundesstaat abzurufen. Dazu passen Sie den Parameterwert filters
an.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Playlist-Berichte
Demografische Merkmale der Playlist-Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
Dieser Bericht ruft Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien ab, die sich die Playlists des Kanals angesehen haben. Die Ergebnisse werden nach Geschlecht und dann nach Altersgruppe sortiert. Diese Abfrage könnte geändert werden, um dieselben Statistiken für alle Betrachter weltweit oder für alle Betrachter in einem Land, Kontinent, Subkontinent oder einem anderen US-Bundesstaat abzurufen. Dazu passen Sie den Parameterwert filters
an.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Freigabemesswerte, zusammengefasst nach Diensten, in denen Videos geteilt wurden
Mit dieser Anfrage wird abgerufen, wie oft Nutzer die Schaltfläche Share
verwendet haben, um die Videos eines Kanals zu teilen. Die Ergebnisse werden nach Freigabedienst (Google+, Twitter usw.) aggregiert und in absteigender Reihenfolge nach der Anzahl der geteilten Inhalte sortiert.
dimensions=sharingService metrics=shares sort=-shares
Messwerte zur Zuschauerbindung eines Videos
In diesem Bericht wird die Fähigkeit eines Videos bewertet, sein Publikum zu binden. Der Bericht kann jeweils nur für ein einzelnes Video abgerufen werden. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch die Video-ID eines Ihrer hochgeladenen Videos ersetzen. In Berichten zur Zuschauerbindung können nicht mehrere Werte für den video
-Filter angegeben werden.
In diesem Beispiel wird für den Bericht der Filter audienceType
verwendet, um die Antwort so einzuschränken, dass er nur Daten zu organischen Aufrufen enthält, die das Ergebnis einer direkten Nutzeraktion sind, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video. Daher enthält der Bericht keine Daten zu Aufrufen von TrueView In-Stream- oder TrueView In-Display-Anzeigen. Du kannst den Filter entfernen, um die Daten zur Zuschauerbindung aller Zielgruppentypen abzurufen.
Daten für den Filter audienceType
stehen seit dem 25. September 2013 zur Verfügung. Die API gibt keine Daten für Abfragen zurück, bei denen der Filter verwendet wird, um Daten aus früheren Zeiträumen abzurufen. Abfragen, bei denen der Filter nicht verwendet wird, funktionieren für alle Daten nach dem 1. Juli 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Messwerte zum Kanalumsatz und zur Anzeigenleistung
Mit dieser Anfrage werden die Messwerte zum Umsatz und zur Anzeigenleistung eines Kanals abgerufen. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Täglicher Umsatz und Messwerte zur Anzeigenleistung
Mit dieser Anfrage werden der tägliche Umsatz und die Messwerte zur Anzeigenleistung eines Kanals abgerufen.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Länderspezifische Messwerte zu Umsatz und Anzeigenleistung
Mit dieser Anfrage werden die länderspezifischen Umsatz- und Anzeigenleistungsmesswerte eines Kanals abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach dem Umsatzbetrag sortiert, was bedeutet, dass das erste aufgeführte Land das Land ist, in dem der Partner den höchsten Nettoumsatz erzielt hat.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
Top 10: Videos mit dem höchsten Umsatz
Durch diese Anfrage werden Messwerte zum Umsatz und zur Anzeigenleistung für die zehn Videos mit dem höchsten Umsatz im Kanal abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach Umsatzbetrag sortiert. Das bedeutet, dass das erste Video das Video mit dem höchsten geschätzten Umsatz ist.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
Mit dieser Anfrage werden Messwerte zur Anzeigenleistung für die beanspruchten Inhalte des Rechteinhabers abgerufen. Die Ergebnisse werden nach Anzeigenart gruppiert, sodass Sie Umsatz- und CPM-Werte über verschiedene Anzeigenarten hinweg vergleichen können.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Berichte zu Rechteinhabern
Videoberichte
Gesamtzahl der Aufrufe, geschätzte Wiedergabezeit und mehr für alle Inhalte, auf die Anspruch erhoben wurde
Mit dieser Abfrage werden zusammengefasste Messwerte für die Inhalte abgerufen, auf die der Rechteinhaber Anspruch erhoben hat. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Länderspezifische Aufrufzahlen (und mehr) für alle selbst hochgeladenen Videos
Mit dieser Abfrage werden Messwerte für ein bestimmtes Land für Videos abgerufen, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Gesamtzahl der Aufrufe (und weitere) für alle Inhalte von Dritten, auf die Anspruch erhoben wurde
Mit dieser Abfrage werden zusammengefasste Messwerte für Videos abgerufen, auf die der Rechteinhaber Anspruch erhoben hat, die er aber nicht hochgeladen hat. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Gesamtzahl der Aufrufe (und weitere) für alle selbst hochgeladenen Inhalte
Mit dieser Abfrage werden zusammengefasste Messwerte für Videos abgerufen, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Gesamtzahl der Aufrufe (und weitere) für alle Inhalte, auf die Anspruch erhoben wurde und die du selbst hochgeladen hast
Diese Abfrage ruft aggregierte Messwerte für Videos ab, die der Rechteinhaber hochgeladen und auch beansprucht hat. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
Top 10 – Meistgesehene Videos für einen Rechteinhaber
Mit dieser Abfrage werden die 10 am häufigsten angesehenen Videos abgerufen, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum, die der Rechteinhaber hochgeladen hat. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
Top 10 – Meistgesehene Videos für einen Rechteinhaber
Diese Abfrage ruft die zehn am häufigsten angesehenen Videos ab, gemessen an den geschätzten angesehenen Minuten im angegebenen Zeitraum, die der Rechteinhaber hochgeladen hat. Die Ergebnisse werden nach den geschätzten angesehenen Minuten in absteigender Reihenfolge sortiert.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
Top 10 – Meistgesehene Videos für den Kanal eines Rechteinhabers
Diese Abfrage ruft die zehn meistgesehenen Videos für einen bestimmten Kanal oder eine Gruppe von Kanälen ab, die der Rechteinhaber verwaltet. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
Top 10 – Klickraten für Anmerkungen zu den am häufigsten angesehenen Videos eines Kanals
Diese Anfrage ruft die Anzahl der Aufrufe, die Klickraten für Anmerkungen, die Abbruchraten für Anmerkungen und die Anmerkungsimpressionen für die zehn am häufigsten angesehenen Videos in einem bestimmten Kanal oder einer Kanalgruppe ab. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Das bedeutet, dass das Video mit den meisten Aufrufen zuerst aufgeführt wird. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Playlist-Berichte
Playlistaufrufe für die Kanäle eines Rechteinhabers
Diese Anfrage ruft die Gesamtzahl der Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Playlist-Aufrufe und die Aufrufe pro Playlist-Start für Playlists auf den Kanälen des Rechteinhabers ab. Der Messwert playlistViews
zählt nur Videoaufrufe, die im Kontext einer Playlist erfolgt sind. Da es sich bei allen angeforderten Messwerten um Messwerte aus der Playlist handelt, muss die Anfrage nicht zusätzlich den Playlist- oder Gruppenfilter enthalten.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statistiken für eine bestimmte Playlist
Diese Anfrage ruft die Gesamtzahl der Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Aufrufe (aggregierter Videomesswert), die Playlist-Aufrufe (ein In-Playlist-Messwert) und die Aufrufe pro Playlist-Start für eine bestimmte Playlist ab. Zum Ausführen dieser Abfrage im APIs Explorer musst du den String PLAYLIST_ID
im Parameterwert filters
durch die Playlist-ID für eine Playlist auf einem der Kanäle des Rechteinhabers ersetzen.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Zum Abrufen zusammengefasster Statistiken für mehrere Playlists kannst du auch den String PLAYLIST_ID
durch eine durch Kommas getrennte Liste von bis zu 500 Playlist-IDs für Playlists in den Kanälen des Rechteinhabers ersetzen.
Videoberichte
Messwerte zur täglichen Wiedergabezeit für selbst hochgeladene Inhalte
Mit dieser Abfrage werden die Messwerte für die tägliche Wiedergabezeit, die Anzahl der Aufrufe, die monetarisierte Wiedergaben und die Impressionen für Videos abgerufen, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine Datenzeile für jeden Tag im angeforderten Zeitraum. Die Zeilen sind in chronologischer Reihenfolge sortiert.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
Messwerte für Anmerkungen zu Inhalten, auf die Anspruch erhoben wurde
Mit dieser Anfrage werden die täglichen Aufrufzahlen, die Klickraten für Anmerkungen, die Abbruchraten für Anmerkungen und die Anmerkungsimpressionen für die beanspruchten Inhalte des Rechteinhabers abgerufen. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Playlist-Berichte
Tägliche Playlistaufrufe für einen Rechteinhaber
Durch diese Anfrage werden Messwerte für tägliche Nutzerinteraktionen mit Videos in den Playlists des Rechteinhabers abgerufen. Die im Bericht abgerufenen Messwerte sind playlistViews, playlistStarts, playlistEstimatedMinutesWatched und viewsPerPlaylistStart. All diese Messwerte sind In-Playlist-Messwerte. Da es sich bei allen angeforderten Messwerten um Messwerte aus der Playlist handelt, muss die Anfrage nicht zusätzlich den Playlist- oder Gruppenfilter enthalten.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Videoberichte
Länderspezifische Messwerte zur Wiedergabezeit für selbst hochgeladene Inhalte
Diese Abfrage ruft die Anzahl der Aufrufe, Messwerte zur Wiedergabezeit und den geschätzten Werbeumsatz für jedes Land ab. Die Messwerte gelten für Videos, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Videos angesehen wurden. Die Zeilen sind in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Länderspezifische Messwerte zu Anmerkungen für selbst hochgeladene Inhalte
Mit dieser Anfrage werden länderspezifische Aufrufzahlen, Klickraten von Anmerkungen, Anmerkungsabschlussraten und Anmerkungsimpressionen für die hochgeladenen Videos des Rechteinhabers abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach der Klickrate der Anmerkungen sortiert. Das bedeutet, dass das Land mit der höchsten Klickrate für Anmerkungen zuerst aufgeführt wird.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.
Mit dieser Anfrage wird eine Aufschlüsselung der Aufrufe, der geschätzten Wiedergabezeit in Minuten und der durchschnittlichen Wiedergabedauer der beanspruchten Videos des Rechteinhabers nach Provinz nach Provinz abgerufen. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Die Ergebnisse sind alphabetisch nach ISO 3166-2-Codes der Provinzen sortiert.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
Top 10 der Städte in den USA nach Aufrufen insgesamt
Diese Abfrage ruft eine Liste der zehn Städte in den USA ab, die im angegebenen Zeitraum die meisten Aufrufe der Videos des Rechteinhabers generiert haben, auf die Anspruch erhoben wurde. Die Abfrage könnte geändert werden, um Daten für ein anderes Land anzufordern, indem Sie einen anderen gültigen Wert für diesen Filter auswählen. In ähnlicher Weise könnte die Abfrage geändert werden, um Daten für einen Subkontinent wie Westeuropa oder Südostasien abzurufen, indem Sie den Filter subContinent und einen der gültigen Werte verwenden. Es werden auch andere Filter unterstützt. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
Top 10-Städte in den USA nach Aufrufen insgesamt für jeden Inhaltstyp
Diese Abfrage ruft eine Liste der zehn Städte in den USA ab, in denen im angegebenen Zeitraum für jeden unterstützten creatorContentType die meisten Aufrufe der beanspruchten Inhalte des Rechteinhabers generiert wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
Top 10 der US-Städte nach Wiedergabezeit insgesamt
Diese Abfrage ruft eine Liste der Top-10-Tage während des angegebenen Zeitraums ab, an denen eine Stadt in den USA die längste tägliche Gesamtwiedergabezeit der Inhalte des Rechteinhabers ausmacht, auf die Anspruch erhoben wurde. Die Abfrageergebnisse geben die gesamte Wiedergabezeit, das Datum, an dem die Wiedergabezeit stattgefunden hat, und die Stadt an, in der die Inhalte laut Schätzung angesehen wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der gesamten Wiedergabezeit sortiert.
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
Top 10 – Meistgesehene Videos in Europa
Mit dieser Abfrage werden unter den Videos, auf die der Rechteinhaber Anspruch erhoben hat, die zehn am häufigsten angesehenen Videos in Europa abgerufen, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum. Die Abfrage könnte so geändert werden, dass Daten für einen anderen Kontinent angefordert werden. Wählen Sie dazu einen anderen gültigen Wert für diesen Filter aus. In ähnlicher Weise könnte die Abfrage geändert werden, um Daten für einen Subkontinent wie Westeuropa oder Südostasien abzurufen, indem Sie den Filter subContinent und einen der gültigen Werte verwenden. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
Playlist-Berichte
Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Rechteinhabers
Diese Abfrage ruft die Anzahl der länderspezifischen Playlist-Aufrufe und Playlist-Wiedergabezeit für alle Playlists auf den Kanälen des Rechteinhabers ab. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Playlists angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
Top 10 – Playlists mit den meisten Aufrufen in den USA
Diese Abfrage ruft die zehn Playlists von den Kanälen des Rechteinhabers ab, die sich Zuschauer in den USA im angegebenen Zeitraum am häufigsten ansehen. Die Ergebnisse werden nach der Anzahl der Playlist-Starts in absteigender Reihenfolge sortiert.
Hinweis: Da in diesem Bericht die Dimension playlist
verwendet wird, müssen Sie einen Wert für den Anfrageparameter sort
angeben und den Parameter maxResults
auf eine Ganzzahl von 10
oder weniger festlegen.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Videoberichte
„Mag ich“- und „Mag ich nicht“-Bewertungen nach Inhaltstyp
Diese Abfrage ruft die Anzahl der „Mag ich“- und „Mag ich nicht“-Bewertungen für jeden Inhaltstyp eines bestimmten Kanals oder einer Kanalgruppe ab. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Videoberichte
Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die Anzahl der Aufrufe und die geschätzte Wiedergabezeit von Videos abgerufen, die auf einen bestimmten Kanal oder eine Gruppe von Kanälen hochgeladen wurden. Die Ergebnisse werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der die Videowiedergabe erfolgte, und die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Tägliche Aufrufzahlen und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die tägliche Anzahl von Aufrufen und die geschätzte Wiedergabezeit in den USA für Videos ab, die auf einen bestimmten Kanal oder eine Gruppe von Kanälen hochgeladen wurden. Die Ergebnisse werden für jede Art von Seite oder Anwendung, in der Videowiedergaben stattfanden, nach Tag gruppiert. Die Ergebnisse werden in umgekehrter chronologischer Reihenfolge sortiert. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
Top 10 – Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
Diese Abfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für ein bestimmtes Video oder eine Gruppe von Videos ab. Die Ergebnisse werden nach der Drittanbieterwebsite gruppiert, auf der das Video eingebettet wurde. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage in APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für Ihre hochgeladenen Videos ersetzen.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die Anzahl der Playlist-Aufrufe, die geschätzte Wiedergabezeit und die Playlist-Starts für alle Playlists auf den Kanälen eines Rechteinhabers abgerufen. Die Ergebnisse werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der bzw. in der die Videowiedergaben stattgefunden haben, und die Ergebnisse in absteigender Reihenfolge nach Playlist-Starts sortiert werden.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die täglichen Playlist-Starts, die Anzahl der Playlist-Aufrufe und die geschätzte Wiedergabezeit von Playlists in den USA für alle Playlists auf den Kanälen eines Rechteinhabers ab. Die Ergebnisse werden für jeden Seiten- oder Anwendungstyp zurückgegeben, bei dem Playlist-Aufrufe aufgetreten sind.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Videoberichte
Anzahl der Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen
Mit dieser Anfrage werden die Anzahl der Aufrufe und die geschätzte Wiedergabezeit der Videos des Rechteinhabers abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst. Daran lässt sich erkennen, wie Nutzer auf das Video gestoßen sind.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Tägliche Aufrufzahlen und Wiedergabezeit von verschiedenen Zugriffsquellen
Mit dieser Anfrage werden die tägliche Aufrufzahl und die geschätzte tägliche Wiedergabezeit der Videos des Rechteinhabers abgerufen. Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in umgekehrter chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Hinweis: Die nächsten beiden Beispielberichte werden nur für bestimmte Besucherquellen unterstützt. Für die Besucherquelle „NO_LINK_EMBEDDED
“ gibt es beispielsweise keine zusätzlichen Details und daher sind diese Berichte für diese Quelle nicht verfügbar. Weitere Informationen zu den Besucherquellen, für die diese Berichtstypen verfügbar sind, findest du in der Definition von insightTrafficSourceType.
Top 10: YouTube-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
Mit dieser Abfrage werden die 10 Suchbegriffe abgerufen, die für ein bestimmtes Video oder eine Videogruppe die meisten Aufrufe aus den YouTube-Suchergebnissen generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage in APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für Ihre hochgeladenen Videos ersetzen.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Top 10: Externe Websites, die die meisten Zugriffe für ein Video generieren
Diese Abfrage ruft die zehn externen Websites ab, die für ein bestimmtes Video oder eine Gruppe von Videos die meisten Aufrufe aus den Google-Suchergebnissen generiert haben. Die Ergebnisse werden nach der geschätzten Wiedergabezeit in absteigender Reihenfolge sortiert. Zum Ausführen dieser Abfrage in APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für Ihre hochgeladenen Videos ersetzen.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
Mit dieser Anfrage werden die Anzahl der Playlist-Aufrufe, Playlist-Starts und die geschätzte Playlist-Wiedergabezeit für Playlist-Aufrufe in einem bestimmten Land abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst. Sie geben an, wie Nutzer auf die Playlist gestoßen sind.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Anzahl der Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen
Diese Anfrage ruft Playlist-Aufrufe, Playlist-Starts und die geschätzte Wiedergabezeit für Playlists auf einem oder mehreren Kanälen eines Rechteinhabers ab. Die Messwerte werden nach Besucherquelle zusammengefasst. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Videoberichte
Tägliche Messwerte für Gerätetypen für Videos, auf die Anspruch erhoben wurde
Diese Abfrage ruft die tägliche Aufrufzahl und die geschätzte Wiedergabezeit nach Gerätetyp für Videos ab, auf die ein bestimmter Rechteinhaber Anspruch erhoben hat. Die Ergebnisse werden für jeden Gerätetyp, auf dem Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Tägliche Betriebssystemmesswerte für Videos, auf die Anspruch erhoben wurde, die auf Mobilgeräten angesehen werden
Mit dieser Abfrage werden die tägliche Anzahl von Aufrufen und die geschätzte Wiedergabezeit nach Betriebssystem für Aufrufe von Videos abgerufen, auf die ein bestimmter Rechteinhaber Anspruch auf ein Mobilgerät erhoben hat. Die Ergebnisse werden für jedes Betriebssystem, auf dem die Videowiedergabe erfolgte, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Tägliche Messwerte zu Betriebssystemen und Gerätetypen
Diese Abfrage ruft die tägliche Aufrufzahl und die geschätzte Wiedergabezeit für Videos ab, auf die ein bestimmter Rechteinhaber Anspruch erhoben hat. Die Statistiken sind nach Betriebssystem und Gerätetyp gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Playlist-Berichte
Messwerte zum Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
Diese Abfrage ruft die Anzahl der Playlist-Aufrufe und die geschätzte Wiedergabezeit von Playlists auf Android-Geräten für Playlists in einem oder mehreren Kanälen eines Rechteinhabers ab. Die Ergebnisse werden für jeden Gerätetyp zurückgegeben, auf dem Playlist-Aufrufe stattgefunden haben. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String CHANNEL_ID
im Parameterwert filters
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten
Diese Abfrage ruft die Anzahl der Playlist-Aufrufe und die geschätzte Wiedergabezeit der Playlist auf Mobilgeräten für Playlists in den Kanälen eines Rechteinhabers ab. Die Ergebnisse werden für jedes Betriebssystem zurückgegeben, auf dem Playlist-Aufrufe erfolgten.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Videoberichte
Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
Mit diesem Bericht werden Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien abgerufen, die sich beanspruchte Inhalte des Rechteinhabers angesehen haben. Die Ergebnisse werden nach Geschlecht und dann nach Altersgruppe sortiert. Diese Abfrage könnte geändert werden, um dieselben Statistiken für alle Betrachter weltweit oder für alle Betrachter in einem Land, Kontinent, Subkontinent oder einem anderen US-Bundesstaat abzurufen. Dazu passen Sie den Parameterwert filters
an.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Freigabemesswerte, zusammengefasst nach Diensten, in denen Videos geteilt wurden
Mit dieser Anfrage wird abgerufen, wie oft Nutzer die Schaltfläche Share
verwendet haben, um vom Rechteinhaber hochgeladene Videos zu teilen. Die Ergebnisse werden nach Freigabedienst (Google+, Twitter usw.) aggregiert und in absteigender Reihenfolge nach der Anzahl der geteilten Inhalte sortiert.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Messwerte zur Zuschauerbindung eines Videos
In diesem Bericht wird die Fähigkeit eines Videos bewertet, sein Publikum zu binden. Der Bericht kann jeweils nur für ein einzelnes Video abgerufen werden. Zum Ausführen dieser Abfrage im APIs Explorer müssen Sie den String VIDEO_ID
im Parameterwert filters
durch die Video-ID eines Ihrer hochgeladenen Videos ersetzen. In Berichten zur Zuschauerbindung können nicht mehrere Werte für den video
-Filter angegeben werden.
In diesem Beispiel wird für den Bericht der Filter audienceType
verwendet, um die Antwort so einzuschränken, dass er nur Daten zu organischen Aufrufen enthält, die das Ergebnis einer direkten Nutzeraktion sind, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video. Daher enthält der Bericht keine Daten zu Aufrufen von TrueView In-Stream- oder TrueView In-Display-Anzeigen. Du kannst den Filter entfernen, um die Daten zur Zuschauerbindung aller Zielgruppentypen abzurufen.
Daten für den Filter audienceType
stehen seit dem 25. September 2013 zur Verfügung. Die API gibt keine Daten für Abfragen zurück, bei denen der Filter verwendet wird, um Daten aus früheren Zeiträumen abzurufen. Abfragen, bei denen der Filter nicht verwendet wird, funktionieren für alle Daten nach dem 1. Juli 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Messwerte zum Umsatz und zur Anzeigenleistung für Inhalte, auf die Anspruch erhoben wurde
Mit dieser Anfrage werden Messwerte zum Umsatz und zur Anzeigenleistung für die Inhalte abgerufen, auf die der Rechteinhaber Anspruch erhoben hat. Der Bericht enthält eine einzelne Datenzeile, die Summen für jeden angeforderten Messwert während des angegebenen Zeitraums enthält.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Täglicher Umsatz und Messwerte zur Anzeigenleistung
Mit dieser Anfrage werden tägliche Umsatz- und Anzeigenleistungsmesswerte für die Inhalte abgerufen, auf die der Rechteinhaber Anspruch erhoben hat.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Länderspezifische Messwerte zu Umsatz und Anzeigenleistung
Mit dieser Anfrage werden länderspezifische Messwerte zum Umsatz und zur Anzeigenleistung für die Inhalte abgerufen, auf die der Rechteinhaber Anspruch erhoben hat. Die Ergebnisse werden in absteigender Reihenfolge nach dem Umsatzbetrag sortiert, was bedeutet, dass das erste aufgeführte Land das Land ist, in dem der Partner den höchsten geschätzten Ertrag erzielt hat.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
Top 10: Videos mit dem höchsten Umsatz
Mit dieser Anfrage werden Messwerte zum Umsatz und zur Anzeigenleistung für die zehn Videos abgerufen, auf die der Rechteinhaber Anspruch erhoben hat und die den höchsten Umsatz erzielt haben. Die Ergebnisse werden in absteigender Reihenfolge nach Umsatzbetrag sortiert. Das bedeutet, dass das erste Video das Video mit dem höchsten geschätzten Umsatz ist.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
Mit dieser Anfrage werden Messwerte zur Anzeigenleistung für die beanspruchten Inhalte des Rechteinhabers abgerufen. Die Ergebnisse werden nach Anzeigenart gruppiert, sodass Sie Umsatz- und CPM-Werte über verschiedene Anzeigenarten hinweg vergleichen können.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType