In diesem Dokument werden die von der YouTube Analytics API unterstützten Dimensionen definiert. Diese API unterstützt zielgerichtete Echtzeitabfragen zur Erstellung benutzerdefinierter YouTube Analytics-Berichte.
Dimensionen sind gängige Kriterien, die zum Aggregieren von Daten verwendet werden, z. B. das Datum der Nutzeraktivität oder das Land, in dem die Nutzer ansässig waren.
In jedem Abfragebericht sind die unterstützten Dimensionen aufgeführt. Wenn Sie beispielsweise Nutzeraktivitäten nach Zeit abrufen, wählen Sie den Zeitraum aus, für den Daten erfasst werden sollen: Tag oder Monat. In jedem Bericht gibt es in jeder Datenzeile eine eindeutige Kombination aus Dimensionswerten.
Rufe zum Abrufen eines Abfrageberichts die Methode reports.query
der YouTube Analytics API auf. Verwenden Sie in Ihrer Anfrage den Parameter dimensions
, um die Dimensionen anzugeben, die YouTube zur Berechnung von Messwerten in den Berichten verwenden soll.
Kerndimensionen
Die YouTube Analytics API unterliegt der in den Nutzungsbedingungen festgelegten Richtlinie zur Einstellung von Produkten, die nicht zu den Kernmesswerten gehören. In den Definitionen auf dieser Seite wird jede Dimension, die eine wesentliche Dimension ist, ausdrücklich als solche gekennzeichnet.
In der folgenden Liste sind die Kerndimensionen der API aufgeführt.
Weitere Informationen finden Sie in der Liste der YouTube-APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
Filter
Alle Abfrageberichte unterstützen Filter. Mit Filtern werden Dimensionswerte identifiziert, die im abgerufenen Datensatz vorhanden sein müssen. Daher beschränken sie eine API-Antwort auf Daten, die mit einem bestimmten Wert oder einer Gruppe von Werten übereinstimmen. Anstatt beispielsweise die Messwerte zur Nutzeraktivität für alle Länder abzurufen, können Sie einen Filter verwenden, um nur Daten für ein bestimmtes Land abzurufen.
In einer Anfrage zum Abrufen eines Abfrageberichts gibt der optionale filters
-Anfrageparameter die Dimensionswerte an, nach denen Sie Daten filtern möchten. Wenn Sie beispielsweise Nutzeraktivitätsmesswerte für Europa abrufen möchten, legen Sie den Parameterwert filters
auf continent==150
fest.
Wichtig: API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder mithilfe einer der Dimensionen für die Berichtsentität oder mit einer unterstützten Kombination aus den Dimensionen claimedStatus
und uploaderType
filtern.
Dimensionen
In den folgenden Abschnitten werden die Dimensionen definiert, die in den Abfrageberichten der YouTube Analytics API verwendet werden. Sofern nicht anders angegeben, werden diese Dimensionen sowohl im Kanalbericht als auch im Rechteinhaberbericht verwendet. Dimensionen, die nur als Filter verwendet werden können, werden ebenfalls identifiziert.
Ressourcen
Diese Dimensionen entsprechen Ressourcen, die Kanäle und Rechteinhaber auf YouTube verwalten:
Hinweis: In der API können Sie mehrere Werte für die Dimensionen video
, playlist
und channel
angeben, wenn sie als Filter verwendet werden. Setze dazu den Parameterwert filters
auf eine durch Kommas getrennte Liste der Video-, Playlist- oder Kanal-IDs, für die die API-Antwort gefiltert werden soll. Im Parameterwert können bis zu 500 IDs angegeben werden.
- Video (Kerndimension)
- Die ID eines YouTube-Videos. In der YouTube Data API ist dies der Wert der
id
-Property einervideo
-Ressource. This is a core dimension and is subject to the Deprecation Policy. - playlist
- Die ID einer YouTube-Playlist. In der YouTube Data API ist dies der Wert der
id
-Property einerplaylist
-Ressource. - channel (Kerndimension) (wird nur in Berichten zu Rechteinhabern verwendet)
- Die ID eines YouTube-Kanals. In der YouTube Data API ist dies der Wert der
id
-Property einerchannel
-Ressource. This is a core dimension and is subject to the Deprecation Policy.
Die Dimensionchannel
wird häufig in Berichten des Rechteinhabers verwendet, weil in diesen Berichten in der Regel Daten für mehrere Kanäle zusammengefasst werden. - group (nur Filter)
- Die ID einer YouTube Analytics-Gruppe. Du kannst diesen Wert mit der Methode
groups.list
der YouTube Analytics API abrufen. Wenn du den Filtergroup
verwendest, enthält die API-Antwort Daten für alle Videos, Playlists oder Kanäle in dieser Gruppe.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen oder Filter für Berichtsentitäten verwendet:
Beispiele für Kanäle
-
Grundlegende Statistiken
- Top 10: Am häufigsten angesehene Videos für einen Kanal
- Top 10 – Klickraten von Anmerkungen für die am häufigsten angesehenen Videos eines Kanals
- Statistiken für eine bestimmte Playlist
- Top 10: Am häufigsten angesehene Playlists für einen Kanal
-
Zielregion
- Top 10: Meistgesehene Videos in einem bestimmten Land
- Top 10: Meistgesehene Videos in Europa
-
Grundlegende Statistiken
Beispiele für Rechteinhaber
-
Grundlegende Statistiken
- Top 10: Am häufigsten angesehene Videos eines Rechteinhabers
- Top 10: Am häufigsten angesehene Videos eines Rechteinhabers
- Top 10: Meistgesehene Videos für den Kanal eines Rechteinhabers
- Top 10 – Klickraten von Anmerkungen für die am häufigsten angesehenen Videos eines Kanals
- Top 10: Am häufigsten angesehene Playlists eines Rechteinhabers
-
Zielregion
- Top 10: Am häufigsten angesehene Videos in Europa für einen Rechteinhaber
- Top 10: am häufigsten gestartete Playlists in den USA
-
Grundlegende Statistiken
Regionen
Mit diesen Dimensionen wird eine geografische Region identifiziert, die mit Messwerten zur Nutzeraktivität, zur Anzeigenleistung oder zum geschätzten Umsatz verknüpft ist.
- country [Land] (Kerndimension)
- Das Land, das mit den Messwerten in der Berichtszeile verknüpft ist. Der Dimensionswert ist ein aus zwei Buchstaben bestehender ISO-3166-1-Ländercode, z. B.
US
,CN
(China) oderFR
(Frankreich). Der LändercodeZZ
wird verwendet, um Messwerte zu melden, für die YouTube das zugehörige Land nicht identifizieren konnte. This is a core dimension and is subject to the Deprecation Policy. - bundesland
- Ein US-Bundesstaat oder -Gebiet, das mit den Messwerten in der Berichtszeile verknüpft ist. Der Dimensionswert ist ein ISO 3166-2-Code, der einen US-Bundesstaat oder den District of Columbia angibt, z.B.
US-MI
(Michigan) oderUS-TX
(Texas). Der Code der ProvinzUS-ZZ
wird verwendet, um Messwerte zu melden, für die YouTube den zugehörigen US-Bundesstaat nicht identifizieren konnte. Wenn eine API-Anfrageprovince
im Parameterwertdimensions
enthält, muss die Anfrage auch Daten auf die USA beschränken, indemcountry==US
im Parameterwertfilters
aufgenommen wird.Hinweis: Diese Dimension unterstützt keine ISO 3166-2-Werte, die die Außengebiete der USA angeben, da für diese Gebiete auch eigene ISO 3166-1-Ländercodes gelten. Außerdem können nur Untergruppen der USA unterteilt werden.
- ort
- Die geschätzte Stadt, die den Messwerten in der Berichtszeile zugeordnet ist. Für diese Dimension sind Daten ab dem 1. Januar 2022 verfügbar.
- continent (nur Filter)
-
Ein statistischer Regionscode der Vereinten Nationen (UN) Die API unterstützt die folgenden Werte:
Werte 002
Afrika 019
Nord-, Mittel- und Südamerika, Lateinamerika und die Karibik 142
Asien 150
Europa 009
Ozeanien filters
aufcontinent==REGION_CODE
und geben Sie einenREGION_CODE
-Wert aus der Liste oben an. - subContinent (nur Filter)
-
Ein statistischer Code der UN-Region, der eine geografische Unterregion identifiziert. Die Statistikabteilung der Vereinten Nationen listet Unterregionen sowie die ihnen zugeordneten Länder auf.
Diese Dimension kann nur zum Filtern von Daten verwendet werden. Wenn Sie diese Dimension verwenden möchten, setzen Sie den Wert des Parameters
filters
aufsubContinent==REGION_CODE
und geben einen WertREGION_CODE
aus der Liste der UN an.
Beispiele
In den folgenden Beispielanfragen werden geografische Dimensionen oder Filter verwendet:
Beispiele für Kanäle
- Grundlegende Statistiken: z. B. die Anzahl der länderspezifischen Aufrufe für einen Kanal
-
Zielregion
- Länderspezifische Wiedergabezeitmesswerte für die Videos eines Kanals
- Länderspezifische Anmerkungsmesswerte für Videos eines Kanals
- Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.
- Länderspezifische Wiedergabezeitmesswerte für die Playlists eines Kanals
- Top 10: am häufigsten gestartete Playlists in den USA
- Wiedergabeort: Tägliche Anzahl an Aufrufen und Wiedergabezeit an verschiedenen Wiedergabeorten
- Zugriffsquelle: Anzahl der Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen in einem Land
- Demografische Merkmale: Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
-
Top-Videos
- Top 10: Meistgesehene Videos in einem bestimmten Land
- Top 10: Meistgesehene Videos in Europa
Beispiele für Rechteinhaber
- Grundlegende Statistiken: z. B. länderspezifische Aufrufzahlen für alle selbst hochgeladenen Videos
-
Zielregion
- Länderspezifische Wiedergabezeitmesswerte für selbst hochgeladene Inhalte
- Länderspezifische Annotationsmesswerte für selbst hochgeladene Inhalte
- Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.
- Länderspezifische Wiedergabezeitmesswerte für die Playlists eines Rechteinhabers
- Top 10: am häufigsten gestartete Playlists in den USA
- Wiedergabeort: Tägliche Anzahl an Aufrufen und Wiedergabezeit an verschiedenen Wiedergabeorten
- Demografische Merkmale: Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
- Top-Videos: Top-10-Videos für einen Rechteinhaber in Europa, die am häufigsten angesehen wurden
- Umsatz/Anzeigenleistung: Länderspezifische Messwerte für Umsatz und Anzeigenleistung
Zeiträume
Diese Dimensionen geben an, dass in einem Bericht Daten basierend auf einem bestimmten Zeitraum, z. B. einem Tag, einer Woche oder einem Monat, aggregiert werden sollen. Die Anfrageparameter startDate
und endDate
geben den Zeitraum an, für den der Bericht Daten enthält. Der Bericht enthält Daten bis zum letzten Tag, an dem alle in der Anfrage angegebenen Messwerte zum Zeitpunkt der Abfrage verfügbar sind. In Berichten werden Datumsangaben im Format YYYY-MM-DD
aufgeführt.
Wichtig: Alle Datumsangaben beziehen sich auf den Zeitraum um 12:00 Uhr Pacific Time (UTC-7 oder UTC-8) bis zum 23.59. Pacific Time am angegebenen Tag, Monat und Jahr. Daher wird das Datum, an dem die Uhrzeit für die Sommerzeit angepasst wird, einem 23-Stunden-Zeitraum zugeordnet, und Datumsangaben, wenn die Uhr rückwärts angepasst wird, sind 25 Stunden.
Die Dimension Monat bezieht sich auf den Zeitraum ab 12:00 Uhr Pacific Time (UTC-7 oder UTC-8) am ersten Tag des angegebenen Monats und Jahres.
- Tag (Kerndimension)
- Wenn Sie diese Dimension verwenden, werden die Daten im Bericht täglich zusammengefasst und jede Zeile enthält Daten für einen Tag. Sie können weitere Dimensionen verwenden, um die Daten weiter aufzuschlüsseln. Im Bericht zu Zugriffsquellen können beispielsweise tägliche Wiedergabestatistiken basierend auf der Art und Weise zusammengefasst werden, wie Nutzer auf deine Videos zugreifen. This is a core dimension and is subject to the Deprecation Policy.
- Monat (Kerndimension)
- Die Daten im Bericht werden nach Kalendermonat zusammengefasst. Wie bei täglichen Berichten können Sie die Daten mit weiteren Filtern noch weiter segmentieren. Im Bericht sind Datumsangaben im Format
YYYY-MM
aufgeführt.
Hinweis:Wenn Ihre API-Abfrage die Dimensionmonth
verwendet, müssen die Parameterstart-date
undend-date
auf den ersten Tag des Monats festgelegt werden. This is a core dimension and is subject to the Deprecation Policy.
Beispiele
In den folgenden Beispielanfragen werden zeitliche Dimensionen oder Filter verwendet:
Beispiele für Kanäle
-
Zeitbasiert
- Tägliche Wiedergabezeitmesswerte für die Videos eines Kanals
- Tägliche Messwerte für Anmerkungen zu den Videos eines Kanals
- Tägliche Playlist-Aufrufe für einen Kanal
- Wiedergabeort: Tägliche Anzahl an Aufrufen und Wiedergabezeit an verschiedenen Wiedergabeorten
- Zugriffsquelle: Tägliche Anzahl an Aufrufen und Wiedergabezeit aus verschiedenen Zugriffsquellen
-
Gerät/Betriebssystem
- Tägliche Messwerte für Gerätetypen für das Android-Betriebssystem
- Tägliche Betriebssystemmesswerte für Mobilgeräte
- Tägliche Messwerte für Betriebssystem und Gerätetyp
-
Zeitbasiert
Beispiele für Rechteinhaber
-
Zeitbasiert
- Tägliche Wiedergabezeitmesswerte für Inhalte, die du selbst hochgeladen hast
- Messwerte für Anmerkungen für Inhalte, auf die Anspruch erhoben wurde
- Tägliche Playlist-Aufrufe für einen Rechteinhaber
- Wiedergabeort: Tägliche Anzahl an Aufrufen und Wiedergabezeit an verschiedenen Wiedergabeorten
- Zugriffsquelle: Tägliche Anzahl an Aufrufen und Wiedergabezeit aus verschiedenen Zugriffsquellen
-
Gerät/Betriebssystem
- Tägliche Messwerte für Gerätetypen für Videos mit Ansprüchen
- Tägliche Messwerte für Betriebssysteme von Videos mit Ansprüchen auf Mobilgeräten
- Tägliche Messwerte für Betriebssystem und Gerätetyp
- Umsatz/Anzeigenleistung: Tägliche Messwerte zum Umsatz und zur Anzeigenleistung
-
Zeitbasiert
Wiedergabeorte
Diese Dimensionen geben Aufschluss über die Seite oder App, auf der Nutzeraktivitäten stattgefunden haben.
- insightPlaybackLocationType
-
Die Daten im Bericht werden je nach Art der Seite oder Anwendung zusammengefasst, auf der die Videowiedergabe erfolgt ist. Mögliche Werte für diese Dimension:
-
BROWSE
: Die Daten beschreiben Aufrufe, die auf der YouTube-Startseite, dem Abofeed oder in einer anderen YouTube-Funktion zum Stöbern stattgefunden haben. -
CHANNEL
: Die Daten beschreiben Aufrufe, die auf einer Kanalseite erfolgt sind. -
EMBEDDED
: Die Daten beschreiben Aufrufe, die über eine Einbettung von<iframe>
oder<object>
auf einer anderen Website oder in einer anderen Anwendung erfolgt sind. -
EXTERNAL_APP
: Die Daten beschreiben Aufrufe in einer Drittanbieteranwendung, bei der das Video nicht mit der Einbettung von<iframe>
oder<object>
wiedergegeben wurde. So würden beispielsweise Wiedergaben in Apps, die die YouTube Android Player API verwenden, mit diesem Wert kategorisiert. -
MOBILE
: Die Daten beschreiben Aufrufe, die auf der mobilen YouTube-Website oder auf YouTube API-Clients (einschließlich Mobilgeräten) stattgefunden haben.Ab dem 10. September 2013 werden Wiedergaben in YouTube Analytics-Berichten nicht mehr als
MOBILE
-Wiedergaben kategorisiert. Der Wert kann jedoch in Berichten verbleiben, da die alten Daten weiterhin unter diese Kategorie fallen. Nach diesem Datum werden mobile Wiedergaben jedoch entweder alsWATCH
-,EMBEDDED
- oderEXTERNAL_APP
-Wiedergaben klassifiziert, je nachdem, um welche Art von App es sich handelt. -
SEARCH
: Die Daten beschreiben Aufrufe, die direkt auf der YouTube-Suchergebnisseite stattgefunden haben. -
WATCH
: Die Daten beschreiben Aufrufe, die auf der YouTube-Wiedergabeseite des Videos oder in einer offiziellen YouTube-App, z. B. in der YouTube App für Android, stattgefunden haben. -
YT_OTHER
: Die Daten beschreiben Ansichten, die nicht anderweitig klassifiziert sind.
-
- insightPlaybackLocationDetails
- Die Daten werden anhand der Seite zusammengefasst, auf der sich der Player befindet. Dieser Bericht wird nur für Aufrufe unterstützt, die in eingebetteten Playern aufgetreten sind. Er enthält die eingebetteten Player, die die meisten Aufrufe für ein bestimmtes Video generiert haben. Sie erhalten dadurch eine detailliertere Ansicht als der Bericht zu Wiedergabeorten, da die URLs oder Anwendungen identifiziert werden, die den am häufigsten eingebetteten Playern zugeordnet sind.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen für den Wiedergabeort verwendet:
Beispiele für Kanäle
-
Wiedergabeort
- Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
- Tägliche Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
- Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
- Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
- Tägliche Playlist-Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
-
Wiedergabeort
Beispiele für Rechteinhaber
-
Wiedergabeort
- Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
- Tägliche Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
- Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
- Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
- Tägliche Playlist-Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
-
Wiedergabeort
Wiedergabedetails
- creatorContentType
- Diese Dimension gibt den Inhaltstyp an, der mit den Messwerten zur Nutzeraktivität in der Datenzeile verknüpft ist. Für diese Dimension sind Daten ab dem 1. Januar 2019 verfügbar.
In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Werte LIVE_STREAM
Der angezeigte Inhalt war ein YouTube-Livestream. SHORTS
Der angezeigte Inhalt war ein YouTube-Kurzvideo. STORY
Der angezeigte Inhalt war eine YouTube Story. VIDEO_ON_DEMAND
Der angezeigte Inhalt war ein YouTube-Video, das unter keinen der anderen Dimensionswerte fällt. UNSPECIFIED
Der Inhaltstyp des angesehenen Inhalts ist unbekannt. - liveOrOnDemand
- Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in der Datenzeile mit den Aufrufen einer Liveübertragung verknüpft sind. Für diese Dimension sind Daten ab dem 1. April 2014 verfügbar.
In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Werte LIVE
Die Daten der Zeile beschreiben die Nutzeraktivität während einer Liveübertragung. ON_DEMAND
Die Daten der Zeile beschreiben die Nutzeraktivität, die während einer Liveübertragung nicht stattgefunden hat. - Abostatus
- Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in der Datenzeile mit Zuschauern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben.
Mögliche Werte sind
SUBSCRIBED
undUNSUBSCRIBED
.
Hinweis: Der Dimensionswert entspricht dem Zeitpunkt, zu dem die Nutzeraktivität erfolgt. Beispiel: Ein Nutzer hat noch keinen Kanal abonniert, sieht sich eines seiner Videos an, abonniert den Kanal und sieht sich dann ein weiteres Video an. Dem Bericht des Kanals zufolge hat eine Datenansicht densubscribedStatus
-WertSUBSCRIBED
und eine Datenansicht densubscribedStatus
-WertUNSUBSCRIBED
. - youtubeProduct
- Diese Dimension gibt den YouTube-Dienst an, auf dem die Nutzeraktivität stattgefunden hat. Die Daten für diese Dimension stehen ab dem 18. Juli 2015 zur Verfügung.
In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Werte CORE
Die Nutzeraktivität, die nicht in einer der speziellen YouTube-Anwendungen (YouTube Gaming, YouTube Kids oder YouTube Music) stattgefunden hat. Ausnahme: Nutzeraktivitäten in YouTube Music vor dem 1. März 2021 sind in CORE
enthalten.GAMING
Die Nutzeraktivität ist in YouTube Gaming aufgetreten. KIDS
Die Nutzeraktivität ist in YouTube Kids aufgetreten. MUSIC
Die Nutzeraktivität ist am oder nach dem 1. März 2021 in YouTube Music aufgetreten. Daten vor dem 1. März 2021 sind in CORE
enthalten. Echtzeitdaten werden nicht aufgezeichnet.UNKNOWN
Die Nutzeraktivität trat vor dem 18. Juli 2015 auf.
Zugriffsquellen
- inightTrafficSourceType
- Die Daten im Bericht werden basierend auf dem Verweistyp aggregiert. Er beschreibt, wie Nutzer auf das Video gelangt sind. Mögliche Werte für diese Dimension sind:
ADVERTISING
: Der Zuschauer wurde von einer Anzeige auf das Video verwiesen. Wenn Sie nach dieser Besucherquelle filtern, wird im FeldinsightTrafficSourceDetail
die Art der Werbung angegeben.ANNOTATION
: Zuschauer haben durch einen Klick auf eine Anmerkung in einem anderen Video das Video erreicht.CAMPAIGN_CARD
: Die Aufrufe stammen aus von Nutzern hochgeladenen Videos, auf die der Rechteinhaber Anspruch auf die angezeigten Inhalte erhoben hat. Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt.END_SCREEN
: Die Aufrufe stammen aus dem Abspann eines anderen Videos.EXT_URL
: Die Videoaufrufe wurden über einen Link auf einer anderen Website referenziert. Wenn Sie nach dieser Besucherquelle filtern, wird die Webseite im FeldinsightTrafficSourceDetail
identifiziert. Diese Besucherquelle enthält Verweise von Google-Suchergebnissen.HASHTAGS
: Die Aufrufe stammen von VOD-Hashtags oder von Shorts mit Hashtags.LIVE_REDIRECT
: Die Videoaufrufe wurden über Live Redirects referenziert.NO_LINK_EMBEDDED
: Das Video wurde auf einer anderen Website eingebettet, als es angesehen wurde.NO_LINK_OTHER
: YouTube hat keine Verweis-URL für den Traffic identifiziert. Diese Kategorie umfasst direkte Zugriffe auf ein Video sowie Zugriffe in mobilen Apps.NOTIFICATION
: Die Videoaufrufe wurden über eine E-Mail oder eine Benachrichtigung von YouTube vorgenommen.PLAYLIST
: Die Videoaufrufe wurden erfasst, während das Video als Teil einer Playlist abgespielt wurde. Diese Zugriffsquelle ist nicht mitYT_PLAYLIST_PAGE
identisch. Das bedeutet, dass die Aufrufe von der Seite stammen, auf der alle Videos in der Playlist aufgeführt werden.PRODUCT_PAGE
: Die Videoaufrufe wurden von einer Produktseite referenziert.PROMOTED
: Die Videoaufrufe wurden von einer unbezahlten YouTube-Werbung, wie der YouTube-Seite „Spotlight-Videos“, verwiesen.RELATED_VIDEO
: Die Videoaufrufe wurden von einem ähnlichen Videoeintrag auf einer anderen Wiedergabeseite ausgelöst. Wenn du nach dieser Zugriffsquelle filterst, gibt das FeldinsightTrafficSourceDetail
die Video-ID für dieses Video an.SHORTS
: Der Nutzer hat auf dem Kanal im Shorts-Format vertikal verwiesen.SOUND_PAGE
: Die Aufrufe stammen von Shorts-Pivot-Seiten.SUBSCRIBER
: Die Videoaufrufe wurden über Feeds auf der YouTube-Startseite oder über die Abofunktionen von YouTube vorgenommen. Wenn Sie nach dieser Besucherquelle filtern, gibt das FeldinsightTrafficSourceDetail
die Feedelemente auf der Startseite oder eine andere Seite an, von der Aufrufe stammen.YT_CHANNEL
: Die Videoaufrufe wurden auf einer Kanalseite durchgeführt. Wenn Sie nach dieser Besucherquelle filtern, wird im FeldinsightTrafficSourceDetail
die Kanal-ID für diesen Kanal angegeben.YT_OTHER_PAGE
: Die Videoaufrufe wurden über einen anderen Link als ein Suchergebnis oder einen Link zu einem ähnlichen Video vorgenommen, der auf einer YouTube-Seite angezeigt wurde. Wenn Sie nach dieser Besucherquelle filtern, wird die Seite im FeldinsightTrafficSourceDetail
identifiziert.YT_PLAYLIST_PAGE
: Die Videoaufrufe stammen von einer Seite, auf der alle Videos einer Playlist aufgeführt sind. Diese Zugriffsquelle ist nicht mitPLAYLIST
identisch. Das bedeutet, dass die Wiedergaben während der Wiedergabe des Videos im Rahmen einer Playlist stattgefunden haben.YT_SEARCH
: Die Videoaufrufe wurden über die YouTube-Suchergebnisse vorgenommen. Wenn Sie nach dieser Besucherquelle filtern, wird im FeldinsightTrafficSourceDetail
der Suchbegriff angegeben.
- insightTrafficSourceDetail
- Die Daten im Bericht werden anhand der Verweis-URLs aggregiert, die die meisten Aufrufe für ein bestimmtes Video und einen angegebenen Zugriffsquellentyp generiert haben. In der folgenden Liste werden die Besucherquellen aufgeführt, für die dieser Bericht verfügbar ist. Die Liste enthält für jede Besucherquelle die Informationen, die in der Dimension
insightTrafficSourceDetail
angegeben werden.ADVERTISING
: Die Art der Werbung, die zu den Aufrufen geführt hat. Mögliche Werte sind:- Click-to-Play-Interaktionsanzeige
- Engagement-Anzeige
- Google-Suchanzeigen
- Videoanzeige auf der Startseite
- Reservierte überspringbare In-Stream-Anzeige
- TrueView In-Search und In-Display
- TrueView In-Stream-Anzeigen
- Unkategorisierte YouTube-Werbung
- Videowand
CAMPAIGN_CARD
: Das Video, auf das Anspruch erhoben wurde und das Zuschauer zu dem im Bericht angegebenen Video geführt hat.END_SCREEN
: Das Video, das Zuschauer zu dem im Bericht angegebenen Video geführt hat.EXT_URL
: Die Website, über die die Zuschauer auf das Video verwiesen wurden.HASHTAGS
: Das Hashtag, das zu den Aufrufen geführt hat.NOTIFICATION
: Die E-Mail oder Benachrichtigung, über die der Traffic weitergeleitet wurde.RELATED_VIDEO
: Das ähnliche Video, das Zuschauer zu dem im Bericht genannten Video geführt hat.SOUND_PAGE
: Das Video, das zu den Aufrufen geführt hat.SUBSCRIBER
: Das Feedelement auf der Startseite oder die YouTube-Abofunktion, das die Zuschauer zum im Bericht genannten Video geführt hat. Gültige Werte sind:activity
: Aufrufe über Artikel in Abo-Feeds auf der Startseite, die nicht aus Upload- und sozialer Kanalaktivität resultierten, wie etwa positive Bewertungen, Favoriten, Bulletinbeiträge und Playlist-Hinzufügungen.blogged
: Aufrufe über Artikel in Abo-Feeds auf der Startseite, die über Links von Top-Blogs zustande kommen.mychannel
: Aufrufe über Artikel in anderen Feeds, die auf der Startseite aufgeführt sind, wie „Mag ich“-Bewertungen, Wiedergabeverlauf und „Später ansehen“.podcasts
: Aufrufe, die von Elementen auf der Podcasts-Landingpage stammen.sdig
: Aufrufe, die von E-Mails zu Abo-Updates stammen.uploaded
: Aufrufe über dieuploaded
-Elemente in Abo-Feeds auf der Startseite./
: Andere Aufrufe von der YouTube-Startseite./my_subscriptions
: Aufrufe über die Seite Meine Abos der Nutzer auf YouTube.
YT_CHANNEL
: Die Kanalseite, auf der sich Zuschauer das Video angesehen haben.YT_OTHER_PAGE
: Die YouTube-Seite, über die Zuschauer auf das Video verwiesen wurden.YT_SEARCH
: Der Suchbegriff, der Zuschauer zum Video geführt hat.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen für Besucherquellen verwendet:
Beispiele für Kanäle
-
Besucherquelle
- Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen in einem Land
- Tägliche Anzahl an Aufrufen und Wiedergabezeit aus verschiedenen Zugriffsquellen
- Top 10: die YouTube-Suchbegriffe, die den meisten Traffic für ein Video generieren
- Top 10 – Google-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
- Anzahl der Playlist-Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen in einem Land
- Tägliche Playlist-Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen
-
Besucherquelle
Beispiele für Rechteinhaber
-
Besucherquelle
- Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen
- Tägliche Anzahl an Aufrufen und Wiedergabezeit aus verschiedenen Zugriffsquellen
- Top 10: die YouTube-Suchbegriffe, die den meisten Traffic für ein Video generieren
- Top 10 – Google-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
- Anzahl der Playlist-Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen in einem Land
- Tägliche Playlist-Aufrufe und Wiedergabezeit aus verschiedenen Zugriffsquellen
-
Besucherquelle
Geräte
- Gerätetyp
- Diese Dimension gibt den physischen Formfaktor des Geräts an, auf dem die Wiedergabe erfolgt ist.
In der folgenden Liste sind die Gerätetypen aufgeführt, für die die API Daten zurückgibt. Sie können die Dimension
deviceType
auch als Filter verwenden, um einen Betriebssystembericht so einzuschränken, dass er nur Daten für einen bestimmten Gerätetyp enthält.DESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- Betriebssystem
- Diese Dimension bezeichnet das Softwaresystem des Geräts, auf dem die Ansicht ausgeführt wurde.
In der folgenden Liste sind die Betriebssysteme aufgeführt, für die die API Daten zurückgibt. Sie können
operatingSystem
auch als Filter verwenden, um einen Gerätetypbericht so einzuschränken, dass er nur Daten für ein bestimmtes Betriebssystem enthält.ANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
Beispiele
In den folgenden Beispielanfragen werden Gerätedimensionen verwendet:
Beispiele für Kanäle
-
Gerät/Betriebssystem
- Tägliche Messwerte für Gerätetypen für das Android-Betriebssystem
- Tägliche Betriebssystemmesswerte für Mobilgeräte
- Tägliche Messwerte für Betriebssystem und Gerätetyp
- Tägliche Messwerte zu Gerätetypen für Playlist-Aufrufe auf dem Android-Betriebssystem
- Tägliche Messwerte für Betriebssysteme für Playlist-Aufrufe auf Mobilgeräten
-
Gerät/Betriebssystem
Beispiele für Rechteinhaber
-
Gerät/Betriebssystem
- Tägliche Messwerte für Gerätetypen für Videos mit Ansprüchen
- Tägliche Messwerte für Betriebssysteme von Videos mit Ansprüchen auf Mobilgeräten
- Tägliche Messwerte für Betriebssystem und Gerätetyp
- Tägliche Messwerte zu Gerätetypen für Playlist-Aufrufe auf dem Android-Betriebssystem
- Tägliche Messwerte für Betriebssysteme für Playlist-Aufrufe auf Mobilgeräten
-
Gerät/Betriebssystem
Demografische Merkmale
Mithilfe von Dimensionen nach demografischen Merkmalen können Sie die Altersgruppe und Geschlechterverteilung Ihrer Zielgruppe besser nachvollziehen. In der YouTube-Hilfe findest du weitere Informationen zu demografischen Daten in YouTube Analytics-Berichten.
- ageGroup (Kerndimension)
- Diese Dimension gibt die Altersgruppe der angemeldeten Nutzer an, die mit den Berichtsdaten verknüpft sind. Die API verwendet die folgenden Altersgruppen:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- gender (Kerndimension)
- Diese Dimension gibt das Geschlecht der angemeldeten Nutzer an, die mit den Berichtsdaten verknüpft sind.
Gültige Werte sind
female
,male
unduser_specified
. This is a core dimension and is subject to the Deprecation Policy.
Beispiele
In den folgenden Beispielanfragen werden demografische Dimensionen verwendet:
Beispiele für Kanäle
-
Demografische Merkmale
- Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
- Demografische Merkmale der Playlist-Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
-
Demografische Merkmale
Beispiele für Rechteinhaber
-
Demografische Merkmale
- Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
- Demografische Merkmale der Playlist-Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
-
Demografische Merkmale
Interaktionen und Teilen von Inhalten
- sharingService (Kerndimension)
- Diese Dimension gibt den Dienst an, mit dem Videos geteilt wurden. Videos können auf YouTube (oder über den YouTube-Player) über die Schaltfläche „Teilen“ geteilt werden. This is a core dimension and is subject to the Deprecation Policy.
Die folgende Tabelle enthält gültige Dimensionswerte:
Dienst, mit dem geteilt wurde API-Wert Ameba AMEBA
Android-E-Mail ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android-Nachrichten ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
In Zwischenablage kopieren COPY_PASTE
Zyworld CYWORLD
Graben DIGG
Logo: Dropbox DROPBOX
Einbetten EMBED
E-Mail-Adresse MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook-Seiten FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go-SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC-SMS HTC_MMS
Google-Posteingang INBOX
Dialogfeld „iOS-Systemaktivität“ IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO-Geschichte KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE-E-Mail LGE_EMAIL
Linie LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Motorola-Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Łőноклассники) ODNOKLASSNIKI
Andere OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony-Unterhaltungen SONY_CONVERSATIONS
Stumble-Up STUMBLEUPON
Telegram TELEGRAM
SMS-Nachricht TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Unbekannt UNKNOWN
Verizon-Nachrichten VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japan YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
Weitere Informationen finden Sie in der Hilfe.
Beispiele
In den folgenden Beispielanfragen werden soziale Dimensionen verwendet:
Beispiele für Kanäle
- Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach den Diensten, in denen die Videos geteilt wurden
Beispiele für Rechteinhaber
- Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach den Diensten, in denen die Videos geteilt wurden
Zuschauerbindung
- elapsedVideoTimeRatio
- Diese Dimension gibt das Verhältnis des verstrichenen Teils des Videos zur Länge des Videos an. Mit Dimensionen und Messwerten zur Zuschauerbindung wird die Zuschauerbindung im Zeitverlauf gemessen. Die Dimension
elapsedVideoTimeRatio
ist die Zeitmessung. Der Wert0.4
gibt beispielsweise an, dass die entsprechenden Berichtsdaten nach 40 % des Videos Daten zur Nutzerbindung enthalten.
Die API gibt für jedes Video 100 Datenpunkte mit Verhältniswerten zwischen0.01
und1.0
zurück. Der Zeitpunkt, zu dem Daten während der Videowiedergabe gemessen werden, ist für jedes Video gleich verteilt. Das heißt, bei einem zweiminütigen Video beträgt das Intervall zwischen Datenpunkten 1,2 Sekunden. Bei einem zweistündigen Video beträgt das Intervall zwischen den Datenpunkten jedoch 72 Sekunden. Der Wert der Dimension bezeichnet das exklusive Ende des Intervalls. - audienceType (nur Filter)
- Der Dimensionswert gibt die Art der Zugriffe in den Berichtsdaten an.
Unterstützte Werte sind
ORGANIC
,AD_INSTREAM
undAD_INDISPLAY
. Informationen zu diesen Arten von Zugriffsquellen findest du in der YouTube-Hilfe.
Für den FilteraudienceType
sind Daten ab dem 25. September 2013 verfügbar. Die API gibt keine Daten für Abfragen zurück, die mit dem Filter versuchen, Daten aus früheren Zeiträumen abzurufen. Abfragen, für die der Filter nicht verwendet wird, funktionieren ab dem 1. Juli 2008.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen zur Zuschauerbindung verwendet:
Beispiele für Kanäle
- Zuschauerbindung: Messwerte zur Zuschauerbindung für ein Video
Beispiele für Rechteinhaber
- Zuschauerbindung: Messwerte zur Zuschauerbindung für ein Video
Anzeigenleistung
- Anzeigentyp
- Die Dimension
adType
wird in Berichten zur Anzeigenleistung verwendet und die angeforderten Messwerte basierend auf den Anzeigentypen zusammengefasst, die während der Videowiedergabe ausgeliefert wurden. In der folgenden Liste werden mögliche Dimensionswerte erläutert. Weitere Informationen zu YouTube-Anzeigenformaten finden Sie in der YouTube-Hilfe.
-
auctionBumperInstream
: Nicht überspringbare Videoanzeigen, die über Auktionen platziert werden und eine Länge von bis zu sechs Sekunden haben, bevor angesehen werden können. -
auctionDisplay
: Eine Rich Media- oder Bildanzeige, die entweder unten im Videoplayer als Overlay oder auf der Wiedergabeseite als Anzeigenblock im Format 300 x 250 eingeblendet wird. Wenn das Overlay ausgeführt wird, wird es nach einer bestimmten Zeit automatisch geschlossen und der Nutzer kann es auch schließen. Wenn ein Overlay und ein Banner zusammen angezeigt werden, wird jede Anzeige als separate Impression gezählt. -
auctionInstream
: Nicht überspringbare Videoanzeigen, die vor, während oder nach dem Hauptvideo eingeblendet werden. -
auctionTrueviewInslate
: Der Zuschauer wählt eine von mehreren Videoanzeigen aus, bevor er das Video startet. See the TrueView documentation for more information. -
auctionTrueviewInstream
: überspringbare Videoanzeigen, die vor oder während des Hauptvideos eingeblendet werden Weitere Informationen finden Sie in der TrueView-Dokumentation. -
auctionUnknown
: Eine Anzeige, die über die AdWords-Auktion gekauft, aber nicht in einen der anderen Anzeigentypen klassifiziert wurde. -
reservedBumperInstream
: Nicht überspringbare Videoanzeigen, die auf Reservierungsbasis verkauft werden und eine Länge von bis zu sechs Sekunden haben, bevor angesehen werden können. -
reservedClickToPlay
: Videoanzeige, auf die der Nutzer klicken muss, um die Wiedergabe zu starten. Eine Anzeigenimpression wird immer dann erfasst, wenn der Click-to-Play-Anzeigenblock erscheint, unabhängig davon, ob der Nutzer die Wiedergabe auslöst. Sie werden auf Reservierungsbasis verkauft. -
reservedDisplay
: Eine Rich Media- oder Bildanzeige, die entweder unten im Videoplayer als Overlay oder auf der Wiedergabeseite als Anzeigenblock im Format 300 x 250 eingeblendet wird. Wenn das Overlay ausgeführt wird, wird es nach einer bestimmten Zeit automatisch geschlossen und der Nutzer kann es auch schließen. Wenn ein Overlay und ein Banner zusammen angezeigt werden, wird jede Anzeige als separate Impression gezählt. -
reservedInstream
: Nicht überspringbare Videoanzeigen, die vor, während oder nach dem Hauptvideo eingeblendet werden. -
reservedInstreamSelect
-
reservedMasthead
: Eine große Anzeige, die Video- und Grafikelemente enthalten kann, die auf der Startseite angezeigt werden. -
reservedUnknown
: Eine Anzeige, die auf reservierter Basis verkauft wurde und nicht einem der anderen Anzeigentypen zugeordnet werden konnte. -
unknown
: Dieser Anzeigentyp konnte nicht klassifiziert werden.
-
Beispiele
In den folgenden Beispielberichten werden Messwerte zur Anzeigenleistung oder zum Umsatz abgerufen:
Beispiele für Kanäle
-
Umsatz/Anzeigen
- Messwerte zum Kanalumsatz und zur Anzeigenleistung
- Tägliche Umsatz- und Anzeigenleistungsmesswerte
- Länderspezifische Messwerte für Umsatz und Anzeigenleistung
- Top 10 – Videos mit dem höchsten Umsatz
- Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
-
Umsatz/Anzeigen
Beispiele für Rechteinhaber
-
Umsatz/Anzeigen
- Umsatz- und Anzeigenleistungsmesswerte für Inhalte, auf die Anspruch erhoben wurde
- Tägliche Umsatz- und Anzeigenleistungsmesswerte
- Länderspezifische Messwerte für Umsatz und Anzeigenleistung
- Top 10 – Videos mit dem höchsten Umsatz
- Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
-
Umsatz/Anzeigen
Playlists
- isCurated (nur Filter)
- Dieser Filter gibt an, dass die Anfrage Daten zu Videoaufrufen abruft, die im Zusammenhang mit einer Playlist aufgetreten sind. Dieser Filter ist für jeden Playlist-Bericht erforderlich. Sein Wert muss auf
1
gesetzt sein.
Beispiele
Für alle Beispielanfragen, die Playlist-Berichte abrufen, wird der Filter isCurated
verwendet.
Dimensionen des Rechteinhabers
Die folgenden Dimensionen werden nur für Rechteinhaberberichte unterstützt.
- Anspruchsstatus (wird nur in Berichten des Rechteinhabers verwendet)
- Mit dieser Dimension kannst du angeben, dass eine API-Antwort nur Messwerte für Inhalte enthalten soll, auf die Anspruch erhoben wurde. Der einzige gültige Wert für diese Dimension ist
claimed
. Wenn der Parameterfilters
die Abfrage aufclaimedStatus==claimed
einschränkt, ruft die API nur Daten für Inhalte ab, auf die Anspruch erhoben wurde. Die Tabelle in der Definition der DimensionuploaderType
enthält weitere Informationen zur Verwendung dieser Dimension.
- UploaderType (Kerndimension) (wird nur in Berichten zu Rechteinhabern verwendet)
- Mit dieser Dimension kannst du angeben, ob eine API-Antwort Messwerte für Inhalte enthalten soll, die vom angegebenen Rechteinhaber und/oder von Drittanbietern hochgeladen wurden, z. B. von Nutzern hochgeladene Videos. Gültige Werte sind
self
undthirdParty
. Dies ist eine Kerndimension und unterliegt der Richtlinie zur Einstellung von Produkten und Diensten.
Die folgende Tabelle enthält die unterstützten Kombinationen der DimensionenclaimedStatus
unduploaderType
, die beide im Parameterfilters
verwendet werden:
claimedStatus
WertuploaderType
WertBeschreibung [Nicht festgelegt] Sich selbst Ruft YouTube Analytics-Daten für Inhalte ab, auf die Anspruch erhoben wurde und auf die kein Anspruch erhoben wurde. Anspruch erhoben [Nicht festgelegt] Ruft Daten für Inhalte ab, auf die Anspruch erhoben wurde und die vom Rechteinhaber oder einem Dritten hochgeladen wurden. Anspruch erhoben Sich selbst Ruft Daten zu vom Rechteinhaber hochgeladenen Inhalten mit Ansprüchen ab. Anspruch erhoben Drittanbieter Ruft Daten für von Dritten hochgeladene Inhalte ab, auf die Anspruch erhoben wurde.
Beispiele
Viele der Beispiel-API-Anfragen für Berichte von Rechteinhabern verwenden eine unterstützte Kombination der Dimensionen claimedStatus
und uploaderType
, um Daten zu filtern.