Dimensions

Ce document définit les dimensions acceptées par l'API YouTube Analytics. Cette API est compatible avec les requêtes ciblées et en temps réel, et génère des rapports YouTube Analytics personnalisés.

Les dimensions sont des critères courants utilisés pour agréger les données, comme la date à laquelle l'activité des utilisateurs s'est produite ou le pays dans lequel ils se trouvaient.

Chaque rapport sur les requêtes identifie les dimensions qu'il accepte. Par exemple, lorsque vous récupérez l'activité des utilisateurs par période, vous choisissez la période pour laquelle les données seront générées : jour ou mois. Dans n'importe quel rapport, chaque ligne de données présente une combinaison unique de valeurs de dimension.

Pour récupérer un rapport sur les requêtes, appelez la méthode reports.query de l'API YouTube Analytics. Dans votre requête, utilisez le paramètre dimensions pour spécifier les dimensions que YouTube utilisera pour calculer les valeurs des métriques dans les rapports.

Dimensions principales

Bien que l'API YouTube Analytics soit soumise au Règlement relatif aux abandons défini dans les Conditions d'utilisation, les dimensions non principales (et les métriques non principales) ne sont pas soumises à ce règlement. Dans les définitions de cette page, toute dimension de base est explicitement identifiée comme telle.

La liste suivante identifie les dimensions principales de l'API.

Pour en savoir plus, consultez la liste des API YouTube soumises au règlement relatif aux abandons.

Filtres

Tous les rapports sur les requêtes sont compatibles avec les filtres. Les filtres identifient les valeurs de dimension qui doivent être présentes dans l'ensemble de données récupéré. Ils limitent donc une réponse d'API pour n'inclure que les données correspondant à une valeur ou à un ensemble de valeurs spécifiques. Par exemple, au lieu de récupérer les métriques sur l'activité des utilisateurs pour tous les pays, vous pouvez utiliser un filtre pour n'obtenir que les données d'un pays spécifique.

Dans une requête visant à récupérer un rapport sur les requêtes, le paramètre de requête facultatif filters spécifie les valeurs de dimension pour lesquelles vous souhaitez filtrer les données. Par exemple, pour récupérer les métriques d'activité des utilisateurs pour l'Europe, vous devez définir la valeur du paramètre filters sur continent==150.

Important : Les requêtes API permettant de récupérer les rapports sur les propriétaires de contenu doivent filtrer les données en utilisant l'une des dimensions d'entité de reporting ou une combinaison compatible des dimensions claimedStatus et uploaderType.

Dimensions

Les sections suivantes définissent les dimensions utilisées dans les rapports sur les requêtes de l'API YouTube Analytics. Sauf indication contraire, ces dimensions sont utilisées dans les rapports Chaîne et Propriétaire du contenu. Les dimensions qui ne peuvent être utilisées que comme filtres sont également identifiées.

Ressources

Ces dimensions correspondent aux ressources que les chaînes et les propriétaires de contenu gèrent sur YouTube :

Remarque : L'API vous permet de spécifier plusieurs valeurs pour les dimensions video, playlist et channel lorsqu'elles sont utilisées comme filtres. Pour ce faire, définissez la valeur du paramètre filters sur une liste d'ID de vidéos, de playlists ou de chaînes séparés par une virgule pour lesquels la réponse de l'API doit être filtrée. La valeur du paramètre peut spécifier jusqu'à 500 ID.

video (dimension principale)
 : ID d'une vidéo YouTube. Dans l'API YouTube Data, il s'agit de la valeur de la propriété id d'une ressource video. This is a core dimension and is subject to the Deprecation Policy.
playlist
ID d'une playlist YouTube. Dans l'API YouTube Data, il s'agit de la valeur de la propriété id d'une ressource playlist.
channel (dimension principale) (uniquement utilisé dans les rapports sur les propriétaires de contenu)
 ID d'une chaîne YouTube. Dans l'API YouTube Data, il s'agit de la valeur de la propriété id d'une ressource channel. This is a core dimension and is subject to the Deprecation Policy.

La dimension channel est fréquemment utilisée dans les rapports des propriétaires de contenu, car ces rapports agrègent généralement les données de plusieurs chaînes.
group (filtre uniquement)
ID d'un groupe YouTube Analytics. Vous pouvez récupérer cette valeur à l'aide de la méthode groups.list de l'API YouTube Analytics. Lorsque vous utilisez le filtre group, la réponse de l'API contient des données pour toutes les vidéos, playlists ou chaînes de ce groupe.

Exemples

Les exemples de requêtes suivants utilisent des dimensions ou des filtres d'entité de reporting :

  • Exemples de chaînes

    • Statistiques de base
      • Top 10 : vidéos les plus regardées d'une chaîne
      • Top 10 des taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne
      • Statistiques pour une playlist spécifique
      • Top 10 des playlists les plus regardées d'une chaîne
    • Zone géographique
      • Top 10 : vidéos les plus vues dans un pays spécifique
      • Top 10 des vidéos les plus regardées en Europe

  • Exemples de propriétaires de contenu

    • Statistiques de base
      • Top 10 des vidéos les plus regardées d'un propriétaire de contenu
      • Top 10 des vidéos les plus regardées d'un propriétaire de contenu
      • Top 10 des vidéos les plus vues pour la chaîne d'un propriétaire de contenu
      • Top 10 des taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne
      • Top 10 des playlists les plus regardées pour un propriétaire de contenu
    • Zone géographique
      • Top 10 des vidéos les plus regardées en Europe pour un propriétaire de contenu
      • Top 10 des playlists les plus lancées aux États-Unis

Zones géographiques

Ces dimensions identifient une région géographique associée à l'activité des utilisateurs, aux performances des annonces ou aux métriques sur les revenus estimés.

country (dimension principale)
 : pays associé aux métriques de la ligne du rapport. La valeur de la dimension est un code pays ISO-3166-1 à deux lettres, tel que US, CN (Chine) ou FR (France). Le code pays ZZ est utilisé pour les métriques pour lesquelles YouTube n'a pas pu identifier le pays associé. This is a core dimension and is subject to the Deprecation Policy.
province
 État ou territoire américain associé aux métriques de la ligne du rapport. La valeur de la dimension est un code ISO 3166-2 qui identifie un État américain ou le district de Columbia, comme US-MI (Michigan) ou US-TX (Texas). Le code de province US-ZZ est utilisé pour signaler les métriques pour lesquelles YouTube n'a pas pu identifier l'État américain associé. Lorsqu'une requête API inclut province dans la valeur du paramètre dimensions, elle doit également limiter les données aux États-Unis en incluant country==US dans la valeur du paramètre filters.

Remarque : Cette dimension n'est pas compatible avec les valeurs ISO 3166-2 qui identifient les territoires extérieurs des États-Unis, car ces territoires ont également leurs propres codes pays ISO 3166-1. Il n'est pas non plus compatible avec les subdivisions de pays autres que les États-Unis.

dma
Identifiant à trois chiffres utilisé par Nielsen pour identifier la zone de marché désignée (DMA) associée aux événements de visionnage décrits dans la ligne de données.
city
 Ville estimée associée aux métriques de la ligne du rapport. Les données de cette dimension sont disponibles pour les dates à partir du 1er janvier 2022.
continent (filtre uniquement)
Code de région statistique des Nations Unies. L'API est compatible avec les valeurs suivantes :
Valeurs
002 Afrique
019 Amériques (Amérique du Nord, Amérique latine, Amérique du Sud et Caraïbes)
142 Asie
150 Europe
009 Océanie
Cette dimension ne peut être utilisée que pour filtrer les données. Pour utiliser cette dimension, définissez la valeur du paramètre filters sur continent==REGION_CODE, en spécifiant une valeur REGION_CODE dans le tableau.
subContinent (filtre uniquement)
Code de région statistique des Nations Unies qui identifie une sous-région géographique. La Division des statistiques des Nations Unies liste les sous-régions ainsi que les pays qu'elle associe à chaque région.

Cette dimension ne peut être utilisée que pour filtrer les données. Pour utiliser cette dimension, définissez la valeur du paramètre filters sur subContinent==REGION_CODE, en spécifiant une valeur REGION_CODE issue de la liste de l'ONU.

Exemples

Les exemples de requêtes suivants utilisent des dimensions ou des filtres géographiques :

  • Exemples de chaînes

    • Statistiques de base : nombre de vues spécifiques à un pays (et plus) pour une chaîne
    • Zone géographique
      • Métriques sur la durée de visionnage spécifiques à un pays pour les vidéos d'une chaîne
      • Métriques d'annotations spécifiques à un pays pour les vidéos d'une chaîne
      • Métriques spécifiques aux provinces pour les États américains et Washington D.C.
      • Métriques de durée de visionnage spécifiques à un pays pour les playlists d'une chaîne
      • Top 10 des playlists les plus lancées aux États-Unis
    • Contexte de lecture : nombre de vues et durée de visionnage quotidiens selon les différents contextes de lecture
    • Source de trafic : nombre de vues et durée de visionnage provenant de différentes sources de trafic dans un pays
    • Données démographiques : données démographiques des spectateurs en Californie (tranche d'âge et genre)
    • Vidéos les plus regardées
      • Top 10 : vidéos les plus vues dans un pays spécifique
      • Top 10 des vidéos les plus regardées en Europe

  • Exemples de propriétaires de contenu

    • Statistiques de base : nombre de vues spécifiques à un pays (et plus) pour toutes les vidéos mises en ligne par vous-même
    • Zone géographique
      • Métriques de durée de visionnage spécifiques à un pays pour les contenus importés par les utilisateurs
      • Métriques d'annotation spécifiques à un pays pour les contenus importés par les utilisateurs
      • Métriques spécifiques aux provinces pour les États américains et Washington D.C.
      • Métriques sur la durée de visionnage spécifiques à un pays pour les playlists d'un propriétaire de contenu
      • Top 10 des playlists les plus lancées aux États-Unis
    • Contexte de lecture : nombre de vues et durée de visionnage quotidiens selon les différents contextes de lecture
    • Données démographiques : données démographiques des spectateurs en Californie (tranche d'âge et genre)
    • Vidéos les plus regardées : top 10 des vidéos les plus regardées en Europe pour un propriétaire de contenu
    • Revenus/Performances des annonces : métriques sur les revenus et les performances des annonces spécifiques à un pays

Périodes

Ces dimensions indiquent qu'un rapport doit agréger les données en fonction d'une période, comme un jour, une semaine ou un mois. Les paramètres de requête startDate et endDate spécifient la période pour laquelle le rapport inclut des données. Notez que le rapport renvoie en fait des données jusqu'au dernier jour pour lequel toutes les métriques spécifiées dans la requête sont disponibles au moment où la requête est effectuée. Dans les rapports, les dates sont indiquées au format YYYY-MM-DD.

Important : Toutes les dates font référence à la période commençant à minuit (heure du Pacifique, UTC-7 ou UTC-8) et se terminant à 23h59 (heure du Pacifique) le jour, le mois et l'année spécifiés. Par conséquent, les dates où les horloges sont avancées pour l'heure d'été représentent une période de 23 heures, et celles où elles sont reculées représentent une période de 25 heures.

La dimension Mois fait référence à la période commençant à minuit, heure du Pacifique (UTC-7 ou UTC-8), le premier jour du mois et de l'année spécifiés.

day (dimension principale)
 Lorsque vous utilisez cette dimension, les données du rapport sont agrégées quotidiennement et chaque ligne contient les données d'un jour. Vous pouvez utiliser d'autres dimensions pour répartir davantage les données. Par exemple, un rapport sur les sources de trafic peut agréger les statistiques de visionnage quotidiennes en fonction de la manière dont les utilisateurs accèdent à vos vidéos. This is a core dimension and is subject to the Deprecation Policy.
month (dimension principale)
 Les données du rapport sont agrégées par mois calendaire. Comme pour les rapports quotidiens, vous pouvez utiliser d'autres filtres pour segmenter davantage les données. Dans le rapport, les dates sont listées au format YYYY-MM.

Remarque : Si votre requête API utilise la dimension month, les paramètres start-date et end-date doivent tous deux être définis sur le premier jour du mois. This is a core dimension and is subject to the Deprecation Policy.

Exemples

Les exemples de requêtes suivants utilisent des dimensions ou des filtres temporels :

  • Exemples de chaînes

    • Basé sur l'heure
      • Métriques quotidiennes sur la durée de visionnage des vidéos d'une chaîne
      • Métriques quotidiennes sur les annotations pour les vidéos d'une chaîne
      • Vues quotidiennes des playlists d'une chaîne
    • Contexte de lecture : nombre de vues et durée de visionnage quotidiens selon les différents contextes de lecture
    • Source de trafic : nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic
    • Appareil/OS
      • Métriques quotidiennes sur les types d'appareils pour le système d'exploitation Android
      • Métriques quotidiennes du système d'exploitation pour les appareils mobiles
      • Métriques quotidiennes sur le système d'exploitation et le type d'appareil

  • Exemples de propriétaires de contenu

    • Basé sur l'heure
      • Métriques quotidiennes sur la durée de visionnage pour les contenus mis en ligne par les utilisateurs
      • Métriques sur les annotations pour les contenus revendiqués
      • Nombre de vues quotidiennes des playlists pour un propriétaire de contenu
    • Contexte de lecture : nombre de vues et durée de visionnage quotidiens selon les différents contextes de lecture
    • Source de trafic : nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic
    • Appareil/OS
      • Métriques quotidiennes sur les types d'appareils pour les vidéos revendiquées
      • Métriques quotidiennes sur le système d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles
      • Métriques quotidiennes sur le système d'exploitation et le type d'appareil
    • Revenus/Performances des annonces : métriques quotidiennes sur les revenus et les performances des annonces

Contextes de lecture

Ces dimensions fournissent des informations sur la page ou l'application dans lesquelles l'activité des utilisateurs s'est produite.

insightPlaybackLocationType
Les données du rapport sont agrégées en fonction du type de page ou d'application sur lesquelles les vidéos ont été lues. Les valeurs possibles pour cette dimension sont les suivantes :

  • BROWSE : les données décrivent les vues qui ont eu lieu sur la page d'accueil ou l'écran d'accueil YouTube, dans le flux d'abonnements de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.

  • CHANNEL : les données décrivent les vues qui ont eu lieu sur la page d'une chaîne.

  • EMBEDDED : les données décrivent les vues qui ont eu lieu sur un autre site Web ou une autre application où la vidéo était intégrée à l'aide d'un code d'intégration <iframe> ou <object>.

  • EXTERNAL_APP : les données décrivent les vues qui se sont produites dans une application tierce où la vidéo a été lue à l'aide d'une méthode autre qu'une intégration <iframe> ou <object>. Par exemple, les lectures dans les applications qui utilisent l'API YouTube Android Player seraient classées à l'aide de cette valeur.

  • MOBILE : les données décrivent les vues qui ont eu lieu sur le site Web mobile de YouTube ou sur les clients API YouTube approuvés, y compris les appareils mobiles.

    Depuis le 10 septembre 2013, les lectures ne sont plus classées comme des lectures MOBILE dans les rapports YouTube Analytics. Il est possible que la valeur reste dans les rapports, car les anciennes données appartiennent toujours à cette catégorie. Toutefois, après cette date, les lectures sur mobile sont classées comme lectures WATCH, EMBEDDED ou EXTERNAL_APP, selon le type d'application dans laquelle elles se produisent.

  • SEARCH : les données décrivent les vues qui ont eu lieu directement sur la page des résultats de recherche YouTube.

  • WATCH : les données décrivent les vues qui ont eu lieu sur la page de lecture YouTube de la vidéo ou dans une application YouTube officielle, comme l'application YouTube pour Android.

  • YT_OTHER : les données décrivent les vues qui ne sont pas classées autrement.

insightPlaybackLocationDetail
Les données
sont agrégées en fonction de la page sur laquelle se trouve le lecteur. Notez que ce rapport n'est compatible qu'avec les vues générées par des lecteurs intégrés. Il identifie les lecteurs intégrés qui ont généré le plus de vues pour une vidéo spécifique. Il offre ainsi une vue plus précise que le rapport sur les lieux de lecture en identifiant les URL ou les applications associées aux principaux lecteurs intégrés.

Exemples

Les exemples de requêtes suivants utilisent des dimensions de lieu de lecture :

  • Exemples de chaînes

    • Contexte de lecture
      • Nombre de vues et durée de visionnage selon les lieux de lecture
      • Nombre de vues et durée de visionnage quotidiennes selon les lieux de lecture
      • Top 10 : sites tiers qui génèrent le plus de vues pour une vidéo intégrée
      • Nombre de vues et durée de visionnage des playlists selon les lieux de lecture
      • Nombre de vues et durée de visionnage quotidiens des playlists selon les différents lieux de lecture

  • Exemples de propriétaires de contenu

    • Contexte de lecture
      • Nombre de vues et durée de visionnage selon les lieux de lecture
      • Nombre de vues et durée de visionnage quotidiennes selon les lieux de lecture
      • Top 10 : sites tiers qui génèrent le plus de vues pour une vidéo intégrée
      • Nombre de vues et durée de visionnage des playlists selon les lieux de lecture
      • Nombre de vues et durée de visionnage quotidiens des playlists selon les différents lieux de lecture

Détails de la lecture

creatorContentType
Cette dimension identifie le type de contenu associé aux métriques d'activité utilisateur dans la ligne de données. Les données de cette dimension sont disponibles pour les dates à partir du 1er janvier 2019.

Le tableau suivant liste les valeurs de la dimension :
Valeurs
LIVE_STREAM Le contenu visionné était un flux en direct YouTube.
SHORTS Le contenu visionné était un Short YouTube.
STORY Le contenu visionné était une story YouTube.
VIDEO_ON_DEMAND Le contenu visionné était une vidéo YouTube qui ne correspond à aucune des autres valeurs de dimension.
UNSPECIFIED Le type de contenu consulté est inconnu.
liveOrOnDemand
Cette dimension indique si les métriques d'activité utilisateur de la ligne de données sont associées à des vues d'une diffusion en direct. Les données de cette dimension sont disponibles à partir du 1er avril 2014.

Le tableau suivant liste les valeurs de la dimension :
Valeurs
LIVE Les données de la ligne décrivent l'activité des utilisateurs lors d'une diffusion en direct.
ON_DEMAND Les données de la ligne décrivent l'activité des utilisateurs qui n'a pas eu lieu lors d'une diffusion en direct.
subscribedStatus
Cette dimension indique si les métriques d'activité utilisateur de la ligne de données sont associées à des spectateurs abonnés à la chaîne de la vidéo ou de la playlist. Les valeurs possibles sont SUBSCRIBED et UNSUBSCRIBED.

Notez que la valeur de la dimension est exacte au moment où l'activité de l'utilisateur se produit. Par exemple, supposons qu'un utilisateur ne soit pas abonné à une chaîne et qu'il regarde l'une de ses vidéos, puis qu'il s'abonne à la chaîne et regarde une autre vidéo, le tout le même jour. Le rapport de la chaîne indique qu'une vue a une valeur subscribedStatus de SUBSCRIBED et qu'une autre vue a une valeur subscribedStatus de UNSUBSCRIBED.
youtubeProduct
Cette dimension identifie le service YouTube sur lequel l'activité de l'utilisateur a eu lieu. Les données de cette dimension sont disponibles depuis le 18 juillet 2015.

Le tableau suivant liste les valeurs de la dimension :
Valeurs
CORE Activité utilisateur qui ne s'est pas produite dans l'une des applications YouTube spécialisées (YouTube Gaming, YouTube Kids ou YouTube Music). Exception : L'activité des utilisateurs sur YouTube Music avant le 1er mars 2021 est incluse dans CORE.
GAMING L'activité de l'utilisateur a eu lieu dans YouTube Gaming.
KIDS L'activité de l'utilisateur a eu lieu sur YouTube Kids.
MUSIC L'activité de l'utilisateur a eu lieu dans YouTube Music le 1er mars 2021 ou après. Les données antérieures au 1er mars 2021 sont incluses dans CORE. Les données en temps réel ne sont pas enregistrées.
UNKNOWN L'activité de l'utilisateur a eu lieu avant le 18 juillet 2015.

Sources de trafic

insightTrafficSourceType
Les données du rapport sont agrégées en fonction du type de provenance, qui décrit la manière dont les utilisateurs ont accédé à la vidéo. Les valeurs possibles pour cette dimension sont les suivantes :
  • ADVERTISING : le spectateur a été redirigé vers la vidéo par une publicité. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie le type d'annonce.
  • ANNOTATION : les spectateurs ont accédé à la vidéo en cliquant sur une annotation dans une autre vidéo.
  • CAMPAIGN_CARD : vues générées par des vidéos mises en ligne par les utilisateurs et revendiquées, que le propriétaire du contenu a utilisées pour promouvoir le contenu visionné. Cette source de trafic n'est disponible que pour les rapports sur les propriétaires de contenu.
  • END_SCREEN : les vues proviennent de l'écran de fin d'une autre vidéo.
  • EXT_URL : les vues de la vidéo proviennent d'un lien sur un autre site Web. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie la page Web. Cette source de trafic inclut les liens de parrainage provenant des résultats de recherche Google.
  • HASHTAGS : vues provenant des pages de hashtags de VOD ou des pages de hashtags de Shorts.
  • LIVE_REDIRECT : les vues de la vidéo proviennent de Live Redirects.
  • NO_LINK_EMBEDDED : la vidéo a été intégrée à un autre site Web lorsqu'elle a été visionnée.
  • NO_LINK_OTHER : YouTube n'a pas identifié de site référent pour le trafic. Cette catégorie englobe le trafic direct vers une vidéo ainsi que le trafic sur les applications mobiles.
  • NOTIFICATION : les vues de la vidéo proviennent d'un e-mail ou d'une notification de YouTube.
  • PLAYLIST : les vues de la vidéo ont été générées lorsqu'elle était lue dans une playlist. Cela inclut le trafic provenant de la page de la playlist.
  • PRODUCT_PAGE : les vues de la vidéo proviennent d'une page produit.
  • PROMOTED : les vues de la vidéo proviennent d'une promotion YouTube non payante, comme la page YouTube "Vidéos à la une".
  • RELATED_VIDEO : les vues de la vidéo proviennent d'une liste de vidéos associées sur la page de lecture d'une autre vidéo. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie l'ID de la vidéo.
  • SHORTS : le spectateur a été redirigé en balayant l'écran verticalement depuis la vidéo précédente dans l'expérience de visionnage de Shorts.
  • SOUND_PAGE : vues provenant des pages de sons de Shorts.
  • SUBSCRIBER : les vues de la vidéo proviennent de flux sur la page d'accueil YouTube ou de fonctionnalités d'abonnement YouTube. Si vous filtrez les données en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie les éléments du flux de la page d'accueil ou d'une autre page à partir desquels les vues ont été générées.
  • YT_CHANNEL : les vues de la vidéo ont été enregistrées sur la page d'une chaîne. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie l'ID du canal.
  • YT_OTHER_PAGE : les vues de la vidéo proviennent d'un lien autre qu'un résultat de recherche ou un lien vers une vidéo associée qui s'affiche sur une page YouTube. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie la page.
  • YT_SEARCH : les vues de la vidéo proviennent des résultats de recherche YouTube. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie le terme de recherche.
  • VIDEO_REMIXES : les vues de la vidéo proviennent du lien vers la vidéo remixée dans le lecteur Shorts. Si vous filtrez en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie la vidéo à partir de laquelle le spectateur a été redirigé.
insightTrafficSourceDetail
Les données du rapport sont agrégées en fonction des sites référents qui ont généré le plus de vues pour une vidéo et un type de source de trafic spécifiques. La liste suivante identifie les sources de trafic pour lesquelles ce rapport est disponible. Pour chaque source de trafic, la liste indique les informations fournies par la dimension insightTrafficSourceDetail.
  • ADVERTISING : type d'annonce ayant généré les vues. Les valeurs possibles sont les suivantes :
    • Annonce axée sur l'engagement click-to-play
    • Annonce ciblant l'engagement
    • Annonces sur le Réseau de Recherche Google
    • Annonce vidéo sur la page d'accueil
    • Annonce InStream désactivable réservée
    • TrueView InSearch et InDisplay
    • TrueView InStream
    • Publicité sans catégorie sur YouTube
    • Sélection de vidéos
  • CAMPAIGN_CARD : la vidéo revendiquée qui a redirigé les spectateurs vers la vidéo identifiée dans le rapport.
  • END_SCREEN : vidéo qui a redirigé les spectateurs vers la vidéo identifiée dans le rapport.
  • EXT_URL : site Web qui a redirigé les spectateurs vers la vidéo.
  • HASHTAGS : hashtag qui a généré les vues.
  • NOTIFICATION : e-mail ou notification ayant généré le trafic.
  • RELATED_VIDEO : vidéo associée qui a conduit les spectateurs à la vidéo couverte par le rapport.
  • SOUND_PAGE : vidéo qui a généré les vues.
  • SUBSCRIBER : élément du flux d'accueil ou fonctionnalité d'abonnement YouTube qui a conduit les spectateurs à la vidéo couverte par le rapport. Les valeurs possibles sont les suivantes :
    • activity : vues des éléments des flux Abonnements de la page d'accueil qui résultent d'une activité autre que les mises en ligne et les activités sociales sur la chaîne, y compris les "J'aime", les favoris, les posts et les ajouts de playlists.
    • blogged : vues des éléments des flux Abonnements de la page d'accueil générées par des liens provenant de blogs populaires.
    • mychannel : vues des éléments d'autres flux listés sur la page d'accueil, comme "J'aime", "Historique des vidéos regardées" et "À regarder plus tard".
    • podcasts : vues provenant d'éléments de la page de destination Podcasts.
    • sdig : vues provenant des e-mails de mise à jour des abonnements.
    • uploaded : vues des éléments uploaded dans les flux Abonnements de la page d'accueil.
    • / : autres vues provenant de la page d'accueil YouTube.
    • /my_subscriptions : vues provenant des pages Mes abonnements des utilisateurs sur YouTube.
  • YT_CHANNEL : page de la chaîne sur laquelle les spectateurs ont regardé la vidéo
  • YT_OTHER_PAGE : page YouTube à partir de laquelle les spectateurs ont été redirigés vers la vidéo.
  • YT_SEARCH : terme de recherche qui a conduit les spectateurs à la vidéo.
  • VIDEO_REMIXES : vidéo qui a généré les vues.

Exemples

Les exemples de requêtes suivants utilisent des dimensions de source de trafic :

  • Exemples de chaînes

    • Source de trafic
      • Nombre de vues et durée de visionnage provenant de différentes sources de trafic dans un pays
      • Nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic
      • Top 10 : termes de recherche YouTube qui génèrent le plus de trafic vers une vidéo
      • Top 10 : termes de recherche Google qui génèrent le plus de trafic vers une vidéo
      • Nombre de vues et durée de visionnage des playlists provenant de différentes sources de trafic dans un pays
      • Nombre de vues et durée de visionnage quotidiens des playlists, selon les différentes sources de trafic

  • Exemples de propriétaires de contenu

    • Source de trafic
      • Nombre de vues et durée de visionnage selon les sources de trafic
      • Nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic
      • Top 10 : termes de recherche YouTube qui génèrent le plus de trafic vers une vidéo
      • Top 10 : termes de recherche Google qui génèrent le plus de trafic vers une vidéo
      • Nombre de vues et durée de visionnage des playlists provenant de différentes sources de trafic dans un pays
      • Nombre de vues et durée de visionnage quotidiens des playlists, selon les différentes sources de trafic

Appareils

deviceType
Cette dimension identifie le facteur de forme physique de l'appareil sur lequel la vue s'est produite. La liste suivante identifie les types d'appareils pour lesquels l'API renvoie des données. Vous pouvez également utiliser la dimension deviceType comme filtre pour limiter un rapport sur les systèmes d'exploitation aux données d'un type d'appareil spécifique.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
Cette dimension identifie le système logiciel de l'appareil sur lequel la vue s'est produite. La liste suivante identifie les systèmes d'exploitation pour lesquels l'API renvoie des données. Vous pouvez également utiliser operatingSystem comme filtre pour limiter un rapport sur les types d'appareils aux données d'un système d'exploitation spécifique.
  • 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

Exemples

Les exemples de requêtes suivants utilisent des dimensions liées aux appareils :

  • Exemples de chaînes

    • Appareil/OS
      • Métriques quotidiennes sur les types d'appareils pour le système d'exploitation Android
      • Métriques quotidiennes du système d'exploitation pour les appareils mobiles
      • Métriques quotidiennes sur le système d'exploitation et le type d'appareil
      • Métriques quotidiennes sur les types d'appareils pour les vues de playlists sur le système d'exploitation Android
      • Métriques quotidiennes sur le système d'exploitation pour les vues de playlists sur les appareils mobiles

  • Exemples de propriétaires de contenu

    • Appareil/OS
      • Métriques quotidiennes sur les types d'appareils pour les vidéos revendiquées
      • Métriques quotidiennes sur le système d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles
      • Métriques quotidiennes sur le système d'exploitation et le type d'appareil
      • Métriques quotidiennes sur les types d'appareils pour les vues de playlists sur le système d'exploitation Android
      • Métriques quotidiennes sur le système d'exploitation pour les vues de playlists sur les appareils mobiles

Données démographiques

Les dimensions démographiques vous permettent de comprendre la répartition par âge et par genre de votre audience. Le Centre d'aide YouTube contient des informations supplémentaires sur les données démographiques dans les rapports YouTube Analytics.

ageGroup (dimension principale)
 : cette dimension identifie la tranche d'âge des utilisateurs connectés associés aux données du rapport. L'API utilise les tranches d'âge suivantes :
  • 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 (dimension principale)
Cette dimension identifie le genre des utilisateurs connectés associés aux données du rapport. Les valeurs valides sont female, male et user_specified. This is a core dimension and is subject to the Deprecation Policy.

Exemples

Les exemples de requêtes suivants utilisent des dimensions démographiques :

  • Exemples de chaînes

    • Données démographiques
      • Données démographiques des spectateurs en Californie (tranche d'âge et genre)
      • Données démographiques des spectateurs de playlists en Californie (tranche d'âge et genre)

  • Exemples de propriétaires de contenu

    • Données démographiques
      • Données démographiques des spectateurs en Californie (tranche d'âge et genre)
      • Données démographiques des spectateurs de playlists en Californie (tranche d'âge et genre)

Engagement et partage de contenu

sharingService (dimension principale)
Cette dimension identifie le service utilisé pour partager des vidéos. Les vidéos peuvent être partagées sur YouTube (ou via le lecteur YouTube) à l'aide du bouton "Partager". This is a core dimension and is subject to the Deprecation Policy.

Le tableau suivant répertorie les valeurs de dimension valides :
Service de partage Valeur de l'API
Ameba AMEBA
Android Email ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Messagerie Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
Copier dans le presse-papiers COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Intégrer EMBED
E-mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Pages Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Message HTC HTC_MMS
Google Inbox INBOX
Boîte de dialogue d'activité système iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Adresse e-mail LGE LGE_EMAIL
Ligne LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Messagerie Motorola MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Partage à proximité NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Autre OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Conversations Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Inconnu UNKNOWN
Messages Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japon YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

 Pour en savoir plus, consultez la documentation d'aide.

Exemples

Les exemples de requêtes suivants utilisent des dimensions sociales :

  • Exemples de chaînes

    • Réseaux sociaux : métriques de partage, agrégées par service sur lequel les vidéos ont été partagées

  • Exemples de propriétaires de contenu

    • Réseaux sociaux : métriques de partage, agrégées par service sur lequel les vidéos ont été partagées

Rétention d'audience

elapsedVideoTimeRatio
Cette dimension spécifie le rapport entre la partie écoulée de la vidéo et sa durée. Les dimensions et métriques de rétention permettent de mesurer la rétention d'audience au fil du temps. La dimension elapsedVideoTimeRatio correspond à la mesure du temps. Par exemple, une valeur de 0.4 indique que les données de fidélisation du rapport correspondant s'affichent après que 40 % de la vidéo se sont écoulés.

L'API renvoie 100 points de données pour chaque vidéo, avec des valeurs de ratio allant de 0.01 à 1.0. Les moments où les données sont mesurées lors de la lecture des vidéos sont espacés de manière égale pour chaque vidéo. Cela signifie que pour une vidéo de deux minutes, l'intervalle entre les points de données est de 1,2 seconde. Toutefois, pour une vidéo de deux heures, l'intervalle entre les points de données est de 72 secondes. La valeur de la dimension indique la fin exclusive de l'intervalle.
audienceType (filtre uniquement)
La valeur de la dimension identifie le type de trafic associé aux données du rapport. Les valeurs acceptées sont ORGANIC, AD_INSTREAM et AD_INDISPLAY. Pour en savoir plus sur ces types de sources de trafic, consultez le Centre d'aide YouTube.

 Notez que les données du filtre audienceType sont disponibles depuis le 25 septembre 2013. L'API ne renvoie pas de données pour les requêtes qui utilisent le filtre pour essayer de récupérer des données antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toutes les dates après le 1er juillet 2008.

Exemples

Les exemples de requêtes suivants utilisent les dimensions de fidélisation de l'audience :

  • Exemples de chaînes

  • Exemples de propriétaires de contenu

Streaming en direct

livestreamPosition
Cette dimension spécifie une minute précise d'un flux vidéo en direct. Les métriques du rapport indiquent le nombre d'utilisateurs qui regardaient la diffusion en direct à ce moment-là.

Résilier des abonnements

membershipsCancellationSurveyReason
 Nombre d'enquêtes complétées par les utilisateurs YouTube qui ont résilié leur abonnement à la chaîne spécifiée au cours de la période de référence. Le tableau suivant répertorie les valeurs de dimension valides :
Valeur de l'API Explication
UNKNOWN L'utilisateur n'a pas terminé l'enquête.
DISLIKE_PERKS L'utilisateur n'a pas aimé les avantages de l'abonnement.
PERKS_NOT_DELIVERED L'utilisateur indique qu'il n'a pas reçu les avantages promis pour les membres.
CANNOT_ACCESS_PERKS L'utilisateur n'a pas pu accéder aux avantages.
NO_LONGER_INTERESTED L'utilisateur ne s'intéresse plus à l'abonnement à la chaîne.
FEEL_UNAPPRECIATED L'utilisateur s'est senti dévalorisé en tant que membre de la chaîne.
FINANCIAL_REASONS L'utilisateur a résilié son abonnement pour des raisons financières.
JOIN_LIMITED_TIME L'utilisateur ne souhaitait adhérer que pour une durée limitée.
OTHER L'utilisateur avait une autre raison d'annuler.

Performances des annonces

adType
La dimension adType est utilisée dans les rapports sur les performances des annonces. Elle agrège les métriques demandées en fonction des types d'annonces diffusées pendant la lecture des vidéos. La liste suivante explique les valeurs de dimension possibles. Pour en savoir plus sur les formats publicitaires YouTube, consultez le Centre d'aide YouTube.

  • auctionBumperInstream : annonces vidéo non désactivables de six secondes maximum, placées via un système d'enchères, que les utilisateurs doivent visionner avant de pouvoir regarder une vidéo.

  • auctionDisplay : annonce rich media ou illustrée qui s'affiche en superposition en bas du lecteur vidéo, en tant que bloc d'annonces 300 x 250 sur la page de lecture de la vidéo ou en combinant les deux. Lorsque l'overlay s'exécute, il se ferme automatiquement après un certain temps. L'utilisateur peut également le fermer. Si un overlay et une bannière sont diffusés ensemble, chaque annonce est comptabilisée comme une impression distincte.

  • auctionInstream : annonces vidéo non désactivables diffusées avant, pendant ou après la vidéo principale.

  • auctionTrueviewInslate : l'internaute choisit l'une des annonces vidéo parmi une sélection d'options affichées avant une vidéo. See the TrueView documentation for more information.

  • auctionTrueviewInstream : annonces vidéo désactivables diffusées avant ou pendant la vidéo principale. Pour en savoir plus, consultez la documentation TrueView.

  • auctionUnknown : annonce achetée via les enchères AdWords, mais qui n'a pas été classée dans l'un des autres types d'annonces.

  • reservedBumperInstream : annonces vidéo non désactivables de six secondes maximum, vendues sur réservation, que les utilisateurs doivent visionner avant de pouvoir regarder une vidéo.

  • reservedClickToPlay : annonce vidéo sur laquelle l'utilisateur doit cliquer pour lancer la lecture. Une impression d'annonce est enregistrée chaque fois que le bloc d'annonces click-to-play s'affiche, que l'utilisateur lance la lecture ou non. Elles sont vendues sur réservation.

  • reservedDisplay : annonce rich media ou illustrée qui s'affiche en superposition en bas du lecteur vidéo, en tant que bloc d'annonces 300 x 250 sur la page de lecture de la vidéo ou en combinant les deux. Lorsque l'overlay s'exécute, il se ferme automatiquement après un certain temps. L'utilisateur peut également le fermer. Si un overlay et une bannière sont diffusés ensemble, chaque annonce est comptabilisée comme une impression distincte.

  • reservedInstream : annonces vidéo non désactivables insérées avant, pendant ou après la vidéo principale.

  • reservedInstreamSelect

  • reservedMasthead : annonce de grande taille, pouvant inclure des éléments vidéo et graphiques, qui s'affiche sur la page d'accueil.

  • reservedUnknown : annonce vendue sur la base d'une réservation et qui ne peut être classée dans aucun autre type d'annonce.

  • unknown : YouTube n'a pas pu classer ce type d'annonce.

Exemples

Les exemples de rapports suivants récupèrent les métriques sur les performances ou les revenus des annonces :

  • Exemples de chaînes

    • Revenus/Annonces
      • Métriques sur les revenus générés par la chaîne et les performances des annonces
      • Métriques quotidiennes sur les revenus et les performances des annonces
      • Métriques sur les revenus et les performances des annonces spécifiques à un pays
      • Top 10 des vidéos ayant généré le plus de revenus
      • Métriques de performances des annonces pour différents types d'annonces

  • Exemples de propriétaires de contenu

    • Revenus/Annonces
      • Métriques sur les revenus et les performances des annonces pour les contenus revendiqués
      • Métriques quotidiennes sur les revenus et les performances des annonces
      • Métriques sur les revenus et les performances des annonces spécifiques à un pays
      • Top 10 des vidéos ayant généré le plus de revenus
      • Métriques de performances des annonces pour différents types d'annonces

Dimensions du propriétaire de contenu

Les dimensions suivantes ne sont compatibles qu'avec les rapports sur les propriétaires de contenu.

Important : Les requêtes API permettant de récupérer les rapports sur les propriétaires de contenu doivent filtrer les données à l'aide de l'une des dimensions suivantes :
  • video
  • channel
  • Combinaison acceptée des dimensions claimedStatus et uploaderType, comme défini ci-dessous.
claimedStatus (utilisé uniquement dans les rapports des propriétaires de contenu)
Cette dimension vous permet d'indiquer qu'une réponse d'API ne doit contenir que des métriques pour le contenu revendiqué. La seule valeur valide pour cette dimension est claimed. Si le paramètre filters limite la requête à claimedStatus==claimed, l'API ne récupère que les données pour les contenus revendiqués. Le tableau de la définition de la dimension uploaderType fournit plus d'informations sur l'utilisation de cette dimension.
uploaderType (dimension principale) (utilisé uniquement dans les rapports sur les propriétaires de contenu)
Cette dimension vous permet d'indiquer si une réponse d'API doit contenir des métriques pour le contenu mis en ligne par le propriétaire de contenu spécifié et/ou le contenu mis en ligne par des tiers, comme les vidéos mises en ligne par les utilisateurs. Les valeurs valides sont self et thirdParty. Il s'agit d'une dimension principale soumise au Règlement sur l'arrêt des fonctionnalités.

Le tableau ci-dessous présente les combinaisons compatibles pour les dimensions claimedStatus et uploaderType, qui sont toutes deux utilisées dans le paramètre filters :

Valeur claimedStatus Valeur uploaderType Description
|Non définie] self Récupère les données YouTube Analytics pour les contenus revendiqués et non revendiqués mis en ligne par le propriétaire du contenu.
revendiquées |Non définie] Récupère les données des contenus revendiqués mis en ligne par le propriétaire du contenu ou par un tiers.
revendiquées self Récupère les données des contenus revendiqués mis en ligne par le propriétaire du contenu.
revendiquées thirdParty Récupère les données pour le contenu revendiqué mis en ligne par un tiers.

Exemples

De nombreuses requêtes API exemples pour les rapports sur les propriétaires de contenu utilisent une combinaison compatible des dimensions claimedStatus et uploaderType pour filtrer les données.