En este documento, se definen las métricas que recupera la API de YouTube Reporting. Esta API recupera informes de datos masivos que contienen datos de YouTube Analytics de un canal o propietario del 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 datos 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 Reporting 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. Cualquiera de estas métricas que también se use en la API de YouTube Analytics también es una métrica principal en esa API.
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
engaged_views
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
Consulta la lista de APIs de YouTube sujetas a la Política de Baja para obtener más información.
Ver métricas
- engaged_views (métrica principal)
- Es la cantidad de veces que se miraron los videos del canal después de los segundos iniciales.
- vistas (métrica principal)
- Es la cantidad de veces que se miró un video. En un informe de playlist, la métrica indica la cantidad de veces que se vio un video en el contexto de una playlist. El Centro de ayuda de YouTube proporciona información adicional sobre cómo se registran 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)
- 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
- watch_time_minutes (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.
- red_watch_time_minutes
- Es 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. 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.
- average_view_duration_percentage
- 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.
- 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. - subscribers_gained (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. Para identificar la cantidad de suscriptores nuevos del canal que no se suscribieron a través de la página de reproducción de un video, un informe básico de 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étricasubscribersLost
, pero no especifica valores para otras métricas. - subscribers_lost (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étricasubscribers_gained
. Para identificar la cantidad de usuarios que se dieron de baja, pero no en la página de reproducción de un video, un informe básico de 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étricasubscribers_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. 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 los videos se agregaron 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. - videos_removed_from_playlists
- 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 registran las vistas que se produjeron en el contexto de la playlist.
La mayoría de las siguientes métricas 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 de playlist.
- playlist_starts
- 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.
- playlist_saves_added (solo se admite en la API de informes de YouTube)
- Es la 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 muestra un número absoluto, 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 agregaron dos playlists guardadas.
- playlist_saves_removed (solo se admite en la API de informes de YouTube)
- Es la cantidad de veces que los usuarios quitaron la playlist de sus listas de playlists guardadas. Esta métrica muestra 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, luego, la vuelve a quitar, el valor de la métrica refleja que se quitaron dos playlists guardadas.
Métricas de anotaciones
- annotation_impressions
- Es la cantidad total de impresiones de anotaciones.
- annotation_clickable_impressions
- Es la cantidad de anotaciones que aparecieron y en las que se podía hacer clic.
- annotation_clicks
- La cantidad de anotaciones en las que se hizo clic.
- annotation_click_through_rate (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.
- annotation_closable_impressions
- Es la cantidad de anotaciones que aparecieron y que se pudieron cerrar.
- annotation_closes
- La cantidad de anotaciones cerradas.
- annotation_close_rate (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.
- card_impressions
- 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.
- 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 de clics de tarjetas en comparación con 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 avances.
- 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.
- 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 se muestran durante los últimos cinco a 20 segundos de un video para promocionar tu contenido, tu canal y tus 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.
- end_screen_element_impressions
- Es la cantidad de elementos de pantalla final que se mostraron. Se registra una impresión por cada elemento de la pantalla final que se muestra.
- end_screen_element_clicks
- Es la cantidad de veces que se hizo clic en los elementos de la pantalla final.
- end_screen_element_click_rate
- Es la tasa de clics de los elementos de la pantalla final, que se calcula como la proporción de clics en los elementos de la pantalla final y las impresiones de los elementos de la pantalla final.
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 reprodujo 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 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 que1
.
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 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 lo miran hasta el minuto 45, luego vuelven al minuto 30 y, finalmente, 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ía1.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.
- 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
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 la publicidad 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.
- estimated_partner_revenue (métrica principal)
- 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.
- estimated_partner_ad_revenue
- Son los ingresos netos totales estimados de todas las fuentes publicitarias vendidas por Google para el período y la región seleccionados.
Las métricas de ingresos estimados están sujetas a ajustes a fin de mes y no incluyen la publicidad vendida y publicada por socios. - estimated_partner_ad_auction_revenue (solo se admite en la API de informes de YouTube)
- 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. Esta métrica antes se llamaba
estimated_partner_ad_sense_revenue
. - 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 reservada vendida a través de DoubleClick (DCLK) y otras fuentes vendidas por YouTube. Esta métrica antes se llamaba
estimated_partner_double_click_revenue
. - estimated_partner_red_revenue (solo se admite en la API de informes de YouTube)
- Son los ingresos totales estimados (ingresos netos) de las suscripciones a YouTube Premium (antes conocido como YouTube Red).
- estimated_partner_transaction_revenue (solo se admite en la API de informes de YouTube)
- Es el total de ingresos estimados de las transacciones, como el contenido pagado y la financiación de fans, menos los reembolsos cobrados 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 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.
- 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
- 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 %.
- estimated_playback_based_cpm
- Son los ingresos brutos estimados por cada mil reproducciones.