En esta página, se muestran ejemplos de solicitudes a la API de YouTube Analytics. En cada ejemplo, se describe brevemente el informe que se recupera y, luego, se muestran los valores de los parámetros dimensions
, metrics
, filters
y sort
correspondientes. (Los documentos informes de canales e informes de propietarios de contenido identifican los informes que admite la API).
En cada ejemplo, se vincula al Explorador de APIs de Google y se propaga con los valores que se muestran. Los ejemplos también usan fechas de inicio y finalización predeterminadas (YYYY-MM-DD
) de 2023-09-01
y 2024-03-31
.
Después de vincular el Explorador de APIs, debes seguir especificando el canal o el propietario del contenido para el que deseas recuperar informes. El Explorador de APIs propagará el valor del parámetro ids
con channel==MINE
o contentOwner==CONTENT_OWNER_ID
, según la consulta en la que hayas hecho clic. Para los informes de canales, puedes cambiar MINE
por el ID del canal del usuario autenticado. Para las denuncias de propietario del contenido, debes reemplazar CONTENT_OWNER_ID
por tu ID de propietario del contenido.
También debes tener la autenticación como el canal o propietario del contenido especificados para que el Explorador de APIs pueda autorizar tus solicitudes a la API mediante OAuth 2.0.
- Ordenación de solicitudes según varias dimensiones o métricas
- Informes de canales
- Informes de propietarios de contenido
Orden de solicitudes por múltiples dimensiones/métricas
La API admite la capacidad de ordenar los datos de respuesta usando múltiples dimensiones o métricas. Por ejemplo, la siguiente solicitud recupera datos diarios de fuentes de tráfico para los videos de un canal en particular. Cada fila del conjunto de resultados identifica la cantidad de reproducciones y el tiempo de reproducción estimado que se originó a partir de un tipo de fuente de tráfico determinado (por ejemplo EXT_URL
) en un día en particular.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
En la respuesta, los resultados se ordenan cronológicamente. Dentro del conjunto de resultados de cada día, los resultados se ordenan en forma descendente por cantidad de vistas. Así, la primera fila del conjunto de resultados contiene los datos de la fuente de tráfico que genera la mayor cantidad de reproducciones en el primer día del intervalo de fechas solicitado. La segunda fila contiene los datos de la fuente de tráfico que generó la siguiente mayor cantidad de reproducciones en el primer día.
Informes de canales
Denuncias de videos
Los recuentos totales de vistas, el tiempo de reproducción estimado y otros datos de un canal
Esta consulta recupera métricas globales del contenido del canal. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Recuentos de vistas específicos de un país (y otros datos) de un canal
Esta consulta recupera métricas para un país específico para los videos de un canal. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
Los 10 principales: Videos más vistos de un canal
Esta consulta recupera los 10 videos más vistos de un canal, medidos según la estimación de minutos vistos durante el intervalo de fechas especificado. Los resultados se ordenan por minutos estimados de reproducción en forma descendente.
Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort
y establezcas el parámetro maxResults
en un valor entero de 10
o menos.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
Los 10 principales: Tasas de clics de anotaciones para los videos más vistos de un canal
Esta solicitud recupera recuentos de vistas, tasas de clics de anotaciones, tasas de cierres de anotaciones e impresiones de anotaciones para los 10 videos más vistos del canal. Los resultados se ordenan por la cantidad de vistas en forma descendente, lo que significa que el video más visto aparecerá en primer lugar.
Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort
y establezcas el parámetro maxResults
en un valor entero de 10
o menos.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Informes de lista de reproducción
Vistas totales de la playlist de un canal
Esta solicitud recupera el total de inicios de playlist, los minutos vistos estimados, las vistas (una métrica de video agregado), las vistas de playlists (una métrica en la playlist) y las vistas por inicio de playlist para las playlists en el canal del usuario autenticado.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Estadísticas de una playlist específica
Esta solicitud recupera el total de inicios de playlist, los minutos vistos estimados, las vistas (una métrica de video agregado), las vistas de listas de reproducción (una métrica en la playlist) y las vistas por inicio de playlist de una playlist específica. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena PLAYLIST_ID
en el valor del parámetro filters
con el ID de una playlist en el canal del usuario autenticado.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Para recuperar estadísticas globales de varias playlists, también puedes reemplazar la cadena PLAYLIST_ID
por una lista separada por comas de hasta 500 IDs de playlists para las playlists del canal del usuario autenticado.
Los 10 principales: Playlists más vistas de un canal
Esta consulta recupera las 10 playlists más vistas de un canal, según la medición de las vistas de playlist durante el período especificado. También recupera otras métricas de playlists, como el número de veces que los espectadores iniciaron la reproducción de cada playlist y la cantidad de tiempo promedio que un usuario miró videos en la playlist después de que se inició. Los resultados se ordenan por vistas de playlist en forma descendente.
Nota: Dado que este informe utiliza la dimensión playlist
, debes especificar un valor para el parámetro de solicitud sort
y, además, establecer el parámetro maxResults
en un número entero de 10
o menos.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Denuncias de videos
Métricas de tiempo de reproducción diario para los videos de un canal
Esta consulta recupera diariamente los recuentos de vistas, las métricas de tiempo de reproducción y los recuentos de suscriptores nuevos para los videos de un canal. El informe muestra una fila de datos para cada día del intervalo de fechas solicitado. Las filas se ordenan en forma cronológica.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Métricas de anotación diarias para los videos de un canal
Esta solicitud recupera diariamente recuentos de vistas, tasas de clics de anotaciones, tasas de cierres de anotaciones e impresiones de anotaciones para el contenido del canal. Los resultados se ordenan en forma cronológica.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Informes de lista de reproducción
Vistas de playlists diarias de un canal
Esta solicitud recupera diariamente el recuento de vistas (una métrica de video agregado), las vistas de playlists (una métrica en la playlist), los inicios de playlist, los minutos vistos estimados y las vistas por inicio de playlist para el canal del usuario autenticado. Los resultados se ordenan en forma cronológica.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Denuncias de videos
Métricas de tiempo de reproducción específicas de un país para los videos de un canal
Esta consulta recupera los recuentos de vistas, las métricas de tiempo de reproducción y las cifras de suscripciones específicas de cada país para los videos de un canal. El informe muestra una fila de datos para cada país en el que se reprodujeron los videos del canal. Las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
Métricas de anotaciones específicas del país para los videos de un canal
Esta solicitud recupera los recuentos de vistas, las tasas de clics de anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones específicas del país para los videos del canal. Los resultados se ordenan por tasa de clics de anotaciones en forma descendente, lo que significa que el país con la mayor tasa de clics de anotaciones aparece en el primer lugar de la lista.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Métricas específicas de la provincia para los estados de EE.UU. y Washington D.C.
Esta solicitud recupera un desglose por provincia de los recuentos de vistas, los minutos de reproducción estimados y la duración promedio de vistas para los videos del canal. Los datos abarcan estados de EE.UU. y Washington D.C. Los resultados se ordenan alfabéticamente según los códigos ISO 3166-2 de las provincias.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
Los 10 principales: Videos más reproducidos en un país específico
Esta consulta recupera los 10 videos más reproducidos del canal, medidos según la cantidad de reproducciones durante el intervalo de fechas especificado, en un país determinado. Los resultados se ordenan por cantidad de vistas de forma descendente.
Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort
y establezcas el parámetro maxResults
en un valor entero de 10
o menos.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
Las 10 ciudades de EE.UU. más populares por vistas totales
Esta consulta recupera una lista de las 10 ciudades de EE.UU. que representaron la mayor cantidad de reproducciones del contenido del canal durante el período especificado. La consulta se podría modificar para solicitar datos de otro país si eliges otro valor válido para ese filtro. Asimismo, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa Occidental o Sudeste Asiático, utilizando el filtro subContinent y uno de sus valores válidos. También se admiten otros filtros. Los resultados se ordenan por cantidad de vistas de forma descendente.
dimensions=city metrics=views filters=country==US maxResults=10 sort=-views
Las 10 ciudades principales de EE.UU. por vistas totales para cada tipo de contenido
Esta consulta recupera una lista de las 10 ciudades de EE.UU. que representaron la mayor cantidad de vistas del contenido del canal durante el período especificado para cada creatorContentType admitido. Los resultados se ordenan por cantidad de vistas de forma descendente.
dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views
Las 10 ciudades de EE.UU. más populares por tiempo de reproducción total
Esta consulta recupera una lista de los 10 días principales durante el período especificado en el que cualquier ciudad de los EE.UU. representaba el mayor tiempo total de reproducción diario del contenido del canal. Los resultados de la consulta identifican el tiempo de reproducción total, la fecha en la que se produjo y la ciudad donde se estimó que se reprodujo el contenido. Los resultados se ordenan en forma descendente según el tiempo de reproducción total.
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
Los 10 principales: Videos más vistos en Europa
Esta consulta recupera los 10 videos más vistos del canal en Europa, medidos según el número de reproducciones durante el período especificado. La consulta podría modificarse a fin de solicitar datos de otro continente eligiendo otro valor válido para ese filtro. Asimismo, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa Occidental o Sudeste Asiático, utilizando el filtro subContinent y uno de sus valores válidos. Los resultados se ordenan por cantidad de vistas de forma descendente.
Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort
y establezcas el parámetro maxResults
en un valor entero de 10
o menos.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Informes de lista de reproducción
Métricas de tiempo de reproducción específicas de un país para las playlists de un canal
Esta consulta recupera los recuentos de vistas específicos de cada país (una métrica de video agregado), las vistas de playlists (una métrica en la playlist) y las métricas de tiempo de reproducción de las playlists de un canal. El informe muestra una fila de datos para cada país en el que se miraron las playlists del canal. Las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
Los 10 principales: Playlists más iniciadas en Estados Unidos
Esta consulta recupera las 10 playlists que los espectadores en Estados Unidos comenzaron a ver con mayor frecuencia durante el período especificado. Los resultados se ordenan por la cantidad de inicios de playlist en orden descendente.
Nota: Dado que este informe utiliza la dimensión playlist
, debes especificar un valor para el parámetro de solicitud sort
y, además, establecer el parámetro maxResults
en un número entero de 10
o menos.
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
Denuncias de videos
Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción
Esta consulta recupera la cantidad de reproducciones y el tiempo de reproducción estimado para los videos de un canal en particular. Los resultados se agrupan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por cantidad de vistas.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Recuentos de vistas y tiempo de reproducción diarios de diferentes ubicaciones de reproducción
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado en los Estados Unidos para los videos de un canal en particular. Los resultados se agrupan por día para cada tipo de página o aplicación en la que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado
Esta consulta recupera la cantidad de vistas y el tiempo de reproducción estimado para un video o grupo de videos en particular. Los resultados se agrupan según el sitio del tercero en el que se integró el video. Los resultados se ordenan en forma descendente por cantidad de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con una lista separada por comas de uno o más IDs de video para los videos subidos.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Informes de lista de reproducción
El tiempo de reproducción y los recuentos de vistas de la playlist desde diferentes ubicaciones de reproducción
Esta consulta recupera la cantidad de vistas (una métrica de video agregada), las vistas de playlists (una métrica en la playlist), el tiempo de reproducción estimado y los inicios de playlist de las playlists de un canal específico. Los resultados se agrupan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por inicio de la playlist.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
El recuento diario de vistas de playlists y el tiempo de reproducción desde diferentes ubicaciones de reproducción
Esta consulta recupera diariamente los inicios de las playlists, los recuentos de vistas (una métrica de video agregada), las vistas de playlists (una métrica en la playlist) y el tiempo de reproducción estimado en Estados Unidos para las playlists de un canal específico. Los resultados se agrupan por día para cada tipo de página o aplicación en la que se vieron vistas de una playlist. Los resultados se ordenan en forma cronológica.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Denuncias de videos
"Me gusta" y "No me gusta" según el tipo de contenido
Esta consulta recupera el número de "Me gusta" y "No me gusta" para cada tipo de contenido en un canal.
dimensions=creatorContentType metrics=likes,dislikes
Denuncias de videos
Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico en un país
Esta solicitud recupera la cantidad de reproducciones y la estimación de tiempo de reproducción para los videos del canal en un país determinado. Las métricas se recopilan por fuente de tráfico, lo que describe la manera en que los usuarios llegaron al video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
El tiempo de reproducción y los recuentos de vistas diarios de distintas fuentes de tráfico
Esta solicitud recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado para los videos del canal. Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
Los 10 principales: Términos de búsqueda de YouTube que generan la mayor parte del tráfico para un video
Esta consulta recupera los 10 términos de búsqueda que generaron la mayor cantidad de reproducciones de los resultados de búsqueda de YouTube para uno o más videos específicos. Los resultados se ordenan por cantidad de vistas de forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de video.
Por ejemplo, puedes ejecutar la búsqueda para un solo video o reemplazar VIDEO_ID
a fin de identificar los términos de búsqueda que generan más tráfico para ese video. También puedes crear una lista de todos los videos de una playlist en particular para determinar qué términos de búsqueda generan más tráfico para cualquiera de los videos de esa playlist.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Los 10 principales: Sitios web externos que generan la mayor cantidad de tráfico para un video
Esta consulta recupera los 10 sitios web externos que generaron la mayor cantidad de reproducciones de un video o grupo de videos específico. Los resultados se ordenan por tiempo estimado de reproducción en forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de video para los videos subidos.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Informes de lista de reproducción
El tiempo de reproducción y los recuentos de vistas de la playlist provenientes de diferentes fuentes de tráfico en un país determinado
Esta solicitud recupera la cantidad de vistas (una métrica de video agregada), las vistas de playlists (una métrica en la playlist), los inicios de playlists y el tiempo de reproducción estimado de las vistas de playlists en un país específico. Las métricas se agrupan por fuente de tráfico, lo que describe la forma en que los usuarios llegaron a la playlist.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
El tiempo de reproducción y los recuentos de vistas de playlists de diferentes fuentes de tráfico
Esta solicitud recupera las vistas diarias de las playlists de un canal (una métrica en la playlist), los inicios de las playlists y el tiempo de reproducción estimado. También recupera las vistas totales (una métrica de video agregado). Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
Denuncias de videos
Métricas diarias de tipo de dispositivo para el sistema operativo Android
Esta consulta recupera diariamente recuentos de vistas y tiempo de reproducción estimado en dispositivos Android para los videos de un canal en particular. Los resultados se agrupan por día para cada tipo de dispositivo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Métricas diarias de sistema operativo para dispositivos móviles
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado en dispositivos móviles para los videos de un canal en particular. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Métricas diarias de sistema operativo y tipo de dispositivo
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado para un canal. Las estadísticas se agrupan según el sistema operativo y el tipo de dispositivo. Los resultados se ordenan en forma cronológica.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Informes de lista de reproducción
Métricas diarias de tipo de dispositivo para las vistas de listas de reproducción en el sistema operativo Android
Esta consulta recupera vistas diarias (una métrica de video agregada), vistas de playlists (una métrica en la playlist) y el tiempo de reproducción estimado en dispositivos Android para las playlists de un canal específico. Los resultados se agrupan por día para cada tipo de dispositivo en el que se vieron las playlists. Los resultados se ordenan en forma cronológica.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Métricas diarias de sistema operativo para las vistas de listas de reproducción en dispositivos móviles
Esta consulta recupera vistas diarias (una métrica de video agregada), vistas de playlists (una métrica en la playlist) y el tiempo de reproducción estimado en dispositivos móviles para las playlists de un canal específico. Los resultados se agrupan por día para cada sistema operativo en el que se vieron las playlists. Los resultados se ordenan en forma cronológica.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Denuncias de videos
Datos demográficos de los usuarios en California (edad y género)
Este informe recupera estadísticas sobre la edad y el género de los espectadores de California que vieron los videos del canal. Los resultados se ordenan por género y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los visualizadores de todo el mundo o todos los visualizadores de un país, continente, subcontinente o de otro estado de EE.UU. mediante el ajuste del valor del parámetro filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Informes de lista de reproducción
Datos demográficos de los usuarios de la playlist en California (edad y género)
En este informe, se obtienen estadísticas sobre la edad y el género de los usuarios de California que miraron las playlists del canal. Los resultados se ordenan por género y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los visualizadores de todo el mundo o todos los visualizadores de un país, continente, subcontinente o de otro estado de EE.UU. mediante el ajuste del valor del parámetro filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Métricas de uso compartido, recopiladas por servicio donde se compartieron videos
Esta solicitud recupera la cantidad de veces que los usuarios usaron el botón Share
para compartir los videos de un canal. Los resultados se recopilan por servicio de uso compartido (Google+, Twitter, etc.) y se ordenan en forma descendente por cantidad de usos compartidos.
dimensions=sharingService metrics=shares sort=-shares
Métricas de retención de público de un video
Este informe mide la capacidad de un video para retener a su público. El informe solo se puede recuperar de un video a la vez. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con el ID de video de uno de tus videos subidos. Ten en cuenta que los informes de retención de público no admiten la capacidad de especificar varios valores para el filtro video
.
En este ejemplo, el informe usa el filtro audienceType
para restringir la respuesta de modo que solo contenga datos de las vistas orgánicas, que son el resultado de una acción directa del usuario, como una búsqueda de un video o un clic en un video sugerido. Por lo tanto, el informe no incluye datos de las vistas provenientes de anuncios TrueView in-stream o TrueView en display. Puedes quitar el filtro para recuperar los datos de retención de público del video de todos los tipos de público.
Ten en cuenta que los datos del filtro audienceType
están disponibles desde el 25 de septiembre de 2013. La API no devolverá datos de las consultas que usan el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no usan el filtro funcionan para ninguna fecha posterior al 1 de julio de 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Métricas de ingresos del canal y rendimiento de los anuncios
Esta solicitud recupera las métricas de ingresos y rendimiento de los anuncios de un canal. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Ingresos diarios y métricas de rendimiento de los anuncios
Esta solicitud recupera las métricas diarias de ingresos y rendimiento de los anuncios de un canal.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Métricas de ingresos y rendimiento de anuncios específicas del país
Esta solicitud recupera las métricas de ingresos y rendimiento de los anuncios específicas del canal de un canal. Los resultados se ordenan en forma descendente por cantidad de ingresos, lo que significa que el primer país de la lista será aquel en el que el socio tuvo los mayores ingresos netos.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
Los 10 principales: Videos con los mayores ingresos
Esta solicitud recupera las métricas de ingresos y de rendimiento de los anuncios para los 10 videos del canal con los mayores ingresos. Los resultados se ordenan en forma descendente por cantidad de ingresos, lo que significa que el primer video será el que tenga los ingresos estimados más altos.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
Métricas de rendimiento de los anuncios para diferentes tipos de anuncios
Esta solicitud recupera las métricas de rendimiento de los anuncios para el contenido reclamado del propietario del contenido. Los resultados se agrupan por tipo de anuncio, lo que te permite comparar los valores de ingresos y CPM en diferentes tipos de anuncios.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Informes de propietarios de contenido
Denuncias de videos
Recuento total de vistas, tiempo de reproducción estimado y otros datos para todo el contenido reclamado
Esta consulta recupera métricas recopiladas para el contenido reclamado del propietario del contenido. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Recuentos de vistas específicos del país (y otros datos) para todos los videos subidos
Esta consulta recupera métricas para un país específico palos videos que el propietario del contenido subió. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Recuentos totales de vistas (y otros datos) de todo el contenido reclamado de terceros
Esta consulta recupera métricas recopiladas para videos que el propietario del contenido reclamó, pero no subió. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Recuento total de vistas (y otros datos) de todo el contenido subido
Esta consulta recupera métricas recopiladas para los videos que el propietario del contenido subió. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Recuentos totales de vistas (y otros datos) de todo el contenido subido y reclamado
Esta consulta recupera métricas recopiladas para videos que el propietario del contenido subió y reclamó. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
Los 10 principales: Videos más reproducidos para un propietario de contenido
Esta consulta recupera los 10 videos más reproducidos, medidos por la cantidad de reproducciones durante el intervalo de fechas especificado, que el propietario del contenido subió. Los resultados se ordenan por cantidad de vistas de forma descendente.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
Los 10 principales: Videos más vistos para un propietario de contenido
Esta consulta recupera los 10 videos más vistos, medidos por minutos de reproducción estimados durante el intervalo de fechas especificado, que el propietario del contenido subió. Los resultados se ordenan por minutos estimados de reproducción en forma descendente.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
Los 10 principales: Videos más reproducidos para el canal de un propietario del contenido
Esta consulta recupera los 10 videos más vistos de un canal o grupo de canales específico que el propietario del contenido administra. Los resultados se ordenan por cantidad de vistas de forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de canal para tus canales.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
Los 10 principales: Tasas de clics de anotaciones para los videos más vistos de un canal
Esta solicitud recupera los recuentos de vistas, las tasas de clics de anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones para los 10 videos más vistos en un canal o grupo de canales específico. Los resultados se ordenan por la cantidad de vistas en forma descendente, lo que significa que el video más visto aparecerá en primer lugar. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de canal para tus canales.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Informes de lista de reproducción
Vistas de la playlist de los canales de un propietario del contenido
Esta solicitud recupera el total de inicios de playlist, los minutos de reproducción estimados de la playlist, las vistas
de playlists y las vistas por inicio de playlist de las playlists en los canales del propietario del contenido. La métrica playlistViews
solo registra las vistas de video que ocurrieron en el contexto de una playlist. Dado que todas las métricas solicitadas son métricas de las playlists, no es necesario que la solicitud incluya el filtro de playlist o de group.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Estadísticas de una playlist específica
Esta solicitud recupera el total de inicios de playlist, los minutos vistos estimados, las vistas (una métrica de video agregado), las vistas de listas de reproducción (una métrica en la playlist) y las vistas por inicio de playlist de una playlist específica. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena PLAYLIST_ID
en el valor del parámetro filters
con el ID de la playlist de una playlist en uno de los canales del propietario del contenido.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Para recuperar estadísticas globales de varias playlists, también puedes reemplazar la cadena PLAYLIST_ID
con una lista separada por comas de hasta 500 IDs de playlists para las playlists en los canales del propietario del contenido.
Denuncias de videos
Métricas de tiempo de reproducción diario para el contenido subido
Esta consulta recupera diariamente métricas de tiempo de reproducción, así como recuentos de vistas, reproducciones monetizadas y recuentos de impresiones para los videos que subió el propietario del contenido. El informe muestra una fila de datos para cada día en el intervalo de fechas solicitado y las filas se ordenan en forma cronológica.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
Métricas de anotaciones para el contenido reclamado
Esta solicitud recupera diariamente los recuentos de vistas, las tasas de clics de las anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones para el contenido reclamado por el propietario del contenido. Los resultados se ordenan en forma cronológica.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Informes de lista de reproducción
Reproducciones diarias de una playlist de un propietario del contenido
Esta solicitud recupera métricas de las interacciones diarias del usuario con los videos de las playlists del propietario del contenido. Las métricas recuperadas en el informe son playlistViews, playlistStarts, playlistEstimatedMinutesWatched y viewsPerPlaylistStart. Todas estas métricas son métricas dentro de las listas de reproducción. Debido a que todas las métricas solicitadas son métricas de las playlists, no es necesario que la solicitud incluya también el filtro de playlist o de group.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Denuncias de videos
Métricas de tiempo de reproducción específicas del país para el contenido subido
Esta consulta recupera los recuentos de vistas, las métricas de tiempo de reproducción y los ingresos publicitarios estimados para cada país. Las métricas son para los videos que el propietario del contenido subió. El informe muestra una fila de datos para cada país donde se reprodujeron los videos y las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Métricas de anotaciones específicas del país para el contenido subido
Esta solicitud recupera los recuentos de vistas, las tasas de clics de anotaciones y las tasas de cierres de anotaciones específicas del país, así como las impresiones de anotaciones para los videos subidos del propietario del contenido. Los resultados se ordenan por tasa de clics de anotaciones en forma descendente, lo que significa que el país con la mayor tasa de clics de anotaciones aparece en el primer lugar de la lista.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Métricas específicas de la provincia para los estados de EE.UU. y Washington D.C.
Esta solicitud recupera un desglose por provincia de los recuentos de vistas, los minutos de reproducción estimados y la duración promedio de vistas para los videos reclamados por el propietario del contenido. Los datos abarcan estados de EE.UU. y Washington D.C. Los resultados se ordenan alfabéticamente según los códigos ISO 3166-2 de las provincias.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
Las 10 ciudades de EE.UU. más populares por vistas totales
Esta consulta recupera una lista de las 10 ciudades de EE.UU. que representaron la mayor cantidad de vistas de los videos reclamados por el propietario del contenido durante el período especificado. La consulta se podría modificar para solicitar datos de otro país si eliges otro valor válido para ese filtro. Asimismo, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa Occidental o Sudeste Asiático, utilizando el filtro subContinent y uno de sus valores válidos. También se admiten otros filtros. Los resultados se ordenan por cantidad de vistas de forma descendente.
dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
Las 10 ciudades principales de EE.UU. por vistas totales para cada tipo de contenido
Esta consulta recupera una lista de las 10 ciudades de EE.UU. que representaron la mayor cantidad de vistas del contenido reclamado por el propietario del contenido durante el período especificado para cada creatorContentType admitido. Los resultados se ordenan por cantidad de vistas de forma descendente.
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
Las 10 ciudades de EE.UU. más populares por tiempo de reproducción total
Esta consulta recupera una lista de los 10 días principales durante el período especificado en el que cualquier ciudad de los Estados Unidos representó el mayor tiempo de reproducción diario total del contenido reclamado por el propietario del contenido. Los resultados de la consulta identifican el tiempo de reproducción total, la fecha en la que se produjo y la ciudad donde se estimó que se reprodujo el contenido. Los resultados se ordenan en forma descendente según el tiempo de reproducción total.
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
Los 10 principales: Videos más vistos en Europa
Esta consulta recupera los 10 videos más vistos en Europa, entre los videos reclamados por el propietario del contenido, según la medición de la cantidad de vistas durante el período especificado. La consulta podría modificarse a fin de solicitar datos de otro continente eligiendo otro valor válido para ese filtro. Asimismo, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa Occidental o Sudeste Asiático, utilizando el filtro subContinent y uno de sus valores válidos. Los resultados se ordenan por cantidad de vistas de forma descendente.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
Informes de lista de reproducción
Métricas de tiempo de reproducción específicas de un país para las playlists de un propietario del contenido
Esta consulta recupera los recuentos de vistas y las métricas de tiempo de reproducción de las playlists específicas de cada país para todas las playlists de los canales del propietario del contenido. El informe muestra una fila de datos para cada país donde se miraron las playlists. Las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
Los 10 principales: Playlists más iniciadas en Estados Unidos
Esta consulta recupera las 10 playlists de los canales del propietario del contenido que los espectadores de Estados Unidos comenzaron a mirar con mayor frecuencia durante el período especificado. Los resultados se ordenan por la cantidad de inicios de playlist en orden descendente.
Nota: Dado que este informe usa la dimensión playlist
, debes especificar un valor para el parámetro de solicitud sort
y también establecer el parámetro maxResults
en un valor entero de 10
o menos.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Denuncias de videos
"Me gusta" y "No me gusta" según el tipo de contenido
Esta consulta recupera el número de "Me gusta" y "No me gusta" de cada tipo de contenido en un canal o grupo de canales en particular. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de canal para tus canales.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Denuncias de videos
Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción
Esta consulta recupera el número de vistas y el tiempo de reproducción estimado para los videos subidos a un canal o grupo de canales en particular. Los resultados se agrupan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por cantidad de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de canal para tus canales.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Recuentos de vistas y tiempo de reproducción diarios de diferentes ubicaciones de reproducción
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado en los Estados Unidos para los videos subidos a un canal o grupo de canales en particular. Los resultados se agrupan por día para cada tipo de página o aplicación en la que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica inversa. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de canal para tus canales.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado
Esta consulta recupera la cantidad de vistas y el tiempo de reproducción estimado para un video o grupo de videos en particular. Los resultados se agrupan según el sitio del tercero en el que se integró el video. Los resultados se ordenan en forma descendente por cantidad de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de video para los videos subidos.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Informes de lista de reproducción
El tiempo de reproducción y los recuentos de vistas de la playlist desde diferentes ubicaciones de reproducción
Esta consulta recupera el número de vistas de playlist, el tiempo de reproducción estimado y los inicios de playlist de todas las playlists en los canales de un propietario del contenido. Los resultados se agrupan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por inicio de la playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
El tiempo de reproducción y los recuentos de vistas de la playlist desde diferentes ubicaciones de reproducción
Esta consulta recupera diariamente los inicios de las playlists, los recuentos de vistas de las playlists y el tiempo de reproducción estimado en los Estados Unidos para todas las playlists en los canales de un propietario del contenido. Se muestran los resultados para cada tipo de página o aplicación en la que se produjeron vistas de listas de reproducción.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Denuncias de videos
Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico
Esta solicitud recupera la cantidad de reproducciones y el tiempo de reproducción estimado para los videos del propietario de contenido. Las métricas se recopilan por fuente de tráfico, lo que describe la manera en que los usuarios llegaron al video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
El tiempo de reproducción y los recuentos de vistas diarios de distintas fuentes de tráfico
Esta solicitud recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado para los videos del propietario del contenido. Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica inversa.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Nota: Los siguientes dos informes de muestra solo se admiten para fuentes de tráfico específicas. Por ejemplo, la fuente de tráfico NO_LINK_EMBEDDED
no tiene detalles adicionales y, por lo tanto, estos informes no están disponibles para esa fuente. Consulta la definición de insightTrafficSourceType para obtener detalles sobre las fuentes de tráfico para las que están disponibles estos tipos de informes.
Los 10 principales: Términos de búsqueda de YouTube que generan la mayor parte del tráfico para un video
Esta consulta recupera los 10 términos de búsqueda que generaron la mayor cantidad de reproducciones de los resultados de búsqueda de YouTube para un video o grupo de videos específico. Los resultados se ordenan por cantidad de vistas de forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de video para los videos subidos.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Los 10 principales: Sitios web externos que generan la mayor cantidad de tráfico para un video
Esta consulta recupera los 10 sitios web externos que generaron la mayor cantidad de reproducciones de los resultados de la Búsqueda de Google para un video o grupo de videos específico. Los resultados se ordenan por tiempo estimado de reproducción en forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con una lista separada por comas de hasta 500 IDs de video para los videos subidos.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Informes de lista de reproducción
El tiempo de reproducción y los recuentos de vistas de la playlist provenientes de diferentes fuentes de tráfico en un país determinado
Esta solicitud recupera el número de vistas de playlists, inicios de playlists y tiempo de reproducción estimado para playlists en un país especificado. Las métricas se agrupan por fuente de tráfico, lo que describe la forma en que los usuarios llegaron a la playlist.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
El tiempo de reproducción y los recuentos de vistas de la playlist provenientes de diferentes fuentes de tráfico
Esta solicitud recupera las vistas de playlists, los inicios de estas y el tiempo de reproducción estimado para las playlists en uno o más canales de un propietario de contenido. Las métricas se agregan por
fuente de tráfico. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
por una lista separada por comas de hasta 500 ID de canal para tus canales.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Denuncias de videos
Métricas diarias de tipo de dispositivo para videos reclamados
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado por tipo de dispositivo para los videos reclamados por un propietario de contenido en particular. Los resultados se agrupan por día para cada tipo de dispositivo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Métricas diarias de sistema operativo para videos reclamados reproducidos en dispositivos móviles
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado por sistema operativo para las reproducciones de videos reclamados por un propietario de contenido específico que se produjeron en dispositivos móviles. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Métricas diarias de sistema operativo y tipo de dispositivo
Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado para los videos reclamados por un propietario de contenido en particular. Las estadísticas se agrupan según el sistema operativo y el tipo de dispositivo. Los resultados se ordenan en forma cronológica.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Informes de lista de reproducción
Métricas de tipo de dispositivo para las vistas de listas de reproducción en el sistema operativo Android
Esta consulta recupera el recuento de vistas y el tiempo de reproducción estimado en dispositivos Android para las playlists en uno o más canales de un propietario del contenido. Se muestran los resultados para cada tipo de dispositivo en el que se produjeron las vistas de la playlist. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID
en el valor del parámetro filters
por una lista separada por comas de hasta 500 IDs de canal para tus canales.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Métricas del sistema operativo para las vistas de listas de reproducción en dispositivos móviles
Esta consulta recupera el recuento de vistas y el tiempo de reproducción estimado en dispositivos móviles para las playlists en cualquiera de los canales de un propietario del contenido. Los resultados se muestran para cada sistema operativo en el que se vieron las playlists de la playlist.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Denuncias de videos
Datos demográficos de los usuarios en California (edad y género)
Este informe recupera estadísticas sobre la edad y el género de los espectadores de California que vieron el contenido reclamado por el propietario del contenido. Los resultados se ordenan por género y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los visualizadores de todo el mundo o todos los visualizadores de un país, continente, subcontinente o de otro estado de EE.UU. mediante el ajuste del valor del parámetro filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Métricas de uso compartido, recopiladas por servicio donde se compartieron videos
Esta solicitud recupera la cantidad de veces que los usuarios usaron el botón Share
para compartir videos que el propietario del contenido subió. Los resultados se recopilan por servicio de uso compartido (Google+, Twitter, etc.) y se ordenan en forma descendente por cantidad de usos compartidos.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Métricas de retención de público de un video
Este informe mide la capacidad de un video para retener a su público. El informe solo se puede recuperar de un video a la vez. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID
en el valor del parámetro filters
con el ID de video de uno de tus videos subidos. Ten en cuenta que los informes de retención de público no admiten la capacidad de especificar varios valores para el filtro video
.
En este ejemplo, el informe usa el filtro audienceType
para restringir la respuesta de modo que solo contenga datos de las vistas orgánicas, que son el resultado de una acción directa del usuario, como una búsqueda de un video o un clic en un video sugerido. Por lo tanto, el informe no incluye datos de las vistas provenientes de anuncios TrueView in-stream o TrueView en display. Puedes quitar el filtro para recuperar los datos de retención de público del video de todos los tipos de público.
Ten en cuenta que los datos del filtro audienceType
están disponibles desde el 25 de septiembre de 2013. La API no devolverá datos de las consultas que usan el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no usan el filtro funcionan para ninguna fecha posterior al 1 de julio de 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Métricas de ingresos y rendimiento de anuncios para el contenido reclamado
Esta solicitud recupera las métricas de ingresos y rendimiento de los anuncios para el contenido reclamado del propietario del contenido. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Ingresos diarios y métricas de rendimiento de los anuncios
Esta solicitud recupera las métricas diarias de ingresos y rendimiento de los anuncios para el contenido reclamado del propietario del contenido.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Métricas de ingresos y rendimiento de anuncios específicas del país
Esta solicitud recupera las métricas de rendimiento de anuncios y ingresos específicas de cada país para el contenido reclamado por el propietario del contenido. Los resultados se ordenan en forma descendente por cantidad de ingresos, lo que significa que el primer país de la lista será aquel en el que el socio tuvo los mayores ingresos estimados.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
Los 10 principales: Videos con los mayores ingresos
Esta solicitud recupera las métricas de ingresos y de rendimiento de los anuncios para los 10 videos que reclamó el propietario del contenido y que tuvieron los mayores ingresos. Los resultados se ordenan en forma descendente por cantidad de ingresos, lo que significa que el primer video será el que tenga los ingresos estimados más altos.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
Métricas de rendimiento de los anuncios para diferentes tipos de anuncios
Esta solicitud recupera las métricas de rendimiento de los anuncios para el contenido reclamado del propietario del contenido. Los resultados se agrupan por tipo de anuncio, lo que te permite comparar los valores de ingresos y CPM en diferentes tipos de anuncios.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType