Nota:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
En esta página, se enumeran los informes que los propietarios del contenido pueden obtener con la API de YouTube Analytics. Los informes de propietarios de contenido contienen métricas para los canales vinculados a un determinado propietario del contenido de YouTube. Las métricas son mediciones individuales de la actividad de los usuarios, el rendimiento de los anuncios o los ingresos estimados.
Los informes de videos contienen métricas de la actividad del usuario, el rendimiento de los anuncios y las métricas de ingresos estimados de los videos en los canales de un propietario del contenido.
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 listas de reproducción usan muchas de las mismas dimensiones y filtros que los informes de video.
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 propietario del contenido, llama al método reports.query de la API y establece el valor del parámetro ids en la solicitud a la API en contentOwner==OWNER_NAME, donde OWNER_NAME especifica el ID del propietario del contenido. Pregúntale a tu administrador de socios si no estás seguro del valor.
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: Las métricas que están marcadas con un asterisco (*) requieren un token de autorización que otorgue acceso al permiso https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Filtros
Todas las solicitudes a la API para recuperar informes de propietario de contenido deben filtrar los datos con la dimensión video, la dimensión channel, la dimensión isCurated o una combinación admitida de las dimensiones claimedStatus y uploaderType. (Las combinaciones admitidas se enumeran en la definición de la dimensión uploaderType).
Las tablas que explican los informes admitidos identifican los filtros que se pueden utilizar para un informe determinado. En las descripciones, los filtros que se muestran entre paréntesis son opcionales. Por ejemplo, si un informe muestra video(,country) como una opción de filtro, se podría filtrar el informe para que incluya solo datos de un video específico o para que solo incluya datos de un video específico en un país específico.
La API también admite la capacidad de especificar varios valores para los filtros video, playlist y channel. 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.
Importante: Todas las solicitudes a la API para recuperar informes de video de propietario de contenido deben filtrar los datos con la dimensión video, la dimensión canal, la dimensión grupo o una combinación compatible de las dimensiones claimedStatus y uploaderType. (Algunos informes no admiten todas estas opciones). Las combinaciones admitidas, que también se enumeran en la definición de la dimensión uploaderType, son las siguientes:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
Denuncias de videos
Estadísticas básicas
Estadísticas básicas (incluidos los recuentos de suscriptores)
Este informe proporciona estadísticas relacionadas con las acciones de los usuarios en todos los canales de un propietario de contenido. Puedes filtrar el informe para que solo muestre los datos de un video o país específico. También se puede utilizar para recuperar solo estadísticas de contenido reclamado, incluido el contenido reclamado que subió el propietario del contenido, terceros o ambos.
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.
Este informe proporciona estadísticas relacionadas con las acciones de los usuarios en todos los canales de un propietario del contenido para 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 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.
Este informe proporciona estadísticas relacionadas con la actividad de los usuarios, país por país, para todos los canales de un propietario de contenido. Puedes filtrar el informe para que solo muestre los datos de un video o canal 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?
Técnicamente, las dimensiones de detalles de reproducción que admiten estos informes son opcionales. Si no incluyes dimensiones de detalles de reproducción en tu solicitud, el informe que se muestre será similar a uno de los informes de estadísticas básicas, basados en el tiempo o de ubicación geográfica del usuario.
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.
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 el contenido de un propietario del contenido. Cuando recuperes este informe, debes establecer el filtro insightPlaybackLocationType en EMBEDDED.
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.
Este informe agrupa estadísticas de reproducción basadas en las URL de referencia que generaron la mayor cantidad de reproducciones para el contenido del propietario del contenido. 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 reproducciones o tiempo de reproducción para el contenido del propietario del contenido.
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 el tipo de dispositivo que usaron los espectadores cuando vieron tu contenido. Por ejemplo, identifica la cantidad de reproducciones que ocurrieron en tablets 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.
Nota: Los valores de viewerPercentage de este informe no están normalizados para diferentes valores de la dimensión de detalles de reproducción de subscribedStatus.
Por ejemplo, si un informe usa la dimensión subscribedStatus, muestra los datos de viewerPercentage, que suman hasta el 100% de las vistas suscritos yviewerPercentage de las vistas suscriptas. (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 de la dimensión subscribedStatus.
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 en general, por país, por continente o por subcontinente (<= 200 resultados)
En este informe, se muestran los principales videos del propietario del contenido según los filtros y criterios de clasificación especificados.
Videos más populares en general por estado de EE.UU. (<= 200 resultados)
En este informe, se muestran los principales videos del propietario del contenido 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 más populares de 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)
En este informe se enumeran los videos más populares y se admiten los filtros geográficos y los detalles de la reproducción. Este informe es similar al anterior, pero admite menos métricas y agrega compatibilidad con el filtro youtubeProduct.
Videos más populares con filtros de detalles de reproducción (<= 200 resultados)
En este informe, se muestran los principales videos del propietario del contenido y se filtran por una o más dimensiones de detalles de la reproducción: liveOrOnDemand, subscribedStatus y youtubeProduct. El informe también admite el filtrado por región.
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.
Este informe proporciona estadísticas relacionadas con las interacciones de los usuarios con los videos de las playlists en los canales de un propietario del contenido. El informe no tiene ninguna dimensión obligatoria.
Este informe proporciona estadísticas relacionadas con las interacciones de los usuarios con videos en las playlists de los canales de un propietario del contenido durante intervalos de tiempo específicos. Puedes filtrar el informe para que solo muestre los datos de una playlist o un canal específicos.
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 las playlists por país.
Este informe proporciona estadísticas de actividad de las listas de reproducción para los estados de EE.UU. y el Distrito de Columbia. Para este informe, incluye country==US en el valor del parámetro filters.
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 las playlists de un propietario de contenido.
En este informe se agrupan las estadísticas de reproducción según la forma en que los espectadores llegaron al contenido de tu playlist. Por ejemplo, identifica la cantidad de vistas que provinieron de una búsqueda de Google o un canal de usuario.
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.
Este informe agrupa estadísticas de reproducción basadas en las URL de referencia que generaron la mayor cantidad de reproducciones para las playlists del propietario del contenido. 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 reproducciones o tiempo de reproducción para las playlists del propietario del contenido.
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 para las playlists
En este informe se agrupan las estadísticas de reproducción según el tipo de dispositivo que utilizaron los espectadores para ver el contenido de tu playlist. 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, identifica la cantidad de reproducciones de listas de reproducción que se produjeron en dispositivos Android o en PlayStations.
Sistema operativo y tipo de dispositivo para las playlists
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 reproducciones de listas de reproducción que se produjeron en tabletas Android o en dispositivos de escritorio con Windows.
Nota: Los valores viewerPercentage de este informe no están normalizados para diferentes valores o combinaciones de valores para las dimensiones de detalles de reproducción (subscribedStatus y youtubeProduct).
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.
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 propietario del contenido 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.
