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 de un canal o propietario de contenido.

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 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, 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. Todas las métricas que se usan en la API de YouTube Analytics también son métricas principales en 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)
Es la cantidad de veces que se miró un video. En un informe de listas de reproducción, la métrica indica la cantidad de veces que se vio un video en el contexto de una lista de reproducción. En el Centro de ayuda de YouTube, se proporciona información adicional sobre cómo se informan las vistas. This is a core metric and is subject to the Deprecation Policy.
red_views
Es la cantidad de veces que los miembros de YouTube Premium (antes conocido como YouTube Red) miraron un video.
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
La cantidad de minutos que los miembros de YouTube Premium (antes conocido como YouTube Red) miraron un video.
average_view_duration_seconds (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.
average_view_duration_percentage
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.
participación (métrica principal)
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.
subscribers_gained (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. Para identificar el número de nuevos suscriptores del canal que no se suscribieron a través de una página de reproducción de video, un informe básico de actividad del usuario contiene una fila que no especifica un valor de dimensión de video_id. Esa fila también especifica un valor para la métrica subscribersLost, pero no especifica valores para otras métricas.
subscribers_lost (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étrica subscribers_gained. Para identificar la cantidad de usuarios que anularon la suscripción, pero no anularon la suscripción en una página de reproducción de video, un informe básico de actividad del usuario contiene una fila que no especifica un valor de dimensión de video_id. Esa fila también especifica un valor para la métrica subscribers_gained, pero no especifica valores para otras métricas.
videos_added_to_playlists
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.
videos_removed_from_playlists
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 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.

playlist_starts
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.
playlist_saves_added (solo es compatible con la API de YouTube Reporting)
Cantidad 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 devuelve un número absoluto, lo que significa que si un usuario guarda una playlist, la elimina de la lista de playlists guardadas y la vuelve a guardar, el valor de la métrica refleja las dos playlists guardadas que se agregan.
playlist_saves_removed (solo es compatible con la API de Informes de YouTube)
La cantidad de veces que los usuarios quitaron la playlist de sus listas de playlists guardadas. Esta métrica devuelve un número absoluto, lo que significa que si un usuario guarda una playlist, la quita de la lista de playlists guardadas, la vuelve a guardar y la quita nuevamente, el valor de la métrica refleja dos playlists guardadas que se quitarán.

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.
annotation_clicks
La cantidad de anotaciones en las que se hizo clic.
annotation_click_through_rate (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.
annotation_closable_impressions
La cantidad de anotaciones que aparecieron y que se pudieron cerrar.
annotation_closes
La cantidad de anotaciones cerradas
annotation_close_rate (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.

card_impressions
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.
card_clicks
Es la cantidad de veces que se hizo clic en las tarjetas.
card_click_rate
La tasa de clics de las tarjetas, que se calcula como la proporción entre los clics de tarjetas y las impresiones de tarjetas.
card_teaser_impressions
Es la cantidad de veces que se mostraron los avances de tarjeta. Una vista de video puede generar varias impresiones de avance.
card_teaser_clicks
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.
card_teaser_click_rate
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 las pantallas finales

Las pantallas finales son elementos que aparecen entre los últimos 5 y 20 segundos de un video para promocionar tu contenido, canal y 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
Es 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
Es 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 entre los clics en los elementos de pantalla final y las impresiones en ellos.

Métricas de retención de público

audience_retention_percentage
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 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 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 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 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 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 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ía 1.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.

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.

La API de informes de YouTube informa todas las cifras de ingresos estimados en USD.
estimated_partner_revenue (métrica principal)
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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (solo es compatible con la API de YouTube Reporting)
Son los ingresos totales estimados (ingresos netos) de la publicidad vendida en subastas a través de AdSense para el período y la región seleccionados. Anteriormente, esta métrica se llamaba estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (solo es compatible con la API de YouTube Reporting)
Son los ingresos totales estimados (ingresos netos) de la publicidad de AdSense vendida por subastas para el período y la región seleccionados.
estimated_partner_ad_reserved_revenue (solo se admite en la API de YouTube Reporting)
Son los ingresos totales estimados (ingresos netos) de la publicidad vendida por reservas a través de DoubleClick (DCLK) y otras fuentes vendidas por YouTube. Anteriormente, esta métrica se llamaba estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (solo es compatible con la API de YouTube Reporting)
Son los ingresos totales estimados (ingresos netos) de la publicidad vendida por reservas a través de DoubleClick (DCLK) y otras fuentes vendidas por YouTube.
estimated_partner_red_revenue (solo compatible con la API de YouTube Reporting)
Son los ingresos totales estimados (ingresos netos) de las suscripciones a YouTube Premium (antes conocido como YouTube Red).
estimated_partner_transaction_revenue (solo compatible con la API de YouTube Reporting)
Son los ingresos totales estimados de las transacciones, como el contenido pagado y la financiación de fans, menos cualquier reembolso cobrado por los socios.

Métricas de rendimiento de los anuncios

estimated_youtube_ad_revenue
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.
estimated_cpm
Son los ingresos brutos estimados por cada mil impresiones de anuncios.
ad_impressions
Es la cantidad de impresiones de anuncios verificadas que se publicaron.
estimated_monetized_playbacks
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 %.
estimated_playback_based_cpm
Los ingresos brutos estimados por cada mil reproducciones.