Dimensions

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 id de un recurso video. 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 id de un recurso playlist.
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 id de un recurso channel. 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) o FR (Francia). El código de país ZZ se 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) o US-TX (Texas). El código de provincia US-ZZ se 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 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
0 Los 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.
1 Los 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>.
2 Los datos se relacionan con la actividad que se produjo en la página de un canal de YouTube.
5 Los datos se refieren a métricas que no se pueden clasificar en uno de los otros tipos de ubicación enumerados.
7 Los 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.
8 Los datos se refieren a las vistas que se generaron directamente en la página de resultados de la búsqueda de YouTube.
10 Los 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
live Los datos de la fila describen la actividad del usuario que ocurrió durante una transmisión en vivo.
onDemand Los 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 subscribed y unsubscribed.

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 subscribed_status de subscribed y otra tiene un valor subscribed_status de unsubscribed.

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
0 Directa 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 como NO_LINK_OTHER o UNKNOWN_MOBILE_OR_DIRECT.
1 Publicidad de YouTube
Un anuncio derivó al usuario al video. En un informe de fuentes de tráfico, si el valor de esta dimensión es 1, 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 como ADVERTISING. Los valores posibles son:
Valores
ctp_engagement_ad Anuncio de participación de clic para reproducir
engagement_ad Anuncio de interacción
googlemediaads Anuncios de la Red de Búsqueda de Google
insearch_display TrueView en resultados de búsqueda y en display
instream TrueView in-stream
instream-select In-stream que se puede omitir reservado
unknown Publicidad en YouTube sin categoría
video_wall Muro de videos
yva Anuncios de video en la página principal
3 Funciones 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 es 3, 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 como SUBSCRIBER. Los valores posibles son:
Valores
explore Niños: Explorar
learning Niños: aprendizaje
music Canal de música
my-history Historial de reproducciones
my-subscriptions Mis suscripciones
my-uploads Mis archivos subidos
podcasts Página de destino de podcasts
shows Niños: programas
watch-later Ver más tarde
what-to-watch Qué ver
4 Canales de YouTube
Los usuarios llegaron desde un canal de usuario de YouTube. En un informe de fuente de tráfico, si el valor de esta dimensión es 4, 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 como YT_CHANNEL.
5 Bú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 es 5, 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 como YT_SEARCH.
7 Videos 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 es 7, 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 como RELATED_VIDEO o YT_RELATED.
8 Otras 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 es 8, 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 como YT_OTHER_PAGE. Los valores posibles son:
Valores
g-crec Canales recomendados
offline Sin conexión
promotion Promoción de socios
unknown Desconocido
widget Widget para pantalla principal de Android
youtu.be youtu.be
ytremote Control remoto de YouTube
9 Externo
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 es 9, 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 como EXT_URL.
11 Anotaciones 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 como ANNOTATION.
14 Playlists
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 como PLAYLIST.

Ten en cuenta que esta fuente de tráfico difiere del tipo de fuente 18, que indica que las vistas se originaron en la página que enumera todos los videos de la playlist.
17 Notificaciones
Los usuarios llegaron 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 como NOTIFICATION. Los valores posibles son:
Valores
inbox
push
sdig Vistas que se originaron a partir de notificaciones que formaban parte del resumen para suscriptores
uploaded_other Vistas 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_push Vistas que se originaron a partir de notificaciones push que se enviaron a los suscriptores cuando se subió un video
18 Páginas de playlists
Son las vistas que se originan en una página que muestra todos los videos de una playlist. En los informes de consultas, este tipo de fuente de tráfico se identifica como YT_PLAYLIST_PAGE.

Ten en cuenta que esta fuente de tráfico difiere del tipo de fuente 14, que indica que las vistas se produjeron mientras se reproducía el video como parte de una playlist.
19 Programació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 como CAMPAIGN_CARD. Esta fuente de tráfico solo es compatible con los informes de propietarios de contenido.
20 Pantalla 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 como END_SCREEN.
23 Historias
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.
24 Shorts
El usuario llegó al video después de deslizar el dedo verticalmente desde el video anterior en la experiencia de visualización de Shorts.
25 Páginas de productos
Los videos de una página de productos llevaron a los usuarios a otro canal.
26 Páginas de hashtag
Son las vistas que se originan en las páginas de redireccionamiento de hashtags de VOD o de Shorts.
27 Páginas de sonido
Son las vistas que se originaron en las páginas de redireccionamiento de audio de Shorts.
28 Redireccionamiento en vivo
Son las vistas que se originaron a partir de redireccionamientos en vivo.
30 Video de remix
Son vistas que se originaron a partir de un vínculo a un video de remix en el reproductor de Shorts.
31 Feed vertical de vivos
Son las vistas que se originaron en el feed vertical de vivos.
32 Video 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ó el 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
100 Desconocido
101 Computadora
102 TV
103 Consola de juegos
104 Teléfono celular
105 Tablet
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
1 Otro
2 Windows
3 Windows Mobile
4 Android
5 iOS
6 Symbian
7 Blackberry
9 Macintosh
10 PlayStation
11 Bada
12 WebOS
13 Linux
14 Hiptop
15 MeeGo
16 Wii
17 Xbox
18 PlayStation Vita
19 Smart TV
20 Nintendo 3DS
21 Chromecast
22 Tizen
23 Firefox
24 RealMedia
25 KaiOS
26 Roku
27 Nintendo Switch
28 Apple tvOS
29 Fire OS
30 ChromeOS
31 Vidaa

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_17
  • AGE_18_24
  • AGE_25_34
  • AGE_35_44
  • AGE_45_54
  • AGE_55_64
  • AGE_65_
This is a core dimension and is subject to the Deprecation Policy.
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, MALE y GENDER_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
0 Desconocido
1 Digg
4 reddit
5 StumbleUpon
6 mixi
7 Yahoo! Japón
8 Goo
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti
20 menéame
21 Wykop
22 Skyrock
25 Fotka
28 hi5
31 Twitter
32 Cyworld
34 Blogger
36 VKontakte (ВКонтакте)
37 Rakuten (楽天市場)
38 LiveJournal
39 Odnoklassniki (Одноклассники)
40 tumblr.
42 LinkedIn
43 Google+
44 Weibo
45 Pinterest
46 Correo electrónico
47 Facebook Messenger
49 WhatsApp
50 Hangouts
51 Gmail
52 Kakao (Kakao Talk)
53 Otro
55 Copiar en el portapapeles
59 Incorporar
60 Mensaje de texto
61 Mensajería de Android
62 Mensajes de Verizon
63 Mensaje de texto de HTC
64 Conversaciones de Sony
65 Go SMS
66 Correo electrónico de LGE
67 Línea
68 Viber
69 Kik
70 Skype
71 Blackberry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 Páginas de Facebook
77 GroupMe
78 Correo electrónico de Android
79 Mensajes de Motorola
80 Compartir con Nearby
81 Naver
82 Diálogo de actividad del sistema de iOS
83 Recibidos de Google
84 Mensajes de Android
85 YouTube Music
86 YouTube Gaming
87 YouTube Kids
88 YouTube 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:
Valores
0 Desconocido
1 Nota
3 Destacado
4 Título
8 Globo de diálogo
9 Etiqueta
10 Marca de agua para desarrollo de la marca
11 Video destacado
12 Playlist destacada
30 Llamado a la acción
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.
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:
Valores
0 Desconocido
60 Vínculo
61 Recaudación de fondos
62 Video
63 Playlist
65 Financiación de fans
66 Artículos promocionales
68 Sitio web asociado
69 Canal
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.
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
501 Video: El elemento promociona otro video de YouTube.
502 Playlist: El elemento promociona una playlist de YouTube.
503 Sitio web: El elemento vincula a tu sitio web asociado.
504 Canal: El elemento se vincula a otro canal.
505 Suscribirse: El elemento alienta a los usuarios a suscribirse a tu canal.
506 Asociado
507 Financiación colectiva: El elemento incluye un vínculo a un sitio web de financiación colectiva aprobado.
508 Artículos promocionales: El elemento incluye un vínculo a un sitio web de artículos promocionales aprobado.
509 Carga reciente: El elemento dirige a los usuarios al video más reciente que subiste a tu canal.
510 La 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 estaban desactivados. 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 estaban desactivados. 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_type se 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
1 Anuncios de video que se pueden omitir (subasta) auctionTrueviewInstream
2 Anuncios gráficos (subasta) auctionDisplay
3 Anuncios de video que no se pueden omitir (subasta) auctionInstream
5 Anuncios gráficos (reservados) reservedDisplay
6 Anuncios de video que no se pueden omitir (reservados) reservedInstream
13 Desconocido unknown
15 Anuncios de video que se pueden omitir (reservados) reservedInstreamSelect
19 Bumpers publicitarios (subasta) auctionBumperInstream
20 Anuncios bumper (reservados) reservedBumperInstream

Nota: Es posible que los informes de consultas muestren 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ón uploader_type proporciona 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 para el contenido que subió el propietario del contenido especificado o el contenido que subieron terceros, como los videos subidos por los usuarios. Los valores válidos son self y thirdParty. Esta es una dimensión principal y está sujeta a la Política de baja.

En la siguiente tabla, se muestran las combinaciones compatibles para las dimensiones claimed_status y uploader_type:

Valor claimed_status Valor uploader_type Descripció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.