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 von benutzerdefinierten YouTube Analytics-Berichten.

Dimensionen sind allgemeine Kriterien, mit denen Daten zusammengefasst werden, 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 aufgeführt. Wenn Sie beispielsweise Nutzeraktivitäten nach Zeit abrufen, wählen Sie den Zeitraum aus, für den Daten erfasst werden: Tag oder Monat. In jedem Bericht hat jede Datenzeile eine eindeutige Kombination von Dimensionswerten.

Wenn du einen Abfragebericht abrufen möchtest, rufe die reports.query-Methode der YouTube Analytics API auf. Verwenden Sie in Ihrer Anfrage den Parameter dimensions, um die Dimensionen anzugeben, die YouTube zur Berechnung von Messwerten in den Berichten verwendet.

Kerndimensionen

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

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 Datensatz vorhanden sein müssen. Daher wird eine API-Antwort so eingeschränkt, dass sie nur Daten enthält, 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.

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

Wichtig:In API-Anfragen zum Abrufen von Rechteinhaberberichten müssen die Daten entweder nach einer der Dimensionen für Berichtentitäten oder 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 für Rechteinhaber 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. Dazu setzt du den Parameterwert 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 Property 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 Property 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 Property 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 dort normalerweise Daten für mehrere Kanäle zusammengefasst werden.
Gruppe (nur Filter)
Die ID einer YouTube Analytics-Gruppe. Du kannst diesen Wert mit der groups.list-Methode der YouTube Analytics API abrufen. Wenn du den group-Filter verwendest, enthält die API-Antwort Daten für alle Videos, Playlists oder Kanäle in dieser Gruppe.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen oder Filter für Berichtsentitäten verwendet:

  • Kanalbeispiele

    • Grundlegende Statistiken
      • Top 10 – Meistgesehene Videos eines Kanals
      • Top 10 – Klickraten für Anmerkungen zu den am häufigsten angesehenen Videos eines Kanals
      • Statistiken für eine bestimmte Playlist
      • Top 10 – Meistgesehene Playlists eines Kanals
    • Standort
      • 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 für Anmerkungen zu den am häufigsten angesehenen Videos eines Kanals
      • Top 10 – Meistgesehene Playlists für einen Rechteinhaber
    • Standort
      • Top 10 - Meistgesehene Videos in Europa für einen Rechteinhaber
      • Top 10 – Playlists mit den meisten Aufrufen in den USA

Regionen

Diese Dimensionen beziehen sich auf eine geografische Region, 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 -Territorium, das mit den Messwerten in der Berichtszeile verknüpft ist. Der Dimensionswert ist ein ISO 3166-2-Code für einen US-Bundesstaat oder den District of Columbia, z.B. US-MI (Michigan) oder US-TX (Texas). Mit dem Provinzcode US-ZZ werden Berichte zu Messwerten erstellt, bei denen YouTube den zugehörigen US-Bundesstaat nicht identifizieren konnte. Wenn eine API-Anfrage province im Parameterwert dimensions enthält, muss die Anfrage die Daten auf die USA beschränken, indem country==US in den Parameterwert filters aufgenommen wird.

Hinweis:Für diese Dimension werden keine Werte gemäß ISO 3166-2 zur Identifizierung von Außengebieten der USA unterstützt, da diese Gebiete auch eigene ISO 3166-1-Ländercodes haben. Eine Unterteilung in andere Länder als die USA ist ebenfalls nicht möglich.

Ort
Die geschätzte Stadt, die mit den Messwerten in der Berichtszeile verknüpft ist. Daten für diese Dimension sind für Zeiträume ab dem 1. Januar 2022 verfügbar.
Kontinent (nur Filter)
Ein statistischer Regionscode der Vereinten Nationen (UN). Die API unterstützt die folgenden Werte:
Werte
002 Afrika
019 Nord- und Südamerika (Nordamerika, Lateinamerika, Südamerika und die Karibik)
142 Asien
150 Europa
009 Ozeanien
Diese Dimension kann nur zum Filtern von Daten verwendet werden. Wenn du diese Dimension verwenden möchtest, setze den Wert des filters-Parameters auf continent==REGION_CODE und gib dabei einen REGION_CODE-Wert aus der obigen Liste an.
subContinent (nur Filter)
Ein statistischer Regionscode der UN, der eine geografische Teilregion identifiziert. In der Statistikabteilung der Vereinten Nationen sind die Unterregionen aufgeführt sowie die Länder, mit denen die einzelnen Regionen verknüpft sind.

Diese Dimension kann nur zum Filtern von Daten verwendet werden. Wenn du diese Dimension verwenden möchtest, setze den Wert des filters-Parameters auf subContinent==REGION_CODE und gib dabei 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 weitere Daten für einen Kanal
    • Standort
      • Länderspezifische Messwerte zur Wiedergabezeit für Videos eines Kanals
      • Länderspezifische Messwerte für Anmerkungen zu 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 – Playlists mit den meisten Aufrufen in den USA
    • Wiedergabeort: Hier siehst du die Anzahl der Aufrufe pro Tag und die Wiedergabezeit an verschiedenen Wiedergabeorten.
    • 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 für alle selbst hochgeladenen Videos
    • Standort
      • 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 die Playlists eines Rechteinhabers
      • Top 10 – Playlists mit den meisten Aufrufen in den USA
    • Wiedergabeort: Hier siehst du die Anzahl der Aufrufe pro Tag und die Wiedergabezeit an verschiedenen Wiedergabeorten.
    • Demografische Merkmale: Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
    • Top-Videos: Top 10 – die am häufigsten angesehenen 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. 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 angegeben.

Wichtig:Alle Daten beziehen sich auf den Zeitraum, der um 00:00 Uhr Pacific Time (UTC-7 oder UTC-8) beginnt und um 23:59 Uhr Pacific Time am angegebenen Tag, Monat und Jahr endet. Aus diesem Grund stellen Datumsangaben, an denen die Uhren an die Sommerzeit angepasst werden, einen 23-Stunden-Zeitraum und Datumsangaben, an denen die Uhren rückwärts angepasst werden, einen 25-Stunden-Zeitraum dar.

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 und jede Zeile enthält die Daten für einen Tag. Sie können andere Dimensionen verwenden, um die Daten noch weiter aufzuschlüsseln. In einem Zugriffsquellenbericht können beispielsweise tägliche Statistiken zu den Aufrufen 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 Kalendermonaten 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 angegeben.

Hinweis: Wenn in Ihrer API-Abfrage die Dimension month verwendet wird, müssen die Parameter start-date und end-date 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 Messwerte zu Anmerkungen zu Videos eines Kanals
      • Tägliche Playlistaufrufe für einen Kanal
    • Wiedergabeort: Hier siehst du die Anzahl der Aufrufe pro Tag und die Wiedergabezeit an verschiedenen Wiedergabeorten.
    • Zugriffsquelle: Die Anzahl der Aufrufe pro Tag und die Wiedergabezeit über verschiedene Zugriffsquellen
    • Gerät/Betriebssystem
      • Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
      • Tägliche Betriebssystemmesswerte für Mobilgeräte
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen

  • Beispiele für Rechteinhaber

    • Zeitbasiert
      • Messwerte zur täglichen Wiedergabezeit für selbst hochgeladene Inhalte
      • Messwerte für Anmerkungen zu Inhalten, auf die Anspruch erhoben wurde
      • Tägliche Playlistaufrufe für einen Rechteinhaber
    • Wiedergabeort: Hier siehst du die Anzahl der Aufrufe pro Tag und die Wiedergabezeit an verschiedenen Wiedergabeorten.
    • Zugriffsquelle: Die Anzahl der Aufrufe pro Tag und die Wiedergabezeit über verschiedene Zugriffsquellen
    • Gerät/Betriebssystem
      • Tägliche Messwerte für Gerätetypen für Videos, auf die Anspruch erhoben wurde
      • Tägliche Betriebssystemmesswerte für Videos, auf die Anspruch erhoben wurde, die auf Mobilgeräten angesehen werden
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen
    • Umsatz und Anzeigenleistung: Tägliche Messwerte zum Umsatz und zur Anzeigenleistung

Wiedergabeorte

Diese Dimensionen liefern Informationen zur Seite oder App, auf der die Nutzeraktivität stattgefunden hat.

insightPlaybackLocationType
Die Daten im Bericht werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der bzw. in der die Videowiedergaben erfolgt sind. 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 erfolgt sind.

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

  • EMBEDDED: Die Daten beschreiben die Aufrufe, die auf einer anderen Website oder in einer anderen Anwendung erfolgt sind, wo das Video über eine <iframe>- oder <object>-Einbettung eingebettet wurde.

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

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

    Seit dem 10. September 2013 werden Wiedergaben in YouTube Analytics-Berichten nicht mehr als MOBILE-Wiedergaben kategorisiert. Der Wert wird möglicherweise weiterhin in Berichten verwendet, da alte Daten noch unter diese Kategorie fallen. Danach werden sie auf einem Mobilgerät als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben eingestuft. Das richtet sich nach der Art der App, in der sie wiedergegeben werden.

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

  • WATCH: Die Daten beschreiben die Aufrufe auf der YouTube-Wiedergabeseite des Videos oder in einer offiziellen YouTube-App, z. B. der YouTube Android-App.

  • 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 ermittelt die eingebetteten Player, die die meisten Aufrufe für ein bestimmtes Video generiert haben. Daher bietet er eine detailliertere Ansicht als der Bericht zum Wiedergabeort, da er die URLs oder Anwendungen identifiziert, die den Top-Playern zugeordnet sind.

Beispiele

In den folgenden Beispielanfragen werden die Dimensionen für den 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
      • Anzahl der 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
      • Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
      • Tägliche Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten

Wiedergabedetails

creatorContentType
Diese Dimension gibt die Art der Inhalte an, 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 zu Aufrufen einer Liveübertragung gehören. Für diese Dimension sind Daten ab dem 1. April 2014 verfügbar.

In der folgenden Tabelle sind Dimensionswerte aufgeführt:
Werte
LIVE Die Daten der Zeile beschreiben Nutzeraktivitäten 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 Zuschauern zugeordnet werden, 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 noch keinen Kanal abonniert und sieht sich eines der Videos dieses Kanals an. Anschließend abonniert er den Kanal und sieht sich ein weiteres Video am selben Tag an. Im Bericht des Kanals wird angegeben, dass für einen Aufruf der subscribedStatus-Wert SUBSCRIBED und für den subscribedStatus der Wert UNSUBSCRIBED ist.
youtubeProduct
Diese Dimension gibt den YouTube-Dienst an, bei dem die Nutzeraktivität stattgefunden hat. Für diese Dimension sind Daten ab dem 18. Juli 2015 verfügbar.

In der folgenden Tabelle sind Dimensionswerte aufgeführt:
Werte
CORE Die Nutzeraktivität, die nicht in einer der speziellen YouTube-Anwendungen erfolgt ist (YouTube Gaming, YouTube Kids oder YouTube Music). Ausnahme: Nutzeraktivitäten in YouTube Music vor dem 1. März 2021 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 in YouTube Music wurde am oder nach dem 1. März 2021 erfasst. 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 basierend auf dem Referrer-URL-Typ zusammengefasst. Dieser gibt an, wie Nutzer auf das Video gestoßen 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 an, um welche Art von Werbung es sich handelt.
  • ANNOTATION: Zuschauer wurden 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, wird die Webseite anhand des Felds insightTrafficSourceDetail identifiziert. Diese Besucherquelle enthält Verweise aus Google-Suchergebnissen.
  • HASHTAGS: Aufrufe über VOD-Hashtags-Seiten oder Pivot-Seiten mit Kurzvideos.
  • LIVE_REDIRECT: Die Videoaufrufe wurden über Live Redirects weitergeleitet.
  • 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 ermittelt. 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 abgespielt 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“ erzielt.
  • RELATED_VIDEO: Die Videoaufrufe wurden über einen Eintrag mit ähnlichen Videos auf einer anderen Videowiedergabeseite weitergeleitet. Wenn du nach dieser Zugriffsquelle filterst, gibt das Feld insightTrafficSourceDetail die Video-ID für das Video an.
  • SHORTS: Der Zuschauer wurde durch vertikales Wischen vom vorherigen Video im Shorts-Format auf den Zuschauer weitergeleitet.
  • SOUND_PAGE: Aufrufe über Pivot-Seiten für Audioinhalte in Kurzvideos.
  • SUBSCRIBER: Die Videoaufrufe stammen aus Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen. 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 erfolgten auf einer Kanalseite. Wenn du nach dieser Besucherquelle filterst, gibt das Feld insightTrafficSourceDetail die Kanal-ID des Kanals an.
  • YT_OTHER_PAGE: Die Videoaufrufe wurden über einen anderen Link als ein Suchergebnis oder einen 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 stammen aus den YouTube-Suchergebnissen. Wenn du nach dieser Besucherquelle filterst, wird der Suchbegriff im Feld insightTrafficSourceDetail angegeben.
  • VIDEO_REMIXES: Die Videoaufrufe wurden über den Link zu den Remix-Videos im Shorts-Player generiert. Wenn du nach dieser Zugriffsquelle filterst, gibt das Feld insightTrafficSourceDetail das Video an, über das der Zuschauer weitergeleitet wurde.
insightTrafficSourceDetail
Die Daten im Bericht werden basierend auf den Verweis-URLs zusammengefasst, die für ein bestimmtes Video und für einen bestimmten Besucherquellentyp die meisten Aufrufe generiert haben. In der folgenden Liste sind die Besucherquellen aufgeführt, für die dieser Bericht verfügbar ist. Die Liste enthält für jede Besucherquelle die Informationen, 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 TrueView 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, über das Zuschauer zu dem im Bericht angegebenen 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, von der 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 zu dem im Bericht genannten Video gelangt sind. Gültige Werte:
    • activity: Aufrufe über Elemente in Abofeeds auf der Startseite, die nicht auf Uploads, sondern auf Aktivitäten in sozialen Netzwerken zurückzuführen sind, z. B. „Mag ich“-Bewertungen, Favoriten, Bulletinbeiträge und Playlist-Hinzufügungen.
    • blogged – Aufrufe über Elemente in Abofeeds auf der Startseite, die über Links von Top-Blogs zustande kamen.
    • mychannel: Aufrufe über Elemente in anderen Feeds auf der Startseite, z. B. „Positive Bewertungen“, „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, über den Zuschauer zum Video gelangt sind.
  • VIDEO_REMIXES: Das Video, das zu den Aufrufen geführt hat.

Beispiele

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

  • Kanalbeispiele

    • Zugriffsquelle
      • Anzahl der Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
      • Tägliche Aufrufzahlen und Wiedergabezeit von 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
      • Anzahl der Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
      • Tägliche Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen

  • Beispiele für Rechteinhaber

    • Zugriffsquelle
      • Anzahl der Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen
      • Tägliche Aufrufzahlen und Wiedergabezeit von 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
      • Anzahl der Playlist-Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
      • Tägliche Playlist-Aufrufe und Wiedergabezeit über verschiedene 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 filtern, 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 filtern, 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 Betriebssystemmesswerte für Mobilgeräte
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen
      • Tägliche Messwerte zum Gerätetyp für Playlist-Aufrufe unter 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, auf die Anspruch erhoben wurde
      • Tägliche Betriebssystemmesswerte für Videos, auf die Anspruch erhoben wurde, die auf Mobilgeräten angesehen werden
      • Tägliche Messwerte zu Betriebssystemen und Gerätetypen
      • Tägliche Messwerte zum Gerätetyp für Playlist-Aufrufe unter 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.
gender (Kerndimension)
Diese Dimension gibt das Geschlecht der angemeldeten Nutzer an, die in den Berichtsdaten aufgeführt 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 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 freigegeben wurden. Videos können über die Schaltfläche „Teilen“ auf YouTube (oder über den YouTube-Player) 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
Ameba AMEBA
Android-E-Mail-Adresse ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android-Messaging ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
In Zwischenablage kopieren COPY_PASTE
Cyworld CYWORLD
Eingraben DIGG
Dropbox DROPBOX
Embed EMBED
E-Mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook-Seiten FACEBOOK_PAGES
Logo: Fotka 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äten IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO-Story KAKAO_STORY
Kakao (Kakao-Talk) KAKAO
Kik KIK
LGE-E-Mail-Adresse LGE_EMAIL
Liniendiagramm LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
Logo: mixi MIXI
Motorola-Botschaften MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki ODNOKLASSNIKI
Sonstiges OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Himmelsfelsen 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 Hilfedokumentation.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen sozialer Netzwerke verwendet:

  • Kanalbeispiele

    • Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach Diensten, über die Videos geteilt wurden

  • Beispiele für Rechteinhaber

    • Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach Diensten, über die Videos geteilt wurden

Zuschauerbindung

elapsedVideoTimeRatio
Diese Dimension gibt das Verhältnis des abgelaufenen Teils des Videos zur Länge des Videos an. Die Dimensionen und Messwerte zur Zuschauerbindung werden verwendet, um die Zuschauerbindung im Zeitverlauf zu messen. Die Dimension elapsedVideoTimeRatio ist die Zeitmessung. Beispielsweise bedeutet der Wert 0.4, dass in den entsprechenden Berichtsdaten Daten zur Zuschauerbindung nach 40 % des Videos angezeigt werden.

Die API gibt 100 Datenpunkte für jedes Video 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 gleich groß. Bei einem zweiminütigen Video beträgt das Intervall zwischen den Datenpunkten also 1, 2 Sekunden. 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 der Zugriffe an, die mit den Berichtsdaten verknüpft sind. Unterstützte Werte sind ORGANIC, AD_INSTREAM und AD_INDISPLAY. Weitere Informationen zu diesen Zugriffsquellen findest du in der YouTube-Hilfe.

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 von früheren Daten abzurufen. Abfragen, bei denen der Filter nicht verwendet wird, funktionieren für alle Daten nach dem 1. Juli 2008.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen zur Zuschauerbindung verwendet:

Anzeigenleistung

adType
Die Dimension adType wird in Berichten zur Anzeigenleistung verwendet und fasst die angeforderten Messwerte basierend auf den Anzeigentypen zusammen, die während der Videowiedergabe geschaltet wurden. In der folgenden Liste werden mögliche Dimensionswerte erläutert. Weitere Informationen zu den Anzeigenformaten von YouTube findest du in der YouTube-Hilfe.

  • auctionBumperInstream: Über eine Auktion platzierte nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe des 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 Wiedergabeseite oder als Kombination aus beidem eingeblendet wird. 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 mehreren Anzeigen eine von mehreren Anzeigen aus, die vor dem Video eingeblendet werden. See the TrueView documentation for more information.

  • auctionTrueviewInstream: Überspringbare Videoanzeigen, die vor oder während des Hauptvideos ausgeliefert werden. Weitere Informationen finden Sie in der TrueView.

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

  • reservedBumperInstream: Nicht überspringbare Videoanzeigen, die auf Reservierungsbasis verkauft werden und bis zu sechs Sekunden dauern und vor der Wiedergabe des Videos angesehen werden müssen.

  • reservedClickToPlay: Videoanzeige, die der Nutzer anklicken 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 Wiedergabeseite oder als Kombination aus beidem eingeblendet wird. 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 mit Video- und Grafikelementen, die auf der Startseite eingeblendet wird.

  • reservedUnknown: Eine Anzeige, die reserviert wurde und nicht einem der anderen Anzeigentypen zugeordnet werden konnte.

  • unknown: Dieser Anzeigentyp konnte nicht klassifiziert werden.

Beispiele

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

  • Kanalbeispiele

    • Umsatz/Werbung
      • Messwerte zum Kanalumsatz und zur Anzeigenleistung
      • Täglicher Umsatz und Messwerte 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/Werbung
      • Messwerte zum Umsatz und zur Anzeigenleistung für Inhalte, auf die Anspruch erhoben wurde
      • Täglicher Umsatz und Messwerte 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 zeigt an, dass mit der Anfrage Daten zu Videoaufrufen abgerufen werden, die im Kontext einer Playlist erfolgt sind.

Beispiele

Alle Beispielanfragen, mit denen Playlist-Berichte abgerufen werden, 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 die Daten nach einer der folgenden Dimensionen gefiltert werden:
  • video
  • channel
  • Eine unterstützte Kombination der Dimensionen claimedStatus und uploaderType, wie unten definiert.
claimStatus (wird nur in Berichten zu 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 filters-Parameter 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 zu Rechteinhabern verwendet)
Mit dieser Dimension kannst du angeben, ob eine API-Antwort Messwerte für Inhalte enthalten soll, die vom angegebenen Rechteinhaber und/oder von Dritten hochgeladen wurden, z. B. von Nutzern hochgeladene Videos. Gültige Werte sind self und thirdParty. Dies ist eine Kerndimension und unterliegt der Einstellungsrichtlinie.

Die folgende Tabelle enthält die unterstützten Kombinationen für die Dimensionen claimedStatus und uploaderType, die beide im filters-Parameter 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 einem Dritten hochgeladen wurden.
Anspruch erhoben Sich selbst Ruft Daten für Inhalte ab, auf die Anspruch erhoben wurde und die der Rechteinhaber hochgeladen hat.
Anspruch erhoben thirdParty Ruft Daten für Inhalte ab, auf die Anspruch erhoben wurde und die von einem Dritten hochgeladen wurden.

Beispiele

In vielen der API-Anfragen für Rechteinhaberberichte wird zum Filtern von Daten eine unterstützte Kombination der Dimensionen claimedStatus und uploaderType verwendet.