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 courants qui sont utilisés pour regrouper les données, comme la date de l'activité de l'utilisateur ou le pays où se trouvait l'utilisateur.

Chaque rapport sur les requêtes identifie les dimensions compatibles. Par exemple, lorsque vous récupérez l'activité des utilisateurs par période, vous choisissez la période pour laquelle les données doivent être enregistrées: jour ou mois. Dans tous les rapports, chaque ligne de données correspond à 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

L'API YouTube Analytics est soumise au règlement relatif aux abandons défini dans les dans les Conditions d'utilisation, les dimensions qui ne sont pas des dimensions principales soumis au règlement. Dans les définitions de cette page, toute dimension principale est explicitement identifiés comme tels.

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 de l'API pour n'inclure que les données correspondant à une valeur ou à un ensemble de valeurs spécifique. Par exemple, au lieu de récupérer les métriques sur l'activité des utilisateurs pour tous les pays, vous pouvez utiliser un filtre pour récupérer uniquement 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 facultatif filters spécifie les valeurs de dimension pour lesquelles vous souhaitez filtrer les données. Par exemple, pour récupérer les métriques sur l'activité des utilisateurs pour l'Europe, vous devez définir la valeur du paramètre filters sur continent==150.

Important:Les requêtes API permettant de récupérer des rapports sur les propriétaires de contenu doivent filtrer les données soit en utilisant l'une des dimensions d'entité de reporting, soit en utilisant 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 gérées par les chaînes et les propriétaires de contenu sur YouTube:

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

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

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

Exemples

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

  • Exemples de chaînes

    • Statistiques de base
      • Top 10 : vidéos les plus regardées d'une chaîne
      • Top 10 – Taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne
      • Statistiques concernant 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 donné
      • 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 pour un propriétaire de contenu
      • Top 10 – Vidéos les plus regardées sur la chaîne d'un propriétaire de contenu
      • Top 10 – Taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne
      • Top 10 : playlists les plus regardées pour 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 lancées 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 américain associé aux métriques de la ligne du rapport. La valeur de la dimension est un code ISO 3166-2 qui identifie un État des États-Unis ou le District de Columbia, tel que 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'accepte pas les valeurs ISO 3166-2 qui identifient les zones éloignées des États-Unis, car ces territoires disposent également de leurs propres codes pays ISO 3166-1. Il ne peut pas non plus accepter les subdivisions de pays autres que les États-Unis.

dma
Identifiant à trois chiffres utilisé par Nielsen pour identifier la zone de marché désignée associés aux événements de visionnage décrits dans la ligne de données.
city
Estimation de la ville associée aux métriques de la ligne du rapport. Les données concernant cette dimension sont disponibles à partir 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 de la filters au paramètre continent==REGION_CODE, en spécifiant une valeur REGION_CODE de la table.
subContinent (filtre uniquement)
Code de région statistique des Nations Unies qui identifie une sous-région géographique. La Division de statistique des Nations Unies répertorie les sous-régions ainsi que les pays associés à 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 UN.

Exemples

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

  • Exemples de chaînes

    • Statistiques de base: nombre de vues par pays (et plus) 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 sur les annotations par pays pour les vidéos d'une chaîne
      • Métriques spécifiques à une province 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 lancées aux États-Unis
    • Contexte de lecture: nombre de vues quotidiennes et durée de visionnage selon les contextes de lecture
    • Source de trafic: nombre de vues et durée de visionnage provenant de différentes sources de trafic dans un pays
    • Données démographiques: données démographiques des spectateurs en Californie (tranche d'âge et genre)
    • Vidéos les plus regardées
      • Top 10 : vidéos les plus regardées dans un pays donné
      • Top 10 : vidéos les plus regardées en Europe

  • Exemples de propriétaires de contenu

    • Statistiques de base: nombre de vues par pays (et plus) 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 sur les annotations propres à chaque pays pour les contenus auto-importés
      • Métriques spécifiques à une province pour les États américains et Washington D.C.
      • Statistiques sur la durée de visionnage des playlists d'un propriétaire de contenu par pays
      • Top 10 : playlists les plus lancées aux États-Unis
    • Contexte de lecture: nombre de vues quotidiennes et durée de visionnage selon les contextes de lecture
    • Données démographiques: données démographiques des spectateurs en Californie (tranche d'âge et genre)
    • Vidéos les plus regardées: top 10 des vidéos les plus regardées en Europe pour un propriétaire de contenu
    • Revenus/Performances des annonces: métriques sur les revenus et les performances des annonces par pays.

Périodes

Ces dimensions indiquent qu'un rapport doit agréger les données sur la base d'une période, telle qu'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 affiche les données jusqu'au dernier jour pour lequel toutes les statistiques spécifiées dans la demande sont disponibles au moment où la requête est effectuée. Dans les rapports, les dates sont listé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 d'ajustement des horloges pour l'heure d'été représentent une période de 23 heures, tandis que les dates pour lesquelles les horloges sont ajustées en arrière représentent une période de 25 heures.

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

day (dimension principale)
Lorsque vous utilisez cette dimension, les données du rapport sont agrégées quotidiennement, et chaque ligne contient les données d'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 des statistiques de visionnage quotidiennes en fonction de la manière dont les utilisateurs accèdent à vos vidéos. This is a core dimension and is subject to the Deprecation Policy.
mois (dimension principale)
Les données du rapport sont agrégées par mois calendaire. Comme pour les rapports quotidiens, vous pouvez utiliser d'autres filtres afin de segmenter encore 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 les 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 filtres ou des dimensions temporelles:

  • Exemples de chaînes

    • Basée sur le temps
      • Métriques sur la durée de visionnage quotidienne des vidéos d'une chaîne
      • Métriques quotidiennes sur les annotations pour les vidéos d'une chaîne
      • Nombre de vues quotidiennes de la playlist d'une chaîne
    • Contexte de lecture: nombre de vues quotidiennes et durée de visionnage selon les contextes de lecture
    • Source de trafic: nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic.
    • Appareil/OS
      • Métriques quotidiennes par type d'appareil pour le système d'exploitation Android
      • Métriques quotidiennes sur les systèmes d'exploitation pour les appareils mobiles
      • Métriques quotidiennes (système d'exploitation et 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-importés
      • Métriques sur les annotations pour le contenu revendiqué
      • Nombre de vues quotidiennes de playlists pour un propriétaire de contenu
    • Contexte de lecture: nombre de vues quotidiennes et durée de visionnage selon les contextes de lecture
    • Source de trafic: nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic.
    • Appareil/OS
      • Métriques quotidiennes par type d'appareil pour les vidéos revendiquées
      • Statistiques quotidiennes sur les systèmes d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles
      • Métriques quotidiennes (système d'exploitation et 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 a eu lieu.

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

<ph type="x-smartling-placeholder">
    </ph>

  • BROWSE : ces données décrivent les vues enregistrées sur la page ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou via une autre fonctionnalité de navigation YouTube.

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

  • EMBEDDED : les données décrivent les vues enregistrées sur un autre site Web ou une autre application où la vidéo a été intégrée à l'aide d'une méthode d'intégration <iframe> ou <object>.

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

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

    Depuis le 10 septembre 2013, les lectures ne sont plus classées comme MOBILE dans les rapports YouTube Analytics. La valeur peut rester dans les rapports, car les anciennes données relèvent toujours de cette catégorie. Toutefois, après cette date, les lectures sur mobile sont classées dans les catégories WATCH, EMBEDDED ou EXTERNAL_APP, selon le type d'application où les lectures sont effectuées.

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

  • WATCH : ces données décrivent les vues enregistrées sur la page de lecture YouTube de la vidéo ou dans une application YouTube officielle, telle que 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 enregistrées dans des lecteurs intégrés. Il identifie les lecteurs intégrés ayant généré le plus de vues pour la vidéo spécifiée. Il offre ainsi un aperçu 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 chaînes

    • Contexte de lecture
      • Le nombre de vues et la durée de visionnage pour différents contextes de lecture
      • Nombre de vues et durée de visionnage par jour pour différents contextes de lecture
      • Top 10 – Sites tiers qui génèrent le plus de vues pour une vidéo intégrée
      • Nombre de vues des playlists et durée de visionnage selon les pays de lecture
      • Nombre de vues de playlists quotidiennes et durée de visionnage selon les 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 contextes de lecture
      • Nombre de vues et durée de visionnage par jour pour différents contextes de lecture
      • Top 10 – Sites tiers qui génèrent le plus de vues pour une vidéo intégrée
      • Nombre de vues des playlists et durée de visionnage selon les pays de lecture
      • Nombre de vues de playlists quotidiennes et durée de visionnage selon les emplacements de lecture

Détails de la lecture

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

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

Le tableau suivant répertorie les valeurs des dimensions:
Valeurs
LIVE Les données de la ligne décrivent l'activité des utilisateurs lors d'une diffusion en direct.
ON_DEMAND Les données de la ligne décrivent les activités des utilisateurs qui n'ont pas eu lieu pendant une diffusion en direct.
subscribedStatus
Cette dimension indique si les métriques sur l'activité des utilisateurs figurant dans la ligne de données sont associées aux spectateurs qui se sont 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 correspond au moment où l'activité de l'utilisateur a lieu. 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 qu'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 relatives à cette dimension sont disponibles depuis le 18 juillet 2015.

Le tableau suivant répertorie les valeurs des dimensions:
Valeurs
CORE Activité de l'utilisateur qui ne s'est pas produite dans l'une des applications YouTube spécifiques (YouTube Gaming, YouTube Kids ou YouTube Music). Exception: les activités des utilisateurs dans YouTube Music avant le 1er mars 2021 sont incluses 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 regroupées en fonction du type d'URL de provenance, qui décrit la manière dont les utilisateurs ont accédé à la vidéo. Les valeurs possibles pour cette dimension sont les suivantes:
  • ADVERTISING : l'internaute a été orienté vers la vidéo via une publicité. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail identifie le type de publicité.
  • ANNOTATION : les spectateurs ont accédé à la vidéo en cliquant sur une annotation dans une autre vidéo.
  • CAMPAIGN_CARD : les vues proviennent de vidéos revendiquées mises en ligne par des utilisateurs et utilisées par le propriétaire du contenu pour promouvoir le contenu qu'il a regardé. Cette source de trafic n'est compatible qu'avec les rapports sur les propriétaires de contenu.
  • END_SCREEN : les vues proviennent de l'écran de fin d'une autre vidéo.
  • EXT_URL : les vues de la vidéo proviennent d'un lien figurant 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 issus des résultats de recherche Google.
  • HASHTAGS : vues provenant des pages avec hashtags pour les vidéos à la demande ou des pages pivots avec les hashtags des Shorts
  • LIVE_REDIRECT : les vues de la vidéo 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 identifié aucune URL de provenance pour le trafic. Cette catégorie englobe les accès directs à une vidéo ainsi que le trafic sur les applications mobiles.
  • NOTIFICATION : les vues de la vidéo proviennent d'un e-mail ou d'une notification de YouTube.
  • PLAYLIST : les vues de la vidéo ont eu lieu pendant la lecture de la vidéo dans le cadre d'une playlist. Cela inclut le trafic provenant de la page de la playlist.
  • PRODUCT_PAGE : les vues de la vidéo proviennent d'une page produit.
  • PROMOTED : les vues de la vidéo proviennent d'une publicité YouTube sans frais, telle que les "Vidéos du moment" YouTube .
  • RELATED_VIDEO : les vues de la vidéo proviennent d'une fiche de vidéos similaires figurant sur une autre page de lecture de vidéos. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie l'ID vidéo de cette vidéo.
  • SHORTS : le spectateur a été orienté en balayant l'écran verticalement de la vidéo précédente dans l'interface de visionnage de Shorts.
  • SOUND_PAGE : vues provenant de pages pivots de sons Shorts.
  • SUBSCRIBER : les vues de la vidéo 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 du flux de la page d'accueil ou la page d'où proviennent les vues.
  • YT_CHANNEL : les vues de la vidéo ont été enregistrées sur une page de chaîne. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie l'ID du canal en question.
  • YT_OTHER_PAGE : les vues de la vidéo proviennent d'un lien autre qu'un résultat de recherche ou un lien vers une vidéo similaire qui s'est affiché 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 de la vidéo proviennent des résultats de recherche YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie le terme de recherche.
  • VIDEO_REMIXES : les vues de la vidéo proviennent du lien de la vidéo remixée dans le lecteur Shorts. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail indique la vidéo de provenance du spectateur.
insightTrafficSourceDetail
Les données du rapport sont regroupé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 répertorie 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 d'annonce ayant généré des vues. Les valeurs possibles sont les suivantes:
    • Annonce ciblant l'engagement click-to-play
    • Annonce ciblant l'engagement
    • Annonces sur le Réseau de Recherche de Google
    • Annonce vidéo sur la page d'accueil
    • InStream désactivable réservé
    • TrueView InSearch et InDisplay
    • TrueView InStream
    • Publicité sans catégorie sur YouTube
    • Sélection de vidéos
  • CAMPAIGN_CARD : vidéo revendiquée qui a conduit les spectateurs à regarder la vidéo identifiée dans le rapport.
  • END_SCREEN : vidéo qui a conduit les spectateurs à regarder la vidéo identifiée dans le rapport.
  • EXT_URL : site Web ayant dirigé les spectateurs vers la vidéo.
  • HASHTAGS : hashtag ayant généré les vues
  • NOTIFICATION : e-mail ou notification ayant généré le trafic
  • RELATED_VIDEO : vidéo similaire qui a conduit les spectateurs à regarder la vidéo couverte dans le rapport.
  • SOUND_PAGE : vidéo ayant généré les vues
  • SUBSCRIBER : élément de flux de la page d'accueil ou fonctionnalité d'abonnement YouTube qui a conduit les internautes à regarder la vidéo couverte par le rapport. Les valeurs possibles sont les suivantes:
    • activity : vues provenant des flux de la page d'accueil auxquels vous êtes abonné, résultant d'activités sur la chaîne autres que des mises en ligne et des activités non liées aux réseaux sociaux, comme les "J'aime", les favoris, les publications au bulletin et les ajouts à des playlists.
    • blogged : vues provenant d'éléments dans les flux d'abonnements de la page d'accueil provenant de liens provenant de blogs les plus populaires.
    • mychannel : vues générées par les articles d'autres flux listés sur la page d'accueil, tels que les "J'aime" "Historique des vidéos regardées" et "À regarder plus tard".
    • podcasts : vues provenant des éléments de la page de destination Podcasts.
    • sdig : vues provenant d'e-mails de mise à jour des abonnements.
    • uploaded : vues provenant des uploaded articles dans les flux d'abonnement de la page d'accueil.
    • / : autres vues provenant de la page d'accueil YouTube
    • /my_subscriptions : vues provenant des utilisateurs Pages Mes abonnements sur YouTube.
  • YT_CHANNEL : page de la chaîne sur laquelle les internautes ont regardé la vidéo.
  • YT_OTHER_PAGE : page YouTube à partir de laquelle les internautes ont été redirigés vers la vidéo.
  • YT_SEARCH : terme de recherche qui a conduit les spectateurs à regarder la vidéo.
  • VIDEO_REMIXES : vidéo ayant généré les vues

Exemples

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

  • Exemples de chaînes

    • Source de trafic
      • Le nombre de vues et la durée de visionnage provenant de différentes sources de trafic dans un pays
      • Nombre de vues et durée de visionnage par jour provenant de différentes sources de trafic
      • Top 10 : termes de recherche YouTube qui génèrent le plus de trafic pour une vidéo
      • Top 10 : termes de recherche Google qui génèrent le plus de trafic pour une vidéo
      • Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic dans un pays
      • Nombre de vues de playlists quotidiennes et durée de visionnage pour différentes sources de trafic

  • Exemples de propriétaires de contenu

    • Source de trafic
      • Nombre de vues et durée de visionnage provenant de différentes sources de trafic
      • Nombre de vues et durée de visionnage par jour provenant de différentes sources de trafic
      • Top 10 : termes de recherche YouTube qui génèrent le plus de trafic pour une vidéo
      • Top 10 : termes de recherche Google qui génèrent le plus de trafic pour une vidéo
      • Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic dans un pays
      • Nombre de vues de playlists quotidiennes et durée de visionnage pour 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 restreindre un rapport sur un système d'exploitation afin qu'il ne contienne que les données d'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 operatingSystem comme filtre pour restreindre un rapport sur le type d'appareil afin qu'il 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 chaînes

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

  • Exemples de propriétaires de contenu

    • Appareil/OS
      • Métriques quotidiennes par type d'appareil pour les vidéos revendiquées
      • Statistiques quotidiennes sur les systèmes d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles
      • Métriques quotidiennes (système d'exploitation et 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 sur les systèmes d'exploitation pour les vues de playlists sur les appareils mobiles

Données démographiques

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

ageGroup (dimension principale)
Cette dimension identifie la tranche d'âge des utilisateurs connectés associés aux données du rapport. L'API utilise les tranches d'âge suivantes:
<ph type="x-smartling-placeholder">
    </ph>
  • 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 demandes suivants utilisent des dimensions démographiques:

  • Exemples de chaînes

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

  • Exemples de propriétaires de contenu

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

Engagement et partage de contenu

sharingService (dimension principale)
Cette dimension identifie le service utilisé pour partager des vidéos. Les vidéos peuvent être partagées sur YouTube (ou via le lecteur YouTube) à l'aide de l'option "Partager" .
This is a core dimension and is subject to the Deprecation Policy.
Le tableau suivant liste les valeurs de dimension valides:
Service de partage Valeur de l'API
Ameba AMEBA
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
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Intégrer EMBED
E-mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Pages Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
SMS Go GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
SMS HTC HTC_MMS
Boîte de réception Google INBOX
Boîte de dialogue "Activité du système iOS" IOS_SYSTEM_ACTIVITY_DIALOG
Histoire de KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Adresse e-mail LGE LGE_EMAIL
Ligne LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Mename MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Partage à proximité NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (地ноклассники) ODNOKLASSNIKI
Autre OTHER
Pinterest PINTEREST
Rakuten (楽天い場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
Tumblr. TUMBLR
Twitter TWITTER
Inconnu UNKNOWN
Messages Verizon VERIZON_MMS
Viber VIBER
VKontakte ( VPCонтакте) (VKontakte) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japon YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

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

Exemples

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

  • Exemples de chaînes

    • Réseaux sociaux: métriques sur le partage, regroupées par service sur lequel des vidéos ont été partagées

  • Exemples de propriétaires de contenu

    • Réseaux sociaux: métriques sur le partage, regroupées par service sur lequel des vidéos ont été partagées

Rétention d'audience

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

L'API renvoie 100 points de données pour chaque vidéo avec des valeurs de ratios comprises entre 0.01 et 1.0. Les moments auxquels les données sont mesurées pendant les lectures vidéo sont espacés de manière égale pour chaque vidéo. Cela signifie que pour une vidéo de deux minutes, l'intervalle entre les points de données est de 1,2 seconde. Cependant, 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 chaînes

  • Exemples de propriétaires de contenu

Streaming en direct

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

Résiliations d'abonnement

membershipsCancellationSurveyReason
Nombre d'enquêtes complétées par des utilisateurs de YouTube ayant annulé leur souscription à la chaîne canal spécifié au cours de la période de référence. Le tableau suivant liste les valeurs de dimension valides:
Valeur de l'API Explication
UNKNOWN L'utilisateur n'a pas répondu à l'enquête.
DISLIKE_PERKS L'utilisateur n'a pas aimé les avantages de la souscription.
PERKS_NOT_DELIVERED L'utilisateur a indiqué que les avantages promis à ses membres n'ont pas été fournis.
CANNOT_ACCESS_PERKS L'utilisateur n'a pas pu accéder aux avantages.
NO_LONGER_INTERESTED L'utilisateur n'est plus intéressé par la souscription à la chaîne.
FEEL_UNAPPRECIATED L'utilisateur ne s'est pas senti apprécié en tant que membre de la chaîne.
FINANCIAL_REASONS L'utilisateur a annulé l'abonnement pour des raisons financières.
JOIN_LIMITED_TIME L'utilisateur ne souhaitait y participer que pour une durée limitée.
OTHER L'utilisateur avait une autre raison d'annuler son abonnement.

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 des 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 mises aux enchères qui durent jusqu'à six secondes et qui doivent être visionnées avant de pouvoir regarder les vidéos.

  • auctionDisplay : annonce illustrée ou rich media qui s'affiche en superposition en bas du lecteur vidéo, sous la forme d'un bloc d'annonces au format 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. 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 une annonce vidéo parmi celles qui s'affichent avant la vidéo. See the TrueView documentation for more information.

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

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

  • reservedBumperInstream : annonces vidéo non désactivables vendues par réservation et d'une durée maximale de six secondes. Les utilisateurs doivent visionner les annonces avant de pouvoir regarder les vidéos.

  • 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 la lecture ou non. Ceux-ci sont vendus sur réservation.

  • reservedDisplay : annonce illustrée ou rich media qui s'affiche en superposition en bas du lecteur vidéo, sous la forme d'un bloc d'annonces au format 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. 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, qui peut inclure des éléments vidéo et graphiques, s'affichant sur la page d'accueil.

  • reservedUnknown : annonce vendue via un système de réservation, qui n'a pas pu être classée dans l'un des autres types d'annonces.

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

Exemples

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

  • Exemples de chaînes

    • Revenus/Annonces
      • Métriques sur les revenus 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 par pays
      • Top 10 : vidéos générant les 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 les contenus revendiqués
      • Métriques sur les revenus quotidiens et les performances des annonces
      • Métriques sur les revenus et les performances des annonces par pays
      • Top 10 : vidéos générant les 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 demande récupère des données sur les visionnages de vidéos ayant eu lieu dans le le contexte d'une playlist.

Exemples

Tous les exemples de demandes qui récupèrent des rapports sur les playlists utilisent le filtre isCurated.

Dimensions du propriétaire de contenu

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

Important:Les requêtes API permettant de récupérer des rapports sur les propriétaires de contenu doivent filtrer les données à l'aide de l'une des dimensions suivantes:
  • video
  • channel
  • Une combinaison acceptée des dimensions claimedStatus et uploaderType, telle que définie ci-dessous.
revendicationStatus (utilisée uniquement dans les rapports sur les propriétaires de contenu)
Cette dimension vous permet d'indiquer qu'une réponse de l'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 l'utilisation de cette dimension.
UploaderType (dimension principale) (utilisée uniquement dans les rapports sur les propriétaires 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 sur 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. Il s'agit d'une dimension principale soumise au Règlement relatif aux abandons.

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

Valeur claimedStatus Valeur uploaderType Description
|Non définie] moi-même Récupère 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ère 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

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