La API de YouTube Analytics te permite generar informes personalizados que contienen datos de YouTube Analytics. La API admite informes para canales y propietarios del 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 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 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 datos 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, donde 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
startDateyendDateespecifican el período para el que el informe contendrá datos. 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
metricsespecifica 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
dimensionsexplica cómo se agruparán las métricas.El parámetro
filtersexplica 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 las 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 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
startDateen2015-06-01y el parámetroendDateen2015-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
metricsenviews,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 analiza en la explicación del valor del parámetrofiltersmá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 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?
El informe contendrá un recuento total de vistas y tiempo de reproducción para cada tipo de dispositivo.
Si estableces 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 televisores el 14 de julio de 2015?
Por último, el parámetro
filterspermite que el propietario del canal restrinja el informe para que solo incluya los 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 se devuelvan solo los 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 se devuelvan 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 que se muestren solo los valores de 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, video también se puede especificar como una dimensión. Esto significa que el parámetro
dimensionstambién admite los valoresdeviceType,videoyday,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 los 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 de los datos y latencia
Si bien la API de YouTube Analytics admite consultas segmentadas, los datos de estadísticas subyacentes no se muestran en tiempo real. El procesamiento de datos suele generar 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 en el que se procesaron por completo todas las métricas solicitadas.
Debido a la latencia de los datos, es posible que notes discrepancias entre los datos que devuelve
la API y las métricas en tiempo real que se muestran en YouTube Studio. Si tu
aplicación requiere estadísticas en tiempo real para videos individuales, como los recuentos actuales de vistas,
Me gusta o comentarios, usa el método videos.list de la API de YouTube Data en lugar de la API de YouTube
Analytics.
Recupera 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 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 views será la primera métrica que se devuelva 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 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 devuelva métricas de cada video. Sin embargo, los informes que agregan métricas para un conjunto de recursos aún incluyen métricas asociadas con los elementos borrados.
Por ejemplo, supongamos que el propietario de un canal recupera dos informes. En el primer informe, se muestra el total de vistas diarias de todos los videos del canal durante un período determinado. En el segundo informe, se muestran las vistas diarias totales por video durante el mismo período.
En este caso, las cifras del primer informe incluirán las vistas de los videos que se borraron más tarde, ya que el primer informe contiene agregados diarios. Sin embargo, el segundo informe no incluirá las vistas asociadas con los elementos borrados, ya que este informe enumera las vistas de cada video. Como resultado, si el canal borró videos durante el período que abarca el informe, los recuentos de vistas diarios totales informados en el primer informe podrían ser 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 determinado. Esto puede suceder en varios informes. En la práctica, esto significa que un informe podría no contener todos tus datos (o ninguno) en los siguientes casos:
un video o canal tiene tráfico limitado durante un período específico
o
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. En el primer informe, se indican las vistas totales de un video en particular, y en el segundo, se indican 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 produjeron otras dos vistas (o de que se produjeron vistas en Francia).
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 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.
- Son las métricas relacionadas con fuentes de tráfico específicas, como los términos de búsqueda o las URLs externas que generaron vistas en 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 a 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 realizas 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 Google Cloud.