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.
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
Usa 1 o más |
En la sección |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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.
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: |
|
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: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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.
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: |
|
Métricas: |
|
Filtros: |
|
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.
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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.
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.
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.
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.
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.
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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.
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: |
|
Métricas: |
|
Filtros: |
|
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.
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
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: |
|
Métricas: |
|
Filtros: |
|
Datos demográficos del espectador
Contenido |
Dimensiones: |
|
Métricas: |
|
Filtros: |
|
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.
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.
Contenido |
Dimensiones: |
|
Métricas: |
|
Filtros: |
|