Dimensions

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 id einer video-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 id einer playlist-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 id einer channel-Ressource. This is a core dimension and is subject to the Deprecation Policy.

Die Dimension channel wird 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.list der YouTube Analytics API abrufen. Wenn du den Filter group 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 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
  • 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

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) oder FR (Frankreich). Der Ländercode ZZ wird 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) oder US-TX (Texas). Der Provinzcode US-ZZ wird verwendet, um Messwerte zu melden, für die YouTube den zugehörigen US-Bundesstaat nicht identifizieren konnte. Wenn eine API-Anfrage province im Parameterwert dimensions enthält, muss die Anfrage auch die Daten auf die USA beschränken, indem country==US im Parameterwert filters enthalten 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:
Wert Beschreibung
002 Afrika
019 Amerika (Nordamerika, Lateinamerika, Südamerika und die Karibik)
142 Asien
150 Europa
009 Ozeanien
Diese Dimension kann nur zum Filtern von Daten verwendet werden. Wenn Sie diese Dimension verwenden möchten, setzen Sie den Wert des Parameters filters auf continent==REGION_CODE und geben Sie einen REGION_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 filters auf subContinent==REGION_CODE fest und geben Sie einen REGION_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-MM aufgeführt.

Hinweis: Wenn Ihre API-Abfrage die Dimension month verwendet, müssen die Parameter start-date und end-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:

  • 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
  • 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

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, als WATCH-, EMBEDDED- oder EXTERNAL_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
  • 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

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_STREAM Der angesehene Inhalt war ein YouTube-Livestream.
SHORTS Der angesehene Inhalt war ein YouTube Short.
STORY Der angesehene Inhalt war eine YouTube-Story.
VIDEO_ON_DEMAND Der angesehene Inhalt war ein YouTube-Video, das nicht unter einen 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 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
LIVE Die Daten in der Zeile beschreiben die Nutzeraktivität während einer Liveübertragung.
ON_DEMAND Die 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 SUBSCRIBED und UNSUBSCRIBED.

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 der subscribedStatus-Wert SUBSCRIBED und für einen anderen Aufruf der subscribedStatus-Wert UNSUBSCRIBED angezeigt.
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
CORE Nutzeraktivitä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 CORE enthalten.
GAMING Die Nutzeraktivität fand in YouTube Gaming statt.
KIDS Die Nutzeraktivität fand in YouTube Kids statt.
MUSIC Die Nutzeraktivität fand am oder nach dem 1. März 2021 auf YouTube Music statt. Daten vor dem 1. März 2021 sind in CORE enthalten. Echtzeitdaten werden nicht aufgezeichnet.
UNKNOWN Die 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 Feld insightTrafficSourceDetail die 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 Feld insightTrafficSourceDetail angegeben. 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 Feld insightTrafficSourceDetail die 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 Feld insightTrafficSourceDetail angegeben, ü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 Feld insightTrafficSourceDetail die 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 Feld insightTrafficSourceDetail angegeben.
  • YT_SEARCH: Die Videoaufrufe stammen aus YouTube-Suchergebnissen. Wenn Sie nach dieser Besucherquelle filtern, wird im Feld insightTrafficSourceDetail der 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 Feld insightTrafficSourceDetail das 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 Feld insightTrafficSourceDetail das 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 insightTrafficSourceDetail liefert.
  • 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 resultierten
    • mychannel – 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 die uploaded-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
  • 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

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 deviceType auch als Filter verwenden, um einen Betriebssystembericht auf Daten für einen bestimmten Gerätetyp zu beschränken.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_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 operatingSystem auch als Filter verwenden, um einen Bericht nach Gerätetyp auf ein bestimmtes Betriebssystem zu beschränken.
  • 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:

  • 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
  • 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

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-
This is a core dimension and is subject to the Deprecation Policy.
gender (Kerndimension)
Diese Dimension gibt das Geschlecht der angemeldeten Nutzer an, die den Berichtsdaten zugeordnet sind. Gültige Werte sind female, male und user_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)
  • 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)

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 ALLO
Ameba AMEBA
Android-E-Mail ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android-Messaging ANDROID_MMS
Dialogfeld „Inhalte über System teilen“ von Android ANDROID_SYSTEM_SHARE_DIALOG
BlackBerry Messenger BBM
Reaktion erhalten BLIND_REACT
Blogger BLOGGER
In Zwischenablage kopieren COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dialogfeld für direkte Systemaktivität DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
Angezeigter QR-Code DISPLAYED_QR_CODE
Dropbox DROPBOX
Einbetten EMBED
E-Mail MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Facebook-Seiten FACEBOOK_PAGES
Facebook-Teilen in Gruppe FACEBOOK_SHARE_TO_GROUP
Facebook Stories FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google App GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Notizen GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC-Nachricht HTC_MMS
m. Mein. n. IMO
Instagram INSTAGRAM
Instagram Stories INSTAGRAM_STORIES
Einladungslink (Android) INVITE_LINK_ANDROID
Einladungslink (iOS) INVITE_LINK_IOS
Mitbearbeiter für Playlist einladen INVITE_PLAYLIST_COLLABORATORS
Dialogfeld „Systemaktivität“ unter iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
KaiOS-Nachrichten KAIOS_MESSAGES
Kik KIK
LGE-E-Mail LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Maps-Kopieren/Einfügen MAPS_COPY_PASTE
„Live teilen“ in Google Meet MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Sonstiges OTHER
Pinterest PINTEREST
Quick Share QUICK_SHARE
Quick Share (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Remix REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
In der Fotogalerie des Geräts speichern SAVE_TO_DEVICE_PHOTOS
Ohne Werbeunterbrechungen teilen SHARE_AD_FREE
Mit Snapchat-Kamera teilen SHARE_TO_SNAPCHAT_CAMERA
Inhalte mit Kindern teilen SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Sony-Unterhaltungen SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Textnachricht TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Unbekannt UNKNOWN
Verizon Messages VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
Dialogfeld für Websystemaktivitäten WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! Japan YAHOO
YouTube-Community-Beitrag YOUTUBE_COMMUNITY_POST
YouTube-Community-Beitrag teilen YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
Vorschau in YouTube Music: Auf Snapchat geteilte Stories YTM_SHARE_TO_SNAPCHAT_PREVIEW
YouTube Shorts – Greenscreen YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
YouTube-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 elapsedVideoTimeRatio ist die Zeitmessung. Der Wert 0.4 gibt 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 von 0.01 bis 1.0 zurü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_INSTREAM und AD_INDISPLAY. In der YouTube-Hilfe findest du Erläuterungen zu diesen Zugriffsquellentypen.

Daten für den Filter audienceType sind 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

  • Beispiele für Rechteinhaber

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
UNKNOWN Der Nutzer hat die Umfrage nicht abgeschlossen.
DISLIKE_PERKS Der Nutzer war mit den Vorteilen der Mitgliedschaft nicht zufrieden.
PERKS_NOT_DELIVERED Der Nutzer hat angegeben, dass die versprochenen Vorteile für Mitglieder nicht erbracht wurden.
CANNOT_ACCESS_PERKS Der Nutzer konnte nicht auf die Vorteile zugreifen.
NO_LONGER_INTERESTED Der Nutzer ist nicht mehr an der Kanalmitgliedschaft interessiert.
FEEL_UNAPPRECIATED Der Nutzer hatte das Gefühl, dass er als Kanalmitglied nicht wertgeschätzt wird.
FINANCIAL_REASONS Der Nutzer hat aus finanziellen Gründen gekündigt.
JOIN_LIMITED_TIME Der Nutzer wollte nur für begrenzte Zeit Mitglied sein.
OTHER Der Nutzer hatte einen anderen Grund für die Kündigung.

Anzeigenleistung

adType
Die Dimension adType wird 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
  • 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

Dimensionen für Rechteinhaber

Die folgenden Dimensionen werden nur für Berichte für Rechteinhaber unterstützt.

Wichtig: Bei API-Anfragen zum Abrufen von Berichten für Rechteinhaber müssen die Daten nach einer der folgenden Dimensionen gefiltert werden:
  • video
  • channel
  • Eine unterstützte Kombination der Dimensionen claimedStatus und uploaderType, wie unten definiert.
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 Parameter filters die Abfrage auf claimedStatus==claimed beschränkt, ruft die API nur Daten für Inhalte ab, auf die Anspruch erhoben wurde. Die Tabelle in der Definition der Dimension uploaderType enthä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 self und thirdParty. 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 Dimensionen claimedStatus und uploaderType aufgeführt, die beide im Parameter filters verwendet werden:

claimedStatus Wert uploaderType Wert Beschreibung
[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.