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 allgemeine Kriterien, mit denen Daten aggregiert werden, etwa das Datum, an dem Nutzeraktivitäten stattgefunden haben, oder das Land, in dem sich die Nutzer befanden.

In jedem Abfragebericht sind die unterstützten Dimensionen aufgeführt. Wenn Sie beispielsweise Nutzeraktivitäten nach Zeit abrufen, wählen Sie den Zeitraum aus, für den Daten gemeldet werden sollen: Tag oder Monat. In allen Berichten enthält jede Datenzeile eine eindeutige Kombination von Dimensionswerten.

Wenn du einen Bericht zu Suchanfragen abrufen möchtest, rufe die Methode reports.query der YouTube Analytics API auf. Verwenden Sie in Ihrer Anfrage den Parameter dimensions, um die Dimensionen anzugeben, die YouTube zur Berechnung der Messwerte in den Berichten verwenden soll.

Kerndimensionen

Die YouTube Analytics API unterliegt der Einstellungsrichtlinie, die in den Nutzungsbedingungen und nicht zu den Kernmesswerten gehörenden Dimensionen unterliegen der Richtlinie. Auf dieser Seite werden alle Kerndimensionen ausdrücklich als solche gekennzeichnet sind.

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

Weitere Informationen finden Sie in der Liste der YouTube APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.

Filter

Alle Abfrageberichte unterstützen Filter. Filter identifizieren Dimensionswerte, die im abgerufenen Dataset vorhanden sein müssen. Daher beschränken sie eine API-Antwort auf Daten, die mit einem bestimmten Wert oder einer Gruppe von Werten übereinstimmen. So könnten Sie beispielsweise, statt Messwerte zur Nutzeraktivität für alle Länder abzurufen, einen Filter verwenden, um nur die Daten für ein bestimmtes Land abzurufen.

Bei einer Anfrage zum Abrufen eines Abfrageberichts gibt der optionale Anfrageparameter filters die Dimensionswerte an, nach denen Daten gefiltert werden sollen. Wenn Sie beispielsweise Messwerte zur Nutzeraktivität für Europa abrufen möchten, setzen Sie den Parameterwert filters auf continent==150.

Wichtig:API-Anfragen zum Abrufen von Berichten zu Rechteinhabern müssen die Daten filtern. Verwenden Sie dazu entweder eine der Dimensionen für das Berichtelement oder eine unterstützte Kombination aus den Dimensionen claimedStatus und uploaderType.

Dimensionen

In den folgenden Abschnitten werden die Dimensionen definiert, die in den Abfrageberichten der YouTube Analytics API verwendet werden. Sofern nicht anders angegeben, werden diese Dimensionen sowohl in Kanalberichten als auch in Rechteinhabern verwendet. Dimensionen, die nur als Filter verwendet werden können, werden ebenfalls identifiziert.

Ressourcen

Diese Dimensionen entsprechen den 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 Parameterwert filters 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 angeben.

Video (Kerndimension)
Die ID eines YouTube-Videos. In der YouTube Data API ist dies der Wert von video. Attribut id der 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.
Kanal (Hauptdimension) (wird nur in Berichten zu Rechteinhabern 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 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 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 Berichtentitäten verwendet:

  • Beispiele für Kanäle

    • Grundlegende Statistiken <ph type="x-smartling-placeholder">
        </ph>
      • Top 10: Am häufigsten angesehene Videos eines Kanals
      • Top 10 – Klickraten der Anmerkungen für die meistgesehenen Videos eines Kanals
      • Statistiken für eine bestimmte Playlist
      • Top 10: Am häufigsten angesehene Playlists eines Kanals
    • Standort <ph type="x-smartling-placeholder">
        </ph>
      • Top 10 – Meistgesehene Videos in einem bestimmten Land
      • Top 10 – Meistgesehene Videos in Europa

  • Beispiele für Rechteinhaber

    • Grundlegende Statistiken <ph type="x-smartling-placeholder">
        </ph>
      • Top 10: Meistgesehene Videos für einen Rechteinhaber
      • Top 10: Am häufigsten angesehene Videos eines Rechteinhabers
      • Top 10: Meistgesehene Videos für den Kanal eines Rechteinhabers
      • Top 10 – Klickraten der Anmerkungen für die meistgesehenen Videos eines Kanals
      • Top 10 – Am häufigsten angesehene Playlists eines Rechteinhabers
    • Standort <ph type="x-smartling-placeholder">
        </ph>
      • Top 10: Von einem Rechteinhaber in Europa am häufigsten angesehene Videos
      • Top 10 – Playlists mit den meisten in den USA am häufigsten gestarteten Playlists

Regionen

Diese Dimensionen geben eine geografische Region an, die den Messwerten zur Nutzeraktivität, zur Anzeigenleistung oder zum geschätzten Umsatz zugeordnet ist.

Land (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). Der Ländercode ZZ wird verwendet, um Messwerte zu melden, für die 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 den Messwerten in der Berichtszeile zugeordnet ist. Der Dimensionswert ist ein ISO 3166-2-Code, der einen US-Bundesstaat oder den District of Columbia angibt, 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 außerdem Daten auf die USA beschränken, indem country==US in den filters-Parameterwert aufgenommen wird.

Hinweis:Diese Dimension unterstützt keine ISO 3166-2-Werte, die sich auf die US-amerikanischen Außengebiete beziehen, da diese Gebiete auch eigene ISO 3166-1-Ländercodes haben. Sie unterstützt außerdem keine Unterteilungen anderer Länder als den USA.

dma
Die dreistellige Kennung, die Nielsen zur Identifizierung des definierten Marktbereichs (Designated Market Area, DMA) verwendet. die mit den Anzeigeereignissen verknüpft sind, die in der Datenzeile beschrieben sind.
Ort
Die geschätzte Stadt, die den Messwerten in der Berichtszeile zugeordnet ist. Für diese Dimension sind Daten ab dem 1. Januar 2022 verfügbar.
Kontinent (nur Filter)
Ein statistischer Regionscode der Vereinten Nationen (UN). Die API unterstützt folgende Werte:
Werte
002 Afrika
019 Nord- und Südamerika (Nordamerika, Lateinamerika, Südamerika und Karibik)
142 Asien
150 Europa
009 Ozeanien
Diese Dimension kann nur zum Filtern von Daten verwendet werden. Um diese Dimension zu verwenden, legen Sie den Wert des Parameter filters für continent==REGION_CODE und gibt einen REGION_CODE-Wert aus der Tabelle an.
subContinent (nur Filter)
Ein statistischer Regionscode der UN, der eine geografische Teilregion identifiziert. Die Statistikabteilung der Vereinten Nationen listet Unterregionen sowie die mit den Regionen verknüpften Länder auf.

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:

  • Beispiele für Kanäle

    • Allgemeine Statistiken: Länderspezifische Aufrufzahlen für einen Kanal
    • Standort <ph type="x-smartling-placeholder">
        </ph>
      • Länderspezifische Messwerte zur Wiedergabezeit für die Videos eines Kanals
      • Länderspezifische Anmerkungsmesswerte zu den Videos eines Kanals
      • Provinzspezifische Messwerte für die US-Bundesstaaten und Washington D.C.
      • Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Kanals
      • Top 10 – Playlists mit den meisten in den USA am häufigsten gestarteten Playlists
    • Wiedergabeort: Die Anzahl der Aufrufe pro Tag und die Wiedergabezeit an verschiedenen Wiedergabeorten.
    • Zugriffsquellen: Hier findest du die Anzahl der Aufrufe und die Wiedergabezeit von verschiedenen Zugriffsquellen in einem Land.
    • Demografische Merkmale: demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
    • Top-Videos <ph type="x-smartling-placeholder">
        </ph>
      • Top 10 – Meistgesehene Videos in einem bestimmten Land
      • Top 10 – Meistgesehene Videos in Europa

  • Beispiele für Rechteinhaber

    • Allgemeine Statistiken: Länderspezifische Aufrufzahlen für alle selbst hochgeladenen Videos
    • Standort <ph type="x-smartling-placeholder">
        </ph>
      • Länderspezifische Messwerte zur Wiedergabezeit bei selbst hochgeladenen Inhalten
      • Länderspezifische Anmerkungsmesswerte für selbst hochgeladene Inhalte
      • Provinzspezifische Messwerte für die US-Bundesstaaten und Washington D.C.
      • Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Rechteinhabers
      • Top 10 – Playlists mit den meisten in den USA am häufigsten gestarteten Playlists
    • Wiedergabeort: 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 – von einem Rechteinhaber in Europa am häufigsten angesehene Videos
    • Umsatz/Anzeigenleistung: Länderspezifische Messwerte zum Umsatz und zur Anzeigenleistung

Zeiträume

Diese Dimensionen geben an, dass in einem Bericht Daten basierend auf einem bestimmten Zeitraum zusammengefasst werden sollen, etwa einem Tag, einer Woche oder einem Monat. Die Anfrageparameter startDate und endDate geben den Zeitraum an, für den der Bericht Daten enthält. Der Bericht gibt Daten bis zum letzten Tag zurück, 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 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. Das bedeutet, dass Datumsangaben, bei denen die Uhr auf die Sommerzeit vorwärts gestellt wird, einen Zeitraum von 23 Stunden und Daten, bei denen die Uhr rückwärts gestellt wird, einen 25-Stunden-Zeitraum darstellen.

Die Dimension Monat 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 aggregiert und jede Zeile enthält die Daten für einen Tag. Sie können weitere Dimensionen verwenden, um die Daten noch weiter aufzuschlüsseln. In einem Zugriffsquellenbericht können beispielsweise tägliche Aufrufstatistiken basierend darauf zusammengestellt werden, wie Nutzer auf deine Videos zugreifen. This is a core dimension and is subject to the Deprecation Policy.
Monat (Kerndimension)
Die Daten im Bericht werden nach Kalendermonat zusammengefasst. Wie bei täglichen Berichten können Sie die Daten mithilfe anderer Filter noch weiter segmentieren. Im Bericht werden Datumsangaben im YYYY-MM-Format angezeigt.

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 werden. This is a core dimension and is subject to the Deprecation Policy.

Beispiele

In den folgenden Beispielanfragen werden zeitliche Dimensionen oder Filter verwendet:

  • Beispiele für Kanäle

    • Zeitbasiert <ph type="x-smartling-placeholder">
        </ph>
      • Messwerte zur täglichen Wiedergabezeit für die Videos eines Kanals
      • Tägliche Anmerkungsmesswerte zu den Videos eines Kanals
      • Tägliche Playlist-Aufrufe für einen Kanal
    • Wiedergabeort: 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 <ph type="x-smartling-placeholder">
        </ph>
      • Tägliche Messwerte zu Gerätetypen 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 <ph type="x-smartling-placeholder">
        </ph>
      • Messwerte zur täglichen Wiedergabezeit für selbst hochgeladene Inhalte
      • Messwerte zu Anmerkungen für Inhalte mit Ansprüchen
      • Tägliche Playlist-Aufrufe für einen Rechteinhaber
    • Wiedergabeort: 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 <ph type="x-smartling-placeholder">
        </ph>
      • 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 Betriebssystem und Gerätetyp
    • Umsatz/Anzeigenleistung: Messwerte zum täglichen Umsatz und zur Anzeigenleistung

Wiedergabeorte

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

insightPlaybackLocationType
Die Daten im Bericht werden basierend auf dem Typ der Seite oder App zusammengefasst, auf der bzw. in der die Videos wiedergegeben wurden. Mögliche Werte für diese Dimension sind:

  • BROWSE: Die Daten beschreiben Aufrufe, die auf der YouTube-Startseite oder dem Startbildschirm, im Abofeed des Nutzers oder über eine andere YouTube-Funktion zum Surfen erfolgt sind.

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

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

  • EXTERNAL_APP: Die Daten beschreiben Aufrufe, die in einer Drittanbieter-App stattgefunden haben, in der das Video mit einer anderen Methode als <iframe>- oder <object>-Einbettung wiedergegeben wurde. Beispielsweise werden Wiedergaben in Anwendungen, die die YouTube Android Player API verwenden, mithilfe dieses Werts kategorisiert.

  • MOBILE: Die Daten beschreiben die Aufrufe, die auf der mobilen YouTube-Website oder über genehmigte 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 unter Umständen in Berichten verbleiben, da ältere Daten weiterhin unter diese Kategorie fallen. Ab diesem Datum werden mobile Wiedergaben jedoch als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben klassifiziert, je nach Art der App, in der sie stattfinden.

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

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

  • YT_OTHER: Die Daten beschreiben Datenansichten, 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 unterstützt, die in eingebetteten Playern erfolgt sind. Er enthält 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 die URLs oder Anwendungen angegeben werden, die mit den Top-eingebetteten Playern verknüpft sind.

Beispiele

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

  • Beispiele für Kanäle

    • Wiedergabeort <ph type="x-smartling-placeholder">
        </ph>
      • Anzahl der Aufrufe und Wiedergabezeiten an verschiedenen Wiedergabeorten
      • Anzahl der Aufrufe pro Tag 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
      • Anzahl der täglichen Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten

  • Beispiele für Rechteinhaber

    • Wiedergabeort <ph type="x-smartling-placeholder">
        </ph>
      • Anzahl der Aufrufe und Wiedergabezeiten an verschiedenen Wiedergabeorten
      • Anzahl der Aufrufe pro Tag 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
      • Anzahl der täglichen Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten

Wiedergabedetails

creatorContentType
Diese Dimension ermittelt den Inhaltstyp, der den Messwerten zur Nutzeraktivität in der Datenzeile zugeordnet ist. Für diese Dimension sind Daten ab dem 1. Januar 2019 verfügbar.

In der folgenden Tabelle sind Dimensionswerte aufgeführt:
Werte
LIVE_STREAM Der angesehene Inhalt war ein YouTube-Livestream.
SHORTS Der angesehene Inhalt war ein YouTube-Kurzvideo.
STORY Der angesehene Inhalt war eine YouTube Story.
VIDEO_ON_DEMAND Bei dem angesehenen Content handelt es sich um ein YouTube-Video, das nicht unter einen der anderen Dimensionswerte fällt.
UNSPECIFIED Der Inhaltstyp des aufgerufenen 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 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 beziehen sich auf Nutzeraktivitäten, die während einer Liveübertragung nicht stattgefunden haben.
subscribedStatus
Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in der Datenzeile mit Nutzern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben. Mögliche Werte sind SUBSCRIBED und UNSUBSCRIBED.

Der Dimensionswert entspricht dem Zeitpunkt, zu dem die Nutzeraktivität stattfindet. Angenommen, ein Nutzer hat einen Kanal nicht abonniert und sieht sich eines der Videos des Kanals an. Anschließend abonniert er am selben Tag den Kanal und sieht sich ein weiteres Video an. Laut Bericht des Kanals hat ein Aufruf den subscribedStatus-Wert SUBSCRIBED und ein Aufruf den subscribedStatus-Wert UNSUBSCRIBED.
youtubeProduct
Diese Dimension ermittelt den YouTube-Dienst, in dem die Nutzeraktivität stattgefunden hat. Daten für diese Dimension stehen seit dem 18. Juli 2015 zur Verfügung.

In der folgenden Tabelle sind die Dimensionswerte aufgeführt:
Werte
CORE Nutzeraktivitäten, die nicht in einer der speziellen YouTube-Apps (YouTube Gaming, YouTube Kids oder YouTube Music) stattgefunden haben. Ausnahme: Nutzeraktivitäten, die vor dem 1. März 2021 in YouTube Music stattfanden, sind in CORE enthalten.
GAMING Die Nutzeraktivität fand in YouTube Gaming statt.
KIDS Die Nutzeraktivität erfolgte in YouTube Kids.
MUSIC Die Nutzeraktivität in YouTube Music erfolgte am oder nach dem 1. März 2021. Daten vor dem 1. März 2021 sind in CORE enthalten. Echtzeitdaten werden nicht aufgezeichnet.
UNKNOWN Die Nutzeraktivität erfolgte vor dem 18. Juli 2015.

Zugriffsquellen

insightTrafficSourceType
Die Daten im Bericht werden basierend auf dem Referrer-URL-Typ zusammengefasst, der beschreibt, wie Nutzer auf das Video zugegriffen haben. 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, wird im Feld insightTrafficSourceDetail die Art der Werbung angegeben.
  • ANNOTATION: Zuschauer haben durch Klicken auf eine Anmerkung in einem anderen Video zum Video gelangt.
  • CAMPAIGN_CARD: Aufrufe über von Nutzern hochgeladene Videos, auf die Anspruch erhoben wurde und mit denen der Rechteinhaber die angesehenen Inhalte beworben hat. Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt.
  • END_SCREEN: Die Aufrufe stammen aus dem Abspann eines anderen Videos.
  • EXT_URL: Die Videoaufrufe wurden über einen Link auf einer anderen Website weitergeleitet. Wenn du nach dieser Besucherquelle filterst, wird die Webseite durch das Feld insightTrafficSourceDetail angegeben. Diese Zugriffsquelle enthält Verweise über Google-Suchergebnisse.
  • HASHTAGS: Aufrufe über VOD-Hashtags oder Pivot-Seiten für Shorts-Hashtags.
  • 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 erfolgten, während das Video als Teil einer Playlist wiedergegeben wurde. Dazu gehören auch Zugriffe über die Playlist-Seite.
  • PRODUCT_PAGE: Die Videoaufrufe stammen von einer Produktseite.
  • PROMOTED: Die Videoaufrufe wurden durch kostenlose YouTube-Werbung wie die "Spotlight-Videos" auf YouTube referenziert. Seite.
  • RELATED_VIDEO: Die Videoaufrufe wurden über einen Eintrag mit einem ähnlichen Video auf einer anderen Videowiedergabeseite aufgerufen. Wenn du nach dieser Besucherquelle filterst, wird im Feld insightTrafficSourceDetail die Video-ID für dieses Video angegeben.
  • SHORTS: Der Zuschauer wurde weitergeleitet, indem er in der Shorts-Ansicht aus dem vorherigen Video wischte.
  • SOUND_PAGE: Aufrufe über Pivot-Seiten zu Audioinhalten in Shorts.
  • SUBSCRIBER: Die Videoaufrufe stammen aus Feeds auf der YouTube-Startseite oder über die YouTube-Abofunktionen. Wenn Sie nach dieser Besucherquelle filtern, gibt das Feld insightTrafficSourceDetail die Feedelemente der Startseite oder eine andere Seite an, von der Aufrufe stammen.
  • YT_CHANNEL: Die Videoaufrufe erfolgten auf einer Kanalseite. Wenn du nach dieser Besucherquelle filterst, wird im Feld insightTrafficSourceDetail die Kanal-ID für diesen Kanal angegeben.
  • YT_OTHER_PAGE: Die Videoaufrufe wurden nicht über ein Suchergebnis oder einen Link zu einem ähnlichen Video auf einer YouTube-Seite generiert. Wenn du nach dieser Besucherquelle filterst, wird die Seite durch das Feld insightTrafficSourceDetail angegeben.
  • 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 stammen über den Link zum Remix-Video im Shorts-Player. Wenn du nach dieser Besucherquelle filterst, gibt das Feld insightTrafficSourceDetail das Video an, von dem der Zuschauer weitergeleitet wurde.
insightTrafficSourceDetail
Die Daten im Bericht werden basierend auf den Verweis-URLs aggregiert, die die meisten Aufrufe für ein bestimmtes Video und einen angegebenen Zugriffsquellentyp generiert haben. In der folgenden Liste sind die Besucherquellen aufgeführt, für die dieser Bericht verfügbar ist. Für jede Besucherquelle werden in der Liste die Informationen angegeben, die über die Dimension „insightTrafficSourceDetail“ bereitgestellt werden.
  • ADVERTISING: Die Art der Werbung, die zu den Aufrufen geführt hat. Mögliche Werte sind:
    • Click-to-Play-Interaktionsanzeige
    • Engagement-Anzeige
    • Google-Suchanzeigen
    • Videoanzeige auf der Startseite
    • Reservierte überspringbare In-Stream-Anzeige
    • TrueView In-Search und TrueView In-Display
    • TrueView In-Stream
    • 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 Zuschauer zu dem im Bericht angegebenen Video geführt hat.
  • EXT_URL: Die Website, über die die Zuschauer auf das Video aufmerksam geworden 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, das Zuschauer zu dem im Bericht behandelten Video geführt hat.
  • SOUND_PAGE: Das Video, das zu den Aufrufen geführt hat.
  • SUBSCRIBER: Der Startseiten-Feed-Artikel oder die YouTube-Abofunktion, über die Zuschauer zum im Bericht behandelten Video gelangt sind. Gültige Werte sind:
    • activity: Aufrufe über Elemente in Abofeeds auf der Startseite, die nicht aus Upload- und sozialer Kanalaktivität resultieren, einschließlich positiver Bewertungen, Favoriten, Bulletinbeiträge und Playlist-Hinzufügungen.
    • blogged: Aufrufe über Artikel in Abofeeds auf der Startseite, die aus Links in Top-Blogs resultieren.
    • mychannel: Aufrufe über Artikel in anderen Feeds, die auf der Startseite aufgeführt sind, z. B. „Gefällt mir“-Angaben, „Wiedergabeverlauf“, und „Später ansehen“.
    • podcasts: Aufrufe, die über Elemente auf der Podcasts-Landingpage erfolgen.
    • sdig: Aufrufe, die aus E-Mails zu Abo-Updates stammen.
    • uploaded: Aufrufe über die uploaded Elemente in Abofeeds auf der Startseite.
    • /: Andere Aufrufe über die YouTube-Startseite.
    • /my_subscriptions: Aufrufe, die von Nutzern stammen Meine Abos auf YouTube ansehen.
  • YT_CHANNEL: Die Kanalseite, auf der sich Zuschauer das Video angesehen haben.
  • YT_OTHER_PAGE: Die YouTube-Seite, über die Zuschauer auf das Video weitergeleitet wurden.
  • YT_SEARCH: Der Suchbegriff, der 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:

  • Beispiele für Kanäle

    • Zugriffsquelle <ph type="x-smartling-placeholder">
        </ph>
      • Anzahl der Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
      • Die Anzahl der Aufrufe pro Tag und die 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 von verschiedenen Zugriffsquellen in einem Land
      • Anzahl der täglichen Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen

  • Beispiele für Rechteinhaber

    • Zugriffsquelle <ph type="x-smartling-placeholder">
        </ph>
      • Anzahl der Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen
      • Die Anzahl der Aufrufe pro Tag und die 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 von verschiedenen Zugriffsquellen in einem Land
      • Anzahl der täglichen Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen

Geräte

deviceType
Diese Dimension gibt den physischen Formfaktor des Geräts an, auf dem der Aufruf 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
  • UNKNOWN_PLATFORM
operatingSystem
Diese Dimension gibt das Softwaresystem des Geräts an, auf dem der Aufruf 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 Daten für 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:

  • Beispiele für Kanäle

    • Gerät/Betriebssystem <ph type="x-smartling-placeholder">
        </ph>
      • Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
      • Tägliche Betriebssystemmesswerte für Mobilgeräte
      • Tägliche Messwerte zu Betriebssystem und Gerätetyp
      • Tägliche Messwerte für den 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 <ph type="x-smartling-placeholder">
        </ph>
      • 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 Betriebssystem und Gerätetyp
      • Tägliche Messwerte für den Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
      • Tägliche Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten

Demografische Merkmale

Demografische Dimensionen helfen Ihnen, die Altersgruppe und Geschlechterverteilung Ihrer Zielgruppe zu verstehen. In der YouTube-Hilfe findest du zusätzliche Informationen zu demografischen Daten in YouTube Analytics-Berichten.

ageGroup (Kerndimension)
Diese Dimension ermittelt die Altersgruppe der angemeldeten Nutzer, die den Berichtsdaten zugeordnet ist. Für die API werden die folgenden Altersgruppen verwendet:
  • 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 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:

  • Beispiele für Kanäle

    • Demografische Merkmale <ph type="x-smartling-placeholder">
        </ph>
      • 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 <ph type="x-smartling-placeholder">
        </ph>
      • Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
      • Demografische Merkmale der Playlist-Zuschauer in Kalifornien (Altersgruppe und Geschlecht)

Interaktion und Teilen von Inhalten

sharingService (Kerndimension)
Diese Dimension ermittelt den Dienst, der zum Teilen von Videos verwendet wurde. Videos können auf YouTube (oder über den YouTube-Player) über die Schaltfläche "Teilen" Schaltfläche. This is a core dimension and is subject to the Deprecation Policy.

In der folgenden Tabelle sind die gültigen Dimensionswerte aufgeführt:
Dienst, mit dem geteilt wurde API-Wert
Ameba AMEBA
Android-E-Mail ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android-Messaging ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
In Zwischenablage kopieren COPY_PASTE
Logo: Cyworld CYWORLD
Ausheben DIGG
Dropbox DROPBOX
Einbetten EMBED
E-Mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook-Seiten FACEBOOK_PAGES
Fótka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC-SMS HTC_MMS
Google-Posteingang INBOX
Dialogfeld „iOS-Systemaktivität“ IOS_SYSTEM_ACTIVITY_DIALOG
Geschichte von KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE-E-Mail LGE_EMAIL
Linie LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki ODNOKLASSNIKI
Sonstiges OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony-Unterhaltungen 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 soziale Dimensionen verwendet:

  • Beispiele für Kanäle

    • Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach dem Dienst, über den Videos geteilt wurden

  • Beispiele für Rechteinhaber

    • Soziale Netzwerke: Messwerte zum Teilen, zusammengefasst nach dem Dienst, über den Videos geteilt wurden

Zuschauerbindung

elapsedVideoTimeRatio
Diese Dimension gibt das Verhältnis des bereits verstrichenen Teils des Videos zur Videolänge an. Mit Dimensionen und Messwerten zur Bindung wird die Zuschauerbindung im Zeitverlauf gemessen. Die Dimension elapsedVideoTimeRatio ist die Zeitmessung. Ein Wert von 0.4 bedeutet beispielsweise, dass die entsprechenden Berichtsdaten Bindungsdaten zeigen, nachdem 40 % des Videos verstrichen sind.

Die API gibt 100 Datenpunkte für jedes Video mit Verhältniswerten zwischen 0.01 und 1.0 zurück. Die Zeitpunkte, zu denen Daten während der Videowiedergabe gemessen werden, sind für jedes Video in gleichmäßigen Abständen angeordnet. 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 bestimmt die Art des Traffics, 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.

Die Daten für den Filter audienceType stehen seit dem 25. September 2013 zur Verfügung. Die API gibt keine Daten für Abfragen zurück, bei denen der Filter zum Abrufen von Daten aus früheren Zeiträumen verwendet wird. Abfragen ohne Filter funktionieren für alle Daten nach dem 1. Juli 2008.

Beispiele

In den folgenden Beispielanfragen werden Dimensionen zur Zuschauerbindung verwendet:

  • Beispiele für Kanäle

  • Beispiele für Rechteinhaber

Livestreaming

livestreamPosition
Diese Dimension gibt eine bestimmte Minute während eines Live-Videostreams an. Berichtsmesswerte geben an, wie viele Nutzer sich den Livestream zu diesem Zeitpunkt angesehen haben.

Kündigungen von Mitgliedschaften

membershipsCancellationSurveyReason
Die Anzahl der Umfragen, in denen YouTube-Nutzer ihre Kanalmitgliedschaft für den Zeitraum für den angegebenen Channel im Berichtszeitraum verwendet wird. In der folgenden Tabelle sind gültige Dimensionswerte aufgeführt:
API-Wert Erklärung
UNKNOWN Der Nutzer hat die Umfrage nicht abgeschlossen.
DISLIKE_PERKS Dem Nutzer gefielen die Vorteile der Mitgliedschaft nicht.
PERKS_NOT_DELIVERED Der Nutzer gab an, dass die versprochenen Vorteile für Mitglieder nicht geliefert 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 fühlte sich als Kanalmitglied nicht wertgeschätzt.
FINANCIAL_REASONS Der Nutzer hat die Mitgliedschaft aus finanziellen Gründen gekündigt.
JOIN_LIMITED_TIME Der Nutzer wollte nur für eine begrenzte Zeit teilnehmen.
OTHER Der Nutzer hatte einen anderen Grund für die Kündigung.

Anzeigenleistung

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

  • auctionBumperInstream: Nicht überspringbare Videoanzeigen, die über eine Auktion platziert werden und 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 Wiedergabeseite oder als Kombination aus beidem eingeblendet wird. Wenn das Overlay ausgeführt wird, wird es nach einer bestimmten Zeit automatisch geschlossen und der Nutzer kann das Overlay ebenfalls schließen. Werden ein Overlay und ein Banner zusammen angezeigt, 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 kann eine von mehreren Videoanzeigen auswählen, 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 nicht einem der anderen Anzeigentypen zugeordnet ist.

  • reservedBumperInstream: Nicht überspringbare Videoanzeigen mit einer Länge von bis zu 6 Sekunden, die nach Reservierung verkauft werden und vor der Wiedergabe eines Videos angesehen werden müssen.

  • reservedClickToPlay: Eine Videoanzeige, auf die der Nutzer klicken 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 eine Wiedergabe startet. Diese Produkte 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 bestimmten Zeit automatisch geschlossen und der Nutzer kann das Overlay ebenfalls schließen. Werden ein Overlay und ein Banner zusammen angezeigt, 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 auf der Startseite, die Video- und Grafikelemente enthalten kann.

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

  • unknown: Dieser Anzeigentyp konnte von YouTube nicht klassifiziert werden.

Beispiele

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

  • Beispiele für Kanäle

    • Umsatz/Werbung <ph type="x-smartling-placeholder">
        </ph>
      • Messwerte zum Kanalumsatz und zur Anzeigenleistung
      • Messwerte zum täglichen Umsatz und zur Anzeigenleistung
      • Länderspezifische Messwerte zum Umsatz und zur Anzeigenleistung
      • Top 10 – Videos mit den höchsten Einnahmen
      • Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen

  • Beispiele für Rechteinhaber

    • Umsatz/Werbung <ph type="x-smartling-placeholder">
        </ph>
      • 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 zum Umsatz und zur Anzeigenleistung
      • Top 10 – Videos mit den höchsten Einnahmen
      • Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen

Playlists

isCurated (nur Filter)
Dieser Filter zeigt an, dass die Anfrage Daten zu Videoaufrufen abruft, die in der Kontext einer Playlist.

Beispiele

Alle Beispielanfragen, die Playlist-Berichte abrufen, verwenden den Filter isCurated.

Dimensionen für Rechteinhaber

Die folgenden Dimensionen werden nur in Rechteinhaberberichten unterstützt.

Wichtig:Bei API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten nach einer der folgenden Dimensionen gefiltert werden: <ph type="x-smartling-placeholder">
    </ph>
  • video
  • channel
  • Eine unterstützte Kombination aus den Dimensionen claimedStatus und uploaderType, wie unten definiert.
beanspruchtStatus (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 einschrä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 Details zur Verwendung dieser Dimension.
UploaderType (Hauptdimension) (wird nur in Berichten zu Rechteinhabern verwendet)
Mit dieser Dimension können Sie 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 folgenden Tabelle 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 YouTube Analytics-Daten für vom Rechteinhaber hochgeladene Inhalte abrufen, auf die Anspruch erhoben oder kein Anspruch erhoben wurde
Anspruch erhoben [Nicht festgelegt] Ruft Daten zu Inhalten ab, auf die Anspruch erhoben wurde, die vom Rechteinhaber oder von Dritten hochgeladen wurden
Anspruch erhoben Sich selbst Ruft Daten zu Inhalten ab, auf die Anspruch erhoben wurde, die vom Rechteinhaber hochgeladen wurden
Anspruch erhoben thirdParty Ruft Daten zu Inhalten ab, auf die Anspruch erhoben wurde und die von Dritten hochgeladen wurden

Beispiele

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