En este documento, se definen las dimensiones que admite la API de informes de YouTube. Esta API recupera informes masivos que contienen datos de YouTube Analytics de un canal o propietario de contenido.
Las dimensiones son criterios comunes que se utilizan para recopilar datos, como la fecha en la que se produjo la actividad de los usuarios o el país donde se encuentran 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 dimensiones. Por lo tanto, la combinación de valores de dimensión de cada fila funciona como la clave primaria de esa fila. No es necesario que especifiques las dimensiones ni tienes la opción de especificarlas en el informe.
Dimensiones principales
Si bien la API de informes de YouTube está sujeta a la Política de Baja definida en las Condiciones del Servicio, las dimensiones no principales (y las métricas no principales) no están sujetas a la política. En las definiciones de esta página, cualquier dimensión que sea principal se identifica explícitamente como tal.
En la siguiente lista, se identifican las dimensiones principales de la API. Todas ellas también son dimensiones principales de la API de YouTube Analytics.
Consulta la lista de APIs de YouTube sujetas a la Política de Baja para obtener más información.
Dimensiones
En las siguientes secciones, se definen las dimensiones que se usan en los informes masivos de la API de informes de YouTube. 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 propietarios de contenido y canales administran en YouTube:
- video_id (dimensión principal)
- El ID de un video de YouTube. En la API de datos de YouTube, este es el valor de la propiedad
id
de 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 datos de YouTube, este es el valor de la propiedad
id
de un recursoplaylist
. - channel_id (dimensión principal)
- El ID de un canal de YouTube. En la API de datos de YouTube, este es el valor de la propiedad
id
de 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)
- El ID de un activo administrado en el sistema 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 mediante 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 a 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ísZZ
se utiliza para informar las métricas con 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
(Míchigan) oUS-TX
(Texas). El código de provinciaUS-ZZ
se usa para informar las métricas con las que YouTube no pudo identificar el estado asociado de EE.UU.Nota: Esta dimensión no admite valores ISO 3166-2 que identifican á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 que no sean Estados Unidos.
Períodos
- date (dimensión principal)
- Esta dimensión identifica la fecha asociada con las métricas en cada fila del informe. En los informes masivos, la fecha se refiere 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 puede ser 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 hacia adelante en función del horario de verano representan un período de 23 horas y las fechas en las que se ajustan los relojes representan un período de 25 horas. This is a core dimension and is subject to the Deprecation Policy.
Ubicaciones 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 indican los valores de dimensiones:
Valores 0
Los datos están relacionados con la actividad que ocurrió en la página de reproducción de YouTube del video o en una aplicación oficial de YouTube, como la aplicación de YouTube para Android. 1
Los datos corresponden a la actividad que ocurrió en otro sitio web o aplicación donde el video se incorporó con un elemento <iframe>
o<object>
incorporado.2
Los datos corresponden a la actividad que ocurrió en un canal de usuario de YouTube. 5
Los datos corresponden a métricas que no se pueden clasificar en uno de los otros tipos de ubicación mencionados anteriormente. 7
Los datos están relacionados con las vistas que se produjeron en la página o pantalla principal de YouTube, en el feed de suscripción del usuario o en otra función de navegación de YouTube. 8
Los datos están relacionados con las vistas que se produjeron directamente en la página de resultados de búsqueda de YouTube. 10
Los datos corresponden a las vistas que se produjeron 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 en las vistas que se produjeron en reproductores incorporados, lo que significa que el valor de la dimensión solo se propaga en las filas donde 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 las fechas que comienzan el 1 de abril de 2014.
En la siguiente tabla, se indican los valores de las dimensiones:
Valores live
Los datos de la fila describen la actividad del usuario que se produjo 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 de la fila de datos se asocian con los usuarios que estaban suscritos al canal del video o de la playlist.
Los valores posibles son
subscribed
yunsubscribed
.
Ten en cuenta que el valor de la dimensión es preciso en el momento en que se produce la actividad del usuario. Por ejemplo, supongamos que un usuario no se suscribió a un canal y mira uno de sus videos. Luego, se suscribe a este y mira otro video el mismo día. El informe del canal indica que una vista tiene un valorsubscribed_status
desubscribed
y una vista tiene un valorsubscribed_status
deunsubscribed
.
Fuentes de tráfico
- traffic_source_type
- Esta dimensión identifica el tipo de URL de referencia asociado con las métricas de actividad del usuario. El tipo de URL 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 indican los valores de dimensiones:
Valores 0
Directo o desconocido
Este valor abarca el tráfico directo a una página, además de aquellas para las que se desconoce la URL de referencia. En los informes de consultas, este tipo de fuente de tráfico se identifica comoNO_LINK_OTHER
oUNKNOWN_MOBILE_OR_DIRECT
.1
Publicidad de YouTube
El usuario llegó al video mediante un anuncio. En un informe de fuente de tráfico, si el valor de esta dimensión es1
, la dimensión traffic_source_detail identifica el tipo de anuncio que se 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_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 exploración
El usuario llegó desde una página de YouTube que dirige a videos o canales. En un informe de fuente de tráfico, si el valor de esta dimensión es3
, la dimensión traffic_source_detail identifica el atributo que refirió el tráfico. En los informes de consultas, este tipo de fuente de tráfico se identifica comoSUBSCRIBER
. Los valores posibles son:Valores explore
Niños: explorar learning
Niños: aprendizaje music
Canal de música my-history
Videos que ya miraste my-subscriptions
Mis suscripciones my-uploads
Mis archivos subidos podcasts
Página de destino de podcasts shows
Infantiles: programas watch-later
Ver más tarde what-to-watch
Qué ver 4
Canales de YouTube
Los usuarios provenían de 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 para ese canal. En los informes de consultas, este tipo de fuente de tráfico se identifica comoYT_CHANNEL
.5
Búsqueda de YouTube
Los usuarios provenían de los resultados de la búsqueda de YouTube. En un informe de fuente 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
.7
Videos sugeridos
Los usuarios provenían de una lista de videos relacionados en otra página de reproducción de videos. En un informe de fuente de tráfico, si el valor de esta dimensión es7
, la dimensión traffic_source_detail identifica el ID de video de ese video. En los informes de consultas, este tipo de fuente de tráfico se identifica comoRELATED_VIDEO
oYT_RELATED
.8
Otras funciones de YouTube
Se remitió a los usuarios desde una página de YouTube que no pertenece a ninguno de los otros tipos de fuentes de tráfico de la lista. En un informe de fuente 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-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
Externos
Se recomendó a los usuarios desde un vínculo en otro sitio web. Esta fuente de tráfico incluye referencias de los resultados de la Búsqueda de Google. En un informe de fuente 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
.11
Anotaciones y tarjetas de video
Se recomendó a los usuarios 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
.14
Playlists
Las vistas se produjeron mientras el video se reproducía como parte de una playlist. En los informes de consultas, este tipo de fuente de tráfico se identifica comoPLAYLIST
.
Ten en cuenta que es diferente del tipo de fuente18
, lo que indica que las vistas se originaron en la página que enumera todos los videos de la playlist.17
Notificaciones
Se recomendó a los usuarios desde 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 inbox
push
sdig
Las vistas se originaron de las notificaciones que formaban parte del resumen de suscriptores uploaded_other
Las vistas se originan a partir de notificaciones no push, como las notificaciones por correo electrónico o Recibidos, que se envían a los suscriptores cuando se sube un video. uploaded_push
Las vistas se originaron a partir de notificaciones push enviadas a los suscriptores cuando se subió un video. 18
Páginas de la playlist
Las vistas se originaron de una página en la que se enumeran 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 es diferente del tipo de fuente14
, lo que indica que las vistas se produjeron mientras el video se reproducía como parte de una playlist.19
Programación a partir de contenido reclamado
Las vistas se originaron de videos subidos por usuarios reclamados y que el propietario del contenido utilizó para promocionar el contenido visto. En los informes de consultas, esta fuente de tráfico se identifica comoCAMPAIGN_CARD
. Esta fuente de tráfico solo se admite en los informes de propietarios de contenido.20
Pantalla final del video interactivo
Las vistas se originan en la pantalla final de otro video. En los informes de consultas, este tipo de fuente de tráfico se identifica comoEND_SCREEN
.23
Historias
Se recomendó al usuario deslizando el dedo verticalmente desde el video anterior en la experiencia de visualización de Historias.24
Shorts
Se recomendó al usuario deslizando 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 producto dirigieron a los usuarios a otro canal.26
Páginas de hashtags
Las vistas se originaron de páginas de hashtags de VOD o de Shorts.27
Páginas Sonidos
Las vistas se originaron de las páginas de reorientación de sonido de Shorts.28
Live Redirect
Las vistas se originaron en Live Redirects.30
Video de remix
Las vistas se originaron a partir del vínculo de un video con un remix en el reproductor de Shorts.31
Feed en vivo vertical
Las vistas se originaron del feed en vivo vertical.32
Video relacionado
Las vistas se originaron a partir de un vínculo de un video relacionado en el reproductor de Shorts. - traffic_source_detail
- Esta dimensión proporciona detalles adicionales sobre la fuente de tráfico del valor de la dimensión traffic_source_type de la fila. Este valor de dimensión se propaga en los siguientes valores de 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 hizo referencia al 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 llegó 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 provino 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 llegó al usuario.20
: el valor de la dimensión identifica el video desde el que llegó 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 llegó al usuario.28
: El valor de la dimensión especifica el ID del canal desde el cual se hizo referencia al usuario mediante Live Redirects.30
: el valor de la dimensión especifica el video desde el que llegó 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 indican 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 indican los valores de dimensión válidos:
Valores 1
Otra opción 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 la edad de los usuarios que accedieron a sus cuentas y está asociada con los datos del informe. La API utiliza los siguientes grupos etarios:
AGE_13_17
AGE_18_24
AGE_25_34
AGE_35_44
AGE_45_54
AGE_55_64
AGE_65_
- género (dimensión principal)
- Esta dimensión identifica el género de los usuarios que accedieron a sus cuentas y está asociado con los datos del informe.
Los valores válidos son
FEMALE
,MALE
yGENDER_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 indican los valores de dimensión válidos:
Valores 0
Desconocido 1
Gobernación de 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
Origen 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
Otra opción 55
Copiar en el portapapeles 59
Embed 60
Mensaje de texto 61
Mensajería de Android 62
Mensajes de Verizon 63
Mensaje de texto de HTC 64
Sony Conversations 65
Usar SMS 66
Correo electrónico de LGE 67
Line 68
Viber 69
Kik 70
Skype 71
Mensajero de BlackBerry 72
WeChat 73
Historia de KAKAO 74
Dropbox 75
Telegram 76
Páginas de Facebook 77
GroupMe 78
Correo electrónico de Android 79
Mensajería de Motorola 80
Compartir con Nearby 81
Naver 82
Diálogo de actividad del sistema de iOS 83
Recibidos de Google 84
Android Messenger 85
YouTube Music 86
YouTube Gaming 87
YouTube Kids 88
YouTube TV
Para obtener más información, consulta los documentos de ayuda.
Anotaciones
- annotation_type
- Esta dimensión identifica la forma en que se muestra la anotación durante el video. En la siguiente tabla, se indican los posibles valores de dimensión:
Valores 0
Desconocido 1
Nota 3
Destacado 4
Título 8
Globo de diálogo 9
Etiqueta 10
Marca de agua para el desarrollo de la marca 11
Video destacado 12
Playlist destacada 30
Llamado a la acción - annotation_id
- ID que YouTube utiliza para identificar de forma exclusiva 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 indican los posibles valores de dimensión:
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 - card_id
- Es el ID que usa YouTube para identificar una tarjeta de forma exclusiva.
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 indican los tipos de elementos de pantalla final y sus valores:
Valores 501
Video: El elemento promociona otro video de YouTube. 502
Playlist: El elemento promueve una playlist de YouTube. 503
Sitio web: El elemento se vincula a tu sitio web asociado. 504
Canal: El elemento se vincula a otro canal. 505
Suscripción: El elemento incentiva las suscripciones a tu canal. 506
Asociado 507
Financiación colectiva: El elemento se vincula a un sitio web aprobado de financiación colectiva. 508
Artículos promocionales: El elemento se vincula a un sitio web de artículos promocionales aprobado. 509
Carga reciente: El elemento vincula al video que subiste más recientemente. 510
La mejor opción para el usuario - end_screen_element_id
- El ID que YouTube utiliza para identificar de forma exclusiva un elemento de pantalla final.
Subtítulos
- subtitle_language
- Esta dimensión identifica el idioma de los subtítulos que se usa por más tiempo durante la vista. No se cuentan las vistas en las que los subtítulos se desactivaron casi por completo. Consulta la documentación sobre los informes de canales o los informes de propietarios de 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ó por más tiempo durante la vista. No se cuentan las vistas en las que los subtítulos se desactivaron casi por completo. Consulta la documentación sobre los informes de canales o los informes de propietarios de 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 recopila las métricas solicitadas según los tipos de anuncios que se publicaron durante las reproducciones de video. En la siguiente tabla, se indican los posibles valores de dimensión. Consulta el Centro de ayuda de YouTube para obtener más información sobre los formatos publicitarios de YouTube.
Valor Descripción Valor en los informes de consultas 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 se muestren los informes de consultas para algunos tipos de anuncios adicionales que se usaron anteriormente en YouTube.
Dimensiones de propietario de contenido
Las siguientes dimensiones solo se usan en los informes de propietarios de contenido.
- reclamado_status (solo se usa en los informes de propietarios de 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_type
proporciona más detalles acerca de cómo usar esta dimensión.
- tipo de persona que subió el video (dimensión principal) (solo se utiliza en los informes de propietarios de contenido)
- Esta dimensión indica si una fila de datos contiene métricas para contenido subido por el propietario de contenido especificado o para contenido subido por terceros, como videos subidos por usuarios. Los valores válidos son
self
ythirdParty
. 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_status
yuploader_type
:
Valor claimed_status
Valor uploader_type
Descripción [No configurado] yo La fila contiene datos de YouTube Analytics del contenido reclamado y no reclamado que subió el propietario del contenido. reclamados yo La fila contiene datos del contenido reclamado que subió el propietario del contenido. reclamados thirdParty La fila contiene datos de contenido reclamado que subió un tercero.