Metrics

En este documento se definen las métricas que recupera la API de informes de YouTube. Esta API recupera informes de datos masivos que contienen datos de YouTube Analytics sobre un canal o propietario de contenido.

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 informes de YouTube 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, 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. Cualquiera de estas métricas que también se usa en la API de YouTube Analytics también son métricas esenciales en esa API.

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.
rojo_vistas
La cantidad de veces que los miembros de YouTube Premium (antes conocidos como YouTube Red) miraron un video.
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes.
La cantidad de minutos durante los que los miembros de YouTube Premium (antes conocidos como YouTube Red) miraron un video.
average_view_duration_seconds (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.
average_view_duration_percentage).
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.
subscribers_gained (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. Para identificar la cantidad de suscriptores nuevos del canal que no se suscribieron mediante una página de reproducción de video, un informe básico de la actividad del usuario contiene una fila que no especifica un valor de dimensión video_id. Esa fila también especifica un valor para la métrica subscribersLost, pero no especifica valores de otras métricas.
subscribers_lost (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 subscribers_gained. Para identificar la cantidad de usuarios que anularon la suscripción en una página de reproducción de video, pero no lo anularon, un informe básico de la actividad del usuario contiene una fila que no especifica un valor de dimensión video_id. Esa fila también especifica un valor para la métrica subscribers_gained, pero no especifica valores de otras métricas.
videos_agregados_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_removed_from_playlists
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 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.
playlist_saves_added (solo admitido en YouTube Reporting API)
La cantidad de veces que los usuarios guardaron una lista de reproducción. Consulta el Centro de ayuda de YouTube para obtener más información sobre las listas de reproducción guardadas. Esta métrica muestra un número absoluto, lo que significa que, si un usuario guarda una lista de reproducción, la quita de la lista de listas de reproducción guardadas y la vuelve a guardar, el valor de la métrica refleja el almacenamiento de dos listas de reproducción guardadas.
playlist_saves_removed (sólo compatible con API de informes de YouTube)
Corresponde a la cantidad de veces que los usuarios quitaron la lista de reproducción de sus listas de listas de reproducción guardadas. Esta métrica muestra un número absoluto, lo que significa que, si un usuario guarda una lista de reproducción, la quita de la lista de listas de reproducción guardadas, la vuelve a guardar y la vuelve a quitar, el valor de la métrica refleja que dos listas de reproducción guardadas se quitan.

Métricas de anotaciones

annotation_impressions
La cantidad total de impresiones de anotaciones.
annotation_clickable_impressions
La cantidad de anotaciones que aparecieron y en las que se pudo hacer clic.
anotaciones_clics
La cantidad de anotaciones en las que se hizo clic.
annotation_click_through_rate (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.
annotation_closable_impressions
La cantidad de anotaciones que aparecieron y se pudieron cerrar.
annotation_closes:
La cantidad de anotaciones cerradas
annotation_close_rate (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.

card_impressions
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.
clics_tarjetas
La cantidad de veces que se hizo clic en las tarjetas.
card_click_rate [tasa_clic_de_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.
card_teaser_impressions
La cantidad de veces que se mostraron los avances de tarjeta. Una vista de video puede generar varias impresiones de avances.
click_teaser_clicks.
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.
card_teaser_click_rate.
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 pantalla final

Las pantallas finales son elementos que aparecen entre los últimos cinco y veinte segundos de un video para promocionar su contenido, su canal y sus sitios web. El Centro de ayuda de YouTube contiene instrucciones más detalladas para agregar pantallas finales a tus videos y el Informe de pantallas finales de YouTube Analytics.

Nota: Los datos de las métricas de las pantallas finales están disponibles desde el 1 de mayo de 2016.

end_screen_element_impressions
La cantidad de elementos de pantalla final que se mostraron. Se registra una impresión por cada elemento de pantalla final que se muestra.
end_screen_element_clicks.
La cantidad de veces que se hizo clic en los elementos de pantalla final.
end_screen_element_click_rate.
La tasa de clics de los elementos de pantalla final, que se calcula como la proporción de clics en el elemento de pantalla final en relación con las impresiones de elementos de pantalla final.

Métricas de retención de público

audience_retention_percentage
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 elapsed_video_time_percentage 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.

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.

La API de informes de YouTube informa todas las cifras estimadas de ingresos e ingresos en dólares estadounidenses.
estimated_partner_revenue (métrica principal)
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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (solo se admite en la API de informes de YouTube)
Los ingresos estimados totales (ingresos netos) que provienen de la publicidad vendida en subastas mediante AdSense para el período y la región seleccionados. Esta métrica antes se llamaba estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (solo se admite en la API de informes de YouTube)
Los ingresos estimados totales (ingresos netos) que provienen de la publicidad de AdSense vendida en subastas para el período y la región seleccionados.
estimated_partner_ad_reserved_revenue (solo se admite en la API de informes de YouTube)
Son los ingresos totales estimados (ingresos netos) de la publicidad vendida por reservas mediante DoubleClick (DCLK) y otras fuentes vendidas por YouTube. Esta métrica antes se llamaba estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (solo se admite en la API de informes de YouTube)
Los ingresos estimados totales (ingresos netos) de la publicidad vendida por reservas mediante DoubleClick (DCLK) y otras fuentes vendidas por YouTube.
estimated_partner_red_revenue (solo se admite en la API de informes de YouTube)
Los ingresos estimados totales (ingresos netos) de las suscripciones a YouTube Premium (antes conocidas como YouTube Red).
estimated_partner_transaction_revenue (solo se admite en la API de informes de YouTube)
Los ingresos totales estimados por transacciones, como el contenido pago y la financiación de fans, menos los reembolsos cobrados por los socios.

Métricas de rendimiento de los anuncios

estimated_youtube_ad_revenue
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_estimadas
Los ingresos brutos estimados por cada mil impresiones de anuncios.
ad_impressions
Es la cantidad de impresiones de anuncios verificadas publicadas.
estimated_monetized_playbacks
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 %.
estimated_playback_based_cpm
Los ingresos brutos estimados por cada mil reproducciones.