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 recuperar con la API de YouTube Analytics. Los informes de propietarios de contenido contienen métricas de los canales vinculados a un propietario del contenido de YouTube específico. Las métricas son mediciones individuales de la actividad del usuario, el rendimiento de los anuncios o los ingresos estimados.
Los informes de video contienen métricas de actividad de los usuarios, rendimiento de los anuncios y estimaciones de ingresos de los videos en los canales de un propietario de contenido.
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 playlists usan muchas de las mismas dimensiones y filtros que los informes de videos.
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 del 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. Si no lo sabes, pregúntale a tu administrador de socios.
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: Las métricas 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 propietarios 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).
En las tablas que explican los informes compatibles, se identifican los filtros que se pueden usar para un informe determinado. En las descripciones, los filtros que se muestran entre paréntesis son opcionales. Por ejemplo, si un informe incluye video(,country) como opción de filtrado, se puede filtrar para incluir solo datos de un video específico o 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 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.
Importante: Todas las solicitudes a la API para recuperar informes de videos de propietarios del contenido deben filtrar los datos con la dimensión video, la dimensión channel, la dimensión group o una combinación compatible de las dimensiones claimedStatus y uploaderType. (algunos informes no admiten todas esas opciones). Las combinaciones compatibles, 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)
En este informe, se proporcionan 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 usar para recuperar solo estadísticas del contenido reclamado, incluido el que subieron 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.
En este informe, se proporcionan estadísticas relacionadas con las acciones de los usuarios en todos los canales de un propietario de 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.
En este informe, se proporcionan estadísticas relacionadas con la actividad de los usuarios por país para todos los canales de un propietario de contenido. Puedes filtrar el informe para que solo muestre 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 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.
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?
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 devuelve será similar a uno de los informes de estadísticas básicas, basados en el tiempo o geográficos de los usuarios.
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.
En este informe, se identifican los reproductores de video incorporados que generaron la mayor cantidad de vistas o tiempo de reproducción para el contenido de un propietario. Cuando recuperes este informe, debes configurar el filtro insightPlaybackLocationType como EMBEDDED.
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 agregan las estadísticas de vistas según los sitios de referencia que generaron la mayor cantidad de vistas para el contenido del propietario. 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 propietario del contenido.
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 estadísticas de reproducción según el tipo de dispositivo que usaban los usuarios cuando miraban tu contenido. Por ejemplo, identifica la cantidad de vistas que se produjeron en tablets o consolas de videojuegos.
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 en este informe no se normalizan para diferentes valores de la dimensión de detalles de reproducción subscribedStatus.
Por ejemplo, si un informe 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 en el informe es del 200 por ciento).
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.
En este informe, se mide la capacidad de un video para retener a su público. La dimensión elapsedVideoTimeRatio mide la cantidad de tiempo transcurrido del video para los valores de métrica correspondientes. Las métricas audienceWatchRatio y relativeRetentionPerformance proporcionan dos mediciones que muestran la eficacia con la que el video retiene a 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 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 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 principales en general, por país, por continente o por subcontinente (<= 200 resultados)
En este informe, se muestran los videos más populares del propietario del contenido según los criterios de filtrado y ordenamiento especificados.
Videos más populares en general por estado de EE.UU. (<= 200 resultados)
En este informe, se muestran los videos más populares 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.
Videos más populares para usuarios suscritos o no suscritos(<= 200 resultados)
En este informe, se muestran los videos más populares para los usuarios suscritos o no suscritos. 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 muestran los videos más populares 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.
Videos más populares con filtros de detalles de reproducción (<= 200 resultados)
En este informe, se muestran los videos más populares del propietario del contenido, filtrados por una o más dimensiones de detalles de 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 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 en los canales de un propietario de contenido. El informe no tiene ninguna dimensión obligatoria.
En este informe, se proporcionan estadísticas relacionadas con las interacciones de los usuarios con los videos de las playlists de los canales de un propietario del contenido en intervalos de tiempo específicos. Puedes filtrar el informe para que solo muestre 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 en particular tienen con los videos de las playlists del canal.
En este informe, se proporcionan estadísticas de las playlists por país.
En este informe, se proporcionan estadísticas de la actividad de las playlists para los estados de EE.UU. y el Distrito de Columbia. Para este informe, incluye country==US en el valor del parámetro filters.
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 las playlists.
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 las playlists de un propietario de contenido.
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 o de una página de canal.
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 visualización según los sitios de referencia que generaron la mayor cantidad de vistas 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 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 las playlists del propietario del contenido.
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 para las playlists
En este informe, se agregan estadísticas de reproducción según el tipo de dispositivo que los usuarios usaron para mirar el contenido de tu playlist. 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 de playlist que se produjeron en dispositivos Android o PlayStation.
Sistema operativo y tipo de dispositivo de 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 vistas de playlist que se produjeron en tablets Android o en dispositivos de escritorio con Windows.
Nota: Los valores de viewerPercentage en este informe no se normalizan para diferentes valores o combinaciones de valores de las dimensiones de detalles de reproducción (subscribedStatus y youtubeProduct).
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.
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 propietario del contenido 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.
