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 ressourcevideo
. 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 ressourceplaylist
. - 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 ressourcechannel
. This is a core dimension and is subject to the Deprecation Policy.
La dimensionchannel
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 filtregroup
, 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
-
Statistiques de base
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
-
Statistiques de base
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) ouFR
(France). Le code paysZZ
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) ouUS-TX
(Texas). Le code de provinceUS-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 inclutprovince
dans la valeur du paramètredimensions
, elle doit également limiter les données aux États-Unis en incluantcountry==US
dans la valeur du paramètrefilters
.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 filters
surcontinent==REGION_CODE
, en spécifiant l'une des valeurs deREGION_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
sursubContinent==REGION_CODE
, en spécifiant une valeurREGION_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 dimensionmonth
, les paramètresstart-date
etend-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
-
Basée sur le temps
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
-
Basée sur le temps
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égoriesWATCH
,EMBEDDED
ouEXTERNAL_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
-
Contexte 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
-
Contexte 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
etUNSUBSCRIBED
.
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 valeursubscribedStatus
deSUBSCRIBED
, et une vue a une valeursubscribedStatus
deUNSUBSCRIBED
. - 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 champinsightTrafficSourceDetail
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 champinsightTrafficSourceDetail
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 champinsightTrafficSourceDetail
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 ShortsSUBSCRIBER
: 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 champinsightTrafficSourceDetail
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 champinsightTrafficSourceDetail
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 champinsightTrafficSourceDetail
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 champinsightTrafficSourceDetail
.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 champinsightTrafficSourceDetail
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 desuploaded
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
-
Source 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
-
Source 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
-
Appareil/OS
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
-
Appareil/OS
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-
- 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
etuser_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)
-
Données démographiques
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)
-
Données démographiques
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 valeur0.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 de0.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
etAD_INDISPLAY
. Pour en savoir plus sur ces types de sources de trafic, consultez le Centre d'aide YouTube.
Notez que les données du filtreaudienceType
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
- Rétention d'audience: métriques sur la rétention d'audience pour une vidéo
Exemples de propriétaires de contenu
- Rétention d'audience: métriques sur la rétention d'audience pour une vidéo
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
-
Revenus/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
-
Revenus/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.
- 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ètrefilters
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 dimensionuploaderType
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
etthirdParty
. Cette dimension principale est soumise au Règlement relatif aux abandons.
Le tableau ci-dessous présente les combinaisons acceptées pour les dimensionsclaimedStatus
etuploaderType
, toutes deux utilisées dans le paramètrefilters
:
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.