En este documento, se definen las dimensiones que admite la API de YouTube Reporting. Esta API recupera informes masivos que contienen datos de YouTube Analytics de un canal o propietario del contenido.
Las dimensiones son criterios comunes que se utilizan para recopilar datos, como la fecha en que se produjo la actividad del usuario o el país donde se encontraban los usuarios.
Cada informe masivo admite una lista predefinida de dimensiones y, en cualquier 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 principal de esa fila. No es necesario que especifiques ni tienes la opción de especificar qué dimensiones se incluyen en el informe.
Dimensiones principales
Si bien la API de YouTube Reporting está sujeta a la Política de Baja definida en las Condiciones del Servicio, las dimensiones y métricas no principales no están sujetas a la política. En las definiciones de esta página, cualquier dimensión que sea una dimensión principal se identifica de forma explícita como tal.
En la siguiente lista, se identifican las dimensiones principales de la API. Todas ellas también son dimensiones principales en la API de YouTube Analytics.
Para obtener más información, consulta la lista de las APIs de YouTube sujetas a la Política de Baja.
Dimensiones
En las siguientes secciones, se definen las dimensiones que se usan en los informes masivos de la API de YouTube Reporting. A menos que se indique lo contrario, estas dimensiones se usan en los informes de canal y de propietario del contenido.
Recursos
Estas dimensiones corresponden a los recursos que los canales y los propietarios del contenido administran en YouTube:
- video_id (dimensión principal)
- Es el ID de un video de YouTube. En la API de YouTube Data, este es el valor de la propiedad
idde un recursovideo. This is a core dimension and is subject to the Deprecation Policy. - playlist_id
- El ID de una playlist de YouTube. En la API de YouTube Data, este es el valor de la propiedad
idde un recursoplaylist. - channel_id (dimensión principal)
- Es el ID de un canal de YouTube. En la API de YouTube Data, este es el valor de la propiedad
idde un recursochannel. This is a core dimension and is subject to the Deprecation Policy. - asset_id (solo se usa en los informes de propietarios de contenido)
- Es el ID de un activo administrado en el sistema de Content ID de YouTube. Un activo es la representación de tu propiedad intelectual en ese sistema. En el sitio web de YouTube, puedes encontrar los IDs de activos en el Administrador de contenido de YouTube. También puedes recuperarlos con la API de Content ID de YouTube.
Áreas geográficas
Estas dimensiones identifican una región geográfica asociada con la actividad del usuario, el rendimiento de los anuncios o las métricas de ingresos estimados.
- country_code (dimensión principal)
- Es el país asociado con las métricas de la fila del informe. El valor de la dimensión es un código de país ISO-3166-1 de dos letras, como
US,CN(China) oFR(Francia). El código de paísZZse usa para informar métricas para las que YouTube no pudo identificar el país asociado. This is a core dimension and is subject to the Deprecation Policy. - province_code
- Es el estado o territorio de EE.UU. asociado con las métricas de la fila del informe. El valor de la dimensión es un código ISO 3166-2 que identifica un estado de EE.UU. o el Distrito de Columbia, como
US-MI(Michigan) oUS-TX(Texas). El código de provinciaUS-ZZse usa para informar métricas para las que YouTube no pudo identificar el estado de EE.UU. asociado.Nota: Esta dimensión no admite valores ISO 3166-2 que identifiquen áreas periféricas de EE.UU., ya que esos territorios también tienen sus propios códigos de país ISO 3166-1. Tampoco admite subdivisiones de países distintos de Estados Unidos.
Períodos
- date (dimensión principal)
- Esta dimensión identifica la fecha asociada con las métricas de cada fila del informe. En los informes masivos, la fecha hace referencia al período que comienza a las 12:00 a.m. (hora del Pacífico) y finaliza a las 11:59 p.m. (hora del Pacífico) del día, mes y año especificados. Según la época del año, la hora del Pacífico es UTC-7 o UTC-8.
Ten en cuenta que, si bien las fechas suelen representar un período de 24 horas, las fechas en las que los relojes se ajustan para el horario de verano representan un período de 23 horas, y las fechas en las que los relojes se ajustan hacia atrás representan un período de 25 horas. This is a core dimension and is subject to the Deprecation Policy.
Sitios de reproducción
Estas dimensiones proporcionan estadísticas sobre la página o la aplicación en la que se produjo la actividad del usuario.
- playback_location_type
-
Esta dimensión identifica el tipo de página o aplicación en la que se produjo la actividad del usuario. En la siguiente tabla, se enumeran los valores de dimensión:
Valores 0Los datos se relacionan con la actividad que se produjo en la página de reproducción de YouTube del video o en una aplicación oficial de YouTube, como la app de YouTube para Android. 1Los datos se relacionan con la actividad que se produjo en otro sitio web o aplicación en el que se incorporó el video con una incorporación <iframe>o<object>.2Los datos se relacionan con la actividad que se produjo en la página de un canal de YouTube. 5Los datos se refieren a métricas que no se pueden clasificar en uno de los otros tipos de ubicación enumerados. 7Los datos se refieren a las vistas que se generaron en la página principal o pantalla principal de YouTube, en el feed de suscripciones del usuario o en otra función de navegación de YouTube. 8Los datos se refieren a las vistas que se generaron directamente en la página de resultados de la búsqueda de YouTube. 10Los datos se refieren a las vistas que se generaron en el feed de YouTube Shorts. - playback_location_detail
- Esta dimensión especifica la URL o la aplicación en la que se produjo la reproducción. Esta dimensión solo se admite para las vistas que se produjeron en reproductores incorporados, lo que significa que el valor de la dimensión solo se propaga en las filas en las que el valor de la dimensión es
1. En otras filas, el valor de esta dimensión está vacío.
Detalles de la reproducción
- live_or_on_demand
- Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con las vistas de una transmisión en vivo. Los datos de esta dimensión están disponibles para fechas a partir del 1 de abril de 2014.
En la siguiente tabla, se indican los valores de la dimensión:
Valores liveLos datos de la fila describen la actividad del usuario que ocurrió durante una transmisión en vivo. onDemandLos datos de la fila describen la actividad del usuario que no ocurrió durante una transmisión en vivo. - subscribed_status
- Esta dimensión indica si las métricas de actividad del usuario en la fila de datos están asociadas con usuarios que se suscribieron al canal del video o de la playlist.
Los valores posibles son
subscribedyunsubscribed.
Ten en cuenta que el valor de la dimensión es preciso a partir del momento en que se produce la actividad del usuario. Por ejemplo, supongamos que un usuario no se ha suscrito a un canal y mira uno de sus videos, luego se suscribe al canal y mira otro video, todo el mismo día. El informe del canal indica que una vista tiene un valor desubscribed_statusdesubscribedy otra tiene un valor desubscribed_statusdeunsubscribed.
Fuentes de tráfico
- traffic_source_type
- Esta dimensión identifica el tipo de referencia asociado con las métricas de actividad del usuario. El tipo de referencia describe la forma en que los usuarios llegaron al video o canal asociado con la fila de datos del informe. En la siguiente tabla, se enumeran los valores de dimensión:
Valores 0Directa o desconocida
Este valor abarca el tráfico directo a una página, así como las páginas para las que se desconoce el referente. En los informes de consultas, este tipo de fuente de tráfico se identifica comoNO_LINK_OTHERoUNKNOWN_MOBILE_OR_DIRECT.1Publicidad de YouTube
Un anuncio derivó al usuario al video. En un informe de fuentes de tráfico, si el valor de esta dimensión es1, la dimensión traffic_source_detail identifica el tipo de anuncio que se le mostró al usuario. En los informes de consultas, este tipo de fuente de tráfico se identifica comoADVERTISING. Los valores posibles son:Valores ctp_engagement_adAnuncio de participación de clic para reproducir engagement_adAnuncio de interacción googlemediaadsAnuncios de la Red de Búsqueda de Google insearch_displayTrueView en resultados de búsqueda y en display instreamTrueView in-stream instream-selectAnuncios in-stream que se pueden omitir reservados unknownPublicidad en YouTube sin categoría video_wallMuro de videos yvaAnuncios de video en la página principal 3Funciones de navegación
El usuario llegó desde una página de YouTube que dirige a videos o canales. En un informe de fuentes de tráfico, si el valor de esta dimensión es3, la dimensión traffic_source_detail identifica la función que derivó el tráfico. En los informes de consultas, este tipo de fuente de tráfico se identifica comoSUBSCRIBER. Los valores posibles son:Valores exploreNiños: Explorar learningNiños: aprendizaje musicCanal de música my-historyHistorial de reproducciones my-subscriptionsMis suscripciones my-uploadsMis archivos subidos podcastsPágina de destino de podcasts showsNiños: programas watch-laterVer más tarde what-to-watchQué ver 4Canales de YouTube
Los usuarios fueron referidos desde un canal de usuario de YouTube. En un informe de fuente de tráfico, si el valor de esta dimensión es4, la dimensión traffic_source_detail especifica el ID del canal. En los informes de consultas, este tipo de fuente de tráfico se identifica comoYT_CHANNEL.5Búsqueda de YouTube
Los usuarios llegaron a tu contenido desde los resultados de la búsqueda de YouTube. En un informe de fuentes de tráfico, si el valor de esta dimensión es5, la dimensión traffic_source_detail especifica el término de búsqueda asociado. En los informes de consultas, este tipo de fuente de tráfico se identifica comoYT_SEARCH.7Videos sugeridos
Los usuarios llegaron desde una ficha de video relacionada en otra página de reproducción de video. En un informe de fuentes de tráfico, si el valor de esta dimensión es7, la dimensión traffic_source_detail identifica el ID de video correspondiente. En los informes de consultas, este tipo de fuente de tráfico se identifica comoRELATED_VIDEOoYT_RELATED.8Otras funciones de YouTube
Los usuarios llegaron desde una página de YouTube que no pertenece a ninguno de los otros tipos de fuentes de tráfico enumerados. En un informe de fuentes de tráfico, si el valor de esta dimensión es8, la dimensión traffic_source_detail identifica la URL de la página. En los informes de consultas, este tipo de fuente de tráfico se identifica comoYT_OTHER_PAGE. Los valores posibles son:Valores g-crecCanales recomendados offlineSin conexión promotionPromoción de socios unknownDesconocido widgetWidget para pantalla principal de Android youtu.beyoutu.be ytremoteControl remoto de YouTube 9Externo
Los usuarios llegaron a través de un vínculo en otro sitio web. Esta fuente de tráfico incluye las referencias de los resultados de la Búsqueda de Google. En un informe de fuentes de tráfico, si el valor de esta dimensión es9, la dimensión traffic_source_detail identifica la página web externa. En los informes de consultas, este tipo de fuente de tráfico se identifica comoEXT_URL.11Anotaciones y tarjetas de video
Los usuarios llegaron al video haciendo clic en una anotación o tarjeta de otro video. En los informes de consultas, este tipo de fuente de tráfico se identifica comoANNOTATION.14Playlists
Las vistas se produjeron mientras el video se estaba reproduciendo como parte de una playlist. En los informes de consultas, este tipo de fuente de tráfico se identifica comoPLAYLIST.
Ten en cuenta que esta fuente de tráfico difiere del tipo de fuente18, que indica que las vistas se originaron en la página que enumera todos los videos de la playlist.17Notificaciones
Los usuarios llegaron a tu canal a través de un correo electrónico o una notificación de YouTube. En los informes de consultas, este tipo de fuente de tráfico se identifica comoNOTIFICATION. Los valores posibles son:Valores inboxpushsdigVistas que se originaron a partir de notificaciones que formaban parte del resumen para suscriptores uploaded_otherVistas que se originaron a partir de notificaciones que no son push, como las notificaciones por correo electrónico o de Recibidos, que se enviaron a los suscriptores cuando se subió un video uploaded_pushVistas que se originaron a partir de notificaciones push que se enviaron a los suscriptores cuando se subió un video 18Páginas de playlists
Son las vistas que se originan en una página que muestra una lista de todos los videos de una playlist. En los informes de consultas, este tipo de fuente de tráfico se identifica comoYT_PLAYLIST_PAGE.
Ten en cuenta que esta fuente de tráfico difiere del tipo de fuente14, que indica que las vistas se produjeron mientras se reproducía el video como parte de una playlist.19Programación de contenido reclamado
Son las vistas que se originan de videos subidos por usuarios y reclamados que el propietario del contenido usó para promocionar el contenido que se vio. En los informes de consultas, esta fuente de tráfico se identifica comoCAMPAIGN_CARD. Esta fuente de tráfico solo es compatible con los informes de propietarios del contenido.20Pantalla final interactiva del video
Vistas que se originaron en la pantalla final de otro video. En los informes de consultas, este tipo de fuente de tráfico se identifica comoEND_SCREEN.23Historias
El usuario llegó a la página de destino deslizando el dedo verticalmente desde el video anterior en la experiencia de reproducción de Historias.24Shorts
El usuario llegó al video después de deslizar el dedo verticalmente desde el video anterior en la experiencia de visualización de Shorts.25Páginas de productos
Los videos de una página de productos llevaron a los usuarios a otro canal.26Páginas de hashtags
Son las vistas que se originan en las páginas de redireccionamiento de hashtags de VOD o de Shorts.27Páginas de sonido
Son las vistas que se originaron en las páginas de redireccionamiento de audio de Shorts.28Redireccionamiento en vivo
Son las vistas que se originaron a partir de redireccionamientos en vivo.29Podcasts
Son las vistas que se originaron en la página Podcasts de YouTube.30Video de remix
Son vistas que se originaron a partir de un vínculo a un video de remix en el reproductor de Shorts.31Feed vertical de vivos
Son las vistas que se originaron en el feed vertical de vivos.32Video relacionado
Son vistas que se originaron a partir de un vínculo a un video relacionado en el reproductor de Shorts. - traffic_source_detail
- Esta dimensión proporciona detalles adicionales sobre la fuente de tráfico que indica el valor de la dimensión traffic_source_type de la fila. Este valor de dimensión se propaga para los siguientes valores de la dimensión traffic_source_type:
1: El valor de la dimensión identifica el tipo de anuncio que se mostró al usuario. Consulta la definición de traffic_source_type para obtener una lista de valores posibles.3: El valor de la dimensión identifica la función de YouTube que generó el tráfico referido. Consulta la definición de traffic_source_type para obtener una lista de valores posibles.4: El valor de la dimensión especifica el ID del canal desde el que se derivó el usuario.5: El valor de la dimensión especifica el término de búsqueda que generó el tráfico referido.7: El valor de la dimensión identifica el video desde el que se derivó al usuario.8: El valor de la dimensión identifica el tipo de página de YouTube que generó el tráfico referido. Consulta la definición de traffic_source_type para obtener una lista de valores posibles.9: El valor de la dimensión identifica la página externa desde la que se derivó el tráfico.17: El valor de la dimensión identifica el tipo de notificación que generó el tráfico referido. Consulta la definición de traffic_source_type para obtener una lista de valores posibles.19: El valor de la dimensión identifica el video desde el que se derivó al usuario.20: El valor de la dimensión identifica el video desde el que se derivó al usuario.25: El valor de la dimensión identifica el ID del producto, que es un ID del Gráfico de conocimiento de Google.26: El valor de la dimensión identifica el hashtag que generó el tráfico referido.27: El valor de la dimensión identifica el video desde el que se derivó al usuario.28: El valor de la dimensión especifica el ID del canal desde el que se redireccionó al usuario a través de los redireccionamientos en vivo.30: El valor de la dimensión especifica el video desde el que se derivó al usuario.
Dispositivos
- device_type
- Esta dimensión identifica el factor de forma físico del dispositivo en el que se produjo la vista.
En la siguiente tabla, se enumeran los valores de dimensión válidos:
Valores 100Desconocido 101Computadora 102TV 103Consola de juegos 104Teléfono celular 105Tablet - operating_system
- Esta dimensión identifica el sistema de software del dispositivo en el que se produjo la vista.
En la siguiente tabla, se enumeran los valores de dimensión válidos:
Valores 1Otro 2Windows 3Windows Mobile 4Android 5iOS 6Symbian 7Blackberry 9Macintosh 10PlayStation 11Bada 12WebOS 13Linux 14Hiptop 15MeeGo 16Wii 17Xbox 18PlayStation Vita 19Smart TV 20Nintendo 3DS 21Chromecast 22Tizen 23Firefox 24RealMedia 25KaiOS 26Roku 27Nintendo Switch 28Apple tvOS 29Fire OS 30ChromeOS 31Vidaa
Datos demográficos
Las dimensiones demográficas te ayudan a comprender el rango de edad y la distribución por género de tu público. El Centro de ayuda de YouTube contiene información adicional sobre los datos demográficos en los informes de YouTube Analytics.
- age_group (dimensión principal)
- Esta dimensión identifica el grupo etario de los usuarios que accedieron a sus cuentas y que están asociados con los datos del informe. La API usa los siguientes grupos etarios:
AGE_13_17AGE_18_24AGE_25_34AGE_35_44AGE_45_54AGE_55_64AGE_65_
- género (dimensión principal)
- Esta dimensión identifica el género de los usuarios que accedieron a sus cuentas y que están asociados con los datos del informe.
Los valores válidos son
FEMALE,MALEyGENDER_OTHER. This is a core dimension and is subject to the Deprecation Policy.
Participación y uso compartido de contenido
- sharing_service (dimensión principal)
- Esta dimensión identifica el servicio que se usó para compartir videos. Los videos se pueden compartir en YouTube (o con el reproductor de YouTube) con el botón "Compartir". This is a core dimension and is subject to the Deprecation Policy.
En la siguiente tabla, se enumeran los valores de dimensión válidos:
Valores 0Desconocido 1Digg 4reddit 5StumbleUpon 6mixi 7Yahoo! Japón 8Goo 9Ameba 10Facebook 11Myspace 12NUjij 18Tuenti 20menéame 21Wykop 22Skyrock 25Fotka 28hi5 31Twitter 32Cyworld 34Blogger 36VKontakte (ВКонтакте) 37Rakuten (楽天市場) 38LiveJournal 39Odnoklassniki (Одноклассники) 40tumblr. 42LinkedIn 43Google+ 44Weibo 45Pinterest 46Correo electrónico 47Facebook Messenger 49WhatsApp 50Hangouts 51Gmail 52Kakao (Kakao Talk) 53Otro 55Copiar en el portapapeles 59Incorporar 60Mensaje de texto 61Mensajería de Android 62Mensajes de Verizon 63Mensaje de texto de HTC 64Conversaciones de Sony 65Go SMS 66Correo electrónico de LGE 67Línea 68Viber 69Kik 70Skype 71Blackberry Messenger 72WeChat 73KAKAO Story 74Dropbox 75Telegram 76Páginas de Facebook 77GroupMe 78Correo electrónico de Android 79Mensajes de Motorola 80Compartir con Nearby 81Naver 82Diálogo de actividad del sistema de iOS 83Recibidos de Google 84Mensajes de Android 85YouTube Music 86YouTube Gaming 87YouTube Kids 88YouTube TV
Consulta los documentos de ayuda para obtener más información.
Anotaciones
- annotation_type
- Esta dimensión identifica la forma en que se muestra la anotación durante el video. En la siguiente tabla, se enumeran los valores de dimensión posibles:
En el Centro de ayuda de YouTube, encontrarás más detalles sobre los diferentes tipos de anotaciones y el proceso para agregarlas a tus videos.Valores 0Desconocido 1Nota 3Destacado 4Título 8Globo de diálogo 9Etiqueta 10Marca de agua para desarrollo de la marca 11Video destacado 12Playlist destacada 30Llamado a la acción - annotation_id
- Es el ID que YouTube usa para identificar de forma inequívoca una anotación.
Tarjetas
- card_type
- Esta dimensión identifica el tipo de tarjeta que se le mostró al usuario. En la siguiente tabla, se enumeran los valores de dimensión posibles:
En el Centro de ayuda de YouTube, encontrarás más detalles sobre los diferentes tipos de tarjetas y el proceso para agregarlas a tus videos.Valores 0Desconocido 60Vínculo 61Recaudación de fondos 62Video 63Playlist 65Financiación de fans 66Artículos promocionales 68Sitio web asociado 69Canal - card_id
- Es el ID que YouTube usa para identificar de forma única una tarjeta.
Pantallas finales
- end_screen_element_type
- Esta dimensión identifica el tipo de elemento de pantalla final que se le mostró al usuario. En la siguiente tabla, se enumeran los tipos de elementos de la pantalla final y sus valores:
Valores 501Video: El elemento promociona otro video de YouTube. 502Playlist: El elemento promociona una playlist de YouTube. 503Sitio web: El elemento vincula a tu sitio web asociado. 504Canal: El elemento se vincula a otro canal. 505Suscribirse: El elemento alienta a los usuarios a suscribirse a tu canal. 506Asociado 507Financiación colectiva: El elemento incluye un vínculo a un sitio web de financiación colectiva aprobado. 508Artículos promocionales: El elemento incluye un vínculo a un sitio web de artículos promocionales aprobado. 509Carga reciente: El elemento incluye un vínculo al video más reciente que subiste a tu canal. 510La mejor opción para el usuario - end_screen_element_id
- Es el ID que YouTube usa para identificar de forma única un elemento de la pantalla final.
Subtítulos
- subtitle_language
- Esta dimensión identifica el idioma de los subtítulos que se usó durante más tiempo durante la vista. No se registran las vistas en las que los subtítulos estuvieron desactivados la mayor parte del tiempo. Consulta la documentación de los informes de canales o los informes de propietarios del contenido para obtener más información sobre los informes que contienen esta dimensión.
- subtitle_language_autotranslated
- Esta dimensión identifica el idioma de los subtítulos traducidos automáticamente que se usó durante más tiempo durante la vista. No se registran las vistas en las que los subtítulos estuvieron desactivados la mayor parte del tiempo. Consulta la documentación de los informes de canales o los informes de propietarios del contenido para obtener más información sobre los informes que contienen esta dimensión.
Rendimiento del anuncio
- ad_type
- La dimensión
ad_typese usa en los informes de rendimiento de los anuncios y agrega las métricas solicitadas en función de los tipos de anuncios que se publicaron durante las reproducciones de video. En la siguiente tabla, se enumeran los valores posibles de la dimensión. Consulta el Centro de ayuda de YouTube para obtener más información sobre los formatos de publicidad de YouTube.
Valor Descripción Valor en los informes de búsquedas 1Anuncios de video que se pueden omitir (subasta) auctionTrueviewInstream2Anuncios gráficos (subasta) auctionDisplay3Anuncios de video que no se pueden omitir (subasta) auctionInstream5Anuncios gráficos (reservados) reservedDisplay6Anuncios de video que no se pueden omitir (reservados) reservedInstream13Desconocido unknown15Anuncios de video que se pueden omitir (reservados) reservedInstreamSelect19Bumpers publicitarios (subasta) auctionBumperInstream20Anuncios bumper (reservados) reservedBumperInstreamNota: Es posible que los informes de consultas muestren datos de algunos tipos de anuncios adicionales que se usaban anteriormente en YouTube.
Dimensiones de propietario de contenido
Las siguientes dimensiones solo se usan en los informes de propietarios del contenido.
- claimed_status (solo se usa en los informes de propietarios del contenido)
- Esta dimensión indica que una fila de datos solo contiene métricas para el contenido reclamado. El único valor válido para esta dimensión es
claimed. La tabla en la definición de la dimensiónuploader_typeproporciona más detalles sobre cómo usarla.
- uploader_type (dimensión principal) (solo se usa en los informes de propietarios del contenido)
- Esta dimensión indica si una fila de datos contiene métricas del contenido que subió el propietario especificado o el contenido que subieron terceros, como los videos subidos por los usuarios. Los valores válidos son
selfythirdParty. Esta es una dimensión principal y está sujeta a la política de baja.
En la siguiente tabla, se muestran las combinaciones admitidas para las dimensionesclaimed_statusyuploader_type:
Valor claimed_statusValor uploader_typeDescripción [No configurado] self La fila contiene datos de YouTube Analytics para el contenido reclamado y no reclamado que subió el propietario del contenido. reclamados self La fila contiene datos del contenido reclamado que subió el propietario. reclamados thirdParty La fila contiene datos del contenido reclamado que subió un tercero.