YouTube Analytics API: Channel Reports

Las dimensiones 7DayTotals y 30DayTotals dejarán de estar disponibles. Consulta el Historial de revisión para obtener más información.

Esta página enumera los informes que los propietarios de canales pueden recuperar con la API de YouTube Analytics. Los informes de canales proporcionan métricas de actividad del usuario para un canal específico y miden, por ejemplo, las reproducciones de video, las calificaciones y los recuentos de suscripciones.

  • Los informes de videos proporcionan estadísticas sobre toda la actividad de los usuarios relacionada con los videos de un canal.
  • Los informes de listas de reproducción proporcionan estadísticas relacionadas específicamente con las vistas de los videos que se producen en el contexto de una lista de reproducción.
  • Los informes de rendimiento de los anuncios contienen métricas relacionadas con los ingresos y el rendimiento de los anuncios. Usan la dimensión adType para agrupar las métricas según los tipos de anuncios que se publicaron durante las reproducciones de video. La sección de informes de rendimiento de los anuncios explica los dos tipos de métricas de rendimiento de los anuncios que admite la API.

Recuperación de un informe

Para recuperar un informe de canal, debes establecer el valor del parámetro ids en tu solicitud de API en uno de los siguientes valores:

  • channel==MINE: la API muestra datos para el canal de YouTube del usuario autenticado.

  • channel==CHANNEL_ID: Establece CHANNEL_ID en el ID de canal único del canal del que deseas recuperar los datos. El usuario que autorice la solicitud debe ser el propietario del canal.

    Actualmente, el ID de canal es una string que comienza con las letras UC, aunque su formato está sujeto a cambios. (Puedes encontrar el ID de tu canal en la página configuración avanzada de la cuenta para tu canal de YouTube o puedes recuperar el ID de tu canal de manera programática mediante el método YouTube Data API's channels.list).

Autorización

Se deben autorizar todas las solicitudes de la API de YouTube Analytics. La Guía de autorización explica cómo utilizar el protocolo OAuth 2.0 para recuperar tokens de autorización.

Las solicitudes de la API de YouTube Analytics utilizan los siguientes alcances de autorización:

Permisos
https://www.googleapis.com/auth/yt-analytics.readonly Permite ver informes de YouTube Analytics sobre tu contenido de YouTube. Este alcance proporciona acceso a las métricas de actividad del usuario, como el número de reproducciones y de calificaciones.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Permite ver informes monetarios de YouTube Analytics sobre tu contenido de YouTube. Este alcance proporciona acceso a las métricas de actividad del usuario y a las estimaciones de ingresos y de rendimiento de los anuncios.
https://www.googleapis.com/auth/youtube Permite administrar tu cuenta de YouTube. En la API de YouTube Analytics, los propietarios de canales utilizan este alcance para administrar grupos de YouTube Analytics y elementos de grupos.
https://www.googleapis.com/auth/youtubepartner Ver y administrar los elementos y contenido asociado en YouTube En la API de YouTube Analytics, los propietarios de contenido utilizan este alcance para administrar grupos de YouTube Analytics y elementos de grupos.

Nota: Por el momento, las métricas estimadas de ingresos y rendimiento de los anuncios no son compatibles con los informes de canales. Como resultado, el permiso https://www.googleapis.com/auth/yt-analytics-monetary.readonly no otorga acceso a los datos monetarios en los informes.

Filtros

Las tablas que explican los informes admitidos identifican los filtros que se pueden utilizar para cada informe. En las tablas, los filtros que se muestran entre paréntesis son opcionales. Por ejemplo, para la opción de filtros video(,country), el filtro video es obligatorio, mientras que el filtro país es opcional.

La API también admite la capacidad de especificar varios valores para los filtros video y playlist. Si especifica varios valores para uno de estos filtros, también puede agregar ese filtro a la lista de dimensiones que especifique para la solicitud. Esto ocurrirá incluso si el filtro no aparece como una dimensión admitida para un informe en particular.

Consulta la definición del parámetro filters para obtener una explicación completa de cómo filtrar los resultados de la API por un valor o un conjunto de valores específicos.

Información sobre las tablas de informes

Esta sección explica el formato y la terminología utilizados en las tablas que definen los informes que admite la API. En la siguiente tabla, se enumeran las dimensiones, las métricas y los filtros compatibles con los informes de listas de reproducción del canal basados en el tiempo:

Contenido
Dimensiones:
Usar exactamente 1 day, month
Usa 0 o más subscribedStatus, YouTubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más subscribedStatus, YouTubeProduct

La tabla contiene dos filas para las dimensiones, una para las métricas y cuatro para los filtros. Para las dimensiones y los filtros, los valores de cada fila se pueden combinar en una solicitud a la API, siempre que la combinación siga las reglas de uso de la tabla. Por ejemplo, los valores del parámetro dimensions válidos para este informe son los siguientes:

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Sin embargo, el valor del parámetro day,month no es válido porque usa dos dimensiones basadas en el tiempo, pero la solicitud debe usar exactamente 1. En este caso, el valor del parámetro subscribedStatus,youtubeProduct no muestra un informe, pero las métricas no se agregan por día, semana, mes, etcétera (ese informe se documenta por separado en la documentación).

Terminología de las tablas de informes

Las tablas usan la siguiente terminología para indicar si las dimensiones son obligatorias u opcionales:

  • Estos términos significan que se requiere un valor:
    • Obligatorio: Debe incluir el valor.
    • Use exactamente 1: Debe incluir un valor del grupo.
    • Use 1 o más: Puede incluir uno o todos los valores del grupo, pero debe incluir al menos uno.
  • Estos términos significan que un valor es opcional:
    • Opcional: Tiene la opción de incluir el valor.
    • Usar 0 o 1: puedes incluir un valor del grupo.
    • Usar 0 o más: puedes incluir cualquiera o todos los valores del grupo.

Denuncias de videos

Estadísticas básicas

Estadísticas básicas de la actividad de los usuarios

Este informe proporciona estadísticas relacionadas con las acciones de los usuarios en un canal. Puedes filtrar el informe para que solo muestre los datos de un video o país específico.

Contenido
Dimensiones:
[None]
Métricas:
Usa 1 o más En la
Filtros:
Usa 0 o 1 country, continent y subContinent
Usa 0 o 1 video, group

Estadísticas básicas de la actividad de los usuarios por estado (EE. UU.)

Este informe ofrece las estadísticas de un estado específico de EE. UU. o del Distrito de Columbia. Ten en cuenta que este informe solo incluye un subconjunto de todas las métricas disponibles para el informe específico del país que se mencionaron anteriormente.

Contenido
Dimensiones:
[None]
Métricas:
Usa 1 o más vistas
Filtros:
Obligatoria province
Usa 0 o 1 video, group

Relacionadas con el tiempo

Actividad de los usuarios por país y por período de tiempo específico

Este informe proporciona estadísticas relacionadas con las acciones de los usuarios en un canal en intervalos de tiempo específicos. Puedes filtrar el informe para que solo muestre los datos de un video o país específico.

Contenido
Dimensiones:
Usar exactamente 1 day, month
Opcional creatorContentType
Métricas:
Usa 1 o más En la sección
Filtros:
Usa 0 o 1 country, continent y subContinent
Usa 0 o 1 video, group

Actividad de los usuarios por estado de Estados Unidos y por período de tiempo específico

Este informe proporciona estadísticas relacionadas con la actividad de los usuarios de un estado específico de EE. UU. o del Distrito de Columbia. Ten en cuenta que este informe solo incluye un subconjunto de todas las métricas disponibles para el informe específico del país que se mencionaron anteriormente.

Contenido
Dimensiones:
Usar exactamente 1 day, month
Opcional creatorContentType
Métricas:
Usa 1 o más vistas
Filtros:
Obligatoria province
Usa 0 o 1 video, group

Ubicación geográfica del usuario

Actividad de los usuarios por país

Este informe proporciona estadísticas relacionadas con la actividad de los usuarios en un canal por país. Puedes filtrar el informe para que solo muestre los datos de un video específico.

Contenido
Dimensiones:
Obligatoria country
Opcional creatorContentType
Métricas:
Usa 1 o más En la
Filtros:
Usa 0 o 1 continent, subContinent
Usa 0 o 1 video, group

Actividad de los usuarios por provincia

Este informe proporciona estadísticas de la actividad de los usuarios para los estados de EE. UU. y el Distrito de Columbia. Para este informe, debes establecer el valor del parámetro filters en country==US.

Contenido
Dimensiones:
Obligatoria province
Opcional creatorContentType
Métricas:
Usa 1 o más vistas
Filtros:
Obligatoria country [país]==US
Usa 0 o 1 video, group

Actividad del usuario por ciudad (<= 250 resultados)

Nota: Este informe requiere que el parámetro maxResults tenga un valor entero inferior o igual a 250. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

Este informe proporciona estadísticas de actividad del usuario por ciudad.

Contenido
Dimensiones:
Obligatoria city
Usa 0 o más creatorContentType, country, province, subscribedStatus

Nota: Si incluyes la dimensión province, también debes usar el filtro country==US.
Usa 0 o 1 day, month
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Opciones de clasificación: -views
-estimatedMinutesWatched

Detalles de reproducción

Los informes detallados de reproducción ofrecen estadísticas relacionadas con los siguientes atributos de visualización:

  • ¿La vista de una transmisión de video en vivo o de un video on demand?
  • ¿El espectador estaba suscrito al canal al que pertenece el video?
  • ¿En qué producto de YouTube se produjo la reproducción?

Nota: La dimensión y el filtro liveOrOnDemand no se pueden usar junto con la métrica averageViewPercentage. Por lo tanto, cada una de las siguientes subsecciones muestra dos informes. Un informe admite la dimensión liveOrOnDemand (y el filtro), mientras que el otro es compatible con la métrica averageViewPercentage.

Actividad del usuario por estado de suscripción

En este informe, se proporcionan métricas de actividad de los usuarios para los espectadores suscritos y no suscritos. Las estadísticas se pueden agrupar por período (día o mes), y el informe también se puede filtrar por país, continente o subcontinente.

Contenido
Dimensiones:
Usa 0 o más creatorContentType, subscribedStatus
Usa 0 o 1 day, month
Métricas:
Usa 1 o más 6 horas en promedio, de 1 a 4 en la vista de 649, en comparación con
Filtros:
Usa 0 o 1 country, continent y subContinent
Usa 0 o 1 video, group
Opcional subscribedStatus.

Actividad del usuario por estado de suscripción para provincias

En este informe, se proporcionan métricas de la actividad de los usuarios para los espectadores suscritos y no suscritos de los estados de EE.UU. o del Distrito de Columbia. Este informe admite menos métricas que el anterior.

Contenido
Dimensiones:
Usa 0 o más creatorContentType, subscribedStatus
Usa 0 o 1 day, month
Métricas:
Usa 1 o más vistas
Filtros:
Usa 0 o 1 video, group
Usa 0 o más provincia, subscribedStatus

Detalles de reproducción con dimensión de tiempo opcional

La dimensión de tiempo día o mes es opcional para estos informes porque, de todas formas, debe usar los parámetros de solicitud startDate y endDate para especificar el período que abarcará el informe. La dimensión, si está presente, indica que desea que los datos del informe se agreguen por día, mes, etcétera.

Detalles de reproducción con dimensión de tiempo opcional y estadísticas de liveOrOnDemand

Este informe proporciona estadísticas detalladas de reproducción para intervalos de tiempo específicos. Admite la dimensión liveOrOnDemand (y el filtro).

Contenido
Dimensiones:
Usa 0 o más creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Usa 0 o 1 day, month
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus, youtubeProduct
Detalles de reproducción con dimensión de tiempo opcional y métrica averageViewPercentage

Este informe proporciona estadísticas detalladas de reproducción para intervalos de tiempo específicos. Admite la métrica averageViewPercentage.

Contenido
Dimensiones:
Usa 0 o más creatorContentType, subscribedStatus, youtubeProduct
Usa 0 o 1 day, month
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más subscribedStatus, YouTubeProduct

Detalles de reproducción por país

Detalles de reproducción por país con estadísticas de liveOrOnDemand

Este informe proporciona estadísticas detalladas sobre la reproducción según el país. Admite la dimensión liveOrOnDemand (y el filtro).

Contenido
Dimensiones:
Obligatoria country
Usa 0 o más creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtros:
Usa 0 o 1 continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus, youtubeProduct
Detalles de reproducción por país con la métrica averageViewPercentage

El siguiente informe es similar al anterior. Agrega compatibilidad con la métrica averageViewPercentage, pero no admite liveOrOnDemand como dimensión o filtro.

Contenido
Dimensiones:
Obligatoria country
Usa 0 o más creatorContentType, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Usa 0 o 1 continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más subscribedStatus, YouTubeProduct

Detalles de reproducción por provincia

Detalles de reproducción por provincia con estadísticas de liveOrOnDemand

Este informe proporciona estadísticas detalladas de reproducción para los estados de EE.UU. y el Distrito de Columbia. Admite la dimensión liveOrOnDemand (y el filtro).

Contenido
Dimensiones:
Obligatoria province
Usa 0 o más creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtros:
Obligatoria país==US
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus, youtubeProduct
Detalles de reproducción por provincia con métrica averageViewPercentage

El siguiente informe es similar al anterior. Agrega compatibilidad con la métrica averageViewPercentage, pero no admite liveOrOnDemand como dimensión o filtro.

Contenido
Dimensiones:
Obligatoria province
Usa 0 o más creatorContentType, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Obligatoria país==US
Usa 0 o 1 video, group
Usa 0 o más subscribedStatus, YouTubeProduct

Sitios de reproducción

Informe de ubicación de reproducción de video

Este informe proporciona estadísticas relacionadas con el tipo de página o aplicación en que se reprodujo el video.

Contenido
Dimensiones:
Obligatoria insightPlaybackLocationType
Usa 0 o más creatorContentType, day, liveOrOnDemand, subscribedStatus
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus

Detalle de ubicación de reproducción (<= 25 resultados)

Nota: Este informe requiere que el parámetro maxResults tenga un valor entero inferior o igual a 25. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

Este informe identifica los reproductores de video incorporados que generaron la mayor cantidad de reproducciones o tiempo de reproducción para un video de un canal.

Contenido
Dimensiones:
Obligatoria insightPlaybackLocationDetail
Opcional creatorContentType
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Obligatoria insightPlaybackLocationType==EMBEDDED
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus
Opciones de clasificación: -views
-estimatedMinutesWatched

Fuentes de tráfico

Fuente de tráfico

En este informe se agrupan las estadísticas de visualización según la manera en la que los espectadores llegaron a tu contenido de video. Por ejemplo, se identifica la cantidad de visitas originadas de una búsqueda de Google o de un vínculo a un video relacionado.

Contenido
Dimensiones:
Obligatoria insightTrafficSourceType.
Usa 0 o más creatorContentType, day, liveOrOnDemand, subscribedStatus
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus

Detalle de fuente del tráfico (<= 25 resultados)

Nota: Este informe requiere que el parámetro maxResults tenga un valor entero inferior o igual a 25. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

En este informe se agrupan las estadísticas de reproducción según las URL de referencia que generaron la mayor cantidad de reproducciones para el contenido del canal. Las URL de referencia se clasifican según el tipo de fuente de tráfico, y la definición de la dimensión insightTrafficSourceDetail identifica las fuentes de tráfico para las que el informe está disponible. Por ejemplo, si estableces el filtro insightTrafficSourceType en ADVERTISING, el informe enumerará los tipos de anuncios que generaron la mayor cantidad de reproducciones o tiempo de reproducción para el contenido del canal.

Contenido
Dimensiones:
Obligatoria insightTrafficSourceDetail
Opcional creatorContentType
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Obligatoria insightTrafficSourceType (ver nota debajo de la tabla)
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus
Opciones de clasificación: -views
-estimatedMinutesWatched

Nota: Este informe solo se admite para ciertas fuentes de tráfico específicas. Por ejemplo, la fuente de tráfico NO_LINK_EMBEDDED no tiene detalles adicionales y, por lo tanto, no admite este informe. Consulta la definición de insightTrafficSourceType para obtener información sobre qué fuentes de tráfico admiten este informe.

Tipo de dispositivo y sistema operativo

Tipo de dispositivo

En este informe se agrupan las estadísticas de visualización según la manera en la que los espectadores llegaron a tu contenido de video. Por ejemplo, identifica la cantidad de vistas que se produjeron en dispositivos móviles o consolas de juegos.

Contenido
Dimensiones:
Obligatoria tipodedispositivo
Usa 0 o más creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más operatingSystem, liveOrOnDemand, subscribedStatus y youtubeProduct

Sistema operativo

En este informe se agrupan las estadísticas de reproducción según los sistemas operativos utilizados por los espectadores. Por ejemplo, se identifica la cantidad de reproducciones en dispositivos Android o en consolas PlayStation.

Contenido
Dimensiones:
Obligatoria Sistema operativo
Usa 0 o más creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistema operativo y tipo de dispositivo

En este informe se agrupan las estadísticas de reproducción según los sistemas operativos y los tipos de dispositivos utilizados por los espectadores. Por ejemplo, se identifica la cantidad de reproducciones en tablets Android o en dispositivos de escritorio Windows.

Contenido
Dimensiones:
Obligatoria deviceType, operatingSystem
Usa 0 o más creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus, youtubeProduct

Datos demográficos del espectador

En este informe se agrupan las estadísticas de reproducción según el grupo etario y el sexo de los espectadores.

Contenido
Dimensiones:
Usa 1 o más ageGroup, gender [género]
Usa 0 o más creatorContentType, liveOrOnDemand, subscribedStatus
Métricas:
Usa 1 o más Porcentaje de usuarios
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 video, group
Usa 0 o más liveOrOnDemand, subscribedStatus
Nota: (El valor total de todos los campos de viewerPercentage en el informe es del 200%).

Puedes usar filtros para asegurarte de que el informe solo contenga los datos de viewerPercentage de un valor (o una combinación de valores) para las dimensiones de detalles de reproducción.

Participación y uso compartido de contenido

En este informe se proporcionan estadísticas que muestran la frecuencia con la que se compartieron los videos del canal en distintas plataformas sociales.

Contenido
Dimensiones:
Obligatoria Servicio compartido
Usa 0 o más creatorContentType, subscribedStatus
Métricas:
Usa 1 o más elementos compartidos
Filtros:
Usa 0 o 1 country, continent y subContinent
Usa 0 o 1 video, group
Opcional subscribedStatus.

Retención de público

Este informe mide la capacidad de un video para retener su público. La dimensión elapsedVideoTimeRatio mide la cantidad de video que ha pasado para los valores de métrica correspondientes. Las métricas audienceWatchRatio y relativeRetentionPerformance proporcionan dos mediciones que muestran qué tan bien el video retiene su público. El primero es un valor absoluto, mientras que el segundo muestra el rendimiento del video en comparación con otros videos de YouTube de duración similar.

Nota: Los informes de retención de público no permiten especificar una lista de valores separados por comas para el filtro video; el valor debe especificar un solo ID de video.

Contenido
Dimensiones:
Obligatoria elapsedVideoTimeRatio
Opcional creatorContentType
Métricas:
Usa 1 o más audienceWatchRatio, relativeRetentionPerformance
Filtros:
Obligatoria video
Usa 0 o más audienceType, subscribedStatus, youtubeProduct

Videos más exitosos

Nota: Estos informes requieren que establezcas el parámetro maxResults en un valor entero igual o inferior a 200. Antes del 1.o de enero de 2013, los datos de los diez videos principales están disponibles. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

Los mejores videos con filtros regionales opcionales (<= 200 resultados)

En este informe aparecen los mejores videos del canal. Puedes filtrar el informe para ordenar los videos principales por país, continente o continente.

Contenido
Dimensiones:
Obligatoria video
Opcional creatorContentType
Métricas:
Usa 1 o más En la
Filtros:
Usa 0 o 1 country, continent y subContinent
Opciones de clasificación: -vistas
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-suscriptores perdidos

Los mejores videos por estado (<= 200 resultados)

En este informe aparecen los mejores videos del canal en un estado específico de EE. UU. o en el Distrito de Columbia. Ten en cuenta que este informe solo incluye un subconjunto de todas las métricas disponibles para el informe específico del país que se mencionaron anteriormente.

Contenido
Dimensiones:
Obligatoria video
Opcional creatorContentType
Métricas:
Usa 1 o más vistas
Filtros:
Obligatoria province
Opcional subscribedStatus.
Opciones de clasificación: -vistas
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Los mejores videos para espectadores suscritos o no suscritos(<= 200 resultados)

En este informe, se muestran los videos principales del canal para los espectadores suscritos o no suscritos. Puedes filtrar el informe para ordenar los videos principales por país, continente o continente. El informe anterior te permite recuperar los videos principales de un estado de EE.UU. específico para usuarios suscritos o no suscritos, pero admite menos métricas que este informe.

Contenido
Dimensiones:
Obligatoria video
Opcional creatorContentType
Métricas:
Usa 1 o más 6 horas en promedio, de 1 a 4 en la vista de 649, en comparación con
Filtros:
Opcional subscribedStatus.
Usa 0 o 1 country, continent y subContinent
Opciones de clasificación: -vistas
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Los mejores videos por producto de YouTube (<= 200 resultados)

Este informe enumera los videos principales del canal y admite detalles de reproducción y filtros geográficos. Este informe es similar al anterior, pero admite menos métricas y agrega compatibilidad con el filtro youtubeProduct.

Contenido
Dimensiones:
Obligatoria video
Opcional creatorContentType
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o más subscribedStatus, YouTubeProduct
Opciones de clasificación: -vistas
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Los mejores videos con filtros de detalles de reproducción (<= 200 resultados)

En este informe se enumeran los videos principales del canal, que se filtran según alguna de las dimensiones de los detalles de reproducción (o todas ellas): liveOrOnDemand, subscribedStatus y youtubeProduct. A diferencia del informe anterior, este es compatible con el filtro liveOrOnDemand y no es compatible con la métrica averageViewPercentage.

Contenido
Dimensiones:
Obligatoria video
Opcional creatorContentType
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtros:
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o más liveOrOnDemand, subscribedStatus, youtubeProduct
Opciones de clasificación: -vistas
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Informes de lista de reproducción

Estadísticas básicas

Este informe proporciona estadísticas relacionadas con las interacciones de los usuarios con las listas de reproducción de un canal. Puedes filtrar el informe para que solo muestre los datos de una lista de reproducción o país específico.

Contenido
Dimensiones:
[None]
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más subscribedStatus, YouTubeProduct

Relacionadas con el tiempo

Este informe proporciona estadísticas relacionadas con las interacciones de los usuarios con las listas de reproducción de un canal. Puedes filtrar el informe para que solo muestre los datos de una lista de reproducción o país específico.

Contenido
Dimensiones:
Usar exactamente 1 day, month
Usa 0 o más subscribedStatus, YouTubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más subscribedStatus, YouTubeProduct

Ubicación geográfica del usuario

Actividad de las listas de reproducción por país

Este informe proporciona estadísticas relacionadas con las interacciones de los usuarios con las listas de reproducción de un canal. Puedes filtrar el informe para que solo muestre los datos de una lista de reproducción específica, un grupo de listas de reproducción o un país.

Contenido
Dimensiones:
Obligatoria country
Usa 0 o más subscribedStatus, YouTubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más subscribedStatus, YouTubeProduct

Actividad de la lista de reproducción por provincia

Este informe ofrece estadísticas de actividad de las listas de reproducción de los estados de EE.UU. y el Distrito de Columbia. Para este informe, debes incluir country==US en el valor del parámetro filters.

Contenido
Dimensiones:
Obligatoria province
Usa 0 o más subscribedStatus, YouTubeProduct
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1;país==US
Usa 0 o 1 lista de reproducción, group
Usa 0 o más subscribedStatus, YouTubeProduct

Sitios de reproducción

Este informe proporciona estadísticas relacionadas con el tipo de página o aplicación donde se produjeron las reproducciones de listas de reproducción.

Contenido
Dimensiones:
Obligatoria insightPlaybackLocationType
Usa 0 o más day, subscribedStatus
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Opcional subscribedStatus.

Detalle de ubicación de reproducción (<= 25 resultados)

Nota: Este informe requiere que el parámetro maxResults tenga un valor entero inferior o igual a 25. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

Este informe identifica los reproductores de video insertados que generaron más reproducciones o tiempo de reproducción para las listas de reproducción de un canal.

Contenido
Dimensiones:
Obligatoria insightPlaybackLocationDetail
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1;insightPlaybackLocationType==EMBEDDED
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Opcional subscribedStatus.
Opciones de clasificación: -views
-estimatedMinutesWatched
-playlistStarts.

Fuentes de tráfico

En este informe se agrupan las estadísticas de reproducción según la manera en la que los espectadores llegaron a tu contenido de la lista de reproducción. Por ejemplo, identifica la cantidad de vistas que provienen de una búsqueda en Google.

Contenido
Dimensiones:
Obligatoria insightTrafficSourceType.
Usa 0 o más day, subscribedStatus
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Opcional subscribedStatus.

Detalle de fuente del tráfico (<= 25 resultados)

Nota: Este informe requiere que el parámetro maxResults tenga un valor entero inferior o igual a 25. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

En este informe se agrupan las estadísticas de reproducción según las URL de referencia que generaron la mayor cantidad de reproducciones para las listas de reproducción del canal. Las URL de referencia se clasifican según el tipo de fuente de tráfico, y la definición de la dimensión insightTrafficSourceDetail identifica las fuentes de tráfico para las que el informe está disponible.

Por ejemplo, si configuras el filtro insightTrafficSourceType como ADVERTISING, el informe enumerará los tipos de anuncios que generaron la mayor cantidad de vistas o tiempo de reproducción para las listas de reproducción del canal.

Contenido
Dimensiones:
Obligatoria insightTrafficSourceDetail
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1;insightTrafficSourceType
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Opcional subscribedStatus.
Opciones de clasificación: -views
-estimatedMinutesWatched
-playlistStarts.

Nota: Este informe solo se admite para ciertas fuentes de tráfico específicas. Por ejemplo, la fuente de tráfico NO_LINK_EMBEDDED no tiene detalles adicionales y, por lo tanto, no admite este informe. Consulta la definición de insightTrafficSourceType para obtener información sobre qué fuentes de tráfico admiten este informe.

Tipo de dispositivo y sistema operativo

Tipo de dispositivo

En este informe se agrupan las estadísticas de reproducción según la manera en la que los espectadores llegaron a tu contenido de la lista de reproducción. Por ejemplo, identifica la cantidad de vistas que se produjeron en dispositivos móviles o consolas de juegos.

Contenido
Dimensiones:
Obligatoria tipodedispositivo
Usa 0 o más day, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más operatingSystem, subscribedStatus y youtubeProduct

Sistema operativo

En este informe se agrupan las estadísticas de reproducción según los sistemas operativos utilizados por los espectadores. Por ejemplo, identifica la cantidad de vistas de listas de reproducción que se produjeron en dispositivos Android o en PlayStations.

Contenido
Dimensiones:
Obligatoria Sistema operativo
Usa 0 o más day, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más deviceType, subscribedStatus, youtubeProduct

Sistema operativo y tipo de dispositivo

En este informe se agrupan las estadísticas de reproducción según los sistemas operativos y los tipos de dispositivos utilizados por los espectadores. Por ejemplo, identifica la cantidad de vistas de listas de reproducción que se produjeron en tablets Android o en dispositivos de escritorio Windows.

Contenido
Dimensiones:
Obligatoria deviceType, operatingSystem
Usa 0 o más day, subscribedStatus, youtubeProduct
Métricas:
Usa 1 o más vistas, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Usa 0 o más subscribedStatus, YouTubeProduct

Datos demográficos del espectador

Contenido
Dimensiones:
Usa 1 o más ageGroup, gender [género]
Usa 0 o más subscribedStatus.
Métricas:
Obligatoria Porcentaje de usuarios
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o 1 lista de reproducción, group
Opcional subscribedStatus.
Nota (El valor total de todos los campos de viewerPercentage en el informe es del 200%).

Puedes usar filtros para asegurarte de que el informe solo contenga los datos de viewerPercentage de un valor (o una combinación de valores) para las dimensiones de detalles de reproducción.

Listas de reproducción más exitosas

Nota: Estos informes requieren que establezcas el parámetro maxResults en un valor entero igual o inferior a 200. Antes del 1.o de enero de 2013, los datos solo están disponibles para las diez listas de reproducción principales. A diferencia de la mayoría de los informes, este también requiere que se especifique un valor para el parámetro de solicitud sort.

En este informe aparecen las principales listas de reproducción del canal según los criterios de filtrado y orden especificados.

Contenido
Dimensiones:
Obligatoria lista de reproducción
Métricas:
Usa 1 o más vistas, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obligatoria isCurated==1
Usa 0 o 1 country, province, continent, subContinent
Usa 0 o más lista de reproducción, subscribedStatus, youtubeProduct
Opciones de clasificación: -vistas
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-Starts

Informe de rendimiento de anuncios

Nota: Los informes de rendimiento de los anuncios requieren un token de autorización que otorgue acceso al alcance de https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Los informes de rendimiento de los anuncios proporcionan métricas basadas en impresiones para los anuncios que se publicaron durante las reproducciones de video. Estas métricas representan cada impresión de anuncio y cada reproducción de video puede generar varias impresiones.

Las métricas de rendimiento de los anuncios basadas en las impresiones son:

Además, algunos informes de video admiten las siguientes métricas de rendimiento de los anuncios basadas en la reproducción. Sin embargo, estas métricas no se incluyen en los informes de rendimiento de los anuncios.

Rendimiento del anuncio por tipo de anuncio

Contenido
Dimensiones:
Obligatoria Tipodeanuncio
Opcional día
Métricas:
Usa 1 o más GrossRevenue, adImpressions y cpm
Filtros:
Usa 0 o 1 video, group
Usa 0 o 1 country, continent y subContinent