Dimensions

En este documento, se definen las dimensiones que admite la API de YouTube Analytics. Esta API admite búsquedas segmentadas en tiempo real para generar informes personalizados de YouTube Analytics.

Las dimensiones son criterios comunes que se utilizan para recopilar datos, como la fecha en que se produjo la actividad del usuario o el país donde se encontraban los usuarios.

Cada informe de consulta identifica las dimensiones que admite. Por ejemplo, cuando recuperas la actividad del usuario por hora, eliges el período para el que se informarán los datos: día o mes. En cualquier informe, cada fila de datos tiene una combinación única de valores de dimensión.

Para recuperar un informe de consulta, llama al método reports.query de la API de YouTube Analytics. En tu solicitud, usa el parámetro dimensions para especificar las dimensiones que YouTube usará para calcular los valores de las métricas en los informes.

Dimensiones principales

Si bien la API de YouTube Analytics está sujeta a la Política de Baja definida en las Condiciones del Servicio, las dimensiones y métricas no principales no están sujetas a la política. En las definiciones de esta página, cualquier dimensión que sea una dimensión principal se identifica de forma explícita como tal.

En la siguiente lista, se identifican las dimensiones principales de la API.

Para obtener más información, consulta la lista de las APIs de YouTube sujetas a la Política de Baja.

Filtros

Todos los informes de búsqueda admiten filtros. Los filtros identifican los valores de dimensión que deben estar presentes en el conjunto de datos recuperado. Por lo tanto, limitan una respuesta de la API para que solo incluya datos que coincidan con un valor o un conjunto de valores en particular. Por ejemplo, en lugar de recuperar métricas de actividad del usuario para todos los países, puedes usar un filtro para recuperar solo los datos de un país en particular.

En una solicitud para recuperar un informe de consulta, el parámetro de solicitud opcional filters especifica los valores de dimensión para los que deseas filtrar los datos. Por ejemplo, para recuperar las métricas de actividad del usuario para Europa, debes establecer el valor del parámetro filters en continent==150.

Importante: Las solicitudes a la API para recuperar informes de propietarios de contenido deben filtrar los datos con una de las dimensiones de la entidad de informes o con una combinación admitida de las dimensiones claimedStatus y uploaderType.

Dimensiones

En las siguientes secciones, se definen las dimensiones que se usan en los informes de consulta de la API de YouTube Analytics. A menos que se indique lo contrario, estas dimensiones se usan en los informes de canal y de propietario del contenido. También se identifican las dimensiones que solo se pueden usar como filtros.

Recursos

Estas dimensiones corresponden a los recursos que los canales y los propietarios del contenido administran en YouTube:

Nota: La API te permite especificar varios valores para las dimensiones video, playlist y channel cuando se usan como filtros. Para ello, establece el valor del parámetro filters en una lista separada por comas de los IDs de video, playlist o canal para los que se debe filtrar la respuesta de la API. El valor del parámetro puede especificar hasta 500 IDs.

video (dimensión principal)
Es el ID de un video de YouTube. En la API de YouTube Data, este es el valor de la propiedad id de un recurso video. This is a core dimension and is subject to the Deprecation Policy.
playlist
El ID de una playlist de YouTube. En la API de YouTube Data, este es el valor de la propiedad id de un recurso playlist.
channel (dimensión principal) (solo se usa en los informes de propietarios de contenido)
Es el ID de un canal de YouTube. En la API de YouTube Data, este es el valor de la propiedad id de un recurso channel. This is a core dimension and is subject to the Deprecation Policy.

La dimensión channel se usa con frecuencia en los informes de propietarios de contenido porque, por lo general, estos informes agregan datos de varios canales.
grupo (solo filtro)
Es el ID de un grupo de YouTube Analytics. Puedes recuperar este valor con el método groups.list de la API de YouTube Analytics. Cuando usas el filtro group, la respuesta de la API contiene datos de todos los videos, las playlists o los canales de ese grupo.

Ejemplos

En las siguientes solicitudes de muestra, se usan dimensiones o filtros de entidades de informes:

  • Ejemplos de canales

    • Estadísticas básicas
      • Los 10 principales: Videos más vistos de un canal
      • Top 10: Tasas de clics en las anotaciones de los videos más vistos de un canal
      • Estadísticas de una playlist específica
      • Top 10: Playlists más vistas de un canal
    • Ubicación geográfica
      • Los 10 principales: Videos más reproducidos en un país específico
      • Top 10: Videos más vistos en Europa

  • Ejemplos de propietarios del contenido

    • Estadísticas básicas
      • Top 10: Videos más vistos de un propietario del contenido
      • Top 10: Videos más vistos de un propietario del contenido
      • Top 10: Videos más vistos del canal de un propietario del contenido
      • Top 10: Tasas de clics en las anotaciones de los videos más vistos de un canal
      • Top 10: Playlists más vistas de un propietario del contenido
    • Ubicación geográfica
      • Top 10: Videos más vistos en Europa de un propietario del contenido
      • Top 10: Playlists que más se iniciaron en Estados Unidos

Áreas geográficas

Estas dimensiones identifican una región geográfica asociada con la actividad del usuario, el rendimiento de los anuncios o las métricas de ingresos estimados.

country (dimensión principal)
Es el país asociado con las métricas de la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como US, CN (China) o FR (Francia). El código de país ZZ se usa para informar métricas para las que YouTube no pudo identificar el país asociado. This is a core dimension and is subject to the Deprecation Policy.
province
Es el estado o territorio de EE.UU. asociado con las métricas de la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE.UU. o el Distrito de Columbia, como US-MI (Michigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar métricas para las que YouTube no pudo identificar el estado de EE.UU. asociado. Cuando una solicitud a la API incluye province en el valor del parámetro dimensions, la solicitud también debe restringir los datos a Estados Unidos, ya que incluye country==US en el valor del parámetro filters.

Nota: Esta dimensión no admite valores ISO 3166-2 que identifiquen áreas periféricas de EE.UU., ya que esos territorios también tienen sus propios códigos de país ISO 3166-1. Tampoco admite subdivisiones de países distintos de Estados Unidos.

dma
Es el identificador de 3 dígitos que Nielsen usa para identificar el área de mercado designada (DMA) asociada con los eventos de visualización que se describen en la fila de datos.
city
La ciudad estimada asociada con las métricas de la fila del informe. Los datos de esta dimensión están disponibles para fechas a partir del 1 de enero de 2022.
continent (solo filtro)
Es un código de región estadística de las Naciones Unidas (ONU). La API admite los siguientes valores:
Valores
002 África
019 América (Norteamérica, América Latina, Sudamérica y el Caribe)
142 Asia
150 Europa
009 Oceanía
Esta dimensión solo se puede usar para filtrar datos. Para usar esta dimensión, establece el valor del parámetro filters en continent==REGION_CODE y especifica un valor REGION_CODE de la tabla.
subContinent (solo filtro)
Es un código de región estadística de la ONU que identifica una subregión geográfica. La División de Estadística de las Naciones Unidas enumera las subregiones, así como los países que asocia con cada región.

Esta dimensión solo se puede usar para filtrar datos. Para usar esta dimensión, establece el valor del parámetro filters en subContinent==REGION_CODE y especifica un valor REGION_CODE de la lista de las Naciones Unidas.

Ejemplos

En las siguientes solicitudes de muestra, se usan dimensiones o filtros geográficos:

  • Ejemplos de canales

    • Estadísticas básicas: Cantidad de vistas específicas de un país (y mucho más) para un canal
    • Ubicación geográfica
      • Métricas de tiempo de reproducción específicas de un país para los videos de un canal
      • Métricas de anotaciones específicas del país para los videos de un canal
      • Métricas específicas de la provincia para los estados de EE.UU. y Washington, D.C.
      • Métricas de tiempo de reproducción específicas de cada país para las playlists de un canal
      • Top 10: Playlists que más se iniciaron en Estados Unidos
    • Ubicación de reproducción: Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción
    • Fuente de tráfico: Cantidad de vistas y tiempo de reproducción de diferentes fuentes de tráfico en un país
    • Datos demográficos: Datos demográficos de los usuarios en California (grupo de edad y género)
    • Videos más populares
      • Los 10 principales: Videos más reproducidos en un país específico
      • Top 10: Videos más vistos en Europa

  • Ejemplos de propietarios del contenido

    • Estadísticas básicas: Recuentos de vistas específicos del país (y mucho más) para todos los videos que subiste
    • Ubicación geográfica
      • Métricas de tiempo de reproducción específicas del país para el contenido subido
      • Métricas de anotaciones específicas del país para el contenido subido
      • Métricas específicas de la provincia para los estados de EE.UU. y Washington, D.C.
      • Métricas de tiempo de reproducción específicas de cada país para las playlists de un propietario de contenido
      • Top 10: Playlists que más se iniciaron en Estados Unidos
    • Ubicación de reproducción: Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción
    • Datos demográficos: Datos demográficos de los usuarios en California (grupo de edad y género)
    • Videos más populares: Top 10: Videos más vistos en Europa de un propietario de contenido
    • Ingresos/rendimiento de los anuncios: Métricas de ingresos y rendimiento de los anuncios específicos de un país

Períodos

Estas dimensiones indican que un informe debe agregar datos en función de un período, como un día, una semana o un mes. Los parámetros de solicitud startDate y endDate especifican el período para el que el informe incluye datos. Ten en cuenta que el informe en realidad muestra datos hasta el último día para el que están disponibles todas las métricas especificadas en la solicitud en el momento en que se realiza la consulta. En los informes, las fechas se enumeran en formato YYYY-MM-DD.

Importante: Todas las fechas se refieren al período que comienza a las 12:00 a.m. (UTC-7 o UTC-8) y finaliza a las 11:59 p.m. (UTC-7 o UTC-8) del día, mes y año especificados. Como resultado, las fechas en las que los relojes se ajustan para el horario de verano representan un período de 23 horas, y las fechas en las que los relojes se ajustan hacia atrás representan un período de 25 horas.

La dimensión mes hace referencia al período que comienza a las 12:00 a.m., hora del Pacífico (UTC-7 o UTC-8), el primer día del mes y año especificados.

día (dimensión principal)
Cuando usas esta dimensión, los datos del informe se agregan a diario y cada fila contiene datos de un día. Puedes usar otras dimensiones para desglosar los datos aún más. Por ejemplo, un informe de fuentes de tráfico puede agregar estadísticas de reproducciones diarias según la forma en que los usuarios llegan a tus videos. This is a core dimension and is subject to the Deprecation Policy.
mes (dimensión principal)
Los datos del informe se agrupan por mes calendario. Al igual que con los informes diarios, se pueden utilizar otros filtros para segmentar los datos aún más. En el informe, las fechas se muestran en formato YYYY-MM.

Nota: Si tu consulta a la API usa la dimensión month, los parámetros start-date y end-date deben establecerse en el primer día del mes. This is a core dimension and is subject to the Deprecation Policy.

Ejemplos

En las siguientes solicitudes de muestra, se usan dimensiones o filtros temporales:

  • Ejemplos de canales

    • Basados en el tiempo
      • Métricas de tiempo de reproducción diario para los videos de un canal
      • Métricas de anotación diarias para los videos de un canal
      • Vistas diarias de playlists de un canal
    • Ubicación de reproducción: Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción
    • Fuente de tráfico: Cantidad de vistas diarias y tiempo de reproducción de diferentes fuentes de tráfico
    • Dispositivo/SO
      • Métricas diarias de tipo de dispositivo para el sistema operativo Android
      • Métricas diarias de sistema operativo para dispositivos móviles
      • Métricas diarias de sistema operativo y tipo de dispositivo

  • Ejemplos de propietarios del contenido

    • Basados en el tiempo
      • Métricas de tiempo de reproducción diario para el contenido subido
      • Métricas de anotaciones para el contenido reclamado
      • Vistas diarias de playlists de un propietario de contenido
    • Ubicación de reproducción: Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción
    • Fuente de tráfico: Cantidad de vistas diarias y tiempo de reproducción de diferentes fuentes de tráfico
    • Dispositivo/SO
      • Métricas diarias de tipo de dispositivo para videos reclamados
      • Métricas diarias de sistema operativo para videos reclamados reproducidos en dispositivos móviles
      • Métricas diarias de sistema operativo y tipo de dispositivo
    • Ingresos/rendimiento de los anuncios: Métricas de ingresos diarios y rendimiento de los anuncios

Sitios de reproducción

Estas dimensiones proporcionan estadísticas sobre la página o aplicación en la que se produjo la actividad del usuario.

insightPlaybackLocationType
Los datos del informe se agregan según el tipo de página o aplicación en la que se produjeron las reproducciones de video. Los valores posibles para esta dimensión son los siguientes:

  • BROWSE: Los datos describen las vistas que se produjeron en la página principal o la pantalla principal de YouTube, en el feed de suscripciones del usuario o en otra función de exploración de YouTube.

  • CHANNEL: Los datos describen las vistas que se produjeron en un canal de usuario.

  • EMBEDDED: Los datos describen las vistas que se produjeron en otro sitio web o aplicación en el que el video se incorporó con una incorporación <iframe> o <object>.

  • EXTERNAL_APP: Los datos describen las vistas que se produjeron en una aplicación de terceros en la que se reprodujo el video con un método que no es una incorporación de <iframe> o <object>. Por ejemplo, las reproducciones en aplicaciones que usan la API de YouTube Android Player se categorizarían con este valor.

  • MOBILE: Los datos describen las vistas que se produjeron en el sitio web móvil de YouTube o en clientes aprobados de la API de YouTube, incluidos los dispositivos móviles.

    A partir del 10 de septiembre de 2013, las reproducciones ya no se clasifican como reproducciones MOBILE en los informes de YouTube Analytics. Es posible que el valor permanezca en los informes, ya que los datos heredados aún se incluyen en esa categoría. Sin embargo, después de esa fecha, las reproducciones en dispositivos móviles se clasifican como reproducciones WATCH, EMBEDDED o EXTERNAL_APP, según el tipo de aplicación en la que se producen.

  • SEARCH: Los datos describen las vistas que se generaron directamente en la página de resultados de la Búsqueda de YouTube.

  • WATCH: Los datos describen las vistas que se produjeron en la página de reproducción de YouTube del video o en una aplicación oficial de YouTube, como la app de YouTube para Android.

  • YT_OTHER: Los datos describen vistas que no se clasifican de otra manera.

insightPlaybackLocationDetail
Los datos se agregan en función de la página en la que se encuentra el reproductor. Ten en cuenta que este informe solo se admite para las reproducciones que se produjeron en reproductores integrados, e identifica los reproductores integrados que generaron la mayor cantidad de reproducciones para un video específico. Por lo tanto, proporciona una visión más detallada que el informe de ubicaciones de reproducción mediante la identificación de las direcciones URL o las aplicaciones asociadas con los principales reproductores integrados.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones de ubicación de reproducción:

  • Ejemplos de canales

    • Ubicación de reproducción
      • Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción
      • Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción
      • Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado
      • Cantidad de vistas y tiempo de reproducción de las playlists desde diferentes ubicaciones de reproducción
      • Cantidad de vistas diarias de las playlists y tiempo de reproducción desde diferentes ubicaciones de reproducción

  • Ejemplos de propietarios del contenido

    • Ubicación de reproducción
      • Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción
      • Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción
      • Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado
      • Cantidad de vistas y tiempo de reproducción de las playlists desde diferentes ubicaciones de reproducción
      • Cantidad de vistas diarias de las playlists y tiempo de reproducción desde diferentes ubicaciones de reproducción

Detalles de la reproducción

creatorContentType
Esta dimensión identifica el tipo de contenido asociado con las métricas de actividad del usuario en la fila de datos. Los datos de esta dimensión están disponibles para las fechas a partir del 1 de enero de 2019.

En la siguiente tabla, se indican los valores de la dimensión:
Valores
LIVE_STREAM El contenido que se miró fue una transmisión en vivo de YouTube.
SHORTS El contenido que se miró fue un YouTube Short.
STORY El contenido que se vio fue una Historia de YouTube.
VIDEO_ON_DEMAND El contenido que se vio fue un video de YouTube que no se encuentra en ninguno de los otros valores de dimensión.
UNSPECIFIED Se desconoce el tipo de contenido que se visualizó.
liveOrOnDemand
Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con las vistas de una transmisión en vivo. Los datos de esta dimensión están disponibles para fechas a partir del 1 de abril de 2014.

En la siguiente tabla, se indican los valores de la dimensión:
Valores
LIVE Los datos de la fila describen la actividad del usuario que ocurrió durante una transmisión en vivo.
ON_DEMAND Los datos de la fila describen la actividad del usuario que no ocurrió durante una transmisión en vivo.
subscribedStatus
Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con usuarios que se suscribieron al canal del video o de la playlist. Los valores posibles son SUBSCRIBED y UNSUBSCRIBED.

Ten en cuenta que el valor de la dimensión es preciso a partir del momento en que se produce la actividad del usuario. Por ejemplo, supongamos que un usuario no se ha suscrito a un canal y mira uno de sus videos, luego se suscribe al canal y mira otro video, todo el mismo día. El informe del canal indica que una vista tiene un valor de subscribedStatus de SUBSCRIBED y otra tiene un valor de subscribedStatus de UNSUBSCRIBED.
youtubeProduct
Esta dimensión identifica el servicio de YouTube en el que se produjo la actividad del usuario. Los datos de esta dimensión están disponibles a partir del 18 de julio de 2015.

En la siguiente tabla, se indican los valores de la dimensión:
Valores
CORE La actividad del usuario que no se produjo en una de las aplicaciones de YouTube especializadas (YouTube Gaming, YouTube Kids o YouTube Music) Excepción: La actividad del usuario que se produjo en YouTube Music antes del 1 de marzo de 2021 se incluye en CORE.
GAMING La actividad del usuario se produjo en YouTube Gaming.
KIDS La actividad del usuario se produjo en YouTube Kids.
MUSIC La actividad del usuario se produjo en YouTube Music a partir del 1 de marzo de 2021. Los datos anteriores al 1 de marzo de 2021 se incluyen en CORE. No se registran datos en tiempo real.
UNKNOWN La actividad del usuario ocurrió antes del 18 de julio de 2015.

Fuentes de tráfico

insightTrafficSourceType
Los datos del informe se agregan según el tipo de referencia, que describe la forma en que los usuarios llegaron al video. Los valores posibles para esta dimensión son los siguientes:
  • ADVERTISING: Un anuncio refirió al usuario al video. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail identifica el tipo de anuncio.
  • ANNOTATION: Los usuarios llegaron al video haciendo clic en una anotación de otro video.
  • CAMPAIGN_CARD: Son vistas que se originaron a partir de videos subidos por usuarios y reclamados que el propietario del contenido usó para promocionar el contenido que se vio. Esta fuente de tráfico solo es compatible con los informes de propietarios del contenido.
  • END_SCREEN: Las vistas se refirieron desde la pantalla final de otro video.
  • EXT_URL: Las vistas del video se generaron a partir de un vínculo en otro sitio web. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail identifica la página web. Esta fuente de tráfico incluye las referencias de los resultados de la Búsqueda de Google.
  • HASHTAGS: Vistas que se originaron en páginas de hashtags de VOD o páginas de redireccionamiento de hashtags de Shorts.
  • LIVE_REDIRECT: Las vistas del video se generaron a partir de Live Redirects.
  • NO_LINK_EMBEDDED: El video se incorporó en otro sitio web cuando se miró.
  • NO_LINK_OTHER: YouTube no identificó una URL de referencia para el tráfico. Esta categoría abarca el tráfico directo a un video, así como el tráfico de las aplicaciones móviles.
  • NOTIFICATION: Las vistas del video se generaron a partir de un correo electrónico o una notificación de YouTube.
  • PLAYLIST: Las vistas del video se produjeron mientras se reproducía como parte de una playlist. Incluye el tráfico que proviene de la página de la playlist.
  • PRODUCT_PAGE: Las vistas del video se refirieron desde una página de producto.
  • PROMOTED: Las vistas del video provienen de una promoción no pagada de YouTube, como la página “Videos destacados” de YouTube.
  • RELATED_VIDEO: Las vistas del video se generaron a partir de una ficha de video relacionada en otra página de reproducción de video. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica el ID de video de ese video.
  • SHORTS: El usuario llegó al video deslizando el dedo verticalmente desde el video anterior en la experiencia de reproducción de Shorts.
  • SOUND_PAGE: Son las vistas que se originaron en las páginas de redireccionamiento de sonidos de Shorts.
  • SUBSCRIBER: Las vistas del video se generaron a partir de feeds de la página principal de YouTube o de las funciones de suscripción de YouTube. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica los elementos del feed de la página principal o de otra página desde la que se refirieron las vistas.
  • YT_CHANNEL: Las vistas del video se produjeron en un canal de usuario. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica el ID del canal.
  • YT_OTHER_PAGE: Las vistas del video se generaron a partir de un vínculo que no es un resultado de la búsqueda ni un vínculo a un video relacionado que apareció en una página de YouTube. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail identifica la página.
  • YT_SEARCH: Las vistas del video se generaron a partir de los resultados de la búsqueda de YouTube. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica el término de búsqueda.
  • VIDEO_REMIXES: Las vistas del video se generaron a partir del vínculo del video de remix en el reproductor de Shorts. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica el video desde el que se redireccionó al usuario.
insightTrafficSourceDetail
Los datos del informe se agregan en función de los sitios de referencia que generaron la mayor cantidad de vistas para un video y un tipo de fuente de tráfico específicos. En la siguiente lista, se identifican las fuentes de tráfico para las que está disponible este informe. Para cada fuente de tráfico, la lista identifica la información que proporciona la dimensión insightTrafficSourceDetail.
  • ADVERTISING: Es el tipo de anuncio que generó las vistas. Los valores posibles son los siguientes:
    • Anuncio de participación de clic para reproducir
    • Anuncio de interacción
    • Anuncios de la Red de Búsqueda de Google
    • Anuncios de video en la página principal
    • In-stream que se puede omitir reservado
    • TrueView en resultados de búsqueda y en display
    • TrueView in-stream
    • Publicidad en YouTube sin categoría
    • Muro de videos
  • CAMPAIGN_CARD: Es el video reclamado que llevó a los usuarios al video identificado en el informe.
  • END_SCREEN: Es el video que llevó a los usuarios al video identificado en el informe.
  • EXT_URL: Es el sitio web que derivó a los usuarios al video.
  • HASHTAGS: Es el hashtag que generó las vistas.
  • NOTIFICATION: Es el correo electrónico o la notificación que refirió el tráfico.
  • RELATED_VIDEO: Es el video relacionado que llevó a los usuarios al video que se incluye en el informe.
  • SOUND_PAGE: Es el video que generó las vistas.
  • SUBSCRIBER: Es el elemento del feed de la página principal o la función de suscripción de YouTube que llevó a los usuarios al video que se incluye en el informe. Los valores válidos son los siguientes:
    • activity: Son las vistas de los elementos de los feeds de suscripciones de la página principal que se generaron a partir de actividades del canal que no son de carga ni de redes sociales, como favoritos, videos que gustaron, publicaciones de boletines y adiciones a playlists.
    • blogged: Vistas de los elementos de los feeds de suscripciones de la página principal que se generaron a partir de vínculos de los blogs principales.
    • mychannel: Vistas de elementos de otros feeds que se muestran en la página principal, como "Videos que me gustan", "Historial de reproducciones" y "Ver más tarde".
    • podcasts: Vistas que provienen de elementos de la página de destino de Podcasts.
    • sdig: Vistas que provienen de correos electrónicos de actualización de suscripciones.
    • uploaded: Vistas de los elementos uploaded en los feeds de suscripción de la página principal.
    • /: Son otras vistas que provienen de la página principal de YouTube.
    • /my_subscriptions: Son las vistas que provienen de las páginas Mis suscripciones de los usuarios en YouTube.
  • YT_CHANNEL: Es el canal de usuario en el que los usuarios miraron el video.
  • YT_OTHER_PAGE: Es la página de YouTube desde la que se redireccionó a los usuarios al video.
  • YT_SEARCH: Es el término de búsqueda que llevó a los usuarios al video.
  • VIDEO_REMIXES: Es el video que generó las vistas.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones de fuente de tráfico:

  • Ejemplos de canales

    • Fuente de tráfico
      • Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico en un país
      • Cantidad de vistas diarias y tiempo de reproducción de diferentes fuentes de tráfico
      • Los 10 principales: Términos de búsqueda de YouTube que generan la mayor parte del tráfico para un video
      • Top 10: Términos de la Búsqueda de Google que generan más tráfico para un video
      • Recuentos de vistas y tiempo de reproducción de las playlists de diferentes fuentes de tráfico en un país
      • Recuentos de vistas diarias de playlists y tiempo de reproducción de diferentes fuentes de tráfico

  • Ejemplos de propietarios del contenido

    • Fuente de tráfico
      • Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico
      • Cantidad de vistas diarias y tiempo de reproducción de diferentes fuentes de tráfico
      • Los 10 principales: Términos de búsqueda de YouTube que generan la mayor parte del tráfico para un video
      • Top 10: Términos de la Búsqueda de Google que generan más tráfico para un video
      • Recuentos de vistas y tiempo de reproducción de las playlists de diferentes fuentes de tráfico en un país
      • Recuentos de vistas diarias de playlists y tiempo de reproducción de diferentes fuentes de tráfico

Dispositivos

deviceType
Esta dimensión identifica el factor de forma físico del dispositivo en el que se produjo la vista. En la siguiente lista, se identifican los tipos de dispositivos para los que la API muestra datos. También puedes usar la dimensión deviceType como filtro para restringir un informe de sistema operativo de modo que solo contenga datos de un tipo específico de dispositivo.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Esta dimensión identifica el sistema de software del dispositivo en el que se produjo la vista. En la siguiente lista, se identifican los sistemas operativos para los que la API muestra datos. También puedes usar operatingSystem como filtro para restringir un informe de tipo de dispositivo de modo que solo contenga datos de un sistema operativo específico.
  • 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

Ejemplos

Las siguientes solicitudes de ejemplo utilizan las dimensiones de dispositivos:

  • Ejemplos de canales

    • Dispositivo/SO
      • Métricas diarias de tipo de dispositivo para el sistema operativo Android
      • Métricas diarias de sistema operativo para dispositivos móviles
      • Métricas diarias de sistema operativo y tipo de dispositivo
      • Métricas diarias de tipo de dispositivo para las vistas de playlists en el sistema operativo Android
      • Métricas diarias del sistema operativo para las vistas de playlists en dispositivos móviles

  • Ejemplos de propietarios del contenido

    • Dispositivo/SO
      • Métricas diarias de tipo de dispositivo para videos reclamados
      • Métricas diarias de sistema operativo para videos reclamados reproducidos en dispositivos móviles
      • Métricas diarias de sistema operativo y tipo de dispositivo
      • Métricas diarias de tipo de dispositivo para las vistas de playlists en el sistema operativo Android
      • Métricas diarias del sistema operativo para las vistas de playlists en dispositivos móviles

Datos demográficos

Las dimensiones demográficas te ayudan a comprender el rango de edad y la distribución por género de tu público. El Centro de ayuda de YouTube contiene información adicional sobre los datos demográficos en los informes de YouTube Analytics.

ageGroup (dimensión principal)
Esta dimensión identifica el grupo etario de los usuarios que accedieron a sus cuentas y que están asociados con los datos del informe. La API usa los siguientes grupos etarios:
  • 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.
género (dimensión principal)
Esta dimensión identifica el género de los usuarios que accedieron a sus cuentas y que están asociados con los datos del informe. Los valores válidos son female, male y user_specified. This is a core dimension and is subject to the Deprecation Policy.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones demográficas:

  • Ejemplos de canales

    • Datos demográficos
      • Datos demográficos de los usuarios en California (grupo etario y género)
      • Datos demográficos de los usuarios de playlists en California (grupo etario y género)

  • Ejemplos de propietarios del contenido

    • Datos demográficos
      • Datos demográficos de los usuarios en California (grupo etario y género)
      • Datos demográficos de los usuarios de playlists en California (grupo etario y género)

Participación y uso compartido de contenido

sharingService (dimensión principal)
Esta dimensión identifica el servicio que se usó para compartir videos. Los videos se pueden compartir en YouTube (o con el reproductor de YouTube) con el botón "Compartir". This is a core dimension and is subject to the Deprecation Policy.

En la siguiente tabla, se enumeran los valores de dimensión válidos:
Servicio para compartir contenido Valor de la API
Ameba AMEBA
Correo electrónico de Android ANDROID_EMAIL
Mensajes de Android ANDROID_MESSENGER
Mensajería de Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
Copiar en el portapapeles COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Incorporar EMBED
Correo electrónico MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Páginas de Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
Goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Mensaje de texto de HTC HTC_MMS
Recibidos de Google INBOX
Diálogo de actividad del sistema de iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Correo electrónico de LGE LGE_EMAIL
Línea LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Mensajes de Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Compartir con Nearby NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Otro OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Conversaciones de Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Mensaje de texto TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Desconocido UNKNOWN
Mensajes de Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japón YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Consulta los documentos de ayuda para obtener más información.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones sociales:

  • Ejemplos de canales

    • Redes sociales: Métricas de uso compartido, agregadas por servicio en el que se compartieron los videos

  • Ejemplos de propietarios del contenido

    • Redes sociales: Métricas de uso compartido, agregadas por servicio en el que se compartieron los videos

Retención de público

elapsedVideoTimeRatio
Esta dimensión especifica la proporción entre la parte transcurrido del video y su duración. Las dimensiones y métricas de retención se utilizan para medir la retención del público a lo largo del tiempo, y la dimensión elapsedVideoTimeRatio es la medición del tiempo. Por ejemplo, un valor de 0.4 indica que los datos del informe correspondiente muestran datos de retención después de que transcurrió el 40% del video.

La API muestra 100 datos para cada video con valores de proporción que van de 0.01 a 1.0. Los tiempos en los que se miden los datos durante las reproducciones de video tienen el mismo espacio para cada video. Esto significa que, para un video de dos minutos, el intervalo entre los datos es de 1.2 segundos. Sin embargo, para un video de dos horas, el intervalo entre los datos es de 72 segundos. El valor de la dimensión indica el final exclusivo del intervalo.
audienceType (solo filtro)
El valor de la dimensión identifica el tipo de tráfico asociado con los datos del informe. Los valores admitidos son ORGANIC, AD_INSTREAM y AD_INDISPLAY. Consulta el Centro de ayuda de YouTube para obtener explicaciones sobre estos tipos de fuentes de tráfico.

Ten en cuenta que los datos del filtro audienceType están disponibles a partir del 25 de septiembre de 2013. La API no muestra datos para las consultas que usan el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no usan el filtro funcionan para cualquier fecha posterior al 1 de julio de 2008.

Ejemplos

En las siguientes solicitudes de ejemplo, se usan dimensiones de retención de público:

Transmisión en vivo

livestreamPosition
Esta dimensión especifica un minuto en particular durante una transmisión de video en vivo. Las métricas del informe indican cuántos usuarios estaban mirando la transmisión en vivo en ese momento.

Cancelaciones de membresías

membershipsCancellationSurveyReason
Es la cantidad de encuestas que completaron los usuarios de YouTube que cancelaron su membresía del canal especificado durante el período del informe. En la siguiente tabla, se enumeran los valores de dimensión válidos:
Valor de la API Explicación
UNKNOWN El usuario no completó la encuesta.
DISLIKE_PERKS Al usuario no le gustaron los beneficios de la membresía.
PERKS_NOT_DELIVERED El usuario dijo que no se entregaron los beneficios prometidos de la membresía.
CANNOT_ACCESS_PERKS El usuario no pudo acceder a los beneficios.
NO_LONGER_INTERESTED Al usuario ya no le interesa la membresía del canal.
FEEL_UNAPPRECIATED El usuario sintió que no se le apreciaba como miembro del canal.
FINANCIAL_REASONS El usuario canceló la suscripción por motivos financieros.
JOIN_LIMITED_TIME El usuario solo quería unirse por un tiempo limitado.
OTHER El usuario tenía otro motivo para cancelar.

Rendimiento del anuncio

adType
La dimensión adType se usa en los informes de rendimiento de los anuncios y agrega las métricas solicitadas en función de los tipos de anuncios que se publicaron durante las reproducciones de video. En la siguiente lista, se explican los posibles valores de dimensión. Consulta el Centro de ayuda de YouTube para obtener más información sobre los formatos publicitarios de YouTube.

  • auctionBumperInstream: Son anuncios de video que no se pueden omitir, que se colocan mediante subastas, de hasta 6 segundos, que deben mirarse antes de que se inicie el video.

  • auctionDisplay: Es un anuncio rich media o con imágenes que aparece como una superposición en la parte inferior del reproductor de video, como una unidad de anuncios de 300 x 250 en la página de reproducción del video o como una combinación de ambos. Cuando se publica la superposición, esta se cierra automáticamente después de aparecer durante un lapso de tiempo determinado, y el usuario también puede cerrarla. Si una superposición y un banner se muestran juntos, cada anuncio se cuenta como una impresión diferente.

  • auctionInstream: Anuncios de video que no se pueden omitir y que se publican antes, durante o después del video principal.

  • auctionTrueviewInslate: El usuario elige uno de varios anuncios de video de una selección de opciones que se muestran antes de un video. See the TrueView documentation for more information.

  • auctionTrueviewInstream: Anuncios de video que se pueden omitir y que se publican antes o durante el video principal. Consulta la documentación de TrueView para obtener más información.

  • auctionUnknown: Es un anuncio que se compró a través de la subasta de AdWords, pero que no se clasificó en uno de los otros tipos de anuncios.

  • reservedBumperInstream: Son anuncios de video que no se pueden omitir, vendidos de forma reservada, de hasta 6 segundos que se deben mirar antes de que se inicie el video.

  • reservedClickToPlay: Es un anuncio de video en el que el usuario debe hacer clic para iniciar la reproducción. Se registra una impresión de anuncio cada vez que aparece el bloque anuncios de hacer clic para reproducir, independientemente de que sea el usuario quien inicie la reproducción. Estos se venden en forma reservada.

  • reservedDisplay: Es un anuncio rich media o con imágenes que aparece como una superposición en la parte inferior del reproductor de video, como una unidad de anuncios de 300 x 250 en la página de reproducción del video o como una combinación de ambos. Cuando se publica la superposición, esta se cierra automáticamente después de aparecer durante un lapso de tiempo determinado, y el usuario también puede cerrarla. Si una superposición y un banner se muestran juntos, cada anuncio se cuenta como una impresión diferente.

  • reservedInstream: Son anuncios de video que no se pueden omitir y se insertan antes, durante o después del video principal.

  • reservedInstreamSelect

  • reservedMasthead: Es un anuncio grande que puede incluir elementos gráficos y de video que aparece en la página principal.

  • reservedUnknown: Es un anuncio que se vendió de forma reservada y que no se pudo clasificar en ninguno de los otros tipos de anuncios.

  • unknown: YouTube no pudo clasificar este tipo de anuncio.

Ejemplos

Los siguientes informes de muestra recuperan métricas de rendimiento de los anuncios o de ingresos:

  • Ejemplos de canales

    • Ingresos/anuncios
      • Métricas de ingresos del canal y rendimiento de los anuncios
      • Métricas de ingresos diarios y rendimiento de los anuncios
      • Métricas de ingresos y rendimiento de los anuncios específicas de cada país
      • Top 10: Videos con los ingresos más altos
      • Métricas de rendimiento de los anuncios para diferentes tipos de anuncios

  • Ejemplos de propietarios del contenido

    • Ingresos/anuncios
      • Métricas de ingresos y rendimiento de los anuncios para el contenido reclamado
      • Métricas de ingresos diarios y rendimiento de los anuncios
      • Métricas de ingresos y rendimiento de los anuncios específicas de cada país
      • Top 10: Videos con los ingresos más altos
      • Métricas de rendimiento de los anuncios para diferentes tipos de anuncios

Dimensiones de propietario de contenido

Las siguientes dimensiones solo se admiten en los informes de propietario de contenido.

Importante: Las solicitudes a la API para recuperar informes de propietarios de contenido deben filtrar los datos con una de las siguientes dimensiones:
  • video
  • channel
  • Una combinación admitida de las dimensiones claimedStatus y uploaderType, como se define a continuación.
claimedStatus (solo se usa en los informes de propietarios del contenido)
Esta dimensión te permite indicar que una respuesta de la API solo debe contener métricas para el contenido reclamado. El único valor válido para esta dimensión es claimed. Si el parámetro filters restringe la búsqueda a claimedStatus==claimed, la API solo recuperará datos del contenido reclamado. La tabla en la definición de la dimensión uploaderType proporciona más detalles sobre cómo usarla.
uploaderType (dimensión principal) (solo se usa en los informes de propietarios del contenido)
Esta dimensión te permite indicar si una respuesta de la API debe contener métricas para el contenido que subió el propietario del contenido especificado o el contenido que subieron terceros, como los videos subidos por los usuarios. Los valores válidos son self y thirdParty. Esta es una dimensión principal y está sujeta a la Política de baja.

En la siguiente tabla, se muestran las combinaciones admitidas para las dimensiones claimedStatus y uploaderType, que se usan en el parámetro filters:

Valor claimedStatus Valor uploaderType Descripción
[No configurado] self Recupera datos de YouTube Analytics de contenido reclamado y no reclamado que subió el propietario de contenido.
reclamados [No configurado] Recupera datos de contenido reclamado que subió el propietario de contenido o un tercero.
reclamados self Recupera datos de contenido reclamado que subió el propietario de contenido.
reclamados thirdParty Recupera datos de contenido reclamado que subió un tercero.

Ejemplos

Muchas de las solicitudes de API de muestra para los informes de propietarios de contenido usan una combinación compatible de las dimensiones claimedStatus y uploaderType para filtrar los datos.