Dimensions

En este documento, se definen las dimensiones que admite la API de YouTube Analytics. Esta API admite consultas orientadas 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 la que se produjo la actividad de los usuarios o el país donde se encuentran los usuarios.

Cada informe de consultas identifica las dimensiones que admite. Por ejemplo, para recuperar la actividad del usuario por tiempo, elige 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 dimensiones.

Para recuperar un informe de consultas, invoca el método reports.query de la API de YouTube Analytics. En tu solicitud, usa el parámetro dimensions para especificar las dimensiones que usará YouTube para calcular los valores de las métricas de 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 no principales (y las métricas no principales) no están sujetas a la política. En las definiciones de esta página, cualquier dimensión que sea principal se identifica explícitamente como tal.

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

Consulta la lista de APIs de YouTube sujetas a la Política de Baja para obtener más información.

Filtros

Todos los informes de consultas 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 conjunto de valores en particular. Por ejemplo, en lugar de recuperar las métricas de actividad del usuario de todos los países, podrías usar un filtro para recuperar solo los datos de un país en particular.

En una solicitud para recuperar un informe de consultas, el parámetro de solicitud filters opcional especifica los valores de dimensión para los que deseas filtrar 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 mediante una de las dimensiones de entidad de informe o 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 consultas 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 propietarios de contenido y canales administran en YouTube:

Nota: La API te permite especificar varios valores para las dimensiones video, playlist y channel cuando se usan como filtros. Para hacerlo, establece el valor del parámetro filters en una lista separada por comas del ID de video, la playlist o el 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)
El ID de un video de YouTube. En la API de datos de YouTube, este es el valor de la propiedad id de un recurso video. This is a core dimension and is subject to the Deprecation Policy.
lista de reproducción
El ID de una playlist de YouTube En la API de datos de YouTube, este es el valor de la propiedad id de un recurso playlist.
canal (dimensión principal) (solo se usa en los informes de propietarios de contenido)
El ID de un canal de YouTube. En la API de datos de YouTube, 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, en general, esos informes recopilan datos de varios canales.
group (solo filtro)
El ID de un grupo de YouTube Analytics. Para recuperar este valor, puedes usar 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

Las siguientes solicitudes de ejemplo utilizan dimensiones o filtros de la entidad de informe:

  • Ejemplos de canales

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

  • Ejemplos de propietarios de contenido

    • Estadísticas básicas
      • Los 10 principales: Videos más vistos para un propietario del contenido
      • Los 10 principales: Videos más vistos para un propietario del contenido
      • Los 10 principales: Videos más reproducidos para el canal de un propietario del contenido
      • Los 10 principales: Tasas de clics de anotaciones para los videos más vistos de un canal
      • Los 10 principales: Playlists más vistas para un propietario de contenido
    • Geográfico
      • Los 10 principales: Videos más vistos en Europa para un propietario de contenido
      • Los 10 principales: Playlists más iniciadas 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.

país (dimensión principal)
Es el país asociado a 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 utiliza para informar las métricas con 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 (Míchigan) o US-TX (Texas). El código de provincia US-ZZ se usa para informar las métricas con las que YouTube no pudo identificar el estado asociado de EE.UU. 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 incluyendo country==US en el valor del parámetro filters.

Nota: Esta dimensión no admite valores ISO 3166-2 que identifican á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 que no sean Estados Unidos.

city
Es la ciudad estimada asociada con las métricas de la fila del informe. Los datos de esta dimensión están disponibles para las fechas que comienzan el 1 de enero de 2022.
continent (solo filtro)
Es un código regional estadístico de las Naciones Unidas (ONU). La API admite los siguientes valores:
Valores
002 África
019 América (Norteamérica, Latinoamérica, 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 lista anterior.
subContinent (solo filtro)
Es un código regional estadístico de la ONU que identifica una subregión geográfica. La División de Estadísticas de las Naciones Unidas enumera las subregiones, así como los países que asocia a 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 la ONU.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones geográficas o filtros:

  • Ejemplos de canales

    • Estadísticas básicas: Recuentos de vistas específicos de un país (y otros datos) de un canal
    • Geográfico
      • 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 un país para las playlists de un canal
      • Los 10 principales: Playlists más iniciadas en Estados Unidos
    • Ubicación de reproducción: El recuento diario de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Fuente de tráfico: El recuento de vistas y el 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 (edad y género)
    • Videos más exitosos
      • Los 10 principales: Videos más reproducidos en un país específico
      • Los 10 principales: Videos más vistos en Europa

  • Ejemplos de propietarios de contenido

    • Estadísticas básicas: Recuentos de vistas específicos de cada país (y otros datos) para todos los videos subidos
    • Geográfico
      • 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 un país para las playlists de un propietario del contenido
      • Los 10 principales: Playlists más iniciadas en Estados Unidos
    • Ubicación de reproducción: El recuento diario de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Datos demográficos: Datos demográficos de los usuarios en California (edad y género)
    • Videos más exitosos: Los 10 videos más populares en Europa para un propietario de contenido
    • Ingresos/rendimiento de los anuncios: Métricas de rendimiento de los anuncios y ingresos específicas de cada país

Períodos

Estas dimensiones indican que un informe debe recopilar 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 cual el informe incluye datos. Ten en cuenta que, en realidad, el informe muestra datos hasta el último día para el cual todas las métricas especificadas en la solicitud están disponibles en el momento en que se realiza la consulta. En los informes, las fechas se indican en el formato YYYY-MM-DD.

Importante: Todas las fechas se refieren al período que comienza a las 12:00 a.m., hora del Pacífico (UTC-7 o UTC-8) y finaliza a las 11:59 p.m., hora del Pacífico, del día, mes y año especificados. En consecuencia, las fechas en las que los relojes se ajustan hacia adelante en función del horario de verano representan un período de 23 horas, y las fechas en las que se ajustan los relojes 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) del primer día del mes y del año especificados.

día (dimensión principal)
Cuando usas esta dimensión, los datos del informe se agregan diariamente, 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 diarias de reproducción 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 agregan 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

Las siguientes solicitudes de ejemplo usan dimensiones temporales o filtros:

  • 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 de playlists diarias de un canal
    • Ubicación de reproducción: El recuento diario de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Fuente de tráfico: El tiempo de reproducción y los recuentos de vistas diarios 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 de 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
      • Reproducciones diarias de una playlist de un propietario del contenido
    • Ubicación de reproducción: El recuento diario de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Fuente de tráfico: El tiempo de reproducción y los recuentos de vistas diarios 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 del anuncio: Ingresos diarios y métricas de rendimiento de los anuncios

Ubicaciones 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 reproducciones que tuvieron lugar en la página o pantalla principal de YouTube, en el feed de suscripción del usuario o en otra función de navegación de YouTube.

  • CHANNEL: los datos describen las reproducciones que se produjeron en la página de un canal.

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

  • EXTERNAL_APP: los datos describen las reproducciones que se produjeron en una aplicación de terceros donde el video se reprodujo con un método distinto de las incorporaciones <iframe> o <object>. Por ejemplo, las reproducciones en aplicaciones que utilizan la API del reproductor de YouTube para Android se categorizarán con este valor.

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

    Desde el 10 de septiembre de 2013, las reproducciones ya no se clasifican como reproducciones MOBILE en los informes de YouTube Analytics. El valor puede permanecer 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 reproducciones que se produjeron directamente en la página de resultados de búsqueda de YouTube.

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

  • YT_OTHER: los datos describen vistas que no están clasificadas de otra manera.

insightPlaybackLocationDetail
Los datos se recopilan según 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
      • Recuentos de vistas y tiempo de reproducción diarios de diferentes ubicaciones de reproducción
      • Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado
      • El tiempo de reproducción y los recuentos de vistas de la playlist desde diferentes ubicaciones de reproducción
      • El recuento diario de vistas de playlists y el tiempo de reproducción desde diferentes ubicaciones de reproducción

  • Ejemplos de propietarios de contenido

    • Ubicación de reproducción
      • Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción
      • Recuentos de vistas y tiempo de reproducción diarios de diferentes ubicaciones de reproducción
      • Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado
      • El tiempo de reproducción y los recuentos de vistas de la playlist desde diferentes ubicaciones de reproducción
      • El recuento diario de vistas de playlists y el 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 que comienzan el 1 de enero de 2019.

En la siguiente tabla, se indican los valores de las dimensiones:
Valores
LIVE_STREAM El contenido visto fue una transmisión en vivo de YouTube.
SHORTS El contenido que se vio era un Short de YouTube.
STORY El contenido visto corresponde a una historia de YouTube.
VIDEO_ON_DEMAND El contenido visto era un video de YouTube que no entra en ninguno de los otros valores de dimensión.
UNSPECIFIED Se desconoce el tipo de contenido que se vio.
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 las fechas que comienzan el 1 de abril de 2014.

En la siguiente tabla, se indican los valores de las dimensiones:
Valores
LIVE Los datos de la fila describen la actividad del usuario que se produjo 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 de la fila de datos se asocian con los usuarios que estaban suscritos 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 en el momento en que se produce la actividad del usuario. Por ejemplo, supongamos que un usuario no se suscribió a un canal y mira uno de sus videos. Luego, se suscribe a este y mira otro video el mismo día. El informe del canal indica que una vista tiene un valor subscribedStatus de SUBSCRIBED y una vista tiene un valor 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 desde el 18 de julio de 2015.

En la siguiente tabla, se indican los valores de las dimensiones:
Valores
CORE La actividad del usuario que no ocurrió en una de las aplicaciones especializadas de YouTube (YouTube Gaming, YouTube Kids o YouTube Music). Excepción: La actividad de los usuarios 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 de los usuarios se produjo en YouTube Music el 1 de marzo de 2021 o después de esa fecha. Los datos anteriores al 1 de marzo de 2021 se incluyen en CORE. No se registran los datos en tiempo real.
UNKNOWN La actividad del usuario tuvo lugar antes del 18 de julio de 2015.

Fuentes de tráfico

insightTrafficSourceType
Los datos del informe se recopilan según el tipo de URL de referencia, que describe la forma en que los usuarios llegaron al video. Los valores posibles para esta dimensión son los siguientes:
  • ADVERTISING: al usuario se le recomendó el video mediante un anuncio. Si filtras en función de esta fuente de tráfico, el campo insightTrafficSourceDetail identifica el tipo de anuncio.
  • ANNOTATION: los usuarios llegaron al video al hacer clic en una anotación en otro video.
  • CAMPAIGN_CARD: las reproducciones se originaron de videos subidos por usuarios reclamados y subidos por usuarios que el propietario del contenido utilizó para promocionar el contenido visto. Esta fuente de tráfico solo se admite en los informes de propietarios de contenido.
  • END_SCREEN: las reproducciones proceden de la pantalla final de otro video.
  • EXT_URL: las reproducciones del video proceden de un vínculo en otro sitio web. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail identifica la página web. Esta fuente de tráfico incluye referencias de los resultados de la Búsqueda de Google.
  • HASHTAGS: Las vistas se originaron en las páginas de redireccionamiento de hashtags de VOD o de Shorts.
  • LIVE_REDIRECT: Las vistas del video proceden de Live Redirects.
  • NO_LINK_EMBEDDED: el video estaba incorporado en otro sitio web cuando se reprodujo.
  • 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 reproducciones del video proceden de un correo electrónico o de una notificación de YouTube.
  • PLAYLIST: las reproducciones del video se produjeron mientras el video se reproducía como parte de una lista de reproducción. Incluye el tráfico que proviene de la página de la playlist.
  • PRODUCT_PAGE: Las vistas del video proceden de una página de producto.
  • PROMOTED: las reproducciones del video proceden de una promoción gratuita de YouTube, por ejemplo, la página "Videos resaltados" de YouTube.
  • RELATED_VIDEO: las reproducciones del video proceden de una lista de videos relacionados en otra página de reproducción de videos. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail especifica el ID de video para ese video.
  • SHORTS: Se recomendó al usuario deslizando el dedo verticalmente desde el video anterior en la experiencia de visualización de Shorts.
  • SOUND_PAGE: Las vistas se originaron en las páginas de reorientación de sonido de Shorts.
  • SUBSCRIBER: las reproducciones del video proceden de feeds en la página principal de YouTube o de los elementos de suscripción de YouTube. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail especifica los elementos del feed de la página principal o cualquier otra página desde la que provinieron las vistas.
  • YT_CHANNEL: las reproducciones del video se produjeron en la página de un canal. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail especifica el ID del canal para ese canal.
  • YT_OTHER_PAGE: las reproducciones del video proceden de un vínculo que aparecía en una página de YouTube y que no era un resultado de búsqueda ni un vínculo de un video relacionado. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail identificará la página.
  • YT_SEARCH: las reproducciones del video proceden de los resultados de búsqueda de YouTube. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail especifica el término de búsqueda.
  • VIDEO_REMIXES: las vistas del video proceden del vínculo del video de remix en el reproductor de Shorts. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail especifica el video desde el que llegó al usuario.
insightTrafficSourceDetail
Los datos del informe se agregan según las URLs de referencia que generaron la mayor cantidad de vistas para un video específico y un tipo de fuente de tráfico determinado. En la siguiente lista, se identifican las fuentes de tráfico para las que se encuentra 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 originó las reproducciones. 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: el video reclamado que llevó a los usuarios al video identificado en el informe.
  • END_SCREEN: el video que llevó a los usuarios al video identificado en el informe.
  • EXT_URL: el sitio web que recomendó el video a los espectadores.
  • HASHTAGS: el hashtag que generó las vistas.
  • NOTIFICATION: es el correo electrónico o la notificación de referencia del tráfico.
  • RELATED_VIDEO: el video relacionado que llevó a los espectadores al video mencionado en el informe.
  • SOUND_PAGE: el video que generó las reproducciones.
  • SUBSCRIBER: el elemento del feed de la página principal o la función de suscripción de YouTube que llevó a los espectadores al video mencionado en el informe. Los valores válidos son los siguientes:
    • activity: reproducciones de elementos en los feeds de suscripción de la página principal derivadas de la actividad del canal que no es social ni relacionada con la carga de contenido; por ejemplo, videos que te gustan, favoritos, publicaciones en boletines y adiciones a playlists.
    • blogged: reproducciones de elementos en los feeds de suscripción de la página principal resultantes de los vínculos de los principales blogs.
    • mychannel: vistas de elementos de otros feeds que aparecen en la página principal, como "Me gusta", "Historial de reproducciones" y "Ver más tarde".
    • podcasts: reproducciones que se originan en elementos de la página de destino de Podcasts.
    • sdig: reproducciones procedentes de correos electrónicos de actualización de suscripciones.
    • uploaded: vistas de los uploaded elementos en los feeds de suscripción de la página principal.
    • /: otras reproducciones procedentes de la página principal de YouTube.
    • /my_subscriptions: reproducciones procedentes de las páginas Mis suscripciones de los usuarios en YouTube.
  • YT_CHANNEL: el canal de usuario donde los espectadores vieron el video.
  • YT_OTHER_PAGE: la página de YouTube desde la cual los espectadores llegaron al video.
  • YT_SEARCH: el término de búsqueda que llevó a los espectadores al video.
  • VIDEO_REMIXES: el video que generó las reproducciones.

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
      • El tiempo de reproducción y los recuentos de vistas diarios de distintas 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
      • Los 10 principales: Términos de búsqueda de Google que generan la mayor parte del tráfico para un video
      • El tiempo de reproducción y los recuentos de vistas de la playlist provenientes de diferentes fuentes de tráfico en un país determinado
      • El tiempo de reproducción y los recuentos de vistas de playlists de diferentes fuentes de tráfico

  • Ejemplos de propietarios de contenido

    • Fuente de tráfico
      • Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico
      • El tiempo de reproducción y los recuentos de vistas diarios de distintas 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
      • Los 10 principales: Términos de búsqueda de Google que generan la mayor parte del tráfico para un video
      • El tiempo de reproducción y los recuentos de vistas de la playlist provenientes de diferentes fuentes de tráfico en un país determinado
      • El tiempo de reproducción y los recuentos de vistas de playlists 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 utilizar la dimensión deviceType como filtro para restringir un informe de sistema operativo para que incluya solo 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 cuales la API muestra datos. También se puede usar operatingSystem como filtro para restringir un informe de tipo de dispositivo de modo que incluya solo 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 listas de reproducción en el sistema operativo Android
      • Métricas diarias de sistema operativo para las vistas de listas de reproducción en dispositivos móviles

  • Ejemplos de propietarios de 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 listas de reproducción en el sistema operativo Android
      • Métricas diarias de sistema operativo para las vistas de listas de reproducción 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 la edad de los usuarios que accedieron a sus cuentas y está asociada con los datos del informe. La API utiliza 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 está asociado 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 (edad y género)
      • Datos demográficos de los usuarios de la playlist en California (edad y género)

  • Ejemplos de propietarios de contenido

    • Datos demográficos
      • Datos demográficos de los usuarios en California (edad y género)
      • Datos demográficos de los usuarios de la playlist en California (edad 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 indican los valores de dimensión válidos:
Servicio para compartir contenido Valor de la API
Ameba AMEBA
Correo electrónico de Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Mensajería de Android ANDROID_MMS
Mensajero de BlackBerry BBM
Blogger BLOGGER
Copiar en el portapapeles COPY_PASTE
Cyworld CYWORLD
Gobernación de Digg DIGG
Dropbox DROPBOX
Embed 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
Usar 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
Historia de KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Correo electrónico de LGE LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Mensajería de Motorola MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Compartir con Nearby NEARBY_SHARE
NUjij NUJIJ
Origen ODNOKLASSNIKI
Otra opción OTHER
Pinterest PINTEREST
Rakuten (](/天場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations 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

Para obtener más información, consulta los documentos de ayuda.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones sociales:

  • Ejemplos de canales

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

  • Ejemplos de propietarios de contenido

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

Retención de público

elapsedVideoTimeRatio
Esta dimensión especifica la proporción entre la parte transcurrido del video y la duración. Las dimensiones y métricas de retención se usan para medir la retención de 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 correspondientes del informe muestran datos de retención una vez transcurrido el 40% del video.

La API muestra 100 datos para cada video con valores de proporción que varían de 0.01 a 1.0. Los momentos en los que se miden los datos durante las reproducciones de video están espaciados por igual para cada video. Esto significa que, para un video de dos minutos, el intervalo entre datos es de 1.2 segundos. Sin embargo, para un video de dos horas, el intervalo entre 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 desde el 25 de septiembre de 2013. La API no devuelve datos de consultas que usan el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no usan el filtro funcionan para ninguna fecha posterior al 1 de julio de 2008.

Ejemplos

Las siguientes solicitudes de ejemplo utilizan dimensiones de retención de público:

Rendimiento del anuncio

adType
La dimensión adType se usa en los informes de rendimiento de los anuncios y recopila las métricas solicitadas según 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 una subasta, y que duran hasta 6 segundos que se deben mirar antes de que se inicie el video.

  • auctionDisplay: es un anuncio con imágenes o rich media 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 de 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: Son 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 entre las opciones que se muestran antes del video. See the TrueView documentation for more information.

  • auctionTrueviewInstream: Son anuncios de video que se pueden omitir y que se publican antes o durante el video principal. Consulta la documentación sobre 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 ninguno de los otros tipos de anuncios.

  • reservedBumperInstream: Son anuncios de video que no se pueden omitir y se venden mediante reserva, y duran un máximo de 6 segundos que se deben mirar antes de reproducir 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 con imágenes o rich media 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 de 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: anuncios de video que no se pueden omitir y que 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ó en forma reservada que no se pudo clasificar en uno de los otros tipos de anuncios.

  • unknown: no pudimos clasificar este tipo de anuncio.

Ejemplos

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

  • Ejemplos de canales

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

  • Ejemplos de propietarios de contenido

    • Ingresos/anuncios
      • Métricas de ingresos y rendimiento de anuncios para el contenido reclamado
      • Ingresos diarios y métricas de rendimiento de los anuncios
      • Métricas de ingresos y rendimiento de anuncios específicas del país
      • Los 10 principales: Videos con los mayores ingresos
      • Métricas de rendimiento de los anuncios para diferentes tipos de anuncios

Playlists

isCurated (solo filtro)
Este filtro indica que la solicitud está recuperando datos sobre las vistas de video que se produjeron en el contexto de una playlist.

Ejemplos

Todas las solicitudes de ejemplo que recuperan informes de listas de reproducción usan el filtro isCurated.

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 mediante una de las siguientes dimensiones:
  • video
  • channel
  • A continuación, se muestra una combinación admitida de las dimensiones claimedStatus y uploaderType.
claimStatus (solo se usa en los informes de propietarios de 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 consulta 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 acerca de cómo usar esta dimensión.
CargadorType (dimensión principal) (solo se usa en los informes de propietarios de contenido)
Esta dimensión te permite indicar si una respuesta de la API debe contener métricas para contenido subido por el propietario de contenido especificado o para contenido subido por terceros, como videos subidos por 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 utilizan en el parámetro filters:

Valor claimedStatus Valor uploaderType Descripción
[No configurado] yo 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 yo 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 a la API de ejemplo para los informes de propietarios de contenido usan una combinación admitida de las dimensiones claimedStatus y uploaderType para filtrar datos.