Dimensions

Ce document définit les dimensions compatibles avec 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 personnalisés.

Les dimensions sont des critères courants utilisés pour agréger des données, comme la date à laquelle l'activité des utilisateurs a eu lieu 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 heure, vous choisissez la période pour laquelle les données seront générées: jour ou mois. Dans un rapport, chaque ligne de données comporte 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 le sont pas. 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é. Par conséquent, ils limitent la réponse d'une API à inclure uniquement 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 ne récupérer que les données d'un pays spécifique.

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

Important:Les requêtes d'API permettant de récupérer des rapports sur les propriétaires de contenu doivent filtrer les données à l'aide de l'une des dimensions d'entité de rapport ou d'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 à la fois dans les rapports Chaîne et Propriétaire de contenu. Les dimensions qui ne peuvent être utilisées qu'en tant que 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éo, de playlist ou de chaîne 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.

vidéo (dimension de base)
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.
chaîne (dimension principale) (utilisée uniquement dans les rapports destinés aux 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 destinés aux propriétaires de contenu, car ils regroupent généralement les données de plusieurs chaînes.
groupe (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 les données de 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 rapport:

  • Exemples de chaînes

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

  • Exemples de propriétaires de contenu

    • Statistiques de base
      • Top 10 : vidéos les plus regardées d'un propriétaire de contenu
      • Top 10 : vidéos les plus regardées d'un propriétaire de contenu
      • Top 10 : vidéos les plus regardées sur la chaîne d'un propriétaire de contenu
      • Top 10 : taux de clics sur les annotations pour les vidéos les plus vues d'une chaîne
      • Top 10 : playlists les plus regardées d'un propriétaire de contenu
    • Géographique
      • Top 10 : vidéos les plus regardées en Europe pour un propriétaire de contenu
      • Top 10 : 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 de base)
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 générer des rapports sur 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 des États-Unis ou le district de Columbia, par exemple US-MI (Michigan) ou US-TX (Texas). Le code de province US-ZZ est utilisé pour générer des rapports sur 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 zones périphériques 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 à partir du 1er janvier 2022.
continent (filtre uniquement)
Code de région statistique des Nations unies (ONU). 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 de statistique 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 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 par pays (et plus encore) pour une chaîne
    • Géographique
      • Métriques sur la durée de visionnage par pays pour les vidéos d'une chaîne
      • Métriques d'annotation spécifiques à chaque pays pour les vidéos d'une chaîne
      • Métriques spécifiques aux provinces pour les États américains et Washington, DC
      • Métriques de durée de visionnage par pays pour les playlists d'une chaîne
      • Top 10 : playlists les plus lancées aux États-Unis
    • Contexte de lecture: nombre de vues et durée de visionnage quotidiens pour 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 : vidéos les plus regardées en Europe

  • Exemples de propriétaires de contenu

    • Statistiques de base: nombre de vues par pays (et plus encore) pour toutes les vidéos que vous avez mises en ligne vous-même
    • Géographique
      • Métriques de durée de visionnage spécifiques à un pays pour les contenus importés par l'utilisateur
      • Métriques d'annotation spécifiques à chaque pays pour les contenus importés par l'utilisateur
      • Métriques spécifiques aux provinces pour les États américains et Washington, DC
      • Métriques de durée de visionnage par pays pour les playlists d'un propriétaire de contenu
      • Top 10 : playlists les plus lancées aux États-Unis
    • Contexte de lecture: nombre de vues et durée de visionnage quotidiens pour 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 par pays

Périodes

Ces dimensions indiquent qu'un rapport doit regrouper les données en fonction d'une période, par exemple 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 les données jusqu'au dernier jour pour lequel toutes les métriques spécifiées dans la requête sont disponibles au moment de la requête. 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 auxquelles les horloges sont avancées pour l'heure d'été représentent une période de 23 heures, et les dates auxquelles 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.

jour (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 encore plus les données. Par exemple, un rapport sur les sources de trafic peut regrouper 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.
mois (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 encore plus les données. Dans le rapport, les dates sont indiquées au format YYYY-MM.

Remarque:Si votre requête API utilise la dimension month, les paramètres start-date et end-date doivent ê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 le temps
      • Métriques sur la durée de visionnage quotidienne pour les vidéos d'une chaîne
      • Métriques quotidiennes sur les annotations pour les vidéos d'une chaîne
      • Nombre de vues quotidiennes des playlists d'une chaîne
    • Contexte de lecture: nombre de vues et durée de visionnage quotidiens pour différents contextes de lecture
    • Source de trafic: nombre de vues et durée de visionnage quotidiennes provenant de différentes sources de trafic
    • Appareil/OS
      • Métriques quotidiennes par type d'appareil pour le système d'exploitation Android
      • Métriques quotidiennes sur les systèmes 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 le temps
      • Métriques quotidiennes sur la durée de visionnage pour les contenus mis en ligne par l'utilisateur
      • Métriques d'annotation pour les contenus revendiqués
      • Nombre de vues quotidiennes de playlists pour un propriétaire de contenu
    • Contexte de lecture: nombre de vues et durée de visionnage quotidiens pour différents contextes de lecture
    • Source de trafic: nombre de vues et durée de visionnage quotidiennes provenant de différentes sources de trafic
    • Appareil/OS
      • Métriques quotidiennes par type d'appareil 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
    • Revenu/Performances des annonces: métriques sur les revenus et les performances des annonces quotidiennes

Contextes de lecture

Ces dimensions fournissent des insights sur la page ou l'application sur laquelle 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 laquelle 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 Abonnements de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.

  • CHANNEL : les données décrivent les vues enregistrées sur une page de chaîne.

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

  • EXTERNAL_APP : les données décrivent les vues qui ont eu lieu 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 sont catégorisées à l'aide de cette valeur.

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

    Depuis le 10 septembre 2013, les visionnages ne sont plus classés comme visionnages MOBILE dans les rapports YouTube Analytics. La valeur peut rester dans les rapports, car les données héritées appartiennent toujours à cette catégorie. Toutefois, après cette date, les lectures sur mobile sont classées en tant que lectures WATCH, EMBEDDED ou EXTERNAL_APP, en fonction du type d'application dans laquelle elles se produisent.

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

  • WATCH : les données décrivent les vues enregistrées 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 regroupées en fonction de la page sur laquelle se trouve le lecteur. Notez que ce rapport n'est disponible que pour les vues générées dans les 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 détaillée que le rapport sur la localisation des lectures 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 contexte de lecture:

  • Exemples de chaînes

    • Emplacement de lecture
      • Nombre de vues et durée de visionnage depuis différents lieux de visionnage
      • Nombre de vues et durée de visionnage quotidiens depuis différents lieux de visionnage
      • Top 10 : sites tiers générant le plus de vues pour une vidéo intégrée
      • Nombre de vues et durée de visionnage des playlists depuis différents lieux de lecture
      • Nombre de vues et durée de visionnage quotidiens des playlists depuis différents lieux de visionnage

  • Exemples de propriétaires de contenu

    • Emplacement de lecture
      • Nombre de vues et durée de visionnage depuis différents lieux de visionnage
      • Nombre de vues et durée de visionnage quotidiens depuis différents lieux de visionnage
      • Top 10 : sites tiers générant le plus de vues pour une vidéo intégrée
      • Nombre de vues et durée de visionnage des playlists depuis différents lieux de lecture
      • Nombre de vues et durée de visionnage quotidiens des playlists depuis différents lieux de visionnage

Détails de la lecture

creatorContentType
Cette dimension identifie le type de contenu associé aux métriques sur l'activité des utilisateurs dans la ligne de données. Les données de cette dimension sont disponibles à partir du 1er janvier 2019.

Le tableau suivant liste les valeurs de cette 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 histoire YouTube.
VIDEO_ON_DEMAND Le contenu regardé é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é des utilisateurs de la ligne de données sont associées aux 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 cette dimension:
Valeurs
LIVE Les données de la ligne décrivent l'activité des utilisateurs pendant une diffusion en direct.
ON_DEMAND Les données de la ligne décrivent l'activité des utilisateurs qui n'a pas eu lieu pendant une diffusion en direct.
subscribedStatus
Cette dimension indique si les métriques sur l'activité des utilisateurs de la ligne de données sont associées aux spectateurs qui étaient 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 de l'activité de l'utilisateur. 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'y abonne et regarde une autre vidéo, le même jour. Le rapport de la chaîne indique qu'une vue a une valeur subscribedStatus de SUBSCRIBED et une autre une valeur subscribedStatus de UNSUBSCRIBED.
youtubeProduct
Cette dimension identifie le service YouTube sur lequel l'activité de l'utilisateur s'est produite. 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é de l'utilisateur qui n'a pas eu lieu dans l'une des applications YouTube spécialisées (YouTube Gaming, YouTube Kids ou YouTube Music). Exception: L'activité des utilisateurs dans 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 à une date ultérieure. 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é 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 site référent, 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 : l'utilisateur a été redirigé vers la vidéo par une annonce. 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 provenant de vidéos mises en ligne par des utilisateurs et revendiquées par le propriétaire du contenu pour promouvoir le contenu consulté. Cette source de trafic n'est disponible que pour les rapports sur les propriétaires de contenu.
  • END_SCREEN : les vues ont été générées par l'écran de fin d'une autre vidéo.
  • EXT_URL : les vues de la vidéo ont été générées par 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 sites référents provenant des résultats de recherche Google.
  • HASHTAGS : vues provenant des pages de pivot avec hashtag de VOD ou de Shorts.
  • LIVE_REDIRECT : les vues de la vidéo ont été générées par des redirections vers des diffusions en direct.
  • NO_LINK_EMBEDDED : la vidéo a été intégrée à un autre site Web au moment de la lecture.
  • NO_LINK_OTHER : YouTube n'a pas identifié de site référent pour le trafic. Cette catégorie comprend le trafic direct vers une vidéo, ainsi que le trafic sur les applications mobiles.
  • NOTIFICATION : les vues de la vidéo ont été générées par un e-mail ou une notification de YouTube.
  • PLAYLIST : les vues de la vidéo ont été enregistrées alors qu'elle était lue dans une playlist. Il inclut le trafic provenant de la page de la playlist.
  • PRODUCT_PAGE : les vues de la vidéo ont été générées par une page produit.
  • PROMOTED : les vues de la vidéo ont été générées par une promotion YouTube non rémunérée, comme la page "Vidéos mises en avant" de YouTube.
  • RELATED_VIDEO : les visionnages de la vidéo ont été générés par une fiche de vidéo associée sur une autre page de lecture de 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'interface de visionnage des Shorts.
  • SOUND_PAGE : vues provenant des pages de pivot de son Shorts.
  • SUBSCRIBER : les vues de la vidéo ont été générées par des flux sur la page d'accueil de YouTube ou par les 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 l'autre page à partir de laquelle 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 de la chaîne.
  • YT_OTHER_PAGE : les vues de la vidéo ont été générées par un lien autre qu'un résultat de recherche ou un lien vers une vidéo similaire qui apparaissait 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 ont été générées par les résultats de recherche YouTube. Si vous filtrez les données en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie le terme de recherche.
  • VIDEO_REMIXES : les vues de la vidéo ont été générées par le 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 l'utilisateur a été redirigé.
insightTrafficSourceDetail
Les données du rapport sont agrégées en fonction des sites référents ayant généré le plus de vues pour une vidéo et un type de source de trafic spécifiés. 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 click-to-play axée sur l'engagement
    • Annonce ciblant l'engagement
    • Annonces sur le Réseau de Recherche de 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 : vidéo revendiquée qui a conduit les spectateurs à la vidéo identifiée dans le rapport.
  • END_SCREEN : vidéo qui a conduit les spectateurs à la vidéo identifiée dans le rapport.
  • EXT_URL : site Web ayant redirigé les spectateurs vers la vidéo.
  • HASHTAGS : hashtag ayant 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 concernée par le rapport.
  • SOUND_PAGE : vidéo ayant généré les vues.
  • SUBSCRIBER : élément du flux de la page d'accueil ou fonctionnalité d'abonnement YouTube qui a conduit les spectateurs à la vidéo concernée par le rapport. Les valeurs valides sont les suivantes :
    • activity : vues des éléments des flux "Abonnements" de la page d'accueil qui résultent d'une activité sur la chaîne autre que la mise en ligne et les réseaux sociaux, y compris les "J'aime", les favoris, les posts dans les bulletins et les ajouts de playlists.
    • blogged : vues des éléments des flux Abonnements de la page d'accueil provenant de liens provenant des principaux blogs.
    • mychannel : vues des éléments d'autres flux listés sur la page d'accueil, tels que "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 d'abonnement.
    • 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 ayant généré les vues.

Exemples

Les exemples de requêtes suivants utilisent des dimensions "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 pour une vidéo
      • Top 10 : termes de recherche Google générant le plus de trafic pour 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 provenant de différentes sources de trafic

  • Exemples de propriétaires de contenu

    • Source de trafic
      • Nombre de vues et durée de visionnage provenant de différentes 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 pour une vidéo
      • Top 10 : termes de recherche Google générant le plus de trafic pour 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 provenant de 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 le système d'exploitation à des données spécifiques à un type d'appareil.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • 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 le type d'appareil à ne contenir que des données pour 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 les dimensions de l'appareil:

  • Exemples de chaînes

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

  • Exemples de propriétaires de contenu

    • Appareil/OS
      • Métriques quotidiennes par type d'appareil 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 le type d'appareil pour les vues de playlists sur le système d'exploitation Android
      • Métriques quotidiennes sur les systèmes d'exploitation pour les vues de playlists sur les appareils mobiles

Données démographiques

Les dimensions démographiques vous aident à 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 de base)
Cette dimension identifie la tranche d'âge des utilisateurs connectés associés aux données du rapport. L'API utilise les groupes d'âge suivants:
  • 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 de base)
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 de base)
Cette dimension identifie le service utilisé pour partager des vidéos. Vous pouvez partager des vidéos 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 Messages 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
Boîte de réception Google INBOX
Boîte de dialogue d'activité du système iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
E-mail LGE LGE_EMAIL
Ligne LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging 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
Sony Conversations 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 ratio de la partie écoulée de la vidéo par rapport à 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 0.4 indique que les données du rapport correspondant affichent des données de fidélisation après 40 % de la durée de la vidéo.

L'API renvoie 100 points de données pour chaque vidéo, avec des valeurs de format allant de 0.01 à 1.0. Les moments où les données sont mesurées pendant la lecture de la vidéo 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 de dates antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toute date postérieure au 1er juillet 2008.

Exemples

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

Streaming en direct

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

Résiliations d'abonnements

membershipsCancellationSurveyReason
Nombre d'enquêtes remplies par les utilisateurs de 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 a indiqué que les avantages de la souscription promis ne lui avaient pas été accordés.
CANNOT_ACCESS_PERKS L'utilisateur n'a pas pu accéder aux avantages.
NO_LONGER_INTERESTED L'utilisateur n'est plus intéressé par l'abonnement à la chaîne.
FEEL_UNAPPRECIATED L'utilisateur s'est senti peu apprécié en tant que membre de la chaîne.
FINANCIAL_REASONS L'utilisateur a annulé pour des raisons financières.
JOIN_LIMITED_TIME L'utilisateur ne voulait s'inscrire que pour une durée limitée.
OTHER L'utilisateur a résilié son abonnement pour une autre raison.

Performances des annonces

adType
La dimension adType est utilisée dans les rapports sur les performances des annonces. Elle regroupe 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, diffusées via un système d'enchères, de six secondes maximum que les utilisateurs doivent visionner avant de pouvoir regarder la 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 combinaison des deux. Lorsque l'utilisateur exécute la superposition, elle se ferme automatiquement après un certain temps d'affichage. L'utilisateur peut également la fermer. Si une superposition et une bannière sont diffusées 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'utilisateur choisit l'une des annonces vidéo parmi plusieurs 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 sur TrueView.

  • auctionUnknown : annonce achetée via le système d'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, vendues sur la base d'une réservation, de six secondes maximum 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. Ils sont vendus 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 combinaison des deux. Lorsque l'utilisateur exécute la superposition, elle se ferme automatiquement après un certain temps d'affichage. L'utilisateur peut également la fermer. Si une superposition et une bannière sont diffusées 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, qui peut 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 pouvait pas être classée dans l'un des autres types d'annonces.

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

Exemples

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

  • Exemples de chaînes

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

  • Exemples de propriétaires de contenu

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

Dimensions "Propriétaire de contenu"

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

Important:Les requêtes d'API permettant de récupérer des 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 du propriétaire 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 des contenus revendiqués. Le tableau de la définition de la dimension uploaderType explique plus en détail comment l'utiliser.
uploaderType (dimension principale) (utilisée uniquement dans les rapports des 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 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 de base soumise au Règlement sur l'abandon.

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 des contenus revendiqués mis en ligne par un tiers.

Exemples

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