En esta página, se enumeran los informes que los propietarios de canales pueden recuperar con la API de YouTube Analytics. Los informes de canales proporcionan métricas de la actividad de los usuarios de un canal específico y miden elementos como las vistas de video, las calificaciones y los recuentos de suscripciones.
Los informes de videos proporcionan estadísticas de toda la actividad de los usuarios relacionada con los videos de un canal.
Los informes de playlists proporcionan estadísticas relacionadas específicamente con las vistas de videos que se producen en el contexto de una playlist.
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 métricas según los tipos de anuncios que se publicaron durante la reproducción de videos. 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 canal, 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 datos del canal de YouTube del usuario autenticado.
channel==CHANNEL_ID: Establece CHANNEL_ID en el ID de canal único del canal para el que recuperas 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 el ID de tu canal en la página de configuración avanzada de la cuenta de tu canal de YouTube, o bien puedes recuperarlo de forma programática con el método channels.listYouTube Data API's).
Autorización
Se deben autorizar todas las solicitudes a la API de YouTube Analytics. En la Guía de autorización, se 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 permisos 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 y a las métricas de ingresos estimados 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 permiso para administrar los grupos y los elementos de YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
Ver y administrar los recursos de YouTube y el contenido asociado en YouTube En la API de YouTube Analytics, los propietarios de contenido usan este permiso para administrar los grupos y los elementos de grupo de YouTube Analytics.
Nota: Actualmente, las métricas de ingresos estimados y el rendimiento de los anuncios no son compatibles con los informes de canales. Como resultado, el alcance de https://www.googleapis.com/auth/yt-analytics-monetary.readonly actualmente no otorga acceso a los datos monetarios en esos informes.
Filtros
En las tablas que explican los informes compatibles, se identifican los filtros que se pueden usar para cada uno. 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 es así 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
En esta sección, se explica el formato y la terminología que se usan 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 el informe de detalles de reproducción de video que utiliza 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. En el caso de las dimensiones y los filtros, los valores de cada fila se pueden combinar en una solicitud a la API, siempre y cuando la combinación siga las reglas de uso de la tabla. Por ejemplo, los valores válidos del parámetro dimensions para este informe incluyen los siguientes:
dimensions=day
dimensions=day,subscribedStatus
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, y la solicitud debe usar 0 o 1.
Terminología de la tabla de informes
En las tablas, se usa la siguiente terminología para indicar si las dimensiones son obligatorias o opcionales:
Estos términos indican 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 indican que un valor es opcional:
Opcional: Puedes incluir el valor.
Usa 0 o 1: Tienes la opción de incluir un valor del grupo.
Usa 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 del usuario por ciudad (<= 250 resultados)
Nota: Para generar este informe, debes establecer el parámetro maxResults en un valor entero de 250 o menos. A diferencia de la mayoría de los otros informes, este también requiere que especifiques un valor para el parámetro de solicitud sort.
En este informe, se proporcionan estadísticas de la actividad de los usuarios por ciudad.
En este informe, se proporcionan estadísticas de la actividad de los usuarios por área de mercado designada (DMA). Para este informe, debes establecer el valor del parámetro filters en country==US o filtrar por una provincia en particular (estado de EE.UU.).
Los informes de detalles de reproducción proporcionan estadísticas relacionadas con los siguientes atributos de visualización:
¿La vista era de una transmisión de video en vivo o de un video on demand?
¿El usuario estaba suscrito al canal propietario del video?
¿En qué producto de YouTube se produjo la vista?
Nota: La dimensión y el filtro liveOrOnDemand no se pueden usar junto con la métrica averageViewPercentage. Por lo tanto, en cada una de las siguientes subsecciones, se enumeran 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 actividad de los usuarios para los usuarios 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 subContinent.
Actividad de los usuarios por estado de suscripción en las provincias
En este informe, se proporcionan métricas de actividad de los usuarios para los usuarios suscritos y no suscritos en los estados de EE.UU. o el Distrito de Columbia. Este informe admite menos métricas que el anterior.
Detalles de la reproducción con dimensión de tiempo opcional
La dimensión de tiempo (día o mes) es opcional para estos informes porque, de cualquier manera, debes usar los parámetros de solicitud startDate y endDate para especificar el período que abarcará el informe. Si está presente, la dimensión 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.
El siguiente informe es similar al anterior. Agrega compatibilidad con la métrica averageViewPercentage, pero no admite liveOrOnDemand como dimensión o filtro.
Detalles de la 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 (y el filtro) liveOrOnDemand.
El siguiente informe es similar al anterior. Agrega compatibilidad con la métrica averageViewPercentage, pero no admite liveOrOnDemand como dimensión o filtro.
Detalles de la ubicación de reproducción (<= 25 resultados)
Nota: Para generar este informe, debes establecer el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los otros 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 agregan las estadísticas de reproducción según la forma en que los usuarios llegaron a tu contenido de video. Por ejemplo, identifica la cantidad de vistas que provienen de una búsqueda de Google o de un vínculo a un video relacionado.
Nota: Este informe muestra un error si el producto de la cantidad de videos consultados por la cantidad de días en el período supera los 50,000. Por ejemplo, una consulta que recupera datos de 500 IDs de video puede solicitar datos de un máximo de 100 días. Para reducir la cantidad de filas que muestra una solicitud, divídela en varias que especifiquen menos videos o establezcan períodos más cortos.
Detalles de la fuente de tráfico (<= 25 resultados)
Nota: Para generar este informe, debes establecer el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los otros 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 configuras 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. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES y NO_LINK_EMBEDDED son algunas de las fuentes de tráfico que no se admiten.
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.
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 muestra datos de viewerPercentage que suman el 100% para las vistas de usuarios suscritos y datos de viewerPercentage que suman el 100% para las vistas de usuarios no suscritos. (El valor total de todos los campos viewerPercentage del informe es del 200 por ciento).
Puedes usar filtros para asegurarte de que el informe solo contenga datos de viewerPercentage para un valor (o una combinación de valores) de 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.
Este informe mide la capacidad de un video para retener a su público y también muestra la frecuencia con la que se miraron partes específicas de un video. La dimensión elapsedVideoTimeRatio mide la cantidad de video que transcurrió para los valores de métrica correspondientes. Las métricas se pueden dividir en dos categorías:
Retención de público
Estas métricas muestran qué tan bien el video retiene al público.
audienceWatchRatio es una proporción que compara la cantidad de veces que se miró una parte de un video con la cantidad total de vistas del video.
relativeRetentionPerformance muestra la capacidad de un video para retener a los usuarios durante las reproducciones en comparación con otros videos de YouTube de duración similar.
Estadísticas detalladas de los relojes
Estas métricas proporcionan información sobre la frecuencia con la que se miraron partes específicas de un video.
startedWatching indica la frecuencia con la que los usuarios comenzaron a mirar un video durante un segmento en particular.
stoppedWatching indica la frecuencia con la que los usuarios dejaron de mirar un video durante un segmento en particular.
totalSegmentImpressions indica la frecuencia con la que se miró un segmento en particular del video.
Nota: Este informe no admite la capacidad de especificar una lista de valores separados por comas para el filtro video. El valor debe especificar un solo ID de video.
En este informe, se muestran los usuarios simultáneos en una posición determinada de un solo video transmitido en vivo.
El filtro especifica el video. La dimensión de posición suele representar un solo minuto.
Nota: Estos informes requieren que establezcas el parámetro maxResults en un valor entero de 200 o menos. Antes del 1 de enero de 2013, los datos solo están disponibles para los 10 videos principales. A diferencia de la mayoría de los otros informes, estos también requieren que especifiques un valor para el parámetro de solicitud sort.
Videos más populares con filtros regionales opcionales (<= 200 resultados)
En este informe, se muestran los videos más exitosos del canal. El informe se puede filtrar para mostrar los videos más populares por país, continente o subContinent.
Videos más populares 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.
Videos más populares para usuarios suscritos o no suscritos(<= 200 resultados)
En este informe, se muestran los videos más populares del canal para los usuarios suscritos o no. El informe se puede filtrar para mostrar los videos más populares por país, continente o subContinent. El informe anterior te permite recuperar los videos más populares en un estado de EE.UU. en particular para los usuarios que se suscribieron o no, pero admite menos métricas que este informe.
Videos principales por producto de YouTube (<= 200 resultados)
En este informe, se enumeran los videos más populares del canal y se admiten filtros geográficos y de detalles de 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 de los usuarios en 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 Recomendado de cada sección, se describe el formato de solicitud de API preferido para recuperar el informe correspondiente. Los informes recomendados admiten un conjunto expandido de métricas que incluyen métricas de videos agregados y métricas de las playlists. Este formato de solicitud no usa la dimensión isCurated.
En la pestaña Cómo usar 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 de las playlists. Ten en cuenta que la dimensión isCurated dejó de estar disponible para todos los informes. En la siguiente nota de advertencia, se explica el cronograma de baja.
En la siguiente nota de advertencia, se explican los cambios entre las dos versiones del informe con más detalle.
Métricas de video agregadas
Estas métricas proporcionan métricas de actividad del usuario y de impresiones que se agregan para todos los videos de la playlist que también son propiedad del canal que la creó. Las métricas de los videos que pertenecen a otros canales no se calculan en la agregación. Como resultado, si un canal crea una playlist que solo contiene 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 de a qué canal pertenezcan, pero solo se registran las vistas que se produjeron 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 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 datos de una playlist específica.
En este informe, se proporcionan estadísticas relacionadas con las interacciones que los usuarios de un país en particular tienen con los videos de las playlists del canal.
En este informe, se proporcionan estadísticas de la actividad de las playlists para los estados de EE.UU. y el Distrito de Columbia.
En este informe, debes filtrar los resultados para que muestren datos solo de Estados Unidos.
En este informe, se proporcionan estadísticas relacionadas con el tipo de página o aplicación en la que se produjeron las reproducciones de los videos de tu playlist.
Detalles de la ubicación de reproducción (<= 25 resultados)
Nota: Para generar este informe, debes establecer el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los otros 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 de las playlists del canal.
En este informe, se agregan las estadísticas de reproducción según la forma en que los usuarios llegaron al contenido de tu playlist.
Por ejemplo, identifica la cantidad de vistas que provienen de una búsqueda de Google.
Detalles de la fuente de tráfico (<= 25 resultados)
Nota: Para generar este informe, debes establecer el parámetro maxResults en un valor entero de 25 o menos. A diferencia de la mayoría de los otros informes, este también requiere que especifiques un valor para el parámetro de solicitud sort.
En este informe, se agregan las estadísticas de vistas según los sitios de referencia que generaron la mayor cantidad de vistas para los videos de las playlists del canal. Los sitios 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 configuras el filtro insightTrafficSourceType en ADVERTISING, el informe mostrará una lista de los tipos de anuncios que generaron la mayor cantidad de 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. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES y NO_LINK_EMBEDDED son algunas de las fuentes de tráfico que no se admiten.
Tipo de dispositivo y sistema operativo
Tipo de dispositivo
En este informe, se agregan las estadísticas de reproducción según la forma en que 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 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, identifica cuántas vistas se generaron en tablets Android o dispositivos de escritorio con Windows.
Nota: Los valores de viewerPercentage en este informe no se normalizan para 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 que suman el 100% para las vistas de usuarios suscritos y datos de viewerPercentage que suman el 100% para las vistas de usuarios no suscritos. (El valor total de todos los campos viewerPercentage del informe es del 200 por ciento).
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 de enero de 2013, los datos solo están disponibles para las 10 playlists principales. A diferencia de la mayoría de los otros informes, estos también requieren que especifiques un valor para el parámetro de solicitud sort.
En este informe, se enumeran las playlists principales del canal según los criterios de filtrado y ordenamiento especificados.
Nota: Los informes de rendimiento de 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 anuncios proporcionan métricas basadas en impresiones para los anuncios que se publicaron durante la reproducción de videos. 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 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.
