Dimensions

Ce document définit les dimensions compatibles avec l'API YouTube Reporting. Cette API permet de récupérer des rapports groupés contenant des données YouTube Analytics pour une chaîne ou un propriétaire de contenu.

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

Chaque rapport groupé est compatible avec une liste prédéfinie de dimensions. Dans chaque rapport, chaque ligne de données présente une combinaison unique de valeurs de dimension. Ainsi, la combinaison de valeurs de dimension de chaque ligne sert de clé primaire pour cette ligne. Vous n'avez pas besoin de spécifier les dimensions à inclure dans le rapport.

Dimensions principales

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

La liste suivante identifie les dimensions principales de l'API. Elles sont toutes des dimensions clés de l'API YouTube Analytics.

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

Dimensions

Les sections suivantes définissent les dimensions utilisées dans les rapports groupés de l'API YouTube Reporting. Sauf indication contraire, ces dimensions sont utilisées dans les rapports sur les chaînes et les propriétaires de contenu.

Ressources

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

video_id (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
ID d'une playlist YouTube. Dans l'API YouTube Data, il s'agit de la valeur de la propriété id d'une ressource playlist.
channel_id (dimension principale)
 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.
asset_id (utilisé uniquement dans les rapports sur les propriétaires de contenu)
Identifiant d'un élément géré dans le système Content ID de YouTube. Un élément représente votre propriété intellectuelle dans ce système. Sur le site Web YouTube, vous pouvez trouver les ID des éléments dans le Gestionnaire de contenu YouTube. Vous pouvez également les récupérer à l'aide de l'API YouTube Content ID.

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_code (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, comme 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_code
 É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 américain ou le district de Columbia, comme US-MI (Michigan) ou US-TX (Texas). Le code de province US-ZZ est utilisé pour signaler les métriques pour lesquelles YouTube n'a pas pu identifier l'État américain associé.

Remarque : Cette dimension n'est pas compatible avec les valeurs ISO 3166-2 qui identifient les territoires éloignés 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.

Périodes

date (dimension principale)
Cette dimension identifie la date associée aux métriques de chaque ligne du rapport. Dans les rapports groupés, la date fait référence à la période commençant à 0h00 heure du Pacifique et se terminant à 23h59 heure du Pacifique le jour, le mois et l'année spécifiés. Selon la période de l'année, l'heure du Pacifique correspond à UTC-7 ou UTC-8.

Notez que si les dates représentent généralement une période de 24 heures, celles où l'heure est avancée pour l'heure d'été représentent une période de 23 heures, et celles où l'heure est reculée représentent une période de 25 heures. This is a core dimension and is subject to the Deprecation Policy.

Contextes de lecture

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

playback_location_type
Cette dimension identifie le type de page ou d'application sur lequel l'activité de l'utilisateur a eu lieu. Le tableau suivant répertorie les valeurs de dimension :
Valeur Description
0 Les données concernent l'activité qui s'est produite sur la page de lecture YouTube de la vidéo ou dans une application YouTube officielle, comme l'application YouTube pour Android.
1 Ces données concernent l'activité qui s'est produite 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>.
2 Les données concernent l'activité qui s'est produite sur la page d'une chaîne YouTube.
5 Les données concernent les métriques qui ne peuvent pas être classées dans l'un des autres types de lieux listés.
7 Les données concernent les vues qui ont eu lieu sur la page ou l'écran d'accueil YouTube, dans le flux Abonnements de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.
8 Les données concernent les vues qui ont eu lieu directement sur la page de résultats de recherche YouTube.
10 Les données concernent les vues enregistrées dans le flux YouTube Shorts.
playback_location_detail
Cette dimension spécifie l'URL ou l'application où la lecture a eu lieu. Cette dimension n'est compatible qu'avec les vues qui se sont produites dans des lecteurs intégrés. Cela signifie que la valeur de la dimension n'est renseignée que dans les lignes où la valeur de la dimension est 1. Dans les autres lignes, la valeur de cette dimension est vide.

Détails de la lecture

live_or_on_demand
Cette dimension indique si les métriques d'activité de l'utilisateur de la ligne de données sont associées à des vues d'une diffusion en direct. Les données de cette dimension sont disponibles pour les dates à partir du 1er avril 2014.

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

Notez que la valeur de la dimension est exacte au moment où l'activité de l'utilisateur se produit. Par exemple, supposons qu'un utilisateur ne soit pas abonné à une chaîne et qu'il regarde l'une de ses vidéos, puis qu'il s'abonne à la chaîne et regarde une autre vidéo, le tout le même jour. Le rapport de la chaîne indique qu'une vue a une valeur subscribed_status de subscribed et qu'une autre vue a une valeur subscribed_status de unsubscribed.

Sources de trafic

traffic_source_type
Cette dimension identifie le type de provenance associé aux métriques sur l'activité des utilisateurs. Le type de provenance décrit la manière dont les utilisateurs ont accédé à la vidéo ou à la chaîne associées à la ligne de données du rapport. Le tableau suivant répertorie les valeurs de dimension :
Valeur Description
0 Source directe ou inconnue
 Cette valeur englobe le trafic direct vers une page, ainsi que les pages pour lesquelles le site référent est inconnu. Dans les rapports sur les requêtes, ce type de source de trafic est identifié comme NO_LINK_OTHER ou UNKNOWN_MOBILE_OR_DIRECT.