En esta página se incluyen los informes que los propietarios de canales pueden obtener con la API de YouTube Analytics. Los informes de canales proporcionan métricas de la actividad de los usuarios para un canal específico y miden aspectos como las vistas de video, las calificaciones y los recuentos de suscripciones.
Los informes de videos proporcionan estadísticas para 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 videos que ocurren en el contexto de una lista de reproducción.
Los informes de rendimiento de 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. En la sección Informes de rendimiento de los anuncios, se explican 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 canales, debes establecer el valor del parámetro ids en tu solicitud a la API en uno de los siguientes valores:
channel==MINE: la API muestra los datos para el canal de YouTube del usuario autenticado.
channel==CHANNEL_ID: establece CHANNEL_ID como el ID de canal único del canal para el que estás recuperando datos. El usuario que autoriza la solicitud debe ser el propietario del canal.
Actualmente, el ID del canal es una cadena que comienza con las letras UC, aunque su formato está sujeto a cambios. (Puedes encontrar tu ID de canal en la página de configuración avanzada de la cuenta de tu canal de YouTube o puedes recuperar el ID de tu canal de manera programática utilizando el método YouTube Data API'schannels.list).
Autorización
Todas las solicitudes a la API de YouTube Analytics deben estar autorizadas. La guía de autorización explica cómo usar el protocolo OAuth 2.0 para recuperar tokens de autorización.
Las solicitudes a la API de YouTube Analytics usan los siguientes alcances de autorización:
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.
Permite ver informes monetarios de YouTube Analytics sobre tu contenido de YouTube. Este permiso proporciona acceso a las métricas de actividad del usuario, así como a las métricas estimadas de ingresos y 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 usan este alcance para administrar grupos y elementos de grupo de YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
Ver y administrar los activos y el contenido asociado de YouTube en la plataforma En la API de YouTube Analytics, los propietarios del contenido usan este alcance para administrar grupos y elementos de grupo de YouTube Analytics.
Nota: Por el momento, las métricas de ingresos estimados y rendimiento de los anuncios no son compatibles con los informes de canales. Como resultado, actualmente el alcance https://www.googleapis.com/auth/yt-analytics-monetary.readonly no otorga acceso a los datos monetarios de esos informes.
Filtros
Las tablas que explican los informes admitidos identifican los filtros que se pueden usar para cada informe. En las tablas, los filtros que se muestran entre paréntesis son opcionales. Por ejemplo, para la opción de filtro video(,country), el filtro video es obligatorio, y el filtro país es opcional.
La API también admite la capacidad de especificar varios valores para los filtros video y playlist. Si especificas varios valores para uno de estos filtros, también puedes agregar ese filtro a la lista de dimensiones que especifiques para la solicitud. Esto se aplica 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 para un valor o conjunto de valores específico.
Conceptos básicos sobre las tablas de informes
En esta sección, se 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 admitidos para el informe de video de detalles de reproducción con la dimensión de tiempo y la métrica averageViewPercentage.
La tabla contiene dos filas para las dimensiones, una fila para las métricas y tres filas 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, entre los valores válidos del parámetro dimensions para este informe, se incluyen los siguientes:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,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 puede utilizar 0 o 1. En este caso, el valor del parámetro subscribedStatus,youtubeProduct muestra un informe, pero las métricas no se agregan por día, semana, mes, etc. (Ese informe se documenta por separado en la documentación).
Terminología de la tabla de informes
Las tablas usan la siguiente terminología para indicar si las dimensiones son obligatorias o que son opcionales:
Estos términos significan que se requiere un valor:
Obligatorio: Debes incluir el valor.
Usa exactamente 1: Debes incluir un valor del grupo.
Usa 1 o más: Puedes incluir cualquiera o todos los valores del grupo, pero debes incluir al menos uno.
Estos términos significan que un valor es opcional:
Opcional: Tienes la opción de incluir el valor.
Usa 0 o 1: Tienes la opción de incluir un valor del grupo.
Usar 0 o más: Tienes la opción de 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.
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.
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.
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.
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.
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.
Actividad de los usuarios por ciudad (<= 250 resultados)
Nota: Este informe requiere que establezcas el parámetro maxResults en un valor entero de 250 o menos. A diferencia de la mayoría de los informes, este también requiere que especifiques un valor para el parámetro de solicitud sort.
Este informe proporciona estadísticas de la actividad de los usuarios por ciudad.
Los informes de detalles de reproducción proporcionan estadísticas relacionadas con los siguientes atributos de visualización:
¿Se vio una transmisión de video en vivo o un video on demand?
¿El usuario estaba suscrito al canal propietario del video?
¿En qué producto de YouTube ocurrió la vista?
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 enumera dos informes. Un informe admite la dimensión (y el filtro) liveOrOnDemand, mientras que el otro admite la métrica averageViewPercentage.
Actividad de los usuarios por estado de suscripción
En este informe, se proporcionan métricas de la actividad de los usuarios suscritos y no suscritos. Las estadísticas se pueden agrupar por período (day o month), y el informe también se puede filtrar por country, continent o subContinent.
Actividad de los usuarios por estado de suscripción para provincias
En este informe, se proporcionan métricas de la actividad de los usuarios suscritos y no suscritos de los estados de EE.UU. o el Distrito de Columbia. Este informe admite menos métricas que el anterior.
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 todos modos, debes 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 deseas que los datos del informe se agreguen por día, mes, etcétera.
Detalles de la 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 (y el filtro) liveOrOnDemand.
Detalles de reproducción con una dimensión de tiempo opcional y la métrica averageViewPercentage
Este informe proporciona estadísticas detalladas de reproducción para intervalos de tiempo específicos. Es compatible con la métrica averageViewPercentage.
El siguiente informe es similar al anterior. Agrega compatibilidad para la métrica averageViewPercentage, pero no admite liveOrOnDemand como dimensión o filtro.
Detalles de las reproducciones por provincia con estadísticas de liveOrOnDemand
Este informe ofrece estadísticas detalladas sobre la reproducción para los estados de EE.UU. y el Distrito de Columbia. Admite la dimensión (y el filtro) liveOrOnDemand.
El siguiente informe es similar al anterior. Agrega compatibilidad para la métrica averageViewPercentage, pero no admite liveOrOnDemand como dimensión o filtro.
Detalle de ubicación de reproducción (<= 25 resultados)
Nota: Este informe requiere que establezcas el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los informes, este también requiere que especifiques 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.
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.
Detalle de la fuente de tráfico (<= 25 resultados)
Nota: Este informe requiere que establezcas el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los informes, este también requiere que especifiques 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 mostrará los tipos de anuncios que generaron la mayor cantidad de vistas o tiempo de reproducción para el contenido del canal.
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 detalles sobre las fuentes de tráfico compatibles con 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 reproducciones que se produjeron en dispositivos móviles o consolas de juegos.
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.
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.
Por ejemplo, un informe que usa la dimensión subscribedStatus devuelve viewerPercentage vistas de percentage suscritas hasta un {viewerPercentage reproducciones suscritas hasta 10{/10 porciento de {10 por ciento{/10 vistas suscriptasviewerPercentage (El valor total de todos los campos viewerPercentage del informe es del 200%).
Puedes usar filtros para asegurarte de que el informe solo contenga datos de viewerPercentage para un valor (o combinación de valores) para las dimensiones de detalles de la 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.
Este informe mide la capacidad de un video para retener a su público. La dimensión elapsedVideoTimeRatio mide la cantidad de video que ha transcurrido para los valores de la métrica correspondientes. Las métricas audienceWatchRatio y relativeRetentionPerformance proporcionan dos mediciones que muestran qué tan bien el video retiene a su público. El primero es un valor absoluto, mientras que el segundo muestra el rendimiento del video en relación con otros videos de YouTube de duración similar.
Nota: Los informes de retención de público no admiten la posibilidad de especificar una lista de valores separados por comas para el filtro video. El valor debe especificar un solo ID de video.
Nota: Estos informes requieren que establezcas el parámetro maxResults en un valor entero de 200 o menos. Antes del 1.o de enero de 2013, los datos solo están disponibles para los 10 videos más vistos. A diferencia de la mayoría de los informes, estos también requieren que especifiques un valor para el parámetro de solicitud sort.
Los mejores videos con filtros regionales opcionales (<= 200 resultados)
En este informe, se incluyen los videos más populares del canal. El informe se puede filtrar para que muestre los videos principales por country, continent o subContinent.
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.
Los mejores videos para los espectadores suscritos o no suscritos (<= 200 resultados)
En este informe, se muestran los videos principales del canal para los usuarios suscritos o no suscritos. El informe se puede filtrar para que muestre los videos principales por country, continent o subContinent. El informe anterior te permite recuperar los videos más populares en un estado particular de EE.UU. para los usuarios suscritos o no suscritos, pero admite menos métricas que este informe.
Videos más populares por producto de YouTube (<= 200 resultados)
Este informe incluye los videos más populares del canal y admite filtros geográficos y de detalles de la reproducción. Este informe es similar al anterior, pero admite menos métricas y agrega compatibilidad con el filtro youtubeProduct.
Los informes de playlists contienen métricas relacionadas con la actividad del usuario relacionada con los videos de las playlists del propietario del canal. Hay dos versiones de estos informes disponibles y, para cada uno de ellos, las siguientes secciones contienen una descripción de cada versión:
En la pestaña Recommended de cada sección, se describe el formato preferido de solicitud a la API para
recuperar el informe correspondiente. Los informes recomendados admiten un conjunto expandido de métricas que incluyen métricas de video agregadas y métricas en la playlist. Este formato de solicitud no usa la dimensión isCurated.
En la pestaña Uso de isCurated de cada sección, se describe un formato de solicitud a la API más antiguo en el que se requiere la dimensión isCurated. Estos informes solo admiten
métricas en las playlists. Ten en cuenta que la dimensión isCurated dejó de estar disponible para todos los informes. En la nota de advertencia que aparece a continuación, se explica el programa de baja.
En la siguiente nota de advertencia, se explican los cambios entre las dos versiones del informe con más detalle.
Métricas agregadas de video
Estas métricas proporcionan métricas de impresiones y actividades de los usuarios que se agregan para todos los videos de la playlist que también pertenecen al canal propietario de la playlist. Las métricas de los videos que pertenecen a otros canales no se calculan en la agregación. Por lo tanto, si un canal crea una playlist que contiene solo videos que pertenecen a otros canales, los informes de esas playlists no proporcionarán valores para estas métricas.
Estas métricas reflejan la actividad y la participación de los usuarios en el contexto de la página de la playlist. Estas métricas incluyen las vistas de todos los videos de la playlist, independientemente del canal que las posea, pero solo cuentan las vistas que ocurrieron en el contexto de la playlist.
En este informe, se proporcionan estadísticas relacionadas con las interacciones de los usuarios con los videos de las playlists del canal. Puedes filtrar el informe para que solo muestre los datos de una playlist específica.
En este informe, se proporcionan estadísticas relacionadas con las interacciones de los usuarios con los videos de las playlists del canal. Puedes filtrar el informe para que solo muestre los datos de una playlist específica.
En este informe, se proporcionan estadísticas relacionadas con las interacciones que los usuarios de un país específico tienen con los videos de las playlists del canal.
Este informe proporciona estadísticas de actividad de las listas de reproducción para los estados de EE.UU. y el Distrito de Columbia.
En este informe, debes filtrar los resultados para que se muestren datos solo de Estados Unidos.
Este informe proporciona estadísticas relacionadas con el tipo de página o aplicación en la que se produjeron las reproducciones de tus videos de listas de reproducción.
Detalle de ubicación de reproducción (<= 25 resultados)
Nota: Este informe requiere que establezcas el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los informes, este también requiere que especifiques un valor para el parámetro de solicitud sort.
En este informe, se identifican los reproductores de video incorporados que generaron la mayor cantidad de vistas o tiempo de reproducción para los videos en las playlists del canal.
En este informe se agrupan las estadísticas de reproducción según cómo los espectadores llegaron al contenido de tu playlist.
Por ejemplo, identifica la cantidad de vistas que se generaron a partir de una búsqueda de Google.
Detalle de la fuente de tráfico (<= 25 resultados)
Nota: Este informe requiere que establezcas el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los informes, este también requiere que especifiques 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 vistas para los videos de las playlists del canal. Las URLs de referencia se clasifican por tipo de fuente de tráfico, y la definición de la dimensión insightTrafficSourceDetail identifica las fuentes de tráfico para las que está disponible el informe.
Por ejemplo, si estableces el filtro insightTrafficSourceType en ADVERTISING, el informe mostrará los tipos de anuncios que generaron más vistas o tiempo de reproducción para las playlists del canal.
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 detalles sobre las fuentes de tráfico compatibles con este informe.
Tipo de dispositivo y sistema operativo
Tipo de dispositivo
En este informe, se agrupan las estadísticas de reproducción según cómo los usuarios llegaron a los videos de tus playlists. Por ejemplo, identifica la cantidad de vistas que se produjeron en dispositivos móviles o consolas de juegos.
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 que se produjeron en dispositivos Android o en PlayStations.
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 cuántas vistas se produjeron en tablets Android o dispositivos de escritorio con Windows.
Nota: Los valores viewerPercentage de este informe no están normalizados para los diferentes valores de la dimensión de detalles de reproducción subscribedStatus.
Por ejemplo, un informe que usa la dimensión subscribedStatus muestra datos de viewerPercentage hasta un 100% para las vistas suscritos yviewerPercentage de datos para las vistas de suscripciones anuladas, con un 100%. (El valor total de todos los campos de viewerPercentage del informe es del 200%).
Puedes usar filtros para asegurarte de que el informe solo contenga datos de viewerPercentage para un valor de las dimensiones subscribedStatus.
Playlists más populares
Nota: Estos informes requieren que establezcas el parámetro maxResults en un valor entero de 200 o menos. Antes del 1.o de enero de 2013, los datos solo están disponibles para las 10 playlists principales. A diferencia de la mayoría de los informes, estos también requieren que especifiques un valor para el parámetro de solicitud sort.
Este informe muestra las playlists principales del canal según los filtros y criterios de orden especificados.
Nota: Los informes de rendimiento de los anuncios requieren un token de autorización que otorgue acceso al alcance https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Los informes de rendimiento de los anuncios proporcionan métricas basadas en las impresiones para los anuncios que se publicaron durante las reproducciones de video. Estas métricas representan cada impresión de anuncios, y cada reproducción de video puede generar varias impresiones.
Las métricas de rendimiento de los anuncios basadas en las impresiones son las siguientes:
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.
