Dimensions

In diesem Dokument werden die Dimensionen definiert, die von der YouTube Analytics API unterstützt werden. Diese API unterstützt gezielte Echtzeitabfragen zum Generieren benutzerdefinierter YouTube Analytics-Berichte.

Dimensionen sind gängige Kriterien für die Zusammenstellung von Daten, z. B. das Datum, an dem eine 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 Nutzeraktivitäten nach Zeit abrufen, wählen Sie den Zeitraum aus, für den Daten gemeldet werden sollen: Tag oder Monat. In jedem Bericht enthält jede Datenzeile eine eindeutige Kombination von Dimensionswerten.

Um einen Suchanfragenbericht abzurufen, kannst du die reports.query-Methode der YouTube Analytics API aufrufen. Verwende in deiner Anfrage den Parameter dimensions, um die Dimensionen anzugeben, die YouTube zur Berechnung der Messwerte in den Berichten verwendet.

Kerndimensionen

Die YouTube Analytics API unterliegt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen definiert ist. Dimensionen, die nicht zu den Kernmesswerten gehören, und Messwerte, die nicht zu den Kernwerten gehören, sind davon nicht betroffen. In den Definitionen auf dieser Seite wird jede Dimension, die eine Kerndimension ist, explizit als solche gekennzeichnet.

In der folgenden Liste sind die Kerndimensionen der API aufgeführt.

Weitere Informationen findest du 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 enthalten 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 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.

Bei 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, setzen Sie den Parameterwert filters auf continent==150.

Wichtig:In API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder mit einer der Dimensionen für Berichtentitäten oder mit einer unterstützten Kombination aus den 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 Berichten zum Kanal als auch in Berichten zu Rechteinhabern verwendet. Dimensionen, die nur als Filter verwendet werden können, werden ebenfalls identifiziert.

Ressourcen

Diese Dimensionen entsprechen den Ressourcen, die Kanäle und Rechteinhaber auf YouTube verwalten:

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 Wert des Parameters filters auf eine durch Kommas getrennte Liste der Video-, Playlist- oder Kanal-IDs, für die die API-Antwort gefiltert werden soll. Für den 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 Eigenschaft 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 der Eigenschaft id einer playlist-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 Eigenschaft id einer channel-Ressource. This is a core dimension and is subject to the Deprecation Policy.

Die Dimension channel wird häufig in Berichten zu Rechteinhabern verwendet, da in diesen Berichten normalerweise 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 Berichtentitäten verwendet:

  • Kanalbeispiele

    • Grundlegende Statistiken
      • Top 10 – Meistgesehene Videos eines Kanals
      • Top 10 – Klickraten von Anmerkungen für die meistgesehenen Videos eines Kanals
      • Statistiken für eine bestimmte Playlist
      • Top 10 – Meistgesehene Playlists eines Kanals
    • Zielregion
      • Top 10 – Meistgesehene Videos in einem bestimmten Land
      • Top 10 – Meistgesehene Videos in Europa

  • Beispiele für Rechteinhaber

    • Grundlegende Statistiken
      • Top 10 - Meistgesehene Videos für einen Rechteinhaber
      • Top 10 - Meistgesehene Videos für einen Rechteinhaber
      • Top 10 – Meistgesehene Videos für den Kanal eines Rechteinhabers
      • Top 10 – Klickraten von Anmerkungen für die meistgesehenen Videos eines Kanals
      • Top 10 – Meistgesehene Playlists für einen Rechteinhaber
    • Zielregion
      • Top 10 - Meistgesehene Videos in Europa für einen Rechteinhaber
      • Top 10 – Die meistgestarteten Playlists in den USA

Regionen

Diese Dimensionen geben eine geografische Region an, die mit Messwerten zur Nutzeraktivität, zur Anzeigenleistung oder zum geschätzten Umsatz verknüpft ist.

country (Kerndimension)
Das Land, das den Messwerten in der Berichtszeile zugeordnet ist. Der Dimensionswert ist ein aus zwei Buchstaben bestehender ISO 3166-1-Ländercode, z. B. US, CN (China) oder FR (Frankreich). Mit dem Ländercode ZZ werden Messwerte erfasst, bei denen YouTube das zugehörige Land nicht identifizieren konnte. This is a core dimension and is subject to the Deprecation Policy.
bundesland
US-Bundesstaat oder US-Territorium, das mit den Messwerten in der Berichtszeile verknüpft ist. Der Dimensionswert ist ein Code gemäß ISO 3166-2, der einen US-Bundesstaat oder den District of Columbia angibt, z.B. US-MI (Michigan) oder US-TX (Texas). Der Provinzcode US-ZZ wird für Berichte über Messwerte verwendet, bei denen YouTube den zugehörigen US-Bundesstaat nicht identifizieren konnte. Wenn eine API-Anfrage province im Parameterwert dimensions enthält, müssen die Daten in der Anfrage auch auf die USA beschränkt werden, indem country==US in den Parameterwert filters aufgenommen wird.

Hinweis:Bei dieser Dimension werden keine Werte gemäß ISO 3166-2 zur Identifizierung von Außengebieten in den USA unterstützt, da diese Gebiete auch eigene Ländercodes gemäß ISO 3166-1 haben. Außerdem werden nur Unterteilungen in andere Länder als die USA unterstützt.

Ort
Die geschätzte Stadt, die mit den Messwerten in der Berichtszeile verknüpft ist. Für diese Dimension sind Daten für Zeiträume ab dem 1. Januar 2022 verfügbar.
kontinent (nur Filter)
Statistischer Regionscode der Vereinten Nationen (UN). Die API unterstützt die folgenden Werte:
Werte
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, legen Sie den Wert des Parameters filters auf continent==REGION_CODE fest und geben Sie einen REGION_CODE-Wert aus der Liste oben an.
subContinent (nur Filter)
Ein statistischer Regionscode der UN, der eine geografische Unterregion identifiziert. In der Statistikabteilung der Vereinten Nationen sind Unterregionen sowie die Länder aufgeführt, denen die einzelnen Regionen zugeordnet sind.

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 Anzahl der Aufrufe (u. a.) für einen Kanal
    • Zielregion
      • Länderspezifische Messwerte zur Wiedergabezeit für Videos auf einem Kanal
      • Länderspezifische Messwerte zu Anmerkungen für Videos auf einem Kanal
      • Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.
      • Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Kanals
      • Top 10 – Die meistgestarteten Playlists in den USA
    • Wiedergabeort: Hier wird die Anzahl der täglichen Aufrufe und die Wiedergabezeit an verschiedenen Wiedergabeorten angezeigt.
    • Zugriffsquelle: Anzahl der Aufrufe und Wiedergabezeit über verschiedene 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 der Aufrufe (u. a.) für alle selbst hochgeladenen Videos
    • Zielregion
      • Länderspezifische Messwerte zur Wiedergabezeit für selbst hochgeladene Inhalte
      • Länderspezifische Messwerte zu Anmerkungen für selbst hochgeladene Inhalte
      • Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.
      • Länderspezifische Messwerte zur Wiedergabezeit für Playlists eines Rechteinhabers
      • Top 10 – Die meistgestarteten Playlists in den USA
    • Wiedergabeort: Hier wird die Anzahl der täglichen Aufrufe und die Wiedergabezeit an verschiedenen Wiedergabeorten angezeigt.
    • Demografische Merkmale: Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
    • Top-Videos: Top 10 – Meistgesehene Videos in Europa für einen Rechteinhaber
    • Umsatz/Anzeigenleistung: Länderspezifische Messwerte zu Umsatz und Anzeigenleistung

Zeiträume

Diese Dimensionen geben an, dass in einem Bericht Daten basierend auf einem Zeitraum aggregiert werden sollen, z. B. einem Tag, einer Woche oder einem Monat. Die Anfrageparameter startDate und endDate geben den Zeitraum an, für den der Bericht Daten enthält. Beachten Sie, dass der Bericht tatsächlich Daten bis zum letzten Tag zurückgibt, 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 um 00:00 Uhr Pacific Time (UTC-7 oder UTC-8) beginnt und am angegebenen Tag, Monat und Jahr um 23:59 Uhr Pacific Time endet. Aus diesem Grund beziehen sich Datumsangaben, an denen die Uhren an die Sommerzeit verschoben werden, auf einen 23-Stunden-Zeitraum und Datumsangaben, an denen die Uhren rückwärts ausgerichtet werden, auf einen 25-Stunden-Zeitraum.

Die Dimension month bezieht sich auf den Zeitraum, der um 00:00 Uhr Pacific Time (UTC-7 oder UTC-8) am ersten Tag des angegebenen Monats und Jahres beginnt.

Tag (Kerndimension)
Wenn Sie diese Dimension verwenden, werden die Daten im Bericht täglich zusammengefasst. Jede Zeile enthält die Daten eines Tages. Sie können andere Dimensionen verwenden, um die Daten noch weiter aufzuschlüsseln. Beispielsweise können in einem Zugriffsquellenbericht tägliche Wiedergabestatistiken zusammengefasst werden, die darauf basieren, wie Nutzer auf deine Videos zugreifen. 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 die Daten mithilfe anderer Filter noch weiter segmentieren. Im Bericht werden Datumsangaben im Format YYYY-MM aufgeführt.

Hinweis:Wenn in Ihrer API-Abfrage die Dimension month verwendet wird, müssen die Parameter start-date und end-date beide auf den ersten Tag des Monats festgelegt sein. 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 Videos eines Kanals
      • Tägliche Anmerkungsmesswerte für die Videos eines Kanals
      • Tägliche Playlist-Aufrufe für einen Kanal
    • Wiedergabeort: Hier wird die Anzahl der täglichen Aufrufe und die Wiedergabezeit an verschiedenen Wiedergabeorten angezeigt.
    • Zugriffsquelle: Hier werden tägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen angezeigt.
    • Gerät/Betriebssystem
      • Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
      • Tägliche Messwerte zu Betriebssystemen für Mobilgeräte
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen

  • Beispiele für Rechteinhaber

    • Zeitbasiert
      • Messwerte zur täglichen Wiedergabezeit von selbst hochgeladenen Inhalten
      • Messwerte für Anmerkungen zu Inhalten, auf die Anspruch erhoben wurde
      • Tägliche Playlist-Aufrufe für einen Rechteinhaber
    • Wiedergabeort: Hier wird die Anzahl der täglichen Aufrufe und die Wiedergabezeit an verschiedenen Wiedergabeorten angezeigt.
    • Zugriffsquelle: Hier werden tägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen angezeigt.
    • Gerät/Betriebssystem
      • Tägliche Messwerte für Gerätetypen für Videos mit Ansprüchen
      • Tägliche Betriebssystemmesswerte für Videos mit Ansprüchen, die auf Mobilgeräten angesehen werden
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen
    • Umsatz/Anzeigenleistung: Messwerte zum täglichen Umsatz und zur Anzeigenleistung

Wiedergabeorte

Diese Dimensionen geben Aufschluss über die Seite oder App, auf bzw. in der Nutzeraktivitäten aufgetreten sind.

insightPlaybackLocationType
Die Daten im Bericht werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der bzw. in der die Videowiedergaben stattgefunden haben. Mögliche Werte für diese Dimension sind:

  • BROWSE: Die Daten beschreiben Aufrufe, die auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion stattgefunden haben.

  • CHANNEL: Die Daten beschreiben die Aufrufe auf einer Kanalseite.

  • EMBEDDED: Die Daten beschreiben Aufrufe auf einer anderen Website oder in einer anderen Anwendung, in die das Video mit der Einbettung <iframe> oder <object> eingebettet wurde.

  • EXTERNAL_APP: Die Daten beschreiben Aufrufe, die in einer Drittanbieter-App stattfanden und in denen das Video nicht mit der Einbettung <iframe> oder <object> wiedergegeben wurde. Zum Beispiel werden Wiedergaben in Anwendungen, die die YouTube Android Player API verwenden, mithilfe dieses Werts kategorisiert.

  • MOBILE: Die Daten beschreiben Aufrufe auf der mobilen YouTube-Website oder über genehmigte YouTube API-Clients, einschließlich Mobilgeräten.

    Seit dem 10. September 2013 werden Wiedergaben in YouTube Analytics-Berichten nicht mehr als MOBILE-Wiedergaben kategorisiert. Unter Umständen bleibt der Wert in Berichten, da alte Daten immer noch unter diese Kategorie fallen. Nach diesem Datum werden mobile Wiedergaben jedoch als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben klassifiziert, abhängig von der Art der App, in der die Wiedergaben stattfinden.

  • SEARCH: Die Daten beschreiben Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.

  • WATCH: Die Daten beschreiben Aufrufe auf der YouTube-Wiedergabeseite des Videos oder in einer offiziellen YouTube-Anwendung wie der YouTube App für Android.

  • YT_OTHER: Die Daten beschreiben Aufrufe, die nicht anderweitig klassifiziert sind.

insightPlaybackLocationDetail
Die Daten werden basierend auf der Seite aggregiert, auf der sich der Player befindet. Dieser Bericht wird nur für Aufrufe in eingebetteten Playern unterstützt. Er gibt die eingebetteten Player an, die für ein bestimmtes Video die meisten Aufrufe generiert haben. Daher liefert er eine detailliertere Ansicht als der Bericht zum Wiedergabeort, da die URLs oder Anwendungen identifiziert werden, die zu den am häufigsten eingebetteten Playern gehören.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen für Wiedergabeort verwendet:

  • Kanalbeispiele

    • Wiedergabeort
      • Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Tägliche Aufrufzahlen und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
      • Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Tägliche Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten

  • Beispiele für Rechteinhaber

    • Wiedergabeort
      • Anzahl der Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Tägliche Aufrufzahlen und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
      • Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Tägliche Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten

Wiedergabedetails

creatorContentType
Diese Dimension identifiziert die Art der Inhalte, die mit den Messwerten zur Nutzeraktivität in der Datenzeile verknüpft sind. Für diese Dimension sind Daten für Zeiträume ab dem 1. Januar 2019 verfügbar.

In der folgenden Tabelle sind Dimensionswerte aufgeführt:
Werte
LIVE_STREAM Die angesehenen Inhalte waren YouTube-Livestreams.
SHORTS Die angesehenen Inhalte waren Kurzvideos auf YouTube.
STORY Der angesehene Inhalt war eine YouTube Story.
VIDEO_ON_DEMAND Der angesehene 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 den Aufrufen einer Liveübertragung zugeordnet sind. Für diese Dimension sind Daten für Zeiträume ab dem 1. April 2014 verfügbar.

In der folgenden Tabelle sind 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 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.

Beachten Sie, dass der Dimensionswert zum Zeitpunkt der Nutzeraktivität korrekt ist. Angenommen, ein Nutzer hat einen Kanal nicht abonniert und sieht sich eines seiner Videos an. Anschließend abonniert er den Kanal und sieht sich ein anderes Video an – alles am selben Tag. Im Bericht des Kanals wird angegeben, dass für eine Ansicht der subscribedStatus-Wert SUBSCRIBED und für eine Ansicht der subscribedStatus-Wert UNSUBSCRIBED ist.
youtubeProduct
Diese Dimension identifiziert den YouTube-Dienst, bei dem die Nutzeraktivität aufgetreten ist. Für diese Dimension stehen Daten 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 YouTube-Spezialanwendungen (YouTube Gaming, YouTube Kids oder YouTube Music) stattgefunden hat. Ausnahme: Nutzeraktivitäten, die vor dem 1. März 2021 in YouTube Music stattgefunden haben, sind in CORE enthalten.
GAMING Die Nutzeraktivität wurde in YouTube Gaming stattgefunden.
KIDS Die Nutzeraktivität ist in YouTube Kids aufgetreten.
MUSIC Die Nutzeraktivität in YouTube Music wurde am oder nach dem 1. März 2021 erfasst. In CORE sind Daten vor dem 1. März 2021 enthalten. Es werden keine Echtzeitdaten aufgezeichnet.
UNKNOWN Die Nutzeraktivität wurde vor dem 18. Juli 2015 erfasst.

Zugriffsquellen

insightTrafficSourceType
Die Daten im Bericht werden basierend auf dem Referrer-Typ zusammengefasst. Dieser gibt an, wie Nutzer auf das Video gelangt sind. Mögliche Werte für diese Dimension sind:
  • ADVERTISING: Der Zuschauer wurde durch eine Anzeige auf das Video verwiesen. Wenn Sie nach dieser Besucherquelle filtern, gibt das Feld insightTrafficSourceDetail die Art der Anzeige an.
  • ANNOTATION: Zuschauer sind durch Klicken auf eine Anmerkung in einem anderen Video zum Video gelangt.
  • CAMPAIGN_CARD: Aufrufe stammen von beanspruchten, von Nutzern hochgeladenen Videos, mit denen der Rechteinhaber die aufgerufenen Inhalte beworben hat. Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt.
  • END_SCREEN: Die Aufrufe wurden über den Abspann eines anderen Videos vermittelt.
  • EXT_URL: Die Videoaufrufe wurden über einen Link auf einer anderen Website weitergeleitet. Wenn du nach dieser Besucherquelle filterst, gibt das Feld insightTrafficSourceDetail die Webseite an. Diese Besucherquelle umfasst Verweise von Google-Suchergebnissen.
  • HASHTAGS: Aufrufe über VOD-Hashtagsseiten oder Pivot-Seiten mit Hashtags in Shorts.
  • LIVE_REDIRECT: Die Videoaufrufe wurden über Live Redirects verwiesen.
  • 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 sowohl direkte Zugriffe auf ein Video als auch Zugriffe über mobile Apps.
  • NOTIFICATION: Die Videoaufrufe wurden über eine E-Mail oder Benachrichtigung von YouTube weitergeleitet.
  • PLAYLIST: Die Videoaufrufe wurden erzielt, während das Video als Teil einer Playlist wiedergegeben wurde. Dazu gehören auch Zugriffe über die Playlist-Seite.
  • PRODUCT_PAGE: Die Videoaufrufe wurden über eine Produktseite weitergeleitet.
  • PROMOTED: Die Videoaufrufe wurden über eine kostenlose YouTube-Werbung wie die YouTube-Seite „Angesagte Videos“ generiert.
  • RELATED_VIDEO: Die Videoaufrufe wurden über einen ähnlichen Videoeintrag auf einer anderen Videowiedergabeseite weitergeleitet. Wenn du nach dieser Zugriffsquelle filterst, gibt das Feld insightTrafficSourceDetail die Video-ID für dieses Video an.
  • SHORTS: Der Zuschauer wurde durch vertikales Wischen vom vorherigen Video im Shorts-Format weitergeleitet.
  • SOUND_PAGE: Aufrufe über Pivot-Seiten für Sounds in Shorts.
  • SUBSCRIBER: Die Videoaufrufe wurden über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen generiert. Wenn Sie nach dieser Besucherquelle filtern, gibt das Feld insightTrafficSourceDetail die Feedelemente auf der Startseite oder eine andere Seite an, von der Aufrufe weitergeleitet wurden.
  • YT_CHANNEL: Die Videoaufrufe wurden auf einer Kanalseite ausgeführt. Wenn du nach dieser Besucherquelle filterst, gibt das Feld insightTrafficSourceDetail die Kanal-ID für diesen Kanal an.
  • YT_OTHER_PAGE: Die Videoaufrufe wurden über einen anderen Link als ein Suchergebnis oder ein Link zu einem ähnlichen Video auf einer YouTube-Seite weitergeleitet. Wenn du nach dieser Besucherquelle filterst, wird die Seite anhand des Felds insightTrafficSourceDetail identifiziert.
  • YT_SEARCH: Die Videoaufrufe wurden über die YouTube-Suchergebnisse weitergeleitet. Wenn du nach dieser Besucherquelle filterst, wird der Suchbegriff im Feld insightTrafficSourceDetail angegeben.
  • VIDEO_REMIXES: Die Videoaufrufe wurden über den Remix-Videolink im Shorts-Player weitergeleitet. Wenn du nach dieser Zugriffsquelle filterst, gibt das Feld insightTrafficSourceDetail das Video an, über das der Zuschauer verwiesen wurde.
insightTrafficSourceDetail
Die Daten im Bericht werden basierend auf den Verweis-URLs zusammengefasst, die für ein bestimmtes Video und einen bestimmten Zugriffsquellentyp die meisten Aufrufe generiert haben. In der folgenden Liste sind die Zugriffsquellen aufgeführt, für die dieser Bericht verfügbar ist. In der Liste werden für jede Besucherquelle die Informationen aufgeführt, die die Dimension insightTrafficSourceDetail bereitstellt.
  • ADVERTISING: Die Art 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-Anzeigen
    • Unkategorisierte YouTube-Werbung
    • Videowand
  • CAMPAIGN_CARD: Das Video mit Ansprüchen, das Zuschauer zu dem im Bericht angegebenen Video geführt hat.
  • END_SCREEN: Das Video, das die Zuschauer zu dem im Bericht angegebenen Video weitergeleitet hat.
  • 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 weitergeleitet wurde.
  • RELATED_VIDEO: Das ähnliche Video, über das Zuschauer zu dem im Bericht genannten Video gelangt sind.
  • SOUND_PAGE: Das Video, das zu den Aufrufen geführt hat.
  • SUBSCRIBER: Das Feedelement auf der Startseite oder die YouTube-Abofunktion, über die Zuschauer zum im Bericht genannten Video gelangt sind. Gültige Werte:
    • activity: Aufrufe über Elemente in Abo-Feeds auf der Startseite, die nicht aus Upload- und sozialen Kanalaktivitäten resultieren, wie positive Bewertungen, Favoriten, Bulletinbeiträge und Playlist-Hinzufügungen.
    • blogged: Aufrufe über Elemente in Abo-Feeds auf der Startseite, die über Links von Top-Blogs zustande kamen.
    • mychannel: Aufrufe über Elemente in anderen Feeds auf der Startseite. Dazu zählen unter anderem „Mag ich“-Bewertungen, der Wiedergabeverlauf und „Später ansehen“.
    • podcasts: Aufrufe über Elemente auf der Podcast-Landingpage.
    • sdig: Aufrufe aus E-Mails zu Abo-Updates.
    • uploaded: Aufrufe über die uploaded Elemente in den Abofeeds auf der Startseite.
    • /: Weitere Aufrufe über die YouTube-Startseite.
    • /my_subscriptions: Aufrufe über die YouTube-Seite Meine Abos der Nutzer.
  • 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 die Zuschauer zum Video geführt hat.
  • VIDEO_REMIXES: Das Video, das zu den Aufrufen geführt hat.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen für Besucherquellen verwendet:

  • Kanalbeispiele

    • Zugriffsquelle
      • 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-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
      • Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
      • Tägliche Playlist-Aufrufe und Wiedergabezeit über unterschiedliche Zugriffsquellen

  • Beispiele für Rechteinhaber

    • Zugriffsquelle
      • 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-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
      • Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
      • Tägliche Playlist-Aufrufe und Wiedergabezeit über unterschiedliche Zugriffsquellen

Geräte

deviceType
Diese Dimension gibt den physischen Formfaktor des Geräts an, auf dem der Aufruf erfolgte. 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 zu beschränken, dass er nur Daten für einen bestimmten Gerätetyp enthält.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Diese Dimension gibt das Softwaresystem des Geräts an, auf dem der Aufruf erfolgte. 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 zu Gerätetypen so zu beschrä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:

  • Kanalbeispiele

    • Gerät/Betriebssystem
      • Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
      • Tägliche Messwerte zu Betriebssystemen für Mobilgeräte
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen
      • Tägliche Messwerte zum Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
      • Tägliche Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten

  • Beispiele für Rechteinhaber

    • Gerät/Betriebssystem
      • Tägliche Messwerte für Gerätetypen für Videos mit Ansprüchen
      • Tägliche Betriebssystemmesswerte für Videos mit Ansprüchen, die auf Mobilgeräten angesehen werden
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen
      • Tägliche Messwerte zum Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
      • Tägliche Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten

Demografische Merkmale

Mit demografischen Dimensionen kannst du die Altersgruppe und die Geschlechterverteilung deiner Zuschauer besser nachvollziehen. In der YouTube-Hilfe findest du zusätzliche Informationen zu demografischen Daten in YouTube Analytics-Berichten.

ageGroup (Kerndimension)
Mit dieser Dimension wird die Altersgruppe der angemeldeten Nutzer identifiziert, die den Berichtsdaten zugeordnet 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.
Geschlecht (Kerndimension)
Diese Dimension ermittelt das Geschlecht der angemeldeten Nutzer, die den Berichtsdaten zugeordnet werden. 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 Playlist-Zuschauer in Kalifornien (Altersgruppe und Geschlecht)

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

Interaktionen und Teilen von Inhalten

sharingService (Kerndimension)
Diese Dimension identifiziert den Dienst, über den Videos geteilt wurden. Videos können auf YouTube (oder über den YouTube-Player) mithilfe der 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
Logo: 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
Logo: Cyworld CYWORLD
Eingraben DIGG
Dropbox DROPBOX
Embed EMBED
E-Mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook-Seiten FACEBOOK_PAGES
Fotka-Ziege FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
SMS senden GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC-SMS HTC_MMS
Google-Posteingang INBOX
Dialogfeld für iOS-Systemaktivität IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao-Talk) KAKAO
Kik KIK
LGE-E-Mail-Adresse LGE_EMAIL
Linie LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
Logo: mixi MIXI
Motorola-Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki ODNOKLASSNIKI
Sonstiges OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon 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 Dimensionen sozialer Netzwerke 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 zwischen dem verstrichenen Teil des Videos und der Länge des Videos an. Mit Dimensionen und Messwerten zur Zuschauerbindung wird die Zuschauerbindung im Zeitverlauf gemessen. Die Dimension elapsedVideoTimeRatio ist die Zeitmessung. Der Wert 0.4 bedeutet beispielsweise, dass in den entsprechenden Berichtsdaten Daten zur Nutzerbindung angezeigt werden, wenn 40 % des Videos bereits wiedergegeben wurden.

Die API gibt für jedes Video 100 Datenpunkte mit Verhältniswerten zwischen 0.01 und 1.0 zurück. Die Zeiten, zu denen die Daten während der Videowiedergaben 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 exklusive Ende des Intervalls an.
audienceType (nur Filter)
Der Dimensionswert gibt die Art des Traffics an, der mit den Berichtsdaten verknüpft ist. Unterstützte Werte sind ORGANIC, AD_INSTREAM und AD_INDISPLAY. Weitere Informationen zu diesen Arten von Zugriffsquellen findest du in der YouTube-Hilfe.

Hinweis: Daten für den Filter audienceType sind seit 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, können für alle Daten nach dem 1. Juli 2008 verwendet werden.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen zur Zuschauerbindung verwendet:

  • Kanalbeispiele

  • Beispiele für Rechteinhaber

Anzeigenleistung

adType
Die Dimension adType wird in Berichten zur Anzeigenleistung verwendet und fasst die angeforderten Messwerte basierend auf den Anzeigentypen, die während der Videowiedergabe geschaltet wurden, zusammen. In der folgenden Liste werden mögliche Dimensionswerte erläutert. Weitere Informationen zu den Werbeformaten auf YouTube findest du in der YouTube-Hilfe.
  • auctionBumperInstream: Über Auktionen platzierte nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos angesehen werden müssen.

  • auctionDisplay: Eine Rich Media- oder Bildanzeige, die entweder als Overlay unten im Videoplayer, als Anzeigenblock im Format 300 x 250 auf der Videowiedergabeseite oder als Kombination aus beidem erscheint. Wenn das Overlay ausgeführt wird, wird es nach einer gewissen Zeit automatisch geschlossen und auch der Nutzer kann das Overlay schließen. Wenn ein Overlay und ein Banner gemeinsam 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 Nutzer wählt aus den vor dem Video eingeblendeten Anzeigen eine von mehreren Videoanzeigen aus. 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.

  • auctionUnknown: Eine Anzeige, die über die AdWords-Auktion gekauft, aber keinem anderen Anzeigentyp zugeordnet wurde.

  • reservedBumperInstream: Nicht überspringbare Videoanzeigen, die auf Reservierungsbasis verkauft werden und bis zu sechs Sekunden dauern, bevor ein Video abgespielt werden kann.

  • 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 eingeblendet wird, unabhängig davon, ob der Nutzer eine Wiedergabe startet. Sie werden auf Reservierungsbasis verkauft.

  • reservedDisplay: Eine Rich Media- oder Bildanzeige, die entweder als Overlay unten im Videoplayer, als Anzeigenblock im Format 300 x 250 auf der Videowiedergabeseite oder als Kombination aus beidem erscheint. Wenn das Overlay ausgeführt wird, wird es nach einer gewissen Zeit automatisch geschlossen und auch der Nutzer kann das Overlay schließen. Wenn ein Overlay und ein Banner gemeinsam 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 reserviert wurde und nicht einem der anderen Anzeigentypen klassifiziert werden konnte.

  • unknown: Dieser Anzeigentyp konnte nicht klassifiziert werden.

Beispiele

Mit den folgenden Beispielberichten werden Messwerte zur Anzeigenleistung oder zum Umsatz abgerufen:

  • Kanalbeispiele

    • Umsatz/Anzeigen
      • Messwerte zum Kanalumsatz und zur Anzeigenleistung
      • Messwerte zum täglichen Umsatz und zur Anzeigenleistung
      • Länderspezifische Messwerte zu Umsatz und Anzeigenleistung
      • Top 10 – Videos mit dem höchsten Umsatz
      • Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen

  • Beispiele für Rechteinhaber

    • Umsatz/Anzeigen
      • Messwerte zum Umsatz und zur Anzeigenleistung für Inhalte, auf die Anspruch erhoben wurde
      • Messwerte zum täglichen Umsatz und zur Anzeigenleistung
      • Länderspezifische Messwerte zu Umsatz und Anzeigenleistung
      • Top 10 – Videos mit dem höchsten Umsatz
      • Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen

Playlists

isCurated (nur Filter)
Dieser Filter gibt an, dass die Anfrage Daten zu Videoaufrufen abruft, die im Kontext einer Playlist erfolgt sind. Dieser Filter ist für alle Playlist-Berichte erforderlich und der Wert muss auf 1 gesetzt sein.

Beispiele

Alle Beispielanfragen zum Abrufen von Playlist-Berichten verwenden den Filter isCurated.

Dimensionen des Rechteinhabers

Die folgenden Dimensionen werden nur für Rechteinhaberberichte unterstützt.

Wichtig:In API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten anhand einer der folgenden Dimensionen gefiltert werden:
  • video
  • channel
  • Eine unterstützte Kombination der Dimensionen claimedStatus und uploaderType (siehe unten).
claimStatus (wird nur in Berichten von Rechteinhabern 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 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) (wird nur in Berichten von 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 Dritten hochgeladen wurden, z. B. von Nutzern hochgeladene Videos. Gültige Werte sind self und thirdParty. Dies ist eine Kerndimension und unterliegt der Richtlinie zur Einstellung von Produkten und Diensten.

In der Tabelle unten sehen Sie die unterstützten Kombinationen für die Dimensionen claimedStatus und uploaderType, die beide im Parameter filters verwendet werden:

claimedStatus Wert uploaderType Wert Beschreibung
[Nicht festgelegt] Sich selbst Ruft YouTube Analytics-Daten für Inhalte ab, auf die Anspruch erhoben wurde oder auf die kein Anspruch erhoben wurde, die vom Rechteinhaber hochgeladen wurden.
Anspruch erhoben [Nicht festgelegt] Ruft Daten für Inhalte ab, auf die Anspruch erhoben wurde und die vom Rechteinhaber oder von Dritten hochgeladen wurden.
Anspruch erhoben Sich selbst Ruft Daten für Inhalte ab, auf die Anspruch erhoben wurde und die vom Rechteinhaber hochgeladen wurden.
Anspruch erhoben thirdParty Ruft Daten zu Inhalten ab, auf die Anspruch erhoben wurde und die von einem Dritten hochgeladen wurden.

Beispiele

Bei vielen der API-Beispielanfragen für Rechteinhaberberichte wird zum Filtern von Daten eine unterstützte Kombination aus den Dimensionen claimedStatus und uploaderType verwendet.