Metrics

En este documento, se definen las métricas que puedes recuperar con 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 elementos como la cantidad de vistas de un video y las 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 definida en las Condiciones del Servicio, las métricas y dimensiones no principales no están sujetas a la política. En las definiciones de esta página, cualquier métrica que sea una métrica principal se identifica explícitamente como tal.

En la siguiente lista, se identifican las métricas principales de la API.

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

Ver métricas

vistas (métrica principal)
Esta métrica representa diferentes números en diferentes tipos de informes:
  • En los informes de video, esta métrica especifica la cantidad de veces que se miró un video.
  • En los informes de playlists que no usan la dimensión isCurated, esta métrica especifica la cantidad total de vistas de los videos de la playlist, independientemente de si esas vistas se produjeron en el contexto de la playlist. Ten en cuenta que el valor de la métrica solo incluye las vistas de los videos del propietario del canal.

    En estos informes, la métrica playlistViews indica la cantidad de veces que se vieron los videos de la playlist en el contexto de una playlist específica.
  • En los informes de playlists que usan la dimensión isCurated, esta métrica indica la cantidad de veces que se vieron los videos en el contexto de una playlist específica. Ten en cuenta que la métrica playlistViews no es compatible con estos informes.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Esta métrica se define en la sección Métricas de playlist.
redViews
Es la cantidad de veces que los miembros de YouTube Premium (antes conocido como YouTube Red) miraron un video.
viewerPercentage (métrica principal)
Es el porcentaje de usuarios que habían accedido a sus cuentas cuando miraron el video o la playlist. This is a core metric and is subject to the Deprecation Policy.

Métricas de tiempo de reproducción

estimatedMinutesWatched (métrica principal)
Es la cantidad de minutos que los usuarios miraron videos del canal, el propietario del contenido, el video o la playlist especificados. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
Es la cantidad de minutos que los miembros de YouTube Premium (antes conocido como YouTube Red) miraron un video.
averageViewDuration (métrica principal)
Es 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 playlist, la métrica indica la duración promedio, en segundos, de las reproducciones de video que se produjeron en el contexto de una playlist. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Es el porcentaje promedio de un video que se mira 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)
Es la cantidad de veces que los usuarios comentaron un video. Consulta el Centro de ayuda de YouTube para obtener más información. This is a core metric and is subject to the Deprecation Policy.
me gusta (métrica principal)
Es la cantidad de veces que los usuarios indicaron que les gustó un video con una calificación positiva. This is a core metric and is subject to the Deprecation Policy.
No me gusta (métrica principal)
Es la cantidad de veces que los usuarios indicaron que no les gustó un video con una calificación negativa. This is a core metric and is subject to the Deprecation Policy.
porcentaje (métrica principal)
Es la cantidad de veces que los usuarios compartieron un video a través del botón Share. Consulta el Centro de ayuda de YouTube para obtener más información. This is a core metric and is subject to the Deprecation Policy.
subscribersGained (métrica principal)
Es 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, como la página de reproducción de videos, 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 de modo que solo incluya 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)
Es la cantidad de veces que los usuarios se dieron de baja de un canal. This is a core metric and is subject to the Deprecation Policy.

Los datos de esta métrica se registran de manera similar a 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 usan la dimensión video o el parámetro filter para restringir la respuesta de modo que solo incluya datos de un video en particular, esta métrica solo incluye a los usuarios que se dieron de baja de la página de reproducción del video especificado.
videosAddedToPlaylists
Es la cantidad de veces que se agregaron videos a cualquier playlist de YouTube. Los videos podrían haberse agregado a la playlist del propietario del video o a las playlists de otros canales.

El valor de la métrica incluye la cantidad de veces que se agregaron videos a playlists predeterminadas, como la playlist “Ver más tarde”. Sin embargo, no se incluyen las playlists a las que se agrega automáticamente un video, como la playlist de cargas de un canal o el historial de reproducciones de un usuario.

Esta métrica muestra un número absoluto, lo que significa que, si un usuario agrega un video a una playlist, lo quita y, luego, lo vuelve a agregar, el valor de la métrica refleja que el video se agregó a una playlist dos veces. Los datos de esta métrica no están disponibles para fechas anteriores al 1 de octubre de 2014.
videosRemovedFromPlaylists
Es la cantidad de veces que se quitaron videos de cualquier playlist de YouTube. Los videos podrían haberse quitado de la playlist del propietario del video o de las playlists de otros canales.

El valor de la métrica incluye la cantidad de veces que se quitaron videos de playlists predeterminadas, como la playlist “Ver más tarde”.

Esta métrica muestra un número absoluto, lo que significa que, si un usuario agrega un video a una playlist, lo quita, lo vuelve a agregar y, luego, lo vuelve a quitar, el valor de la métrica refleja que el video se quitó de una playlist dos veces. Los datos de esta métrica no están disponibles para fechas anteriores al 1 de octubre de 2014.

Métricas de listas de reproducción

Los informes de playlists contienen dos tipos de métricas que explican cómo los usuarios interactúan con los videos de una playlist:

  • Las métricas de video agregadas proporcionan métricas de actividad del usuario e impresiones que se agregan para todos los videos de la playlist que también son propiedad del canal al que pertenece la playlist. 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.

    Consulta las secciones Métricas de vistas y Métricas de tiempo de reproducción de este documento para ver las definiciones de las métricas de video agregadas compatibles.

  • Las métricas de la playlist 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 cuentan las vistas que se produjeron en el contexto de la playlist.

La mayoría de las métricas que se enumeran a continuación son métricas de la playlist. Las métricas restantes de la lista, como la métrica playlistSaves, se relacionan con las interacciones de los usuarios con la playlist en sí, no con los videos de la playlist. Por lo tanto, esas métricas no se caracterizarían como métricas de video agregadas ni métricas en la playlist.

averageTimeInPlaylist
Es la cantidad promedio estimada en minutos que un usuario miró videos en una playlist después de que se inició. Ten en cuenta que esta métrica solo incluye las vistas de playlists que se produjeron en la Web.
playlistAverageViewDuration
Es la duración promedio estimada, en segundos, que se miró por vista de playlist. Ten en cuenta que esta métrica representa la duración promedio de las vistas de videos individuales dentro de una playlist. Por el contrario, la métrica averageTimeInPlaylist representa el tiempo promedio que cada usuario dedica a mirar la playlist en su totalidad. Esta métrica incluye datos de los videos de playlists que pertenecen a otros canales.
playlistEstimatedMinutesWatched
Es la cantidad de minutos que los usuarios miraron el contenido de la playlist como parte de ella. No se registra el tiempo de reproducción que se produjo en otros contextos, por ejemplo, el tiempo de reproducción de las vistas que se produjeron cuando los usuarios miraban el mismo video como parte de otras playlists. Esta métrica incluye datos de los videos de playlists que pertenecen a otros canales.
playlistSaves
Es la cantidad neta de veces que los usuarios guardaron una playlist. Consulta el Centro de ayuda de YouTube para obtener más información sobre las playlists guardadas. Esta métrica muestra un número de cambio neto, lo que significa que, si un usuario guarda una playlist, la quita de la lista de playlists guardadas y la vuelve a guardar, el valor de la métrica refleja que se agregó una playlist guardada.
playlistStarts
Es la cantidad de veces que los usuarios iniciaron la reproducción de una playlist. Ten en cuenta que esta métrica solo incluye las vistas de playlists que se produjeron en la Web.
playlistViews
Es la cantidad de veces que se vieron los videos de la playlist en el contexto de esa playlist. Esta métrica incluye datos de los videos de las playlists que pertenecen a otros canales.
viewsPerPlaylistStart
Es la cantidad promedio de vistas de video que se produjeron cada vez que se inició una playlist. Ten en cuenta que esta métrica solo incluye las vistas de playlists que se produjeron en la Web.

Métricas de anotaciones

Nota: Los informes de la API de YouTube Analytics solo muestran datos de 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 de las métricas de anotaciones restantes a partir del 16 de julio de 2013.

annotationImpressions
Es la cantidad total de impresiones de anotaciones.
annotationClickableImpressions
Es la cantidad de anotaciones que aparecieron y en las que se podía hacer clic.
annotationClicks
La cantidad de anotaciones en las que se hizo clic.
annotationClickThroughRate (métrica principal)
Es la proporción de anotaciones en las que los usuarios hicieron clic en relación con la cantidad total de impresiones de anotaciones en las que se podía 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 para crear anotaciones y usar anotaciones de vínculos.
annotationClosableImpressions
Es la cantidad de anotaciones que aparecieron y que se pudieron cerrar.
annotationCloses
La cantidad de anotaciones cerradas.
annotationCloseRate (métrica principal)
Es la proporción de anotaciones que cerraron los usuarios en relación con 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.

cardImpressions
Es 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 del video.
cardClicks
Es la cantidad de veces que se hizo clic en las tarjetas.
cardClickRate
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.
cardTeaserImpressions
Es la cantidad de veces que se mostraron los avances de tarjeta. Una vista de video puede generar varias impresiones de avances.
cardTeaserClicks
Es la cantidad de clics en los avances de tarjeta. Los clics en el ícono de la tarjeta se atribuyen al último avance que se le mostró al usuario.
cardTeaserClickRate
La tasa de clics de los avances de tarjeta, que se calcula como la proporción de clics en los avances de tarjeta con respecto a la cantidad total de impresiones de avances de tarjeta.

Métricas de las transmisiones en vivo (usuarios simultáneos)

averageConcurrentViewers
Es la cantidad promedio de usuarios simultáneos de un video en particular. Si se especifica la dimensión livestreamPosition para el informe, el valor averageConcurrentViewers especifica la cantidad promedio de usuarios simultáneos durante un segmento en particular.
peakConcurrentViewers
Es la cantidad máxima de usuarios simultáneos de un video en particular. Si se especifica la dimensión livestreamPosition para el informe, el valor peakConcurrentViewers especifica la cantidad máxima de usuarios simultáneos durante un segmento en particular del video.

Métricas de retención de público

audienceWatchRatio
Es la proporción absoluta de usuarios que miran el video en un momento determinado. Para calcular la proporción, se compara la cantidad de veces que se reprodujo una parte de un video con la cantidad total de vistas del video. 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 puede mirar más de una vez (o no mirarse) en una vista determinada. Por ejemplo, si los usuarios rebobinan 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 ilustra cómo se calcula el valor:
  • Un video de un minuto se mira 100 veces. La mitad de los usuarios dejan de mirar el video después de 15 segundos y el resto lo mira completo. Ninguno de los usuarios 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 cuarto del video y 0.50 para el resto del video.
  • Un video de un minuto se mira 100 veces. Todos los usuarios miran el video completo, pero 20 de ellos lo miran hasta el minuto 45, luego vuelven al minuto 30 y, después, miran el resto del video. En este caso, el valor de la métrica sería 1 para los intervalos de tiempo en la primera mitad o el último cuarto del video. Sin embargo, el valor sería 1.2 para los intervalos de tiempo del tercer cuarto del video, ya que el 100% de los usuarios miraron ese segmento del video, pero el 20% de ellos lo miraron dos veces.
relativeRetentionPerformance
Es una medición que muestra la capacidad de un video para retener a los usuarios durante las reproducciones en comparación con todos los videos de YouTube de duración similar. La métrica tiene un valor entre 0 y 1 que identifica el rendimiento de retención relativo del video en un momento determinado. La dimensión elapsedVideoTimeRatio proporciona el punto en el video.

Un valor de 0 indica que el video retiene a los usuarios peor que cualquier otro video de duración similar, mientras que un valor de 1 indica que el video retiene a los usuarios 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 usuarios, mientras que la otra mitad lo hace peor.

En el siguiente ejemplo hipotético, se muestra cómo podrían aparecer los valores en un informe. En promedio, el 90% de los usuarios que miran videos de 10 minutos siguen mirándolos después de tres minutos, y el 70%, después de ocho minutos. Sin embargo, en el caso de un video específico de 10 minutos, solo el 80% de los usuarios sigue mirándolo después de tres minutos, pero todos siguen mirándolo después de ocho minutos.
  • En el valor de elapsedVideoTimeRatio que corresponde al punto 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.
  • En el valor de elapsedVideoTimeRatio correspondiente al punto que está a los ocho minutos del 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 de duración similar.
startedWatching
Es la cantidad de veces que un segmento en particular del video fue el primero que se vio durante la reproducción.

Por ejemplo, supongamos que el video X dura 5 minutos. A los efectos de este informe, YouTube divide el video en 100 segmentos de 3 segundos, que se identifican con la dimensión elapsedVideoTimeRatio. Un usuario visita YouTube y mira el primer minuto y diez segundos del video, que incluye todos o parte de los primeros 24 segmentos del video. En una visita posterior a YouTube, el usuario mira el resto del video, reanuda la reproducción en el segmento 24 y continúa hasta el segmento 100.

Este ejemplo produciría estos valores de métrica de observación:
  • El valor de la métrica startedWatching sería 1 para los segmentos 1 y 24, y el valor de la métrica sería 0 para todos los demás segmentos.
  • El valor de la métrica stoppedWatching sería 1 para los segmentos 24 y 100, y el valor de la métrica sería 0 para todos los demás segmentos.
  • El valor de la métrica totalSegmentImpressions sería 2 para el segmento 24 y el valor de la métrica sería 1 para todos los demás segmentos.
stoppedWatching
Es la cantidad de veces que un segmento en particular del video fue el último que se vio durante una reproducción. Consulta la definición de la métrica startedWatching para ver un ejemplo de cómo se calcula este valor.
totalSegmentImpressions
Es la cantidad de veces que se miró un segmento específico de un video. Consulta la definición de la métrica startedWatching para ver un ejemplo de cómo se calcula este valor. Ten en cuenta que un usuario puede mirar el mismo segmento de un video varias veces en la misma reproducción.

Métricas de cancelación de membresías

membershipsCancellationSurveyResponses
Es la cantidad de encuestas completadas por los usuarios de YouTube que cancelaron su membresía del canal especificado durante el período del informe.

Métricas de ingresos estimados

Nota: Las métricas de ingresos estimados están sujetas a ajustes de fin de mes y no incluyen los ingresos publicitarios que publican o venden los socios. Consulta el Centro de ayuda de YouTube para obtener información adicional y notas sobre las cifras de ingresos estimados.

De forma predeterminada, todas las cifras de ingresos estimados se registran en USD. Sin embargo, la API de YouTube Analytics admite el parámetro currency para algunas métricas de ingresos estimados y rendimiento de los anuncios, lo que te permite recuperar datos de ingresos estimados en otras monedas.
estimatedRevenue (métrica principal) (anteriormente llamada earnings)
Son los ingresos netos totales estimados de todas las fuentes publicitarias 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 los ingresos publicitarios que publican o venden los socios.
estimatedAdRevenue (anteriormente llamado adEarnings)
Son los ingresos netos totales estimados de todas las fuentes de publicidad vendidas por Google para el período y la región seleccionados.

Las métricas de ingresos estimados están sujetas a un ajuste de fin de mes y no incluyen los ingresos publicitarios que publican o venden los socios.
estimatedRedPartnerRevenue (anteriormente llamado redPartnerRevenue)
Son los ingresos totales estimados que se obtuvieron de las suscripciones a YouTube Premium (antes conocido como YouTube Red) para las dimensiones del informe seleccionadas. El valor de la métrica refleja los ingresos del contenido musical y no musical, y está sujeto a ajustes al final del mes.

Métricas de rendimiento de los anuncios

grossRevenue
Son los ingresos brutos estimados, en USD, de toda la publicidad vendida por Google o por socios de 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. No debes confundir los ingresos brutos con los ingresos estimados o netos, que tienen en cuenta tu porcentaje de propiedad y los acuerdos de reparto de ingresos.
cpm (anteriormente llamado impressionBasedCpm)
Son los ingresos brutos estimados por cada mil impresiones de anuncios.
adImpressions (anteriormente llamado impressions)
Es la cantidad de impresiones de anuncios verificadas que se publicaron.
monetizedPlaybacks
Es la cantidad de veces que un usuario reprodujo tu video y se le 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 %.
playbackBasedCpm
Son los ingresos brutos estimados por cada mil reproducciones.