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 propietarios de contenido. Los campos de los 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 en el que se encontraban los usuarios.

  En un informe, cada fila de datos tiene una combinación única de valores de dimensiones. Por lo tanto, las dimensiones que elijas para un informe determinarán 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 de los anuncios o los ingresos estimados. Las métricas de actividad del usuario incluyen aspectos como los recuentos de vistas de videos y las calificaciones (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 de los grupos de YouTube Analytics, en los que un grupo es una colección personalizada de hasta 500 videos, playlists, canales o activos.

Cómo elegir los parámetros del informe

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 y, además, 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, se podría filtrar un informe para que solo contenga métricas de un país, un video o un grupo de videos determinados.

  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 devueltas también se agrupen por video, playlist o canal.

Opciones de informes de muestra

Por ejemplo, supongamos que el propietario de un canal quiere recuperar un informe sobre los tipos de dispositivos 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.

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

  • Si configuras el valor del parámetro como deviceType, los recuentos de vistas y de tiempo de reproducción se agruparán por tipo de dispositivo para 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 y el 31 de julio de 2015?
    • ¿Cuántas veces se vieron los videos del canal en consolas de juegos entre el 1 de junio y el 31 de julio de 2015?

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

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

    • ¿Cuántas veces se vieron los videos del canal en dispositivos móviles el 1 de junio de 2015?
    • ¿Cuántas veces se miraron los videos del canal en televisores 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 particulares. 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 devolver valores solo para el 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 devolver valores solo para un país en particular. (¿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 devolver valores solo para videos espec��ficos. Sin embargo, el filtro 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 video especifica varios valores, también se puede especificar video como dimensión. Esto 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 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?)

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 los informes de canales y los informes de propietarios del 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 deben siempre 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 devolverá en una respuesta solo porque es la primera métrica que se menciona 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 las 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, este ya no aparecerá en una respuesta de la API que muestre métricas de cada video. Sin embargo, los informes que agregan métricas para un conjunto de recursos sí incluyen las métricas asociadas con los elementos borrados.

Por ejemplo, supongamos que el propietario de un canal recupera dos informes. El primer informe muestra las vistas diarias totales de todos los videos del canal durante un período determinado. 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 agregados diarios. Sin embargo, el segundo informe no incluirá las vistas asociadas con los elementos borrados, ya que las enumera video por video. Como resultado, si el canal borró videos durante el período que abarca el informe, es posible que los recuentos de vistas diarios totales que se informan en el primer informe sean más altos que la suma de los recuentos de vistas diarios específicos de cada video en el segundo informe.

Anonimización de datos

Algunos datos de YouTube Analytics se limitan cuando las métricas no alcanzan un umbral específico. Esto puede ocurrir en varios informes. En la práctica, significa que un informe podría no contener todos tus datos (o ninguno) en los siguientes casos:

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

   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 específico.

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 las vistas totales de un video en particular, y el segundo muestra las vistas totales 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 vio 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ía ninguna indicación de que también se habían generado otras dos vistas (o de que se habían generado 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

Es posible que los siguientes datos se limiten 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 en los que 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 se contabilizará 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.