En este documento, se definen las métricas que puedes recuperar con la API de YouTube Analytics. Esta API permite realizar consultas en tiempo real para generar informes personalizados de YouTube Analytics.
Las métricas son mediciones individuales de la actividad de los usuarios, el rendimiento de los anuncios o los ingresos estimados. Las métricas de actividad del usuario incluyen aspectos como el recuento de vistas 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 no principales (y las dimensiones no principales) no están sujetas a la política. En las definiciones de esta página, todas las métricas que son métricas principales se identifican de forma explícita como tales.
La siguiente lista identifica las métricas principales de la API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
- La métrica principal
earnings
dejó de estar disponible el 4 de agosto de 2016 y se le cambió el nombre aestimatedRevenue
. Conforme a la Política de Baja definida en las Condiciones del Servicio, las métricasearnings
yestimatedRevenue
se admitieron de forma simultánea hasta el 10 de agosto de 2017. - Las métricas principales
favoritesAdded
yfavoritesRemoved
dejaron de estar disponibles el 31 de marzo de 2015. Solo se pueden recuperar estas métricas mediante la API de YouTube Analytics.
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 cantidades en distintos 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 listas de reproducción que no utilizan la dimensión
isCurated
, esta métrica especifica el número total de vistas para 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 incluye solo las vistas de los videos del propietario del canal.
En estos informes, la métricaplaylistViews
indica la cantidad de veces que se vieron los videos de una playlist en el contexto de una playlist específica. - En los informes de listas de reproducción que utilizan la dimensión
isCurated
, esta métrica indica la cantidad de veces que se vieron videos en el contexto de una playlist específica. Ten en cuenta que la métricaplaylistViews
no es compatible con estos informes.
- playlistViews
- Esta métrica se define en la sección Métricas de la playlist.
- redViews
- Es la cantidad de veces que los miembros de YouTube Premium (antes conocido como YouTube Red) miraron un video.
- uniques (dejó de estar disponible el 27 de septiembre de 2016)
- Es la cantidad de usuarios únicos que miraron un video. Este cálculo se basa en la cantidad de cookies únicas y, por lo tanto, superará a los usuarios que usan varios dispositivos o navegadores.
La métricauniques
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 usuarios que accedieron a sus cuentas cuando miraban 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, un video o una playlist especificados. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- 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. Desde el 13 de diciembre de 2021, esta métrica excluye el tráfico de clips en bucle. En un informe de lista 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
- Es el porcentaje promedio de un video que se miró durante la reproducción. Desde el 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)
- Corresponde a 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)
- 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)
- 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.
- 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)
- 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, incluidos 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ónvideo
o el parámetrofilter
para restringir la respuesta y que solo incluya datos de un video en particular, la métricasubscribersGained
solo incluirá las estadísticas de la página de reproducción del video especificado. - subscribersLost (métrica principal)
- Cantidad de veces que los usuarios anularon su suscripción a un canal. This is a core metric and is subject to the Deprecation Policy.
Los datos de esta métrica se informan de manera similar a la métricasubscribersGained
. 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ónvideo
o el parámetrofilter
para restringir la respuesta y que solo incluya datos de un video específico, esta métrica solo incluye a los usuarios que anularon la suscripción a la página de reproducción del video especificado. - videosAddedToPlaylists
- Es la cantidad de veces que se agregaron videos a cualquier playlist de YouTube. Es posible que los videos se hayan agregado a la playlist del propietario del video o a las de otros canales.
El valor de la métrica incluye la cantidad de veces que los videos se agregaron a playlists predeterminadas, como “Ver más tarde”. Sin embargo, no se tienen en cuenta 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, es decir, 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ó dos veces. Los datos de esta métrica no están disponibles para las fechas anteriores al 1 de octubre de 2014. - videosRemovedFromPlaylists
- La cantidad de veces que se eliminaron videos de alguna playlist de YouTube. Es posible que los videos se hayan 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 los videos se eliminaron de playlists predeterminadas, como la playlist “Ver más tarde”.
Esta métrica muestra un número absoluto, es decir, si un usuario agrega un video a una playlist, lo vuelve a agregar y, luego, lo vuelve a quitar, el valor de la métrica refleja el video que se quita de una playlist. 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 a partir del 31 de marzo de 2015)
- Cantidad de veces que los usuarios marcaron un video como favorito. 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.
- favoritesRemoved (métrica principal) (obsoleto a partir del 31 de marzo de 2015)
- Corresponde a la cantidad de veces que los usuarios quitaron un video de sus listas de videos favoritos. 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.
Métricas de las listas de reproducción
Los informes de playlists contienen dos tipos de métricas que explican cómo interactúan los espectadores con los videos de una playlist:
-
Las métricas agregadas de video proporcionan métricas de impresiones y actividad del usuario que se agregan para todos los videos de la playlist que también pertenecen al canal propietario de la playlist. Las métricas de los videos que pertenecen a otros canales no se calculan en la agregación. Por lo tanto, si un canal crea una playlist que contiene solo videos que pertenecen a otros canales, los informes de esas playlists no proporcionarán valores para estas métricas.
Consulta las secciones Métricas de vista y Métricas de tiempo de reproducción de este documento para conocer las definiciones de las métricas de video agregadas admitidas.
-
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 del canal que las posea, pero solo cuentan las vistas que ocurrieron en el contexto de la playlist.
La mayoría de las métricas que se enumeran a continuación pertenecen a la playlist. Las métricas restantes de la lista, como playlistSaves
, se refieren a las interacciones del usuario con la playlist y no con los videos de la playlist. Por lo tanto, esas métricas no se caracterizarían como métricas agregadas de video ni métricas en la playlist.
- averageTimeInPlaylist
- Es la cantidad de tiempo promedio estimada, en minutos, que un usuario vio videos en una playlist después de iniciarla. 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) de reproducción por vista de la playlist. Ten en cuenta que esta métrica representa la duración promedio de vistas de videos individuales en una playlist. Por el contrario, la métrica
averageTimeInPlaylist
representa el tiempo promedio que cada usuario pasa mirando la playlist en su totalidad. Esta métrica incluye datos de los videos de playlists que son propiedad de otros canales. - playlistEstimatedMinutesWatched
- 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 ocurrió en otros contextos (por ejemplo, el tiempo de reproducción de las vistas cuando los usuarios miraban el mismo video que formaba parte de otras playlists). Esta métrica
incluye datos de videos de playlists que son propiedad de 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 el guardado de una playlist que se agregó.
- playlistStarts
- 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
- La cantidad de veces que se vieron los videos de la playlist según el contexto de la playlist.
Esta métrica incluye datos de los videos de playlists que son propiedad de otros canales.
- viewsPerPlaylistStart
- 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 los datos de las métricas annotationClickThroughRate
y annotationCloseRate
al 10 de junio de 2012. Además, los informes de la API de YouTube Analytics solo devuelven datos de las demás métricas de anotaciones a partir del 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)
- Proporción de las 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. El Centro de ayuda de YouTube tiene más información sobre cómo crear anotaciones y usar anotaciones de vínculos.
- annotationClosableImpressions
- La cantidad de anotaciones que aparecieron y que se pudieron cerrar.
- annotationCloses
- La cantidad de anotaciones cerradas
- annotationCloseRate (métrica principal)
- Proporción de las anotaciones que los usuarios 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.
- cardImpressions
- La cantidad de veces que se mostraron las tarjetas. Cuando se abre el panel de tarjetas, se registra una impresión de tarjetas por 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 entre los clics de tarjetas y las impresiones de tarjetas.
- Es la cantidad de veces que se mostraron los avances de tarjeta. Una vista de video puede generar varias impresiones de avance.
- Es la cantidad de clics en los avances de tarjeta. Los clics en el ícono de la tarjeta se atribuyen al avance más reciente que se mostró al usuario.
- Es 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 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 miró 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 podría mirar más de una vez (o no se podría mirar) en una vista 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 que1
.
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 usuarios dejan de mirar después de 15 segundos y el resto mira el video completo. Ninguno de los usuarios miró 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 y0.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 miran hasta los 45 segundos del video. Luego, vuelven a la marca de 30 segundos del video y, luego, 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 en el último trimestre del video. Sin embargo, el valor sería1.2
para los intervalos de tiempo del tercer cuarto del video, ya que el 100% de los usuarios miró ese segmento, pero el 20% lo miró dos veces.
- Un video de un minuto se mira 100 veces. La mitad de los usuarios dejan de mirar después de 15 segundos y el resto mira el video completo. Ninguno de los usuarios miró ninguna parte del video más de una vez. En este caso, el valor de esta métrica sería
- relativeRetentionPerformance
- Es una medición que muestra qué tan bien retiene un video 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
y1
que identifica el rendimiento relativo de la retención del video en un punto determinado del video. La dimensiónelapsedVideoTimeRatio
proporciona el punto del video.
Un valor de0
indica que el video retiene a los usuarios peor que cualquier otro video de duración similar, mientras que un valor de1
indica que el video retiene a los usuarios mejor que cualquier otro video de duración similar. Un valor medio de0.5
indica que la mitad de los videos de duración similar retienen a los usuarios mejor, mientras que la mitad lo retienen peor.
El siguiente ejemplo hipotético ilustra cómo pueden aparecer los valores en un informe. En promedio, el 90% de los usuarios que miran videos de 10 minutos de duración sigue mirando después de tres minutos y el 70% 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 usuarios sigue mirando después de tres minutos, pero todos ellos siguen mirando después de ocho minutos.- En el valor
elapsedVideoTimeRatio
que corresponde al punto que está a tres minutos del video, la métricarelativeRetentionPerformance
tendría un valor inferior a0.5
, ya que, en ese momento, el rendimiento del video es peor que el promedio. - En el valor de
elapsedVideoTimeRatio
correspondiente al punto en el que se encuentran ocho minutos de duración del video, la métricarelativeRetentionPerformance
tendría un valor superior a0.5
, ya que, en ese momento, el rendimiento del video era mejor que el de otros videos de duración similar.
- En el valor
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. Para obtener información adicional y notas sobre las cifras de ingresos estimados, consulta el Centro de ayuda de YouTube.
currency
para algunas métricas estimadas de los ingresos y el rendimiento de los anuncios, lo que te permite recuperar esos datos en otras monedas.- estimatedRevenue (métrica principal) (anteriormente llamada
earnings
) - Son los ingresos netos totales estimados de todas las fuentes de publicidad vendidas por Google y de 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 (antes denominado
adEarnings
) - Son los ingresos netos totales estimados provenientes 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 la publicidad vendida ni publicada por socios. - estimatedRedPartnerRevenue (anteriormente llamado
redPartnerRevenue
) - Son los ingresos totales estimados que obtuviste de las suscripciones a YouTube Premium (antes conocido como YouTube Red) para las dimensiones de informes seleccionadas. El valor de la métrica refleja los ingresos provenientes del contenido musical y no musical, y está sujeto a un ajuste de fin de 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 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 se deben confundir los ingresos brutos con los ingresos estimados o los ingresos netos, que consideran los acuerdos de cuota de propiedad y reparto de ingresos.
- cpm (antes llamado
impressionBasedCpm
) - Son los ingresos brutos estimados por cada mil impresiones de anuncios.
- adImpressions (antes llamada
impressions
) - Es la cantidad de impresiones de anuncios verificadas que se publicaron.
- monetizedPlaybacks
- La cantidad de casos en los 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
- Los ingresos brutos estimados por cada mil reproducciones.