YouTube Analytics API - Data Model

La API de YouTube Analytics te permite generar informes personalizados que contengan datos de YouTube Analytics. La API admite informes para canales y propietarios de contenido. Los campos de informes se caracterizan como dimensiones o métricas:

  • Las dimensiones son criterios comunes que se utilizan para agregar datos, como la fecha en que se produjo una acción 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, las dimensiones que elija para un informe determinarán cómo calcula YouTube los valores de las métricas de ese informe.

  • Las métricas son mediciones individuales relacionadas con 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).

La API de Analytics proporciona parámetros para filtrar y ordenar, por lo que la aplicación que realiza la llamada no necesita admitir esas funciones de forma nativa. La API también te permite recuperar datos de grupos de YouTube Analytics, donde un grupo es una colección personalizada de hasta 500 videos, listas de reproducción, canales o activos.

Cómo elegir los parámetros del informe

Cuando solicitas un informe mediante el método reports.query de la API, la solicitud de API contiene cinco parámetros que determinan cómo se calcularán los valores del informe:

  • Los parámetros startDate y endDate especifican el período de tiempo durante el cual el informe contendrá datos. La respuesta de la API contiene datos hasta el último día especificado para los que todas las métricas de la consulta están disponibles en el momento de la consulta.

  • El parámetro metrics especifica las medidas que se incluirán en el informe. En los informes de canales, las métricas miden la actividad del usuario e incluyen valores como vistas y me gusta. Algunas métricas también miden el rendimiento de los anuncios o los ingresos estimados.

  • El parámetro dimensions explica cómo se agruparán las métricas.

  • El parámetro filters explica cómo se filtrarán los datos del informe. Por ejemplo, en lugar de mostrar todos los datos de un canal, es posible que se filtre un informe para que incluya solo las métricas de un determinado país, video o grupo de videos.

    Nota: La API te permite especificar varios valores para los filtros video, playlist y channel. Si lo haces, también puedes incluir ese filtro en la lista de dimensiones para que las métricas que se muestran también se agrupen por video, lista de reproducción o canal.

Opciones de informes de muestra

A modo de ejemplo, supongamos que el propietario de un canal desea recuperar un informe de tipo de dispositivo de video para determinar cuántas vistas de los videos del canal se produjeron en dispositivos móviles, consolas de juegos, TV, etc.

  • El propietario del canal establece el parámetro startDate en 2015-06-01 y el parámetro endDate en 2015-07-31. En función de estos valores, el informe contendrá datos para un período de dos meses.

  • El informe de tipos de dispositivos admite las métricas views y estimatedMinutesWatched, por lo que el propietario del canal establece el parámetro metrics en views,estimatedMinutesWatched.

  • Para el parámetro dimensions, el propietario del canal tiene varias opciones. Dos de ellos se muestran en la siguiente lista, y un tercero se explica en la explicación del valor del parámetro filters más adelante en esta sección.

    • Si estableces el valor del parámetro en deviceType, los recuentos de vistas y de tiempo de reproducción se agruparán por tipo de dispositivo durante todo el período que abarque el informe. Por lo tanto, con este valor, los datos del informe responderán preguntas como las siguientes:

      • ¿Cuántas veces los videos del canal se vieron en dispositivos móviles entre el 1 de junio de 2015 y el 31 de julio de 2015?
      • ¿Cuántas veces los videos del canal se vieron en las consolas de juegos entre el 1 de junio de 2015 y el 31 de julio de 2015?

      El informe incluirá el total de vistas y recuento de tiempo de reproducción de cada tipo de dispositivo.

    • Establecer el valor del parámetro en day,deviceType significa que los recuentos de vistas y de tiempo de reproducción se calcularán por tipo de dispositivo para cada día durante el período del informe. Por lo tanto, con este valor, los datos del informe responderán preguntas como las siguientes:

      • ¿Cuántas veces los videos del canal se vieron en dispositivos móviles el 1 de junio de 2015?
      • ¿Cuántas veces los videos del canal se miraron en televisores el 14 de julio de 2015?

  • Por último, el parámetro filters permite que el propietario del canal restrinja el informe para incluir solo los datos que coincidan con valores de filtro específicos. El informe admite demasiadas opciones de filtro para explicarlas todas, por lo que estos ejemplos solo representan una fracción de los informes que podría generar.

    • El propietario del canal podría filtrar la solicitud a fin de que muestre los valores solo para el sistema operativo Android. (¿Cuántas vistas hubo en dispositivos móviles Android durante el período del informe)?

    • El propietario del canal podría filtrar la solicitud para mostrar los valores solo de un país en particular. (¿Cuántas veces se vieron los videos en Canadá cada día del período del informe?)

    • El propietario del canal podría filtrar la solicitud para mostrar los valores solo de videos específicos. Sin embargo, el filtro video admite una lista de valores separados por comas, de modo que el informe podría contener datos para muchos videos.

      Además, si el filtro video especifica varios valores, también se puede especificar video como dimensión. Eso significa que el parámetro dimensions también admite los valores deviceType,video y day,deviceType,video.

      • Si el propietario del canal incluye video en la lista de dimensiones, las métricas especifican los valores individuales para cada video. (¿Cuántas veces se vio el video XYZ en una consola de juegos el 1 de junio de 2015)?
      • Si el propietario del canal no incluye video en la lista de dimensiones, las métricas especifican los valores totales que abarcan todos los videos especificados. (¿Cuántas veces se vieron los videos ABC, DEF y XYZ en una consola de juegos el 1 de junio de 2015)?

Cómo recuperar informes

Para recuperar un informe, envía una solicitud GET autorizada al método reports.query de la API y especifica los parámetros que definen el informe que deseas recuperar.

Consulta la documentación de informes de canales e informes de propietarios de contenido para obtener una lista de los informes que admite la API. Cada definición de informe identifica los valores que el informe permite para los parámetros metrics, dimensions y filters.

Prácticas recomendadas

Las aplicaciones que utilizan la API de YouTube Analytics siempre deben seguir estas prácticas:

  • Usa la fila de encabezado de una respuesta para determinar el orden de las columnas del informe. Por ejemplo, no supongas que las vistas serán la primera métrica que se mostrará en una respuesta solo porque es la primera métrica que aparece en la descripción de un informe. En su lugar, usa la fila del encabezado de la respuesta para determinar qué columna contiene esos datos.
  • Usa la API de datos de YouTube para recuperar los metadatos adicionales de los recursos que se identifican en las respuestas de la API de YouTube Analytics. Tal como se indica en las Políticas para desarrolladores de los servicios de la API de YouTube (secciones III.E.4.b a III.E.4.d), los clientes de las API deben borrar o actualizar los metadatos de recursos almacenados de esa API después de 30 días.

Métricas agregadas y elementos borrados

Las respuestas de la API de YouTube Analytics no contienen desgloses de métricas de los elementos borrados. Por ejemplo, si el propietario de un canal borra un video, este ya no aparecerá en la respuesta de la API que muestra las métricas video por video. Sin embargo, los informes que agregan métricas para un conjunto de recursos sí incluyen métricas asociadas con los elementos eliminados.

Por ejemplo, supongamos que el propietario de un canal recupera dos informes. El primer informe enumera el total de reproducciones diarias de todos los videos del canal durante un período de tiempo particular. El segundo informe muestra el total de vistas diarias de cada video durante el mismo período.

En este caso, las cifras del primer informe incluirán las vistas de los videos que se borraron posteriormente, ya que el primer informe contiene datos agregados diarios. Sin embargo, el segundo informe no incluirá las vistas asociadas con los elementos eliminados, ya que el segundo informe muestra las reproducciones video a video. Por lo tanto, si el canal borró videos durante el período que abarca el informe, es posible que el recuento total de vistas diarias del primer informe sea superior a la suma de los recuentos diarios específicos de videos en el segundo informe.

Anonimización de datos

Algunos datos de YouTube Analytics están limitados cuando las métricas no cumplen con un umbral determinado. Esto puede suceder en varios informes. En la práctica, significa que un informe puede no contener todos (o ninguno) de sus datos si:

  1. un video o canal tiene tráfico limitado durante un período específico,

    o

  2. Seleccionó un filtro o una dimensión, como una fuente de tráfico o un país, para los que los valores no cumplen con un límite determinado.

En los casos en que los datos sean limitados, es posible que exista una diferencia entre los totales registrados en distintos informes y la manera en la que se agrupan esos datos.

Por ejemplo, supongamos que el propietario de un canal recupera dos informes. El primer informe enumera el total de vistas de un video específico, y el segundo, la lista de las vistas totales de ese video según el país. Durante el período especificado, supongamos que el video se vio 1, 000 veces, en el que se produjeron 500 vistas en Estados Unidos, 498 en Canadá y dos en Francia.

En este ejemplo, el primer informe indicaría que el video se vio 1,000 veces. El segundo informe solo indica que el video se vio 500 veces en Estados Unidos y 498 veces en Canadá. Por lo tanto, habría una diferencia entre los recuentos totales de vistas en los dos informes. Tenga en cuenta que el segundo informe no contendrá ninguna indicación de que también se produjeron otras dos vistas (o de que estas hubieran ocurrido en Francia).

Los límites reales en los que se limitan los datos no se publican y están sujetos a cambios a discreción de YouTube.

Tipos de datos limitados

Es posible que se limiten los siguientes datos en los informes de YouTube Analytics:

  • Datos demográficos, como la edad y el género.
  • Datos geográficos, incluidas métricas o dimensiones relacionadas con los países o regiones donde se encontraban los espectadores, como sus países o regiones. Sin embargo, ten en cuenta que los informes no aplican límites geográficos a las métricas de ingresos.
  • Métricas relacionadas con fuentes de tráfico específicas, como términos de búsqueda o URL externas que generaron vistas de tus videos. Por ejemplo, los términos de búsqueda y las URL que generan una cantidad muy pequeña de vistas no aparecerán en los informes. Sin embargo, aún verás términos y URL que dirigen a muchos espectadores a tu contenido.

Consulta el Centro de ayuda de YouTube para obtener más información sobre los datos limitados en los informes de YouTube Analytics.

Uso de cuota

Cada solicitud a la API que realices se cuenta como una unidad de la cuota de uso de la API. Puedes ver los límites de cuota en el panel Cuotas de Google API Console.