Metrics

En este documento se definen las métricas que se pueden recuperar mediante la API de YouTube Analytics. Esta API admite consultas en tiempo real para generar informes personalizados de YouTube Analytics.

Las métricas son mediciones individuales de la actividad del usuario, el rendimiento de los anuncios o los ingresos estimados. Las métricas de actividad del usuario incluyen recuentos de vistas de videos y calificaciones (me gusta y no me gusta).

Métricas principales

Si bien la API de YouTube Analytics está sujeta a la Política de Baja que se define en las Condiciones del Servicio, las métricas no principales (y las dimensiones no principales) no están sujetas a la política. En las definiciones de esta página, cualquier métrica que es una métrica principal se identifica de forma explícita como tal.

La siguiente lista identifica las métricas principales de la API.

Nota: Las siguientes métricas principales dejaron de estar disponibles por completo:
  • La métrica principal de earnings dejó de estar disponible el 4 de agosto de 2016 y se le cambió el nombre a estimatedRevenue. De acuerdo con la Política de Baja que se define en las Condiciones del Servicio, las métricas earnings y estimatedRevenue se admiten de forma simultánea hasta el 10 de agosto de 2017.
  • Las métricas principales favoritesAdded y favoritesRemoved dejaron de estar disponibles el 31 de marzo de 2015. Solo se pueden recuperar estas métricas a través de la API de YouTube Analytics.

Consulta la lista de las API de YouTube sujetas a la Política de Baja para obtener más información.

Ver métricas

vistas (métrica principal)
La cantidad de veces que se reprodujo un video. En un informe de listas de reproducción, la métrica indica la cantidad de veces que un video se vio en el contexto de una lista de reproducción. El Centro de ayuda de YouTube proporciona información adicional sobre cómo se informan las reproducciones. This is a core metric and is subject to the Deprecation Policy.
RedViews.
La cantidad de veces que los miembros de YouTube Premium (antes conocidos como YouTube Red) miraron un video.
uniques (obsoleto a partir del 27 de septiembre de 2016)
La cantidad de usuarios únicos que miraron un video. Este cálculo se basa en el número de cookies únicas y, por lo tanto, superará a los usuarios que utilizan varios dispositivos o navegadores.
La métrica uniques dejó de estar disponible el 27 de septiembre de 2016. No es una métrica principal y se admitirá hasta el 31 de octubre de 2016.
viewerPercentage (métrica principal)
El porcentaje de espectadores que accedieron cuando miraron el video o la lista de reproducción. This is a core metric and is subject to the Deprecation Policy.

Métricas de tiempo de reproducción

estimatedMinutesWatched (métrica principal)
Corresponde a la cantidad de minutos que los usuarios miraron videos del canal, propietario del contenido, video o lista de reproducción especificados. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
La cantidad de minutos durante los que los miembros de YouTube Premium (antes conocidos como YouTube Red) miraron un video.
averageViewDuration (métrica principal)
La duración promedio, en segundos, de las reproducciones de video. A partir del 13 de diciembre de 2021, esta métrica excluye el tráfico de clips en bucle. En un informe de listas de reproducción, la métrica indica la duración promedio, en segundos, de las reproducciones de video que se produjeron en el contexto de una lista de reproducción. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
El porcentaje promedio de un video que se miró durante la reproducción. A partir del 13 de diciembre de 2021, esta métrica excluye el tráfico de clips en bucle.

Métricas de participación

comentarios (métrica principal)
La cantidad de veces que los usuarios comentaron un video. Para obtener más información, visita el Centro de ayuda de YouTube. This is a core metric and is subject to the Deprecation Policy.
“Me gusta” (métrica principal)
La cantidad de veces que los usuarios indicaron que les gustó un video, dándole una calificación positiva. This is a core metric and is subject to the Deprecation Policy.
No me gusta (métrica principal)
La cantidad de veces que los usuarios indicaron que no les gustó un video, dándole una calificación negativa. This is a core metric and is subject to the Deprecation Policy.
uso compartido (métrica principal)
La cantidad de veces que los usuarios compartieron un video mediante el botón Share. Para obtener más información, visita el Centro de ayuda de YouTube. This is a core metric and is subject to the Deprecation Policy.
subscribersGained (métrica principal)
La cantidad de veces que los usuarios se suscribieron a un canal. This is a core metric and is subject to the Deprecation Policy.

Los canales pueden ganar o perder suscriptores en varios lugares, incluida la página de reproducción del video, el canal de usuario y la guía que aparece en la página principal de YouTube. En los informes de canales, esta métrica incluye los suscriptores obtenidos en cualquiera de estos lugares. Sin embargo, en los informes que usan la dimensión video o el parámetro filter para restringir la respuesta e incluir solo los datos de un video en particular, la métrica subscribersGained solo incluirá estadísticas de la página de reproducción del video especificado.
subscribersLost (métrica principal)
La cantidad de veces que los usuarios anularon sus suscripciones a un canal. This is a core metric and is subject to the Deprecation Policy.

Los datos de esta métrica se informan de un modo similar al de la métrica subscribersGained. En los informes de canales, esta métrica incluye a los suscriptores perdidos a través de cualquier mecanismo que permita a los usuarios anular su suscripción a un canal. Sin embargo, en los informes que utilizan la dimensión video o el parámetro filter para restringir la respuesta e incluir solo los datos de un video en particular, esta métrica solo incluye a los usuarios que anularon su suscripción a la página de reproducción del video especificado.
videosAgregados a listas de reproducción
La cantidad de veces que se agregaron videos a cualquier lista de reproducción de YouTube. Es posible que los videos se hayan agregado a la lista de reproducción del propietario del video o a otras de otros canales.

El valor de la métrica incluye la cantidad de veces que se agregaron los videos a las listas de reproducción predeterminadas, como la lista de reproducción “Ver más tarde”. Sin embargo, no se tienen en cuenta las listas de reproducción a las que se agrega un video automáticamente, como la lista de reproducción subida de un canal o el historial de reproducciones del usuario.

Esta métrica muestra un número absoluto, lo que significa que si un usuario agrega un video a una lista de reproducción, lo quita y luego lo vuelve a agregar, el valor de la métrica refleja el video que se agrega a una lista de reproducción dos veces. Los datos de esta métrica no están disponibles para las fechas anteriores al 1 de octubre de 2014.
videos quitados de listas de reproducción
La cantidad de veces que se quitaron videos de cualquier lista de reproducción de YouTube. Es posible que los videos se hayan quitado de las listas de reproducción del propietario del video o de otros canales.

El valor de la métrica incluye la cantidad de veces que se quitaron videos de las listas de reproducción predeterminadas, como la lista de reproducción “Ver más tarde”.

Esta métrica muestra un número absoluto, es decir, si un usuario agrega un video a una lista de reproducción, lo quita de nuevo, lo vuelve a quitar y vuelve a quitarlo, y el valor de la métrica refleja que el video se quita de una lista de reproducción dos veces. Los datos de esta métrica no están disponibles para las fechas anteriores al 1 de octubre de 2014.

Métricas de participación obsoletas

Las siguientes métricas eran métricas principales que dejaron de estar disponibles el 31 de marzo de 2015.

favoritesAdded (métrica principal) (obsoleto desde el 31 de marzo de 2015)
Cantidad de veces que los usuarios marcaron un video como favorito. Para obtener más información, visita el Centro de ayuda de YouTube. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (métrica principal) (obsoleto desde el 31 de marzo de 2015)
La cantidad de veces que los usuarios quitaron un video de sus listas de videos favoritos. Para obtener más información, visita el Centro de ayuda de YouTube. This is a core metric and is subject to the Deprecation Policy.

Métricas de las listas de reproducción

Listas de reproducción
Corresponde a la cantidad de veces que los usuarios iniciaron la reproducción de una lista de reproducción. Ten en cuenta que esta métrica solo incluye las vistas de las listas de reproducción que se produjeron en la Web.
viewsPerPlaylistStart.
La cantidad promedio de vistas de video que se produjeron cada vez que se inició una lista de reproducción. Ten en cuenta que esta métrica solo incluye las vistas de las listas de reproducción que se produjeron en la Web.
promedio de tiempo en lista de reproducción
La cantidad de tiempo promedio estimada, en minutos, que un usuario miró videos en una lista de reproducción luego de que esta se inició. Ten en cuenta que esta métrica solo incluye las vistas de las listas de reproducción que se produjeron en la Web.

Métricas de anotaciones

Nota: Los informes de la API de YouTube Analytics solo muestran datos para las métricas annotationClickThroughRate y annotationCloseRate a partir del 10 de junio de 2012. Además, los informes de la API de YouTube Analytics solo muestran datos para las métricas de anotaciones restantes al 16 de julio de 2013.

annotationImpressions
La cantidad total de impresiones de anotaciones.
annotationClickableImpressions
La cantidad de anotaciones que aparecieron y en las que se pudo hacer clic.
AnnotationClicks
La cantidad de anotaciones en las que se hizo clic.
annotationClickThroughRate (métrica principal)
La proporción de anotaciones en las que los espectadores hicieron clic con respecto a la cantidad total de impresiones de anotaciones en las que se puede hacer clic. This is a core metric and is subject to the Deprecation Policy. En el Centro de ayuda de YouTube, encontrarás más información sobre cómo crear anotaciones y cómo usar anotaciones de vínculos.
annotationClosableImpressions
La cantidad de anotaciones que aparecieron y se pudieron cerrar.
annotationCloses.
La cantidad de anotaciones cerradas
annotationCloseRate (métrica principal)
La proporción de anotaciones que los espectadores cerraron con respecto a la cantidad total de impresiones de anotaciones. This is a core metric and is subject to the Deprecation Policy.

Métricas de la tarjeta

El Centro de ayuda de YouTube contiene instrucciones más detalladas para agregar tarjetas a tus videos y el Informe de tarjetas de YouTube Analytics.

tarjetasimpresiones
La cantidad de veces que se mostraron las tarjetas. Cuando se abre el panel de tarjetas, se registra una impresión de tarjeta para cada una de las tarjetas de video.
Clicsdetarjeta
La cantidad de veces que se hizo clic en las tarjetas.
Tasa de clics de la tarjeta
La tasa de clics de las tarjetas, que se calcula como la proporción de clics de tarjetas en comparación con las impresiones de tarjetas.
tarjetaTeaserImpressions
La cantidad de veces que se mostraron los avances de tarjeta. Una vista de video puede generar varias impresiones de avances.
tarjetaTeaserClicks
La cantidad de clics en avances de tarjeta. Los clics en el ícono de la tarjeta se atribuyen al último avance que se muestra al usuario.
Tasa de clics del anuncio de tarjeta de crédito
La tasa de clics de los avances de tarjeta, que se calcula como la proporción de clics en los avances de tarjeta en comparación con la cantidad total de impresiones del avance de tarjeta.

Métricas de retención de público

audienceWatchRatio
La proporción absoluta de usuarios que miran el video en un punto determinado del video. Para calcular la proporción, se compara la cantidad de veces que se vio una parte de un video con la cantidad total de vistas. La dimensión elapsedVideoTimeRatio identifica la parte del video a la que corresponde la métrica.

Ten en cuenta que una parte de un video se podría mirar más de una vez (o directamente no) en una vista de video determinada. Por ejemplo, si los usuarios retroceden y miran la misma parte de un video varias veces, la proporción absoluta de esa parte del video podría ser mayor que 1.

En los siguientes ejemplos, se muestra cómo se calcula el valor:
  • Un video de un minuto se mira 100 veces. La mitad de los espectadores deja de mirar después de 15 segundos y el resto mira todo el video. Ninguno de los espectadores mira ninguna parte del video más de una vez. En este caso, el valor de esta métrica sería 1 para los intervalos de tiempo del primer trimestre del video, y su valor sería 0.50 para el resto del video.
  • Un video de un minuto se mira 100 veces. Todos los espectadores miran el video completo, pero veinte de ellos lo miran hasta la marca de 45 segundos del video, vuelven a la marca de 30 segundos y lo miran. En este caso, el valor de la métrica sería 1 para intervalos de tiempo en la primera mitad o en el último cuarto del video. Sin embargo, el valor sería 1.2 para los intervalos de tiempo en el tercer cuarto del video, ya que el 100% de los espectadores miró ese segmento del video, pero el 20% vio esos segmentos dos veces.
RelativeRetentionPerformance.
Una medición que muestra qué tan bien un video retiene a los usuarios durante las reproducciones en comparación con todos los videos de YouTube que tienen una duración similar. La métrica tiene un valor entre 0 y 1 que identifica el rendimiento de retención relativa del video en un punto determinado del video. La dimensión elapsedVideoTimeRatio proporciona el punto del video.

Un valor de 0 indica que el video retiene a los espectadores por peor que cualquier otro video de duración similar, mientras que un valor de 1 indica que el video retiene a los espectadores mejor que cualquier otro video de duración similar. Un valor medio de 0.5 indica que la mitad de los videos de duración similar retienen mejor a los espectadores, mientras que la mitad retiene a los espectadores.

El siguiente ejemplo hipotético ilustra cómo pueden aparecer los valores en un informe. En promedio, el 90% de los espectadores que miran videos que duran 10 minutos lo sigue mirando después de tres minutos, y el 70 por ciento lo hace después de ocho minutos. Sin embargo, en el caso de un video específico de 10 minutos, solo el 80% de los espectadores lo mira después de tres minutos, pero todos lo hacen después de ocho minutos.
  • En el valor elapsedVideoTimeRatio que corresponde al punto que se encuentra a los tres minutos del video, la métrica relativeRetentionPerformance tendría un valor inferior a 0.5, ya que en ese momento el video tiene un rendimiento inferior al promedio del video.
  • En el valor elapsedVideoTimeRatio correspondiente al punto que está ocho minutos en el video, la métrica relativeRetentionPerformance tendría un valor superior a 0.5, ya que en ese momento el video tiene un mejor rendimiento que otros videos de duración similar.

Métricas de ingresos estimados

Nota: Las métricas de ingresos estimados están sujetas a ajustes de fin de mes y no incluyen la publicidad vendida ni publicada por socios. Consulta el Centro de ayuda de YouTube para obtener más información y notas sobre las cifras de ingresos estimados.

De manera predeterminada, todas las cifras estimadas de ingresos se expresan en dólares estadounidenses. Sin embargo, la API de YouTube Analytics es compatible con el parámetro currency para algunas métricas de ingresos estimados y de rendimiento de los anuncios, lo que te permite recuperar los datos de ingresos estimados en otras monedas.
estimatedRevenue (métrica principal) (anteriormente denominada earnings)
La estimación de los ingresos netos totales de todas las fuentes de publicidad vendidas por Google, así como de las fuentes no publicitarias para el período y la región seleccionados. This is a core metric and is subject to the Deprecation Policy.

Las métricas de ingresos estimados están sujetas a un ajuste de fin de mes y no incluyen la publicidad vendida ni publicada por socios.
estimatedAdRevenue (anteriormente llamado adEarnings)
Los ingresos netos estimados totales de todas las fuentes de publicidad vendidas por Google para el período y la región seleccionados.

Las métricas de ingresos estimadas están sujetas a un ajuste de fin de mes y no incluyen la publicidad vendida por socios ni presentada por socios.
estimatedRedPartnerRevenue (anteriormente llamado redPartnerRevenue)
Los ingresos estimados totales que provienen de las suscripciones a YouTube Premium (antes conocidas como YouTube Red) para las dimensiones de informes seleccionadas. El valor de la métrica refleja los ingresos del contenido musical y no musical, y está sujeto a un ajuste de fin de mes.

Métricas de rendimiento de los anuncios

Ingresos brutos
Los ingresos brutos estimados, en dólares estadounidenses, de toda la publicidad vendida por Google o por socios DoubleClick para el período y la región seleccionados. Los ingresos brutos están sujetos a un ajuste de fin de mes y no incluyen la publicidad presentada por socios. Los ingresos brutos no deben confundirse con los ingresos estimados ni los ingresos netos, que incluyen tu acuerdo de propiedad y los ingresos compartidos.
cpm (anteriormente llamado impressionBasedCpm)
Los ingresos brutos estimados por cada mil impresiones de anuncios.
adImpressions (anteriormente llamada impressions)
Es la cantidad de impresiones de anuncios verificadas publicadas.
monetizedPlaybacks
La cantidad de instancias en las que un espectador reprodujo tu video y se mostró al menos una impresión de anuncios. Se contabiliza una reproducción monetizada cuando a un espectador se le muestra un anuncio previo al video, pero deja de ver el anuncio antes de que comience el video. La expectativa de error estimado para esta cifra es de aproximadamente 2,0 %.
reproducción basadaencpm
Los ingresos brutos estimados por cada mil reproducciones.