In diesem Dokument werden die Dimensionen definiert, die von der YouTube Analytics API unterstützt werden. Diese API unterstützt gezielte Echtzeitabfragen, über die benutzerdefinierte YouTube Analytics-Berichte erstellt werden können.
Dimensionen sind gängige Kriterien, die zum Aggregieren von Daten verwendet werden, z. B. das Datum, an dem die Nutzeraktivität stattgefunden hat, oder das Land, in dem sich die Nutzer befanden.
In jedem Abfragebericht werden die unterstützten Dimensionen angegeben. Wenn Sie beispielsweise die Nutzeraktivität nach Zeit abrufen, wählen Sie den Zeitraum aus, für den Daten erfasst werden sollen: Tag oder Monat. In jedem Bericht hat jede Datenzeile eine eindeutige Kombination von Dimensionswerten.
Wenn du einen Abfragebericht abrufen möchtest, rufe die Methode reports.query der YouTube Analytics API auf. Verwende in deiner Anfrage den Parameter dimensions, um die Dimensionen anzugeben, die YouTube zur Berechnung der Messwerte in den Berichten verwenden soll.
Kerndimensionen
Die YouTube Analytics API unterliegt der in den Nutzungsbedingungen definierten Richtlinie zur Einstellung von Produkten und Diensten. Nicht-Kerndimensionen und Nicht-Kernmesswerte unterliegen dieser Richtlinie jedoch nicht. In den Definitionen auf dieser Seite wird jede Kerndimension explizit als solche gekennzeichnet.
In der folgenden Liste sind die wichtigsten Dimensionen 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 Dataset vorhanden sein müssen. Sie beschränken eine API-Antwort auf Daten, die einem bestimmten Wert oder einer Gruppe von Werten entsprechen. Anstatt beispielsweise 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 Anfrageparameter filters die Dimensionswerte an, nach denen Sie Daten filtern möchten. Wenn Sie beispielsweise Messwerte zur Nutzeraktivität für Europa abrufen möchten, legen Sie für den Parameter filters den Wert continent==150 fest.
Wichtig: Bei API-Anfragen zum Abrufen von Berichten für Rechteinhaber müssen die Daten entweder mithilfe einer der Dimensionen für Berichtsentitäten oder mithilfe einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType gefiltert werden.
Abmessungen
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 in Kanal- als auch in Rechteinhaberberichten verwendet. Dimensionen, die nur als Filter verwendet werden können, werden ebenfalls gekennzeichnet.
Ressourcen
Diese Dimensionen entsprechen Ressourcen, die von Kanälen und Rechteinhabern auf YouTube verwaltet werden:
Hinweis: Mit 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 filters Parameterwert auf eine durch Kommas getrennte Liste der Video-, Playlist- oder Kanal-IDs, nach denen die API-Antwort gefiltert werden soll. Der Parameterwert kann bis zu 500 IDs enthalten.
- video (Kerndimension)
- Die ID eines YouTube-Videos. In der YouTube Data API ist dies der Wert des Attributs
ideinervideo-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 des Attributs
ideinerplaylist-Ressource. - channel (Kerndimension) (nur in Berichten für Rechteinhaber verwendet)
- Die ID eines YouTube-Kanals. In der YouTube Data API ist dies der Wert des Attributs
ideinerchannel-Ressource. This is a core dimension and is subject to the Deprecation Policy.
Die Dimensionchannelwird häufig in Berichten für Rechteinhaber verwendet, da 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.listder YouTube Analytics API abrufen. Wenn du den Filtergroupverwendest, 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 die Berichtsentität verwendet:
Kanalbeispiele
-
Grundlegende Statistiken
- Top 10 – Meistgesehene Videos eines Kanals
- Top 10 – Klickraten für Anmerkungen bei den am häufigsten angesehenen Videos eines Kanals
- Statistiken für eine bestimmte Playlist
- Top 10 – Meistgesehene Playlists für einen Kanal
-
Geografisch
- Top 10 – Meistgesehene Videos in einem bestimmten Land
- Top 10 – Meistgesehene Videos in Europa
-
Grundlegende Statistiken
Beispiele für Rechteinhaber
-
Grundlegende Statistiken
- Top 10 – Meistgesehene Videos eines Rechteinhabers
- Top 10 – Meistgesehene Videos eines Rechteinhabers
- Top 10 – Videos mit den meisten Aufrufen für den Kanal eines Rechteinhabers
- Top 10 – Klickraten für Anmerkungen bei den am häufigsten angesehenen Videos eines Kanals
- Top 10 – Playlists eines Rechteinhabers mit den meisten Wiedergaben
-
Geografisch
- Top 10 – Meistgesehene 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 zu Nutzeraktivitäten, Anzeigenleistung oder geschätztem Umsatz verknüpft ist.
- Land (Hauptdimension)
- Das Land, das den Messwerten in der Berichtszeile zugeordnet ist. Der Dimensionswert ist ein zweistelliger ISO-3166-1-Ländercode, z. B.
US,CN(China) oderFR(Frankreich). Der LändercodeZZwird für Messwerte verwendet, bei denen YouTube das zugehörige Land nicht ermitteln konnte. This is a core dimension and is subject to the Deprecation Policy. - bundesland
- Der US-Bundesstaat oder das US-Territorium, der bzw. 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 identifiziert, z.B.
US-MI(Michigan) oderUS-TX(Texas). Der ProvinzcodeUS-ZZwird verwendet, um Messwerte zu melden, für die YouTube den zugehörigen US-Bundesstaat nicht identifizieren konnte. Wenn eine API-Anfrageprovinceim Parameterwertdimensionsenthält, muss die Anfrage auch die Daten auf die USA beschränken, indemcountry==USim Parameterwertfiltersenthalten ist.Hinweis: Diese Dimension unterstützt keine ISO 3166-2-Werte, die US-amerikanische Außengebiete identifizieren, da diese Gebiete auch eigene ISO 3166-1-Ländercodes haben. Außerdem werden keine Unterteilungen von Ländern außerhalb der USA unterstützt.
- dma
- Die dreistellige ID, die Nielsen verwendet, um die Designated Market Area (DMA) zu identifizieren, die mit den in der Datenzeile beschriebenen Wiedergabeereignissen verknüpft ist.
- Ort
- Die geschätzte Stadt, die den Messwerten in der Berichtszeile zugeordnet ist. Daten für diese Dimension sind ab dem 1. Januar 2022 verfügbar.
- continent (nur Filter)
-
Ein statistischer Regionscode der Vereinten Nationen (UN). Die API unterstützt die folgenden Werte:
Diese Dimension kann nur zum Filtern von Daten verwendet werden. Wenn Sie diese Dimension verwenden möchten, setzen Sie den Wert des ParametersWert Beschreibung 002Afrika 019Amerika (Nordamerika, Lateinamerika, Südamerika und die Karibik) 142Asien 150Europa 009Ozeanien filtersaufcontinent==REGION_CODEund geben Sie einenREGION_CODE-Wert aus der Tabelle an. - subContinent (nur Filter)
-
Ein UN-Statistikregionscode, der eine geografische Unterregion identifiziert. Die Statistikabteilung der Vereinten Nationen listet die Unterregionen sowie die Länder auf, die sie den einzelnen Regionen zuordnet.
Diese Dimension kann nur zum Filtern von Daten verwendet werden. Wenn Sie diese Dimension verwenden möchten, legen Sie den Wert des Parameters
filtersaufsubContinent==REGION_CODEfest und geben Sie einenREGION_CODE-Wert aus der UN-Liste an.
Beispiele
In den folgenden Beispielanfragen werden geografische Dimensionen oder Filter verwendet:
Kanalbeispiele
- Grundlegende Statistiken: länderspezifische Aufrufzahlen (und mehr) für einen Kanal
-
Geografisch
- Länderspezifische Messwerte zur Wiedergabezeit für die Videos eines Kanals
- Länderspezifische Anmerkungsmesswerte für die Videos eines Kanals
- Provinzspezifische Messwerte für US-Bundesstaaten und Washington, D.C.
- Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Kanals
- Top 10 – Am häufigsten gestartete Playlists in den USA
- Wiedergabeort: Tägliche Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
- Zugriffsquelle: Aufrufzahlen 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: länderspezifische Anzahl an Aufrufen (und mehr) für alle selbst hochgeladenen Videos
-
Geografisch
- Länderspezifische Messwerte zur Wiedergabezeit 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 Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
- Demografische Merkmale: Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
- Top-Videos: Top 10 der meistgesehenen Videos eines Rechteinhabers in Europa
- Umsatz/Anzeigenleistung: länderspezifische Umsatz- und Anzeigenleistungsmesswerte
Zeiträume
Diese Dimensionen geben an, dass in einem Bericht Daten basierend auf einem Zeitraum wie einem Tag, einer Woche oder einem Monat aggregiert werden sollen. Mit den Anfrageparametern startDate und endDate wird der Zeitraum angegeben, für den der Bericht Daten enthält. Der Bericht enthält Daten bis zum letzten Tag, für den 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, der am angegebenen Tag, Monat und Jahr um 00:00 Uhr Pacific Time (UTC-7 oder UTC-8) beginnt und um 23:59 Uhr Pacific Time endet. Daher umfassen Tage, an denen die Uhren für die Sommerzeit vorgestellt werden, einen Zeitraum von 23 Stunden und Tage, an denen die Uhren zurückgestellt werden, einen Zeitraum von 25 Stunden.
Die Dimension Monat bezieht sich auf den Zeitraum, der am ersten Tag des angegebenen Monats und Jahres um 00:00 Uhr Pacific Time (UTC-7 oder UTC-8) beginnt.
- Tag (Kerndimension)
- Wenn Sie diese Dimension verwenden, werden die Daten im Bericht täglich aggregiert und jede Zeile enthält Daten für einen Tag. Sie können die Daten mithilfe anderer Dimensionen noch weiter aufschlüsseln. In einem Bericht zu Zugriffsquellen können beispielsweise tägliche Wiedergabestatistiken basierend darauf zusammengefasst werden, wie Nutzer zu deinen Videos gelangen. This is a core dimension and is subject to the Deprecation Policy.
- month (Kerndimension)
- Die Daten im Bericht werden nach Kalendermonat zusammengefasst. Wie bei täglichen Berichten können Sie auch hier andere Filter verwenden, um die Daten noch weiter zu segmentieren. Im Bericht werden die Daten im Format
YYYY-MMaufgeführt.
Hinweis: Wenn Ihre API-Abfrage die Dimensionmonthverwendet, müssen die Parameterstart-dateundend-dateauf 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:
Kanalbeispiele
-
Zeitbasiert
- Tägliche Messwerte zur Wiedergabezeit für die Videos eines Kanals
- Tägliche Messwerte zu Anmerkungen für die Videos eines Kanals
- Tägliche Playlist-Aufrufe für einen Kanal
- Wiedergabeort: Tägliche Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
- Traffic-Quelle: Tägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Traffic-Quellen
-
Gerät/Betriebssystem
- Tägliche Messwerte nach Gerätetyp für das Android-Betriebssystem
- Tägliche Betriebssystemmesswerte für Mobilgeräte
- Tägliche Messwerte zu Betriebssystem und Gerätetyp
-
Zeitbasiert
Beispiele für Rechteinhaber
-
Zeitbasiert
- Tägliche Messwerte zur Wiedergabezeit für selbst hochgeladene Inhalte
- Anmerkungsmesswerte für Inhalte mit Ansprüchen
- Tägliche Playlist-Aufrufe für einen Rechteinhaber
- Wiedergabeort: Tägliche Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
- Zugriffsquelle: Tägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen
-
Gerät/Betriebssystem
- Tägliche Messwerte nach Gerätetyp für Videos mit Ansprüchen
- Tägliche Betriebssystemmesswerte für Videos mit Ansprüchen, die auf Mobilgeräten angesehen wurden
- Tägliche Messwerte zu Betriebssystem und Gerätetyp
- Umsatz/Anzeigenleistung: Messwerte für den täglichen Umsatz und die Anzeigenleistung
-
Zeitbasiert
Wiedergabeorte
Diese Dimensionen liefern Informationen zur Seite oder Anwendung, auf der die Nutzeraktivität stattgefunden hat.
- insightPlaybackLocationType
-
Die Daten im Bericht werden nach dem Typ der Seite oder App zusammengefasst, auf der die Videowiedergabe erfolgt ist. Mögliche Werte für diese Dimension:
-
BROWSE: Die Daten beschreiben Aufrufe, die auf der YouTube-Startseite oder dem Startbildschirm, im Abofeed des Nutzers oder über eine andere YouTube-Funktion zur Auswahl von Inhalten erfolgt sind. -
CHANNEL: Die Daten beschreiben Aufrufe, die auf einer Kanalseite erfolgt sind. -
EMBEDDED: Die Daten beschreiben Aufrufe, die auf einer anderen Website oder in einer anderen App erfolgten, in der das Video über eine<iframe>- oder<object>-Einbettung eingebettet war. -
EXTERNAL_APP: Die Daten beschreiben Aufrufe, die in einer Drittanbieter-App erfolgt sind, in der das Video mit einer anderen Methode als einer<iframe>- oder<object>-Einbettung abgespielt wurde. Beispielsweise werden Wiedergaben in Anwendungen, die die YouTube Android Player API verwenden, mit diesem Wert kategorisiert. -
IMMERSIVE_LIVE_FEED: Die Daten beschreiben Aufrufe, die über den vertikalen Livefeed erfolgt sind. -
MOBILE: Die Daten beschreiben Aufrufe, die auf der mobilen Website von YouTube oder auf genehmigten YouTube API-Clients, einschließlich Mobilgeräten, erfolgt sind.Seit dem 10. September 2013 werden Wiedergaben in YouTube Analytics-Berichten nicht mehr als
MOBILE-Wiedergaben kategorisiert. Der Wert kann in Berichten enthalten sein, da Altdaten weiterhin in diese Kategorie fallen. Nach diesem Datum werden Wiedergaben auf Mobilgeräten je nach Art der Anwendung, in der sie erfolgen, alsWATCH-,EMBEDDED- oderEXTERNAL_APP-Wiedergaben klassifiziert. -
SEARCH: Die Daten beschreiben Aufrufe, die direkt auf der YouTube-Suchergebnisseite stattgefunden haben. -
SHORTS_FEED: Die Daten beschreiben Aufrufe, die über den YouTube Shorts-Feed generiert wurden. -
WATCH: Die Daten beschreiben Aufrufe, die auf der YouTube-Wiedergabeseite des Videos oder in einer offiziellen YouTube-Anwendung wie der YouTube App für Android erfolgt sind. -
YT_OTHER: Die Daten beschreiben Aufrufe, die nicht anderweitig klassifiziert sind.
-
- insightPlaybackLocationDetail
- Die Daten werden basierend auf der Seite zusammengefasst, auf der sich der Player befindet. Dieser Bericht wird nur für Aufrufe in eingebetteten Playern unterstützt. Er zeigt die eingebetteten Player, die die meisten Aufrufe für ein bestimmtes Video generiert haben. Er bietet also eine detailliertere Ansicht als der Bericht „Wiedergabeorte“, da er die URLs oder Anwendungen identifiziert, die mit den am häufigsten eingebetteten Playern verknüpft sind.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen für den Wiedergabeort verwendet:
Kanalbeispiele
-
Ort der Wiedergabe
- Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
- Tägliche Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
- Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
- Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
- Tägliche Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
-
Ort der Wiedergabe
Beispiele für Rechteinhaber
-
Ort der Wiedergabe
- Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
- Tägliche Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
- Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
- Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
- Tägliche Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Wiedergabeorten
-
Ort der Wiedergabe
Wiedergabedetails
- creatorContentType
- Diese Dimension gibt den Typ des Inhalts an, der mit den Messwerten für Nutzeraktivitäten in der Datenzeile verknüpft ist. Daten für diese Dimension sind für Zeiträume ab dem 1. Januar 2019 verfügbar.
In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Wert Beschreibung LIVE_STREAMDer angesehene Inhalt war ein YouTube-Livestream. SHORTSDer angesehene Inhalt war ein YouTube Short. STORYDer angesehene Inhalt war eine YouTube-Story. VIDEO_ON_DEMANDDer angesehene Inhalt war ein YouTube-Video, das nicht unter einen der anderen Dimensionswerte fällt. UNSPECIFIEDDer Inhaltstyp des angesehenen Inhalts ist unbekannt. - liveOrOnDemand
- Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in der Datenzeile mit Aufrufen einer Liveübertragung verknüpft sind. Daten für diese Dimension sind für Zeiträume ab dem 1. April 2014 verfügbar.
In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Wert Beschreibung LIVEDie Daten in der Zeile beschreiben die Nutzeraktivität während einer Liveübertragung. ON_DEMANDDie Daten der Zeile beschreiben Nutzeraktivitäten, die nicht während einer Liveübertragung stattgefunden haben. - subscribedStatus
- 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
SUBSCRIBEDundUNSUBSCRIBED.
Der Dimensionswert ist zum Zeitpunkt der Nutzeraktivität korrekt. Angenommen, ein Nutzer hat einen Kanal nicht abonniert und sieht sich ein Video dieses Kanals an. Anschließend abonniert er den Kanal und sieht sich ein weiteres Video an – alles am selben Tag. Im Bericht des Kanals wird für einen Aufruf dersubscribedStatus-WertSUBSCRIBEDund für einen anderen Aufruf dersubscribedStatus-WertUNSUBSCRIBEDangezeigt. - youtubeProduct
- Diese Dimension gibt den YouTube-Dienst an, in dem die Nutzeraktivität stattgefunden hat. Daten für diese Dimension sind ab dem 18. Juli 2015 verfügbar.
In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Wert Beschreibung CORENutzeraktivitäten, die nicht in einer der speziellen YouTube-Anwendungen (YouTube Gaming, YouTube Kids oder YouTube Music) stattgefunden haben. Ausnahme: Nutzeraktivitäten, die vor dem 1. März 2021 in YouTube Music stattgefunden haben, sind in COREenthalten.GAMINGDie Nutzeraktivität fand in YouTube Gaming statt. KIDSDie Nutzeraktivität fand in YouTube Kids statt. MUSICDie Nutzeraktivität fand am oder nach dem 1. März 2021 auf YouTube Music statt. Daten vor dem 1. März 2021 sind in COREenthalten. Echtzeitdaten werden nicht aufgezeichnet.UNKNOWNDie Nutzeraktivität fand vor dem 18. Juli 2015 statt.
Zugriffsquellen
- insightTrafficSourceType
- Die Daten im Bericht werden nach Referrer-Typ aggregiert. Dieser beschreibt, wie Nutzer zum Video gelangt sind. Mögliche Werte für diese Dimension sind:
ADVERTISING: Der Zuschauer wurde über eine Anzeige auf das Video verwiesen. Wenn Sie nach dieser Traffic-Quelle filtern, wird im FeldinsightTrafficSourceDetaildie Art der Anzeige angegeben.ANNOTATION: Zuschauer haben das Video über eine Anmerkung in einem anderen Video aufgerufen.CAMPAIGN_CARD: Aufrufe von von Nutzern hochgeladenen Videos mit Ansprüchen, die der Rechteinhaber zur Bewerbung der angesehenen Inhalte verwendet hat. Diese Zugriffsquelle wird nur für Berichte für Rechteinhaber unterstützt.END_SCREEN: Die Aufrufe wurden über den Abspann eines anderen Videos generiert.EXT_URL: Die Videoaufrufe wurden über einen Link auf einer anderen Website generiert. Wenn Sie nach dieser Zugriffsquelle filtern, wird die Webseite im FeldinsightTrafficSourceDetailangegeben. Diese Besucherquelle umfasst Verweise aus Google-Suchergebnissen.HASHTAGS: Aufrufe, die von VOD-Hashtag-Seiten oder Shorts-Hashtag-Musik-Linkseiten stammen.LIVE_REDIRECT: Die Videoaufrufe wurden über Live Redirects weitergeleitet.NO_LINK_EMBEDDED: Das Video war auf einer anderen Website eingebettet, als es angesehen wurde.NO_LINK_OTHER: YouTube konnte keinen Referrer für den Traffic identifizieren. Diese Kategorie umfasst direkte Zugriffe auf ein Video sowie Zugriffe über mobile Apps.NOTIFICATION: Die Videoaufrufe stammen aus einer E-Mail oder Benachrichtigung von YouTube.PLAYLIST: Die Videoaufrufe erfolgten, während das Video als Teil einer Playlist abgespielt wurde. Dazu gehören auch Zugriffe über die Playlist-Seite.PRODUCT_PAGE: Die Videoaufrufe wurden von einer Produktseite weitergeleitet.PROMOTED: Die Videoaufrufe stammen aus einer unbezahlten YouTube-Werbeaktion, z. B. von der YouTube-Seite „Spotlight-Videos“.RELATED_VIDEO: Die Videoaufrufe stammen aus einer Liste ähnlicher Videos auf der Wiedergabeseite eines anderen Videos. Wenn du nach dieser Zugriffsquelle filterst, wird im FeldinsightTrafficSourceDetaildie Video-ID für dieses Video angegeben.SHORTS: Der Zuschauer wurde durch vertikales Wischen vom vorherigen Video im Shorts-Player weitergeleitet.SOUND_PAGE: Aufrufe, die über die Musik-Linkseiten von Shorts generiert wurden.SUBSCRIBER: Die Videoaufrufe stammen aus Feeds auf der YouTube-Startseite oder aus YouTube-Abofunktionen. Wenn du nach dieser Zugriffsquelle filterst, wird im FeldinsightTrafficSourceDetailangegeben, über welche Elemente im Startseitenfeed oder über welche andere Seite die Aufrufe generiert wurden.YT_CHANNEL: Die Videoaufrufe erfolgten auf einer Kanalseite. Wenn Sie nach dieser Zugriffsquelle filtern, wird im FeldinsightTrafficSourceDetaildie Kanal-ID für diesen Kanal angegeben.YT_OTHER_PAGE: Die Videoaufrufe wurden über einen Link generiert, der kein Suchergebnis oder Link zu einem ähnlichen Video auf einer YouTube-Seite war. Wenn Sie nach dieser Zugriffsquelle filtern, wird die Seite im FeldinsightTrafficSourceDetailangegeben.YT_SEARCH: Die Videoaufrufe stammen aus YouTube-Suchergebnissen. Wenn Sie nach dieser Besucherquelle filtern, wird im FeldinsightTrafficSourceDetailder Suchbegriff angegeben.VIDEO_REMIXES: Die Videoaufrufe stammen über den Link zum Remix-Video im Shorts-Player. Wenn du nach dieser Traffic-Quelle filterst, wird im FeldinsightTrafficSourceDetaildas Video angegeben, von dem der Zuschauer weitergeleitet wurde.WATCH_WITH– Die Videoaufrufe stammen aus einem Creator-Kommentar / „Watch With“-Stream. Wenn du nach dieser Traffic-Quelle filterst, wird im FeldinsightTrafficSourceDetaildas Video angegeben, von dem der Zuschauer weitergeleitet wurde.
- insightTrafficSourceDetail
- Die Daten im Bericht werden anhand der Verweise aggregiert, die die meisten Aufrufe für ein bestimmtes Video und einen bestimmten Typ von Zugriffsquelle generiert haben. In der folgenden Liste sind die Zugriffsquellen aufgeführt, für die dieser Bericht verfügbar ist. Für jede Besucherquelle werden die Informationen aufgeführt, die die Dimension
insightTrafficSourceDetailliefert.ADVERTISING: Der Typ der Anzeige, 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
- Unkategorisierte YouTube-Werbung
- Videowand
CAMPAIGN_CARD: Das Video mit Anspruch, über das Zuschauer zum Video im Bericht gelangt sind.END_SCREEN: Das Video, über das Zuschauer zu dem im Bericht aufgeführten Video gelangt sind.EXT_URL: Die Website, über die die Zuschauer zum Video gelangt sind.HASHTAGS: Das Hashtag, das zu den Aufrufen geführt hat.NOTIFICATION: Die E‑Mail oder Benachrichtigung, über die der Traffic generiert wurde.RELATED_VIDEO: Das ähnliche Video, über das Zuschauer zum Video im Bericht gelangt sind.SOUND_PAGE: Das Video, das zu den Aufrufen geführt hat.SUBSCRIBER: Das Element im Startseitenfeed oder die YouTube-Abofunktion, über die Zuschauer zum Video im Bericht gelangt sind. Gültige Werte sind:activity: Aufrufe über die Elemente in den Abofeeds auf der Startseite, die aus Kanalaktivitäten resultierten, die keine Uploads oder Aktivitäten in sozialen Netzwerken waren, einschließlich „Mag ich“-Bewertungen, Favoriten, Bulletin-Beiträgen und Playlist-Hinzufügungen.blogged: Aufrufe über die Elemente in den Abo-Feeds auf der Startseite, die aus Links von Top-Blogs resultiertenmychannel– Aufrufe über Elemente in anderen Feeds, die auf der Startseite aufgeführt sind, z. B. „Mag ich“, „Wiedergabeverlauf“ und „Später ansehen“.podcasts: Aufrufe über Elemente auf der Landingpage für Podcasts.sdig: Aufrufe über E-Mails mit Abo-Updates.uploaded: Aufrufe über dieuploaded-Elemente in den Abofeeds auf der Startseite./: Andere Aufrufe, die von der YouTube-Startseite stammen./my_subscriptions: Aufrufe, die von der Seite Meine Abos der Nutzer auf YouTube stammen.
YT_CHANNEL: Die Kanalseite, auf der Zuschauer das Video angesehen haben.YT_OTHER_PAGE: Die YouTube-Seite, von der Zuschauer zum Video weitergeleitet wurden.YT_SEARCH: Der Suchbegriff, über den Zuschauer auf das Video gestoßen sind.VIDEO_REMIXES: Das Video, das zu den Aufrufen geführt hat.WATCH_WITH: Das Video, das zu den Aufrufen geführt hat.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen für Traffic-Quellen verwendet:
Kanalbeispiele
-
Traffic-Quelle
- Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen in einem Land
- Tägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen
- Top 10 – YouTube-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
- Top 10 – Google Suche-Suchbegriffe, die die meisten Zugriffe auf ein Video generieren
- Anzahl der Aufrufe und Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen in einem Land
- Tägliche Anzahl der Aufrufe und Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen
-
Traffic-Quelle
Beispiele für Rechteinhaber
-
Traffic-Quelle
- Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen
- Tägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen
- Top 10 – YouTube-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
- Top 10 – Google Suche-Suchbegriffe, die die meisten Zugriffe auf ein Video generieren
- Anzahl der Aufrufe und Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen in einem Land
- Tägliche Anzahl der Aufrufe und Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen
-
Traffic-Quelle
Geräte
- deviceType
- 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
deviceTypeauch als Filter verwenden, um einen Betriebssystembericht auf Daten für einen bestimmten Gerätetyp zu beschränken.DESKTOPGAME_CONSOLEMOBILETABLETTVAUTOMOTIVEWEARABLEUNKNOWN_PLATFORM
- operatingSystem
- Diese Dimension gibt das Software-System des Geräts an, auf dem die Wiedergabe erfolgt ist.
In der folgenden Liste sind die Betriebssysteme aufgeführt, für die die API Daten zurückgibt. Sie können
operatingSystemauch als Filter verwenden, um einen Bericht nach Gerätetyp auf ein bestimmtes Betriebssystem zu beschränken.ANDROIDBADABLACKBERRYCHROMECASTDOCOMOFIREFOXHIPTOPIOSKAIOSLINUXMACINTOSHMEEGONINTENDO_3DSOTHERPLAYSTATIONPLAYSTATION_VITAREALMEDIASMART_TVSYMBIANTIZENVIDAAWEBOSWIIWINDOWSWINDOWS_MOBILEXBOX
Beispiele
In den folgenden Beispielanfragen werden Gerätedimensionen verwendet:
Kanalbeispiele
-
Gerät/Betriebssystem
- Tägliche Messwerte nach Gerätetyp für das Android-Betriebssystem
- Tägliche Betriebssystemmesswerte für Mobilgeräte
- Tägliche Messwerte zu Betriebssystem und Gerätetyp
- Tägliche Messwerte nach Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
- Tägliche Betriebssystemmesswerte für Playlistaufrufe auf Mobilgeräten
-
Gerät/Betriebssystem
Beispiele für Rechteinhaber
-
Gerät/Betriebssystem
- Tägliche Messwerte nach Gerätetyp für Videos mit Ansprüchen
- Tägliche Betriebssystemmesswerte für Videos mit Ansprüchen, die auf Mobilgeräten angesehen wurden
- Tägliche Messwerte zu Betriebssystem und Gerätetyp
- Tägliche Messwerte nach Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
- Tägliche Betriebssystemmesswerte für Playlistaufrufe auf Mobilgeräten
-
Gerät/Betriebssystem
Demografische Merkmale
Anhand der demografischen Dimensionen können Sie die Altersgruppe und Geschlechterverteilung Ihrer Zielgruppe 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. Dazu gehören auch Nutzer, die laut Schätzung von YouTube unter 18 Jahre alt 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 den Berichtsdaten zugeordnet sind.
Gültige Werte sind
female,maleunduser_specified. This is a core dimension and is subject to the Deprecation Policy.
Beispiele
In den folgenden Beispielanfragen werden demografische Dimensionen verwendet:
Kanalbeispiele
-
Demografische Merkmale
- Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
- Demografische Merkmale der Zuschauer von Playlists 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 Zuschauer von Playlists in Kalifornien (Altersgruppe und Geschlecht)
-
Demografische Merkmale
Interaktion und Teilen von Inhalten
- sharingService (Kerndimension)
- Diese Dimension gibt den Dienst an, über den 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.
In der folgenden Tabelle sind gültige Dimensionswerte aufgeführt:
Dienst, mit dem geteilt wurde API-Wert Allo ALLOAmeba AMEBAAndroid-E-Mail ANDROID_EMAILAndroid Messenger ANDROID_MESSENGERAndroid-Messaging ANDROID_MMSDialogfeld „Inhalte über System teilen“ von Android ANDROID_SYSTEM_SHARE_DIALOGBlackBerry Messenger BBMReaktion erhalten BLIND_REACTBlogger BLOGGERIn Zwischenablage kopieren COPY_PASTECyworld CYWORLDDigg DIGGDialogfeld für direkte Systemaktivität DIRECT_SYSTEM_ACTIVITY_DIALOGDiscord DISCORDAngezeigter QR-Code DISPLAYED_QR_CODEDropbox DROPBOXEinbetten EMBEDE-Mail MAILFacebook FACEBOOKFacebook Lite FACEBOOK_LITEFacebook Messenger FACEBOOK_MESSENGERFacebook-Seiten FACEBOOK_PAGESFacebook-Teilen in Gruppe FACEBOOK_SHARE_TO_GROUPFacebook Stories FACEBOOK_STORIESFotka FOTKAGmail GMAILgoo GOOGoogle App GOOGLE_APPGoogle Chat GOOGLE_CHATGoogle Chrome GOOGLE_CHROMEGoogle Inbox INBOXGoogle Notizen GOOGLE_KEEPGoogle+ GOOGLEPLUSGo SMS GO_SMSGroupMe GROUPMEHangouts HANGOUTShi5 HI5HTC-Nachricht HTC_MMSm. Mein. n. IMOInstagram INSTAGRAMInstagram Stories INSTAGRAM_STORIESEinladungslink (Android) INVITE_LINK_ANDROIDEinladungslink (iOS) INVITE_LINK_IOSMitbearbeiter für Playlist einladen INVITE_PLAYLIST_COLLABORATORSDialogfeld „Systemaktivität“ unter iOS IOS_SYSTEM_ACTIVITY_DIALOGKAKAO Story KAKAO_STORYKakao (Kakao Talk) KAKAOKaiOS-Nachrichten KAIOS_MESSAGESKik KIKLGE-E-Mail LGE_EMAILLine LINELinkedIn LINKEDINLiveJournal LIVEJOURNALMaps-Kopieren/Einfügen MAPS_COPY_PASTE„Live teilen“ in Google Meet MEET_LIVE_SHARINGmenéame MENEAMEmixi MIXIMotorola Messaging MOTOROLA_MESSAGINGMyspace MYSPACENaver NAVERNearby Share NEARBY_SHARENUjij NUJIJOdnoklassniki (Одноклассники) ODNOKLASSNIKISonstiges OTHERPinterest PINTERESTQuick Share QUICK_SHAREQuick Share (Samsung) QUICK_SHARE_SAMSUNGRakuten (楽天市場) RAKUTENreddit REDDITRemix REMIXSamsung Messages SAMSUNG_MESSAGESSamsung Notes SAMSUNG_NOTESIn der Fotogalerie des Geräts speichern SAVE_TO_DEVICE_PHOTOSOhne Werbeunterbrechungen teilen SHARE_AD_FREEMit Snapchat-Kamera teilen SHARE_TO_SNAPCHAT_CAMERAInhalte mit Kindern teilen SHARE_WITH_KIDSSkype SKYPESkyrock SKYBLOGSnapchat SNAPCHATSony-Unterhaltungen SONY_CONVERSATIONSStumbleUpon STUMBLEUPONTelegram TELEGRAMTextnachricht TEXT_MESSAGETuenti TUENTItumblr. TUMBLRTwitter TWITTERUnbekannt UNKNOWNVerizon Messages VERIZON_MMSViber VIBERVKontakte (ВКонтакте) VKONTAKTEDialogfeld für Websystemaktivitäten WEB_SYSTEM_ACTIVITY_DIALOGWeChat WECHATWeibo WEIBOWhatsApp WHATS_APPWhatsApp Business WHATS_APP_BUSINESSWykop WYKOPYahoo! Japan YAHOOYouTube-Community-Beitrag YOUTUBE_COMMUNITY_POSTYouTube-Community-Beitrag teilen YOUTUBE_COMMUNITY_REPOSTYouTube Gaming YOUTUBE_GAMINGYouTube Kids YOUTUBE_KIDSYouTube Mango YOUTUBE_MANGOYouTube Music YOUTUBE_MUSICVorschau in YouTube Music: Auf Snapchat geteilte Stories YTM_SHARE_TO_SNAPCHAT_PREVIEWYouTube Shorts – Greenscreen YOUTUBE_SHORTS_GREEN_SCREENYouTube TV YOUTUBE_TVYouTube-Inhalte gemeinsam ansehen YOUTUBE_WATCH_WITH_FRIENDS
Weitere Informationen finden Sie in der Hilfe.
Beispiele
In den folgenden Beispielanfragen werden soziale Dimensionen verwendet:
Kanalbeispiele
- Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach Dienst, über den Videos geteilt wurden
Beispiele für Rechteinhaber
- Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach Dienst, über den Videos geteilt wurden
Zuschauerbindung
- elapsedVideoTimeRatio
- Diese Dimension gibt das Verhältnis des bereits abgespielten Teils des Videos zur Gesamtlänge des Videos an. Dimensionen und Messwerte zur Bindung werden verwendet, um die Zuschauerbindung im Zeitverlauf zu messen. Die Dimension
elapsedVideoTimeRatioist die Zeitmessung. Der Wert0.4gibt beispielsweise an, dass die entsprechenden Berichtsdaten die Wiedergabetreue nach 40 % des Videos zeigen.
Die API gibt für jedes Video 100 Datenpunkte mit Verhältniswerten von0.01bis1.0zurück. Die Zeitpunkte, zu denen Daten während der Videowiedergabe gemessen werden, sind für jedes Video gleichmäßig verteilt. Das bedeutet, dass bei einem zweiminütigen Video das Intervall zwischen den Datenpunkten 1,2 Sekunden beträgt. Bei einem zweistündigen Video beträgt das Intervall zwischen den Datenpunkten jedoch 72 Sekunden. Der Wert der Dimension gibt das ausgeschlossene Ende des Intervalls an. - audienceType (nur Filter)
- Der Dimensionswert gibt den Typ des Traffics an, der mit den Berichtsdaten verknüpft ist.
Unterstützte Werte sind
ORGANIC,AD_INSTREAMundAD_INDISPLAY. In der YouTube-Hilfe findest du Erläuterungen zu diesen Zugriffsquellentypen.
Daten für den FilteraudienceTypesind ab dem 25. September 2013 verfügbar. 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, die den Filter nicht verwenden, funktionieren für jedes Datum nach dem 1. Juli 2008.
Beispiele
In den folgenden Beispielanfragen werden Dimensionen zur Zuschauerbindung verwendet:
Kanalbeispiele
- Zuschauerbindung: Messwerte zur Zuschauerbindung für ein Video
Beispiele für Rechteinhaber
- Zuschauerbindung: Messwerte zur Zuschauerbindung für ein Video
Livestreaming
- livestreamPosition
- Diese Dimension gibt eine bestimmte Minute während eines Live-Videostreams an. Die Berichtsmesswerte geben an, wie viele Nutzer den Livestream zu diesem Zeitpunkt angesehen haben.
Kündigungen von Mitgliedschaften
- membershipsCancellationSurveyReason
- Die Anzahl der Umfragen, die von YouTube-Nutzern ausgefüllt wurden, die ihre Kanalmitgliedschaft für den angegebenen Kanal im Berichtszeitraum gekündigt haben. In der folgenden Tabelle sind gültige Dimensionswerte aufgeführt:
API-Wert Erklärung UNKNOWNDer Nutzer hat die Umfrage nicht abgeschlossen. DISLIKE_PERKSDer Nutzer war mit den Vorteilen der Mitgliedschaft nicht zufrieden. PERKS_NOT_DELIVEREDDer Nutzer hat angegeben, dass die versprochenen Vorteile für Mitglieder nicht erbracht wurden. CANNOT_ACCESS_PERKSDer Nutzer konnte nicht auf die Vorteile zugreifen. NO_LONGER_INTERESTEDDer Nutzer ist nicht mehr an der Kanalmitgliedschaft interessiert. FEEL_UNAPPRECIATEDDer Nutzer hatte das Gefühl, dass er als Kanalmitglied nicht wertgeschätzt wird. FINANCIAL_REASONSDer Nutzer hat aus finanziellen Gründen gekündigt. JOIN_LIMITED_TIMEDer Nutzer wollte nur für begrenzte Zeit Mitglied sein. OTHERDer Nutzer hatte einen anderen Grund für die Kündigung.
Anzeigenleistung
- adType
- Die Dimension
adTypewird in Berichten zur Anzeigenleistung verwendet. Die angeforderten Messwerte werden basierend auf den Anzeigentypen aggregiert, die während der Videowiedergabe ausgeliefert wurden. In der folgenden Liste werden mögliche Dimensionswerte erläutert. Weitere Informationen zu YouTube-Anzeigenformaten findest du in der YouTube-Hilfe.
-
auctionBumperInstream: Nicht überspringbare Videoanzeigen, die über eine Auktion platziert werden und bis zu 6 Sekunden lang sind. Sie müssen angesehen werden, bevor ein Video abgespielt werden kann. -
auctionDisplay: Eine Rich Media- oder Bildanzeige, die entweder als Overlay am unteren Rand des Videoplayers, als Anzeigenblock im Format 300 × 250 auf der Wiedergabeseite des Videos oder als Kombination aus beidem eingeblendet wird. Das Overlay wird nach einer bestimmten Zeit automatisch geschlossen. Der Nutzer kann es aber auch selbst 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, die vor einem Video angezeigt werden. See the TrueView documentation for more information. -
auctionTrueviewInstream: Überspringbare Videoanzeigen, die vor oder während des Hauptvideos abgespielt werden. Weitere Informationen finden Sie in der TrueView. -
auctionUnknown: Eine Anzeige, die über die AdWords-Auktion gekauft, aber keinem der anderen Anzeigentypen zugeordnet wurde. -
reservedBumperInstream: Nicht überspringbare Videoanzeigen mit einer Länge von bis zu 6 Sekunden, die auf Reservierungsbasis verkauft werden und angesehen werden müssen, bevor ein Video abgespielt werden kann. -
reservedClickToPlay: Eine Videoanzeige, die der Nutzer anklicken muss, um die Wiedergabe zu starten. Eine Anzeigenimpression wird jedes Mal erfasst, wenn der Click-to-Play-Anzeigenblock angezeigt wird, unabhängig davon, ob der Nutzer die Wiedergabe startet. Diese werden auf Reservierungsbasis verkauft. -
reservedDisplay: Eine Rich Media- oder Bildanzeige, die entweder als Overlay am unteren Rand des Videoplayers, als Anzeigenblock im Format 300 × 250 auf der Wiedergabeseite des Videos oder als Kombination aus beidem eingeblendet wird. Das Overlay wird nach einer bestimmten Zeit automatisch geschlossen. Der Nutzer kann es aber auch selbst 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 und auf der Startseite erscheint. -
reservedUnknown: Eine Anzeige, die auf Reservierungsbasis verkauft wurde und keinem der anderen Anzeigentypen zugeordnet werden konnte. -
unknown: YouTube konnte diesen Anzeigentyp nicht klassifizieren.
-
Beispiele
In den folgenden Beispielberichten werden Messwerte zur Anzeigenleistung oder zum Umsatz abgerufen:
Kanalbeispiele
-
Umsatz/Anzeigen
- Messwerte zu Kanaleinnahmen und Anzeigenleistung
- Tägliche Umsatz- und Anzeigenleistungsmesswerte
- Länderspezifische Umsatz- und Anzeigenleistungsmesswerte
- 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 Umsatz- und Anzeigenleistungsmesswerte
- Top 10 – Videos mit dem höchsten Umsatz
- Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
-
Umsatz/Anzeigen
Dimensionen für Rechteinhaber
Die folgenden Dimensionen werden nur für Berichte für Rechteinhaber unterstützt.
- claimedStatus (nur in Berichten für Rechteinhaber verwendet)
- Mit dieser Dimension kannst du angeben, dass eine API-Antwort nur Messwerte für beanspruchte Inhalte enthalten soll. Der einzige gültige Wert für diese Dimension ist
claimed. Wenn der Parameterfiltersdie Abfrage aufclaimedStatus==claimedbeschränkt, ruft die API nur Daten für Inhalte ab, auf die Anspruch erhoben wurde. Die Tabelle in der Definition der DimensionuploaderTypeenthält weitere Informationen zur Verwendung dieser Dimension.
- uploaderType (Kerndimension) (nur in Berichten für Rechteinhaber verwendet)
- Mit dieser Dimension kannst du angeben, ob eine API-Antwort Messwerte für Inhalte enthalten soll, die vom angegebenen Rechteinhaber hochgeladen wurden, und/oder für Inhalte, die von Dritten hochgeladen wurden, z. B. von Nutzern hochgeladene Videos. Gültige Werte sind
selfundthirdParty. Dies ist eine Kerndimension, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegt.
In der folgenden Tabelle sind die unterstützten Kombinationen für die DimensionenclaimedStatusunduploaderTypeaufgeführt, die beide im Parameterfiltersverwendet werden:
claimedStatusWertuploaderTypeWertBeschreibung [Nicht festgelegt] Sich selbst Ruft YouTube Analytics-Daten für Inhalte ab, die vom Rechteinhaber hochgeladen wurden und auf die er Anspruch erhebt oder nicht. Anspruch erhoben [Nicht festgelegt] Ruft Daten für Inhalte mit Ansprüchen ab, die vom Rechteinhaber oder von einem Dritten hochgeladen wurden. Anspruch erhoben Sich selbst Ruft Daten für beanspruchte Inhalte ab, die vom Rechteinhaber hochgeladen wurden. Anspruch erhoben thirdParty Ruft Daten für Inhalte mit Ansprüchen ab, die von einem Dritten hochgeladen wurden.
Beispiele
In vielen der Beispiel-API-Anfragen für Berichte für Rechteinhaber wird eine unterstützte Kombination der Dimensionen claimedStatus und uploaderType verwendet, um Daten zu filtern.