Dimensions

Ce document définit les dimensions compatibles avec l'API YouTube Analytics. Cette API prend en charge les requêtes ciblées en temps réel pour générer des rapports YouTube Analytics personnalisés.

Les dimensions sont des critères couramment utilisés pour regrouper des données, comme la date à laquelle l'utilisateur a effectué une activité ou le pays dans lequel se trouvaient les utilisateurs.

Chaque rapport sur les requêtes identifie les variables compatibles. 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 chaque rapport, chaque ligne de données est associée à 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 demande, 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 et métriques secondaires ne sont pas concernées. Dans les définitions de cette page, toute dimension correspondant à une dimension principale 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 une réponse d'API pour n'inclure que les données correspondant à une valeur ou à un ensemble de valeurs particulier. Par exemple, au lieu d'extraire 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 en particulier.

Dans une demande de récupération d'un rapport sur les requêtes, 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 en Europe, vous devez définir la valeur du paramètre filters sur continent==150.

Important:Les demandes d'API pour 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 reporting 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 sur la chaîne et sur les propriétaires 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 en tant que filtres. Pour ce faire, définissez la valeur du paramètre filters sur une liste des ID de vidéos, de playlists ou de chaînes pour lesquels la réponse de l'API doit être filtrée, séparés par une virgule. La valeur du paramètre peut spécifier jusqu'à 500 ID.

vidéo (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.
chaîne (dimension principale) (uniquement utilisée dans les rapports de propriétaire 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 sur les propriétaires de contenu, car ils regroupent généralement les données de plusieurs canaux.
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 l'ensemble des 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 canaux

    • Statistiques de base
      • Top 10 : vidéos les plus regardées pour une chaîne
      • Top 10 : 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 : playlists les plus regardées d'une chaîne
    • Zone géographique
      • Top 10 : vidéos les plus regardées 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 pour un propriétaire de contenu
      • Top 10 : vidéos les plus regardées par propriétaire de contenu
      • Top 10 : vidéos les plus regardées pour la chaîne d'un propriétaire de contenu
      • Top 10 : taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne
      • Top 10 : playlists les plus regardées d'un propriétaire de contenu
    • Zone géographique
      • Top 10 : vidéos les plus regardées en Europe pour un propriétaire de contenu
      • Top 10 : playlists les plus populaires aux États-Unis

Zones géographiques

Ces dimensions identifient une zone géographique associée à des métriques sur l'activité des utilisateurs, les performances des annonces ou 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 permet de 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 des États-Unis 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 permet de 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 éloignées des États-Unis, car ces territoires possèdent é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.

city
Ville estimée associée aux métriques de la ligne du rapport. Les données concernant cette dimension sont disponibles à compter du 1er janvier 2022.
continent (filtre uniquement)
Code de région statistique des Nations Unies (ONU). L'API accepte 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 l'une des valeurs de REGION_CODE de la liste ci-dessus.
subContinent (filtre uniquement)
Code régional statistique des Nations Unies qui identifie une sous-région géographique. La Division de statistique des Nations Unies répertorie 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 des Nations Unies.

Exemples

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

  • Exemples de canaux

    • Statistiques générales: nombre de vues par pays (et plus encore) pour une chaîne.
    • Zone géographique
      • Métriques sur la durée de visionnage des vidéos d'une chaîne par pays
      • Métriques d'annotation spécifiques au pays pour les vidéos d'une chaîne
      • Métriques propres aux provinces pour les États américains et Washington D.C.
      • Métriques sur la durée de visionnage des playlists d'une chaîne par pays
      • Top 10 : playlists les plus populaires aux États-Unis
    • Contexte de lecture: nombre de vues quotidiennes et durée de visionnage 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 sur les spectateurs en Californie (tranche d'âge et genre)
    • Vidéos les plus regardées
      • Top 10 : vidéos les plus regardées dans un pays spécifique
      • Top 10 : vidéos les plus regardées en Europe

  • Exemples de propriétaires de contenu

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

Périodes

Ces dimensions indiquent qu'un rapport doit agréger 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 demande 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 au cours desquelles les horloges sont ajustées en amont de l'heure d'été représentent une période de 23 heures, tandis que celles au cours desquelles les horloges sont décalées représentent une période de 25 heures.

La dimension mois fait référence à la période commençant à minuit (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'une journée. Vous pouvez utiliser d'autres dimensions pour ventiler davantage 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.
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 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 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 canaux

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

  • Exemples de propriétaires de contenu

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

Contextes de lecture

Ces dimensions fournissent des insights sur la page ou l'application où l'activité de l'utilisateur s'est produite.

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

  • BROWSE : ces données décrivent les vues enregistrées 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 : ces données décrivent les vues enregistrées 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 dans une autre application où la vidéo était intégrée à l'aide d'une intégration <iframe> ou <object>.

  • EXTERNAL_APP : les données décrivent les vues enregistrées 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 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 des clients API YouTube approuvés, y compris des 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 relèvent toujours de cette catégorie. Toutefois, après cette date, les lectures sur mobile seront classées dans les catégories WATCH, EMBEDDED ou EXTERNAL_APP, en fonction du type d'application où elles ont lieu.

  • SEARCH : les données décrivent les vues enregistrées 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 des 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 dans des lecteurs intégrés. Il identifie les lecteurs intégrés ayant généré le plus de vues pour une vidéo spécifiée. Il offre ainsi un affichage plus détaillé que le rapport sur les contextes de lecture, car il identifie les URL ou les applications associées aux principaux lecteurs intégrés.

Exemples

Les exemples de requêtes suivants utilisent les dimensions "Contexte de lecture" :

  • Exemples de canaux

    • Contexte de lecture
      • le nombre de vues et la durée de visionnage pour différents emplacements de lecture ;
      • Nombre de vues quotidiennes et durée de visionnage depuis différents emplacements de lecture
      • Top 10 : sites tiers qui génèrent le plus de vues pour une vidéo intégrée
      • Nombre de vues de la playlist et durée de visionnage depuis différents emplacements de lecture
      • Nombre de vues quotidiennes pour les playlists et durée de visionnage depuis différents emplacements de lecture

  • Exemples de propriétaires de contenu

    • Contexte de lecture
      • le nombre de vues et la durée de visionnage pour différents emplacements de lecture ;
      • Nombre de vues quotidiennes et durée de visionnage depuis différents emplacements de lecture
      • Top 10 : sites tiers qui génèrent le plus de vues pour une vidéo intégrée
      • Nombre de vues de la playlist et durée de visionnage depuis différents emplacements de lecture
      • Nombre de vues quotidiennes pour les playlists et durée de visionnage depuis différents emplacements de lecture

Détails de la lecture

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

Le tableau suivant répertorie les valeurs des dimensions:
Valeurs
LIVE_STREAM Le contenu consulté était une diffusion en direct sur YouTube.
SHORTS Le contenu consulté était un Short YouTube.
STORY le contenu consulté était une story YouTube ;
VIDEO_ON_DEMAND Le contenu consulté correspond à une vidéo YouTube qui n'appartient à aucune des autres dimensions.
UNSPECIFIED Le type de contenu du contenu consulté est inconnu.
liveOrOnDemand
Cette dimension indique si les métriques sur l'activité des utilisateurs de la ligne de données sont associées aux vues d'une diffusion en direct. Les données concernant cette dimension sont disponibles à compter du 1er avril 2014.

Le tableau suivant répertorie les valeurs des dimensions:
Valeurs
LIVE Les données de cette ligne décrivent l'activité de l'utilisateur lors d'une diffusion en direct.
ON_DEMAND Les données de la ligne décrivent une activité de l'utilisateur qui ne s'est pas produite 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 où l'activité de l'utilisateur se produit. Par exemple, supposons qu'un utilisateur ne s'est pas abonné à une chaîne et qu'il regarde l'une des vidéos de cette chaîne, puis s'abonne à la chaîne et regarde une autre vidéo, tout cela le même jour. Le rapport du canal indique qu'une vue a une valeur subscribedStatus de SUBSCRIBED, et une 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 concernant cette dimension sont disponibles depuis le 18 juillet 2015.

Le tableau suivant répertorie les valeurs des dimensions:
Valeurs
CORE L'activité de l'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 dans YouTube Kids.
MUSIC L'activité de l'utilisateur a eu lieu dans YouTube Music à partir du 1er mars 2021. 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 d'URL de provenance, c'est-à-dire la manière dont les utilisateurs ont accédé à la vidéo. Les valeurs possibles pour cette dimension sont les suivantes :
  • ADVERTISING : une publicité a orienté le spectateur vers la vidéo. Si vous définissez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie le type de publicité.
  • ANNOTATION : les spectateurs ont atteint la vidéo en cliquant sur une annotation dans une autre vidéo.
  • CAMPAIGN_CARD : nombre de vues provenant de vidéos revendiquées mises en ligne par des utilisateurs et utilisées par le propriétaire du contenu pour promouvoir le contenu consulté. Cette source de trafic n'est compatible qu'avec les rapports de 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 effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie la page Web. Cette source de trafic inclut les sites référents à partir des résultats de recherche Google.
  • HASHTAGS : les vues proviennent des pages de hashtags de VOD ou des pages pivots avec des hashtags pour les Shorts.
  • LIVE_REDIRECT : les vues des vidéos proviennent de Live Redirect.
  • NO_LINK_EMBEDDED : la vidéo a été intégrée sur un autre site Web lors de son visionnage.
  • NO_LINK_OTHER : YouTube n'a pas identifié d'URL de provenance 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 des vidéos proviennent d'un e-mail ou d'une notification de YouTube.
  • PLAYLIST : nombre de vues de la vidéo lorsqu'elle était en cours de lecture dans le cadre d'une playlist. Cela inclut le trafic provenant de la page de la playlist.
  • PRODUCT_PAGE : les vues des vidéos proviennent d'une page produit.
  • PROMOTED : les vues de la vidéo proviennent d'une publicité YouTube sans frais, telle que la page "Vidéos du moment" de YouTube.
  • RELATED_VIDEO : les vues proviennent d'une liste de vidéos similaires figurant sur la page de lecture d'une autre vidéo. Si vous appliquez un filtre en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie l'ID de la vidéo.
  • SHORTS : le spectateur était redirigé verticalement depuis la vidéo précédente dans l'interface de visionnage des Shorts.
  • SOUND_PAGE : vues provenant des pages pivots de sons Shorts
  • SUBSCRIBER : les vues de vidéos proviennent des flux de la page d'accueil YouTube ou des fonctionnalités d'abonnement de YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie les éléments de flux de la page d'accueil ou une autre page d'où proviennent les vues.
  • YT_CHANNEL : nombre de vues de la vidéo sur la page d'une chaîne Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie l'ID de la chaîne concernée.
  • YT_OTHER_PAGE : les vues de la vidéo proviennent d'un lien autre qu'un résultat de recherche ou une vidéo similaire sur une page YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie la page.
  • YT_SEARCH : les vues des vidéos proviennent des résultats de recherche YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le terme de recherche est spécifié dans le champ insightTrafficSourceDetail.
  • VIDEO_REMIXES : les vues proviennent du lien de la vidéo remixée dans le lecteur Shorts. Si vous appliquez un filtre basé sur cette source de trafic, le champ insightTrafficSourceDetail indique la vidéo d'où provient le spectateur.
insightTrafficSourceDetail
Les données du rapport sont agrégées en fonction des URL de provenance ayant généré le plus de vues pour une vidéo et un type de source de trafic donnés. La liste suivante identifie les sources de trafic pour lesquelles ce rapport est disponible. Pour chaque source de trafic, la liste identifie les informations fournies par la dimension insightTrafficSourceDetail.
  • ADVERTISING : type de publicité ayant généré des vues. Les valeurs possibles sont les suivantes :
    • Annonce ciblant l'engagement click-to-play
    • Annonce ciblant l'engagement
    • Annonces ciblées sur les recherches Google
    • Annonce vidéo sur la page d'accueil
    • InStream désactivable réservé
    • TrueView InSearch et TrueView InDisplay
    • TrueView InStream
    • Publicité sans catégorie sur YouTube
    • Mur de vidéos
  • CAMPAIGN_CARD : 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 similaire qui a conduit les spectateurs à la vidéo couverte dans le rapport.
  • SOUND_PAGE : vidéo ayant généré des vues.
  • SUBSCRIBER : élément du flux de la page d'accueil ou fonctionnalité d'abonnement YouTube qui a redirigé les spectateurs vers la vidéo couverte dans le rapport. Les valeurs possibles sont les suivantes :
    • activity : vues des éléments des flux de page d'accueil auxquels vous êtes abonné, résultant d'activités sur la chaîne autres que des mises en ligne de vidéos et des activités liées aux réseaux sociaux, comme les "J'aime", les favoris, les posts à des bulletins et les ajouts à des playlists.
    • blogged : vues des articles dans les flux de page d'accueil Abonnements résultant de liens provenant de blogs populaires.
    • mychannel : nombre de vues provenant des éléments d'autres flux listés sur la page d'accueil ("J'aime", "Historique des vidéos regardées" et "À regarder plus tard", par exemple).
    • podcasts : vues provenant des éléments de la page de destination Podcasts.
    • sdig : vues provenant des e-mails de mise à jour des abonnements.
    • uploaded : vues des uploaded articles dans les flux "Abonnements" de la page d'accueil.
    • / : autres vues provenant de la page d'accueil YouTube
    • /my_subscriptions : nombre de 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é des vues.

Exemples

Les exemples de requêtes suivants utilisent les dimensions "Source de trafic" :

  • Exemples de canaux

    • Source de trafic
      • le nombre de vues et la durée de visionnage de différentes sources de trafic dans un pays ;
      • Nombre de vues quotidiennes et durée de visionnage 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 qui génèrent le plus de trafic pour une vidéo
      • Nombre de vues de la playlist et durée de visionnage provenant de différentes sources de trafic dans un pays
      • Nombre de vues quotidiennes pour les playlists et durée de visionnage 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 quotidiennes et durée de visionnage 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 qui génèrent le plus de trafic pour une vidéo
      • Nombre de vues de la playlist et durée de visionnage provenant de différentes sources de trafic dans un pays
      • Nombre de vues quotidiennes pour les playlists et durée de visionnage provenant de différentes sources de trafic

Appareils

deviceType
Cette dimension identifie le facteur de forme physique de l'appareil sur lequel la vue a eu lieu. 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 que le rapport sur le système d'exploitation ne contienne que les données correspondant à un type d'appareil spécifique.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Cette dimension identifie le système logiciel de l'appareil sur lequel la vue a eu lieu. La liste suivante identifie les systèmes d'exploitation pour lesquels l'API renvoie des données. Vous pouvez également utiliser le filtre operatingSystem pour qu'un rapport par type d'appareil ne contienne que les 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 les dimensions de l'appareil:

  • Exemples de canaux

    • Appareil/OS
      • Métriques quotidiennes par type d'appareil pour le système d'exploitation Android
      • Métriques quotidiennes du système d'exploitation pour les appareils mobiles
      • Métriques quotidiennes du système d'exploitation et du type d'appareil
      • Métriques quotidiennes par type d'appareil pour les vues de playlists sur le système d'exploitation Android
      • Métriques quotidiennes du système d'exploitation pour les vues des 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 du système d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles
      • Métriques quotidiennes du système d'exploitation et du type d'appareil
      • Métriques quotidiennes par type d'appareil pour les vues de playlists sur le système d'exploitation Android
      • Métriques quotidiennes du système d'exploitation pour les vues des 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 principale)
Cette dimension identifie la tranche d'âge des utilisateurs connectés associée 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.
sexe (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 canaux

    • 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. Vous pouvez partager vos 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
Adresse e-mail Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Messagerie Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
Copier dans le presse-papiers COPY_PASTE
Cymonde CYWORLD
Digg DIGG
Dropbox DROPBOX
Embed EMBED
Adresse e-mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Pages Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Envoyer des SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Message HTC HTC_MMS
Boîte de réception Google INBOX
Boîte de dialogue Activité du système iOS IOS_SYSTEM_ACTIVITY_DIALOG
Histoire KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Adresse e-mail LGE LGE_EMAIL
Ligne LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Avancement 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
Gratte-ciel 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 (essayez Off issues) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Les marchands Yahoo! Japon YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music. YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Pour plus d'informations, consultez la documentation d'aide.

Exemples

Les exemples de requêtes suivants utilisent des dimensions de réseau social:

  • Exemples de canaux

    • Réseaux sociaux: métriques de partage cumulées par service via lequel les vidéos ont été partagées

  • Exemples de propriétaires de contenu

    • Réseaux sociaux: métriques de partage cumulées par service via lequel les vidéos ont été partagées

Rétention d'audience

elapsedVideoTimeRatio
Cette dimension spécifie le rapport entre la durée écoulée de la vidéo et la durée de la vidéo. Les dimensions et métriques de fidélisation permettent de mesurer la rétention d'audience au fil du temps, tandis que la dimension elapsedVideoTimeRatio est la mesure temporelle. Par exemple, la valeur 0.4 indique que les données de rapport correspondantes affichent les données de fidélisation une fois que la vidéo s'est écoulée à 40 %.

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 auxquels 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 à des dates antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toute date ultérieure au 1er juillet 2008.

Exemples

Les exemples de requêtes suivants utilisent des dimensions sur la rétention d'audience:

  • Exemples de canaux

  • Exemples de propriétaires de contenu

Performances des annonces

adType
La dimension adType est utilisée dans les rapports sur les performances des annonces et regroupe les métriques demandées en fonction des types d'annonces diffusées pendant les lectures de vidéos. La liste suivante décrit les valeurs de dimension possibles. Pour en savoir plus sur les formats d'annonces YouTube, consultez le Centre d'aide YouTube.

  • auctionBumperInstream : annonces vidéo non désactivables, placées aux enchères et d'une durée maximale de six secondes, que les internautes 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, dans un bloc d'annonces 300 x 250 sur la page de lecture de la vidéo, ou les deux. Lorsque la superposition s'exécute, 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 simultanément, 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 une sélection affichée 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 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 via un système de réservation et d'une durée maximale de six secondes devant être visionnées avant de pouvoir regarder la 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'internaute lance ou non une lecture. Ces annonces sont vendues via un système de réservations.

  • reservedDisplay : annonce rich media ou illustrée qui s'affiche en superposition en bas du lecteur vidéo, dans un bloc d'annonces 300 x 250 sur la page de lecture de la vidéo, ou les deux. Lorsque la superposition s'exécute, 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 simultanément, 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 : grande annonce, pouvant inclure des éléments vidéo et graphiques, qui s'affiche sur la page d'accueil.

  • reservedUnknown : annonce vendue sur une base réservée qui n'a pas pu être classée dans l'un des autres types d'annonces.

  • unknown : impossible de classer ce type d'annonce.

Exemples

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

  • Exemples de canaux

    • Revenus/Annonces
      • Métriques sur les revenus de la chaîne et les performances des annonces
      • Métriques sur les revenus quotidiens et les performances des annonces
      • Métriques sur les revenus et les performances des annonces spécifiques à chaque pays
      • Top 10 : vidéos aux revenus les plus élevés
      • Métriques sur les 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 le contenu revendiqué
      • Métriques sur les revenus quotidiens et les performances des annonces
      • Métriques sur les revenus et les performances des annonces spécifiques à chaque pays
      • Top 10 : vidéos aux revenus les plus élevés
      • Métriques sur les performances des annonces pour différents types d'annonces

Playlists

isCurated (filtre uniquement)
Ce filtre indique que la requête récupère des données sur les vues de vidéos qui ont eu lieu dans le contexte d'une playlist.

Exemples

Tous les exemples de requêtes permettant de récupérer les rapports sur les playlists utilisent le filtre isCurated.

Dimensions du propriétaire de contenu

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

Important:Les requêtes API pour récupérer des rapports de propriétaires de contenu doivent filtrer les données à l'aide de l'une des dimensions suivantes :
  • video
  • channel
  • Combinaison des dimensions claimedStatus et uploaderType acceptée, comme défini ci-dessous.
ClaimStatus (uniquement utilisé 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 sur 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 du contenu revendiqué. Le tableau de la définition de la dimension uploaderType fournit plus de détails sur la façon d'utiliser cette dimension.
UploaderType (dimension principale) (utilisée uniquement dans les rapports du propriétaire de contenu)
Cette dimension vous permet d'indiquer si une réponse de l'API doit contenir des métriques sur 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 des utilisateurs. Les valeurs valides sont self et thirdParty. Cette dimension principale est soumise au Règlement relatif aux abandons.

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

Valeur claimedStatus Valeur uploaderType Description
|Non définie] moi-même Récupérer les données YouTube Analytics concernant les contenus revendiqués et non revendiqués mis en ligne par le propriétaire de contenu
revendiquées |Non définie] Récupérer les données du contenu revendiqué mis en ligne par le propriétaire du contenu ou par un tiers
revendiquées moi-même Récupère les données du contenu revendiqué mis en ligne par le propriétaire de contenu.
revendiquées thirdParty Récupère les données du contenu revendiqué mis en ligne par un tiers.

Exemples

Un grand nombre d'exemples de requêtes API pour les rapports de propriétaires de contenu utilisent une combinaison compatible des dimensions claimedStatus et uploaderType pour filtrer les données.