YouTube Analytics API - Data Model

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

  • Las dimensiones son criterios comunes que se utilizan para recopilar datos, como la fecha en que se produjo una acción o el país donde se encontraban 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 elijas para un informe determinan cómo YouTube calcula los valores de las métricas en ese informe.

  • Las métricas son mediciones individuales relacionadas con la actividad del usuario, el rendimiento del anuncio o los ingresos estimados. Las métricas de actividad del usuario incluyen elementos como los recuentos de vistas y las calificaciones de los videos (Me gusta y No me gusta).

La API de Analytics proporciona parámetros de filtrado y ordenamiento, 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 para grupos de YouTube Analytics, en los que un grupo es una colección personalizada de hasta 500 videos, listas de reproducción, canales o recursos.

Cómo elegir parámetros de informes

Cuando solicitas un informe con el método reports.query de la API, la solicitud a la 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 para el que el informe contendrá datos. En realidad, la respuesta de la API contiene datos hasta el último día especificado para el que todas las métricas de la consulta están disponibles en el momento de la consulta.

  • El parámetro metrics especifica las mediciones que se incluirán en el informe. En los informes de canales, las métricas miden la actividad del usuario e incluyen valores como las vistas y los 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, un informe se podría filtrar para que solo contenga métricas de un país, un video o un grupo de videos determinado.

    Nota: La API te permite especificar varios valores para los filtros de video, lista de reproducción y canal. 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.

Ejemplos de opciones de informes

Por ejemplo, supongamos que el propietario de un canal quiere 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, TVs, etcétera.

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

  • El informe de tipo de dispositivo 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 ellas se muestran en la siguiente lista, y se analiza una tercera en la explicación del valor del parámetro filters más adelante en esta sección.

    • Si se establece 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 abarca el informe. Por lo tanto, con este valor, los datos del informe responderán preguntas como las siguientes:

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

      En realidad, el informe contendrá un recuento total de vistas y de tiempo de reproducción para cada tipo de dispositivo.

    • Si se establece el valor del parámetro en day,deviceType, 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 se miraron los videos del canal en dispositivos móviles el 1 de junio de 2015?
      • ¿Cuántas veces se miraron los videos del canal en TVs el 14 de julio de 2015?

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

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

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

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

      Además, si el filtro de video especifica varios valores, video también se puede especificar como una dimensión. Eso significa que el dimensions parámetro 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 valores individuales para cada video. (¿Cuántas veces se miró 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 valores totales que abarcan todos los videos especificados. (¿Cuántas veces se miraron los videos ABC, DEF y XYZ en una consola de juegos el 1 de junio de 2015?).

Actualidad y latencia de los datos

Si bien la API de YouTube Analytics admite consultas segmentadas, los datos de Analytics subyacentes no son en tiempo real. Por lo general, el procesamiento de datos introduce una latencia de 48 a 72 horas. Por lo tanto, las respuestas de la API no contienen datos de los días más recientes, y el endDate de tu informe solo incluye datos hasta el último día para el que todas las métricas solicitadas se procesan por completo.

Dada la latencia de los datos, es posible que notes discrepancias entre los datos que muestra la API y las métricas en tiempo real visibles en YouTube Studio. Si tu aplicación requiere estadísticas en tiempo real para videos individuales , como los recuentos de vistas, Me gusta o comentarios actuales, usa el método de la API de YouTube Data videos.list en lugar de la API de YouTube Analytics.

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 y de 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 usan 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 de encabezado de la respuesta para determinar qué columna contiene esos datos.
  • Usa la API de YouTube Data para recuperar metadatos adicionales de los recursos identificados en las respuestas de la API de YouTube Analytics. Como se indica en las Políticas para desarrolladores de los Servicios de APIs de YouTube (secciones III.E.4.b a III.E.4.d), los clientes de la 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 para los elementos borrados. Por ejemplo, si el propietario de un canal borra un video, ese video ya no aparecerá en una respuesta de la API que muestre métricas de video por video. Sin embargo, los informes que agregan métricas para un conjunto de recursos sí incluyen métricas asociadas con elementos borrados.

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

En este caso, los números del primer informe incluirán vistas de videos que se borraron más tarde porque el primer informe contiene agregados diarios. Sin embargo, el segundo informe no incluirá vistas asociadas con elementos borrados porque el segundo informe muestra las vistas de video por video. Como resultado, si el canal borró videos durante el período que abarca el informe, es posible que los recuentos totales de vistas diarias que se muestran en el primer informe sean más altos que la suma de los recuentos de vistas diarias específicos de cada video en el segundo informe.

Anonimización de datos

Algunos datos de YouTube Analytics son limitados cuando las métricas no alcanzan un umbral determinado. Esto puede ocurrir en varios informes. En la práctica, significa que un informe podría no contener todos tus datos (o ninguno) si sucede lo siguiente:

  1. Un video o canal tiene tráfico limitado durante un período determinado.

    o

  2. Seleccionaste un filtro o una dimensión, como la fuente de tráfico o el país, para los que los valores no alcanzan un umbral determinado.

En los casos en que los datos son limitados, se puede generar una diferencia entre los totales indicados en diferentes informes, según la forma en que estos agregan datos.

Por ejemplo, supongamos que el propietario de un canal recupera dos informes. El primer informe muestra el total de vistas de un video determinado, y el segundo informe muestra el total de vistas de ese video por país. Durante el período especificado, supongamos que el video se reprodujo 1, 000 veces, con 500 vistas de Estados Unidos, 498 de Canadá y dos de Francia.

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

Los umbrales 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

Los siguientes datos podrían estar limitados en los informes de YouTube Analytics:

  • Datos demográficos, como la edad y el género
  • Datos geográficos, incluidas las métricas o dimensiones relacionadas con los países o las regiones donde se encontraban los usuarios, como sus países o regiones (sin embargo, ten en cuenta que los informes no aplican umbrales 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 URLs externas que generaron vistas de tus videos (por ejemplo, los términos de búsqueda y las URLs que generan una cantidad muy pequeña de vistas no aparecerán en los informes, aunque sí verás los términos y las URLs que dirigen muchos usuarios 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 cuenta como una unidad de tu cuota de uso de la API. Los límites de cuota se pueden ver en el panel Cuotas de la consola de APIs de Google.