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.

Cada informe de consulta identifica las dimensiones que admite. Por ejemplo, cuando se recupera la actividad del usuario por hora, debes elegir 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 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 en los informes.

Dimensiones principales

Si bien la API de YouTube Analytics está sujeta a la Política de Baja definida en el Condiciones del Servicio, las dimensiones no principales (y las métricas no principales) no sujeto a la política. En las definiciones de esta página, cualquier dimensión que sea una dimensión principal se identificadas explícitamente como tales.

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

Consulta la lista de las 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 valores de dimensión que deben estar presentes en el conjunto de datos recuperado. Como tal, limitan una respuesta de API para incluir solo 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 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 filters opcional especifica los valores de dimensión para los que deseas filtrar datos. Por ejemplo, para recuperar 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 propietario de contenido deben filtrar los datos mediante una de las dimensiones de la entidad de informe o una combinación compatible de las dimensiones claimedStatus y uploaderType.

Dimensiones

Las siguientes secciones definen las dimensiones que se utilizan 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 canales y de propietarios de contenido. También se identifican las dimensiones que solo se pueden utilizar como filtros.

Recursos

Estas dimensiones se corresponden con los recursos que administran los canales y los propietarios del contenido 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 ID de videos, playlists o canales para los que se debe filtrar la respuesta de la API. El valor del parámetro puede especificar hasta 500 ID.

video (dimensión principal)
El ID de un video de YouTube. En la API de datos de YouTube, este es el valor de un video. propiedad id del recurso. 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.
channel (dimensión principal) (solo se usa en los informes de propietarios del 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 suelen recopilar 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

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
      • Las 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 de contenido
      • Los 10 principales: Videos más vistos para un propietario de contenido
      • Los 10 principales: Videos más reproducidos para el canal de un propietario de contenido
      • Los 10 principales: Tasas de clics de anotaciones para los videos más vistos de un canal
      • Las 10 principales: Playlists más vistas para un propietario de contenido
    • Geográfico
      • Los 10 principales: Videos más vistos en Europa por un propietario de contenido
      • Las 10 principales: Playlists más iniciadas en Estados Unidos

Áreas geográficas

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

country (dimensión principal)
El país asociado a las métricas de la fila del informe. El valor de 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
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 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 los Estados Unidos incluyendo 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 es compatible con subdivisiones de países que no sean Estados Unidos.

dma
El identificador de 3 dígitos que Nielsen usa para identificar el Área de mercado designada (DMA) asociados con los eventos de visualización descritos 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 las fechas que comienzan el 1 de enero de 2022.
continent (solo filtro)
Código de región estadística de las Naciones Unidas (ONU). La API admite los siguientes valores:
Valores
002 África
019 América (América del Norte, 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 atributo Parámetro filters para continent==REGION_CODE, que 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í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 usan dimensiones o filtros geográficos:

  • Ejemplos de canales

    • Estadísticas básicas: Muestra los recuentos de vistas específicos de un país (y datos más) 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 por provincia para los estados de EE.UU. y Washington D.C.
      • Métricas de tiempo de reproducción específicas del país para las playlists de un canal
      • Las 10 principales: Playlists más iniciadas en Estados Unidos
    • Ubicación de reproducción: Muestra los recuentos diarios de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Fuente de tráfico: La cantidad de reproducciones y el tiempo de reproducción de diferentes fuentes de tráfico en un país.
    • Datos demográficos: Los datos demográficos de los usuarios en California (grupo de 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: Muestra los recuentos de vistas específicos del país (y otros datos) de 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 por provincia para los estados de EE.UU. y Washington D.C.
      • Métricas de tiempo de reproducción específicas del país para las playlists de un propietario del contenido
      • Las 10 principales: Playlists más iniciadas en Estados Unidos
    • Ubicación de reproducción: Muestra los recuentos diarios de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Datos demográficos: Los datos demográficos de los usuarios en California (grupo de edad y género)
    • Videos más exitosos: Los 10 videos más vistos en Europa por un propietario de contenido
    • Ingresos y rendimiento de los anuncios: Métricas de ingresos y rendimiento de los anuncios 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 que el informe incluye datos. Ten en cuenta que el informe en realidad 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 muestran en formato YYYY-MM-DD.

Importante: Todas las fechas hacen referencia 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. Como resultado, las fechas en las que los relojes se ajustan hacia adelante 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 se refiere 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 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. Se pueden utilizar otras dimensiones para desglosar aún más los datos. Por ejemplo, un informe de fuentes de tráfico puede agregar estadísticas diarias de reproducción según la manera 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, entonces 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 utilizan dimensiones temporales o filtros:

  • Ejemplos de canales

    • Basado 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 las playlists de un canal
    • Ubicación de reproducción: Muestra los recuentos diarios de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Fuente de tráfico: Muestra los recuentos diarios de vistas y el 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 de contenido

    • Basado 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: Muestra los recuentos diarios de vistas y el tiempo de reproducción desde diferentes ubicaciones de reproducción.
    • Fuente de tráfico: Muestra los recuentos diarios de vistas y el 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 y 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 ocurrió 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. Estos son los valores posibles para esta dimensión:

  • BROWSE: los datos describen las vistas que tuvieron lugar en la página principal 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 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 donde el video se incorporó mediante una incorporación <iframe> o <object>.

  • EXTERNAL_APP: los datos describen las vistas 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 clasificarían con este valor.

  • MOBILE: los datos describen las reproducciones que se produjeron en el sitio web móvil de YouTube o en los 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 categorizan 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 donde se produzcan.

  • SEARCH: los datos describen las vistas que se produjeron directamente en la página de resultados de 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 aplicación YouTube para Android.

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

insightPlaybackLocationDetail
Los datos se agregan 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
      • Los recuentos diarios de vistas y el 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
      • Los recuentos de vistas y el tiempo de reproducción de la playlist desde diferentes ubicaciones de reproducción
      • Los recuentos de vistas y el tiempo de reproducción diarios de las playlists de 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
      • Los recuentos diarios de vistas y el 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
      • Los recuentos de vistas y el tiempo de reproducción de la playlist desde diferentes ubicaciones de reproducción
      • Los recuentos de vistas y el tiempo de reproducción diarios de las playlists de diferentes ubicaciones de reproducción

Detalles de 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 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 Short de YouTube.
STORY El contenido visto era una Historia de YouTube.
VIDEO_ON_DEMAND El contenido que se vio corresponde a un video de YouTube que no pertenece a ninguno de los otros valores de dimensión.
UNSPECIFIED No se conoce el tipo de contenido visto.
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 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 se asocian con 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 a partir del momento en que ocurre la actividad del usuario. Por ejemplo, supongamos que un usuario no se suscribió a un canal y mira uno de los videos de ese canal; 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 subscribedStatus de SUBSCRIBED y una vista tiene un valor subscribedStatus de UNSUBSCRIBED.
youtubeProduct
Esta dimensión identifica el servicio de YouTube en el que ocurrió 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 dimensión:
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 del usuario ocurrió 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. Los datos en tiempo real no se registran.
UNKNOWN La actividad del usuario se produjo antes del 18 de julio de 2015.

Fuentes de tráfico

insightTrafficSourceType
Los datos del informe se agregan según el tipo de URL de referencia, lo 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 según 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 vistas se originaron a partir de videos 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 del contenido.
  • END_SCREEN: las vistas proceden de la pantalla final de otro video.
  • EXT_URL: las reproducciones del video proceden 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 referencias de los resultados de la Búsqueda de Google.
  • HASHTAGS: vistas originadas en 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 una notificación de YouTube.
  • PLAYLIST: las vistas del video se produjeron mientras el video se reproducía como parte de una playlist. Incluye el tráfico proveniente de la página de la playlist.
  • PRODUCT_PAGE: Las vistas de video proceden de una página de producto.
  • PROMOTED: las vistas del video proceden de una promoción gratuita de YouTube, por ejemplo, los "videos destacados" 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 filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica el ID de ese video.
  • SHORTS: Se refirió 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 vistas del video proceden de feeds en 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 cualquier otra página de la que provinieron las vistas.
  • YT_CHANNEL: las vistas del video se produjeron en la página de un canal. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especifica el ID del canal para ese canal.
  • YT_OTHER_PAGE: las vistas 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 filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail identifica la página.
  • YT_SEARCH: las reproducciones del video proceden 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 proceden del vínculo del video del remix en el reproductor de Shorts. Si se usa esta fuente de tráfico como filtro, el campo insightTrafficSourceDetail especifica el video del que provino el espectador.
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 específico. La siguiente lista identifica las fuentes de tráfico para las cuales este informe se encuentra disponible. Para cada fuente de tráfico, la lista identifica la información que proporciona la dimensión insightTrafficSourceDetail.
  • ADVERTISING: el tipo de anuncio que generó las vistas. Estos son los posibles valores:
    • Anuncio de participación en el cual se hace 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 dirigió a los espectadores al video identificado en la denuncia.
  • END_SCREEN: el video que dirigió a los usuarios al video identificado en el informe.
  • EXT_URL: el sitio web que recomendó el video a los usuarios.
  • HASHTAGS: Es el hashtag que generó las vistas.
  • NOTIFICATION: el correo electrónico o la notificación que refirió el tráfico.
  • RELATED_VIDEO: el video relacionado que llevó a los usuarios al video mencionado en el informe.
  • SOUND_PAGE: el video que generó las vistas.
  • SUBSCRIBER: el elemento del feed de la página principal o la función de suscripción a YouTube que llevó a los espectadores al video mencionado en el informe. Los valores válidos son los siguientes:
    • activity: vistas de elementos en los feeds de suscripción de la página principal derivadas de la actividad del canal que no es social ni de subida, incluidos los videos que me gustan, los favoritos, las publicaciones en los boletines y las adiciones a playlists.
    • blogged: vistas de elementos en los feeds de suscripción de la página principal derivadas de vínculos de los principales blogs.
    • mychannel: vistas de elementos en otros feeds de la página principal, como "Me gusta", "Historial de reproducciones" y "Ver más tarde".
    • podcasts: reproducciones que se originan a partir de elementos en la página de destino de podcasts.
    • sdig: reproducciones procedentes 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.
    • /: otras vistas que se originan en la página principal de YouTube.
    • /my_subscriptions: reproducciones procedentes de los usuarios Páginas Mis suscripciones en YouTube
  • YT_CHANNEL: la página del canal donde los espectadores miraron 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 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
      • Los recuentos diarios de vistas y el 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
      • Los 10 principales: Términos de la Búsqueda de Google que generan la mayor cantidad de tráfico para un video
      • Los recuentos de vistas y el tiempo de reproducción de las playlists de diferentes fuentes de tráfico en un país
      • Los recuentos de vistas y el tiempo de reproducción diarios de las 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
      • Los recuentos diarios de vistas y el 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
      • Los 10 principales: Términos de la Búsqueda de Google que generan la mayor cantidad de tráfico para un video
      • Los recuentos de vistas y el tiempo de reproducción de las playlists de diferentes fuentes de tráfico en un país
      • Los recuentos de vistas y el tiempo de reproducción diarios de las 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 vio. En la siguiente lista se identifican los tipos de dispositivos para los cuales 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 vio. La siguiente lista identifica los sistemas operativos para los cuales la API muestra datos. También puedes usar operatingSystem como filtro para restringir un informe de tipo de dispositivo para 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 la playlist en el sistema operativo Android
      • Métricas diarias de sistema operativo para las vistas de playlists 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 la playlist en el sistema operativo Android
      • Métricas diarias de sistema operativo para las vistas de playlists en dispositivos móviles

Datos demográficos

Las dimensiones demográficas te permiten 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 asociado 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.
gender (dimensión principal)
Esta dimensión identifica el género de los usuarios que accedieron a sus cuentas 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 (grupo de edad y género)
      • Datos demográficos de usuarios de playlists en California (grupo de edad y género)

  • Ejemplos de propietarios de contenido

    • Datos demográficos
      • Datos demográficos de los usuarios en California (grupo de edad y género)
      • Datos demográficos de usuarios de playlists en California (grupo de 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. de

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
Messenger de Blackberry BBM
Blogger BLOGGER
Copiar en el portapapeles COPY_PASTE
Cyworld CYWORLD
DGG 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
Go GOO
Google+ GOOGLEPLUS
Enviar 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 iOS IOS_SYSTEM_ACTIVITY_DIALOG
Historia sobre KAKAO KAKAO_STORY
Kakao (Charla de Kakao) 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 (igi vehículoкласссаски) ODNOKLASSNIKI
Otro OTHER
Pinterest PINTEREST
Rakuten (以天 {6/}場) 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 (įоimeтакте) 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: Uso compartido de métricas, agrupadas por servicio en el que se compartieron videos

  • Ejemplos de propietarios de contenido

    • Redes sociales: Uso compartido de métricas, agrupadas por servicio en el que se compartieron videos

Retención de público

elapsedVideoTimeRatio
Esta dimensión especifica la proporción entre la parte transcurrida del video y su 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 del informe correspondiente 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 tiempos en los que se miden los datos durante las reproducciones de video se separan de forma equitativa para cada video. Esto significa que, para un video de dos minutos, el intervalo entre datos es de 1.2 segundos. Sin embargo, en el caso de un video de dos horas, el intervalo entre datos es de 72 segundos. El valor de la dimensión denota 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 para 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

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

Transmisión en vivo

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

Cancelaciones de membresías

membershipsCancellationSurveyReason
La cantidad de encuestas que completaron los usuarios de YouTube que cancelaron su membresía del canal para las canal especificado durante el período del informe. En la siguiente tabla, se indican 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 de la membresía prometida.
CANNOT_ACCESS_PERKS El usuario no pudo acceder a los beneficios.
NO_LONGER_INTERESTED El usuario ya no está interesado en la membresía del canal.
FEEL_UNAPPRECIATED El usuario no se sentía apreciado por ser miembro del canal.
FINANCIAL_REASONS El usuario canceló la operación por motivos financieros.
JOIN_LIMITED_TIME El usuario tenía la intención de unirse únicamente por tiempo limitado.
OTHER El usuario tenía otro motivo para la cancelación.

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: Anuncios de video que no se pueden omitir, colocados mediante subastas, de hasta 6 segundos que deben mirarse antes de que se pueda ver el video.

  • auctionDisplay: anuncio con imagen 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: 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 los 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 sobre TrueView para obtener más información.

  • auctionUnknown: 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: Anuncios de video que no se pueden omitir y que se venden mediante reserva y duran un máximo de 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: anuncio con imagen 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 de gran tamaño que puede incluir elementos gráficos y de video, y 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: YouTube no pudo clasificar este tipo de anuncio.

Ejemplos

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

  • Ejemplos de canales

    • Ingresos y 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 anuncios específicas del país
      • Los 10 principales: Videos con los ingresos más altos
      • Métricas de rendimiento de los anuncios para diferentes tipos de anuncios

  • Ejemplos de propietarios de contenido

    • Ingresos y 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 anuncios específicas del país
      • Los 10 principales: Videos con los ingresos más altos
      • 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 ocurrieron en el el contexto de una playlist.

Ejemplos

Todas las solicitudes de ejemplo que recuperan informes de listas de reproducción utilizan 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 propietario de contenido deben filtrar los datos mediante una de las siguientes dimensiones:
  • video
  • channel
  • Se admite una combinación de las dimensiones claimedStatus y uploaderType, como se define a continuación.
reclamadoStatus(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 sobre cómo usar esta dimensión.
UploadType (dimensión principal) (solo se usa en informes de propietarios de contenido)
Esta dimensión te permite indicar si una respuesta de la API debe contener métricas para el contenido subido por el propietario del contenido especificado o para el 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 muestra para informes de propietarios de contenido usan una combinación admitida de las dimensiones claimedStatus y uploaderType para filtrar datos.