Introduction

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En este documento se explican las similitudes y diferencias en las formas en que la API de YouTube Analytics y la API de informes de YouTube proporcionan acceso a los datos de YouTube Analytics. El propósito del documento es ayudarte a elegir la API correcta para tu aplicación.

Ambas API permiten a los desarrolladores recuperar datos de YouTube Analytics. Además, ambas API admiten propietarios de canales de YouTube y propietarios de contenido de YouTube, cada uno de los cuales puede acceder a un conjunto específico de informes:

  • Informes de canales: contienen métricas de actividad de los usuarios para un canal especificado.

  • Informes de propietarios de contenido: recopilan métricas de todos los canales vinculados a un determinado propietario de contenido de YouTube. Por ejemplo, un sello discográfico podría recuperar un informe que contenga estadísticas combinadas de los canales de YouTube de todos los artistas del sello. Algunos informes de propietarios de contenido contienen métricas de actividad de los usuarios, mientras que otros contienen métricas relacionadas con los ingresos y el rendimiento de los anuncios.

La API de informes también permite que algunos propietarios del contenido accedan a los informes de ingresos por anuncios administrados por el sistema. Los datos de los informes administrados por el sistema solo se pueden recuperar con la API de informes.

Todas las solicitudes de la API de informes de YouTube y de YouTube Analytics deben contar con la autorización del canal o del propietario del contenido que posee los datos solicitados.

Informar contenido

Los informes que recuperan las API contienen dos tipos de datos:

  • Dimensiones: criterios comunes que se utilizan para recopilar datos, como la fecha en que se produjo la actividad de los usuarios o el país donde se encuentran los usuarios.

    En un informe, cada fila de datos tiene una combinación única de valores de dimensión. Por lo tanto, la combinación de valores de dimensión de cada fila funciona como la clave primaria de esa fila.

  • 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).

Elige la API adecuada para tu aplicación

API de YouTube Analytics
La API de YouTube Analytics admite consultas objetivo en tiempo real para generar informes personalizados de YouTube Analytics. La API proporciona parámetros para filtrar y ordenar, por lo que la aplicación que realiza la llamada no necesita admitir estas funciones de forma nativa.

Cada solicitud a la API especifica el período en el que se mostrarán los datos. La API también te permite recuperar conjuntos de datos semanales y mensuales. Como tal, la aplicación que realiza la llamada no necesita almacenar conjuntos de datos recuperados ni agregar estadísticas en períodos.
API de informes de YouTube
La API de informes de YouTube recupera informes masivos que contienen datos de YouTube Analytics de un canal o propietario de contenido. Está diseñado para aplicaciones que pueden importar conjuntos grandes de datos y que proporcionan herramientas para filtrar, ordenar y extraer esos datos.

Cada informe contiene un conjunto predefinido de campos. Los programadores usan la API para programar trabajos de informes, cada uno de los cuales identifica un informe que YouTube debe generar. Luego, YouTube genera un informe diario que se puede descargar de manera asíncrona. Cada informe contiene datos para un período único de 24 horas.

Además, YouTube genera automáticamente un conjunto de informes administrados por el sistema para los propietarios del contenido que tienen acceso a los informes correspondientes en YouTube Creator Studio. Estos informes proporcionan acceso programático a los datos de ingresos publicitarios.

Informes compatibles

En la siguiente tabla se identifican los diferentes tipos de informes que puedes recuperar mediante las API. Las consultas de orientación están disponibles a través de la API de YouTube Analytics y los informes masivos están disponibles a través de la API de informes de YouTube.

Es posible que los datos disponibles en una API no estén disponibles en la otra. Por ejemplo, la API de YouTube Analytics te permite recuperar métricas de actividad del usuario de manera semanal o mensual, pero la API de informes de YouTube requiere que agregues esa información. Por otro lado, la API de informes de YouTube admite informes de elementos para propietarios de contenido, pero esos datos no están disponibles desde la API de YouTube Analytics.

Tipos de informes
Denuncias de videos Compatible con canales (consulta o masivas) y propietarios de contenido (consulta o masivas).

Los informes de video proporcionan estadísticas sobre toda la actividad de los usuarios relacionada con los videos de un canal o de un propietario del contenido. Por ejemplo, estos informes contienen la cantidad de vistas que recibieron tus videos. En la API de YouTube Analytics, algunos informes de videos acerca de propietarios de contenido también incluyen ingresos estimados y métricas de rendimiento de los anuncios.
Informes de lista de reproducción Compatible con canales (consulta o masivas) y propietarios de contenido (consulta o masivas).

Los informes de listas de reproducción proporcionan estadísticas relacionadas específicamente con las vistas de video que se producen en el contexto de una lista de reproducción. La API de informes de YouTube admite los informes de retención de público para las listas de reproducción, pero la API de YouTube Analytics no admite un informe similar.
Informe de rendimiento de anuncios Compatible con propietarios de contenido (consulta o masiva).

Los informes de rendimiento de los anuncios proporcionan métricas basadas en impresiones para los anuncios que se publicaron durante las reproducciones de video. Estas métricas representan cada impresión de anuncio y cada reproducción de video puede generar varias impresiones.
Informes de ingresos estimados Compatible con propietarios de contenido (masivas).

Los informes de ingresos estimados proporcionan los ingresos estimados totales de los videos de fuentes de publicidad vendidas por Google y de fuentes no publicitarias. Estos informes también contienen algunas métricas de rendimiento de los anuncios. Ten en cuenta que los informes administrados por el sistema contienen ingresos reales.
Informes de activos Compatible con propietarios de contenido (masivas).

Los informes de activos proporcionan métricas sobre la actividad de los usuarios relacionadas con los videos que están vinculados a los activos de un propietario de contenido. Un video se incluye en el informe de un propietario de contenido si el propietario del contenido ha reclamado ese video como una coincidencia de uno de los elementos del propietario del contenido. Es posible que el propietario del contenido o algún otro usuario de YouTube haya subido el video.
Informes administrados por el sistema Compatible con los propietarios de contenido que tienen acceso a los informes correspondientes en la sección Informes de YouTube Studio.

Los informes administrados por el sistema proporcionan datos de ingresos reales que generan los activos y videos. Un informe adicional enumera los videos reclamados y los activos con los que coinciden. Ten en cuenta que no todos los informes de Creator Studio están disponibles actualmente en la API.

Nota: YouTube genera automáticamente los informes administrados por el sistema para los propietarios de contenido que tienen acceso a los informes correspondientes en Creator Studio. Como resultado, el proceso para recuperar estos informes es diferente al de los otros tipos de informes de esta lista. Consulta la documentación sobre los informes administrados por el sistema para obtener más información.

Diferencias clave

En la siguiente tabla, se destacan las diferencias importantes entre las API de YouTube Analytics y de informes.

Función API de YouTube Analytics API de informes de YouTube
Proceso para recuperar datos Cada solicitud a la API especifica las dimensiones y métricas que se mostrarán, así como el período para el que se mostrarán los datos. Las aplicaciones programan trabajos de informes. Para cada trabajo, YouTube genera informes diarios que se pueden descargar de manera asíncrona.
Intervalos de fechas Algunos informes de la API especifican la fecha en que ocurrió la actividad del usuario. Algunos de esos informes admiten dimensiones para agregar métricas de actividad del usuario por mes. Todos los informes de la API especifican el día en que se produjo la actividad del usuario. Las aplicaciones que usan la API pueden implementar funciones para agregar datos durante intervalos periódicos.
Cómo filtrar datos Puede filtrar los informes a fin de incluir solo las filas para las que una dimensión tiene un valor específico. La API también admite algunas dimensiones, como continent y subContinent, que se usan solo como filtros. La API admite descargas masivas de conjuntos de datos completos. No admite el filtrado ni muestra datos para dimensiones solo de filtro. La aplicación cliente almacena los datos descargados e implementa sus propias funciones para filtrar los datos.
Ordenamiento Los informes se pueden ordenar según los valores de métrica mostrados. Algunos informes solo admiten una cantidad limitada de resultados. Por ejemplo, el informe que enumera los videos más vistos de un canal muestra un máximo de 200 filas. Esta API admite descargas masivas de conjuntos de datos completos. Las aplicaciones cliente pueden implementar sus propias funciones para ordenar los datos descargados.
Enumeraciones Los informes de la API contienen valores de texto, como "ANDROID" o "CHANNEL", para identificar los valores de dimensión enumerados. Los informes de la API contienen números enteros que se pueden asignar a valores de texto.
Cuota El servidor de la API evalúa cada consulta para determinar su costo de cuota. En el documento Uso de cuotas, se explica la metodología con más detalle. El uso de la cuota no es un problema, ya que los datos se recuperan una vez y, luego, se filtran, ordenan y consultan dentro de la aplicación.
Informes únicos
  • Actividad del usuario relacionada con los subtítulos
  • Datos de retención de público para las listas de reproducción
  • Informes de ingresos estimados para propietarios de contenido (2 informes diferentes disponibles)
  • Informes de activos para propietarios de contenido (11 informes diferentes disponibles)
Dimensiones únicas group (dimensión de solo filtro)
continent (dimensión de solo filtro)
subContinent (dimensión de solo filtro)
month
isCurated==1 (dimensión de solo filtro)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
Métricas únicas uniques
relativeRetentionPerformance
viewsPerPlaylistStart
averageTimeInPlaylist
card_click_rate
card_clicks
card_impressions_ card_teaser_click_rate
card_teaser_clicks
card_teaser_impressions
estimated_partner_adsense_revenue
estimated_partner_doubleclick_revenue

Diferencias de nombres entre las API

Actualmente, las dos API usan convenciones de nombres diferentes para identificar las dimensiones y las métricas. Por el momento, los nombres de la API de YouTube Analytics son camelCase, mientras que los de los informes de YouTube usan nombres delimitados por guiones bajos.

Las tablas siguientes identifican los diferentes nombres que las dos API utilizan para identificar las mismas métricas y dimensiones. En algunos casos, la diferencia entre los dos nombres es más de lo que obtendrías después de convertir un nombre de camelCase en guiones bajos. Por ejemplo, la dimensión video en la API de YouTube Analytics se denomina video_id en la API de informes de YouTube.

Dimensiones

Nombre de la API de YouTube Analytics Nombre de la API de informes de YouTube
Tipodeanuncio tipo_anuncio
edad age_group [edad]
elemento asset_id [id_activo]
audienceType audience_retention_type
channel channel_id [id_canal]
claimedStatus claimed_status
contentOwner; content_owner_id [id_propietario_contenido]
country country_code [código_país]
día date
tipodedispositivo device_type [tipo_dispositivo]
elapsedVideoTimeRatio elapsed_video_time_percentage.
género [gender] género [gender]
insightPlaybackLocationDetail detalle_de_reproducción
insightPlaybackLocationType playback_location_type [tipo_ubicación_reproducción]
insightTrafficSourceDetail traffic_source_detail.
insightTrafficSourceType. traffic_source_type.
liveOrOnDemand live_or_on_demand.
Sistema operativo sistema_operativo
lista de reproducción ID de la lista de reproducción
province provincia_código
Servicio compartido servicio_de_sharding
subscribedStatus. subscribed_status
subtitleLanguage subtitle_language
Tipo de quien sube el video uploader_type [tipo_cargador]
video video_id [id_video]

Métricas

Nombre de la API de YouTube Analytics Nombre de la API de informes de YouTube
Ingresosdelosanuncios estimated_partner_ad_revenue
annotationImpressions annotation_impressions
annotationClickableImpressions annotation_clickable_impressions
AnnotationClicks anotaciones_clics
AnnotationClickThroughRate annotation_click_through_rate [porcentaje_clic_a través de anotaciones]
annotationClosableImpressions annotation_closable_impressions
annotationCloses. annotation_closes:
annotationCloseRate: Annotation_close_rate
audienceWatchRatio audience_retention_percentage
averageViewDuration; average_view_duration_seconds)
averageViewPercentage average_view_duration_percentage).
Tasa de clics de la tarjeta card_click_rate [tasa_clic_de_tarjeta]
Clicsdetarjeta clics_tarjetas
tarjetasimpresiones card_impressions
Tasa de clics del anuncio de tarjeta de crédito card_teaser_click_rate.
tarjetaTeaserClicks click_teaser_clicks.
tarjetaTeaserImpressions card_teaser_impressions
comments comments
no me gusta no me gusta
ingresos estimated_partner_revenue
estimatedMinutesWatched watch_time_minutes.
estimatedPartnerAdSenseRevenue. estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue. estimated_partner_doubleclick_revenue
Ingresos brutos estimated_youtube_ad_revenue
impressionBasedCpm cpm_estimadas
impresiones ad_impressions
me gusta me gusta
monetizedPlaybacks estimated_monetized_playbacks
reproducción basadaencpm estimated_playback_based_cpm
Listas de reproducción listas_de_reproducción
se agregó el elemento guardado playlist_saves_added
anulado quitado playlist_saves_removed
elementos compartidos elementos compartidos
Suscriptores obtenidos subscribers_gained
suscriptores perdidos subscribers_lost
videosAgregados a listas de reproducción videos_agregados_a_listas_de_reproducción
videos quitados de listas de reproducción videos_quitados_de_la_lista_de_reproducción
Porcentaje de usuarios views_percentage
vistas vistas