Qué son las dimensiones de
GA4, cuáles usar, sus nombres en la API, los límites por propiedad y cómo crear una dimensión personalizada paso a paso.

En esta página
En resumen
Una dimensión de Google Analytics es un atributo de texto que describe tus datos, como el país de un visitante, el dispositivo que usó o la página en la que empezó su sesión. Las dimensiones dan contexto a métricas como las sesiones o las conversiones. Empieza por las dimensiones integradas y crea una dimensión personalizada solo cuando esa lista no pueda responder a tu pregunta, dentro de los límites de tu propiedad (50 de ámbito evento y 25 de ámbito usuario en una propiedad estándar).
¿Quiere ir más lejos? Pregunte a
Quiz rápido
¿Qué forma de medir tu marketing te conviene?
Sorank encaja con tus respuestas
Pruébalo 3 días en tu propia web y descubre dónde estás en Google, ChatGPT y las demás IA.
Prueba gratis de 3 días3 días gratis y luego lo dejas cuando quieras. Garantía de resultados de 90 días, sujeta a condiciones.
Cada número de un informe de GA4 tiene una etiqueta. El número es una métrica. La etiqueta es una dimensión. «412 sesiones» es una métrica. «412 sesiones desde Alemania en móvil» añade dos dimensiones, el país y la categoría de dispositivo, que indican qué visitantes generaron ese número.
La referencia de la Ayuda de Analytics de Google hace la misma distinción. Las dimensiones son atributos descriptivos, en forma de texto o categorías. Las métricas son cantidades. Los promedios, las tasas y los porcentajes cuentan como métricas, aunque se calculen a partir de otras métricas. Puedes sumar sesiones entre filas. No puedes sumar países. Los agrupas.
Por eso la misma métrica puede significar cosas distintas. Una tasa de interacción del 60% en una página de destino se lee de forma muy diferente si sabes que los visitantes llegaron desde tu newsletter y no desde una campaña de pago. La dimensión te dice quién llegó. La métrica te dice cuántos de ellos hicieron algo.
Si GA4 te resulta nuevo, lee primero nuestra entrada del glosario sobre GA4 y vuelve después aquí. Esta guía supone que los datos ya llegan a una propiedad de GA4.
¿Dimensión o métrica?
Las guías antiguas hablan de «dimensión personalizada, índice 1» y de ámbitos a nivel de hit. Ese mundo ha terminado. Google dejó de procesar nuevos hits en las propiedades estándar de Universal Analytics el 1 de julio de 2023. Las propiedades 360 con un contrato vigente tuvieron tiempo de procesamiento adicional hasta el 1 de julio de 2024. Si tu equipo todavía habla en números de índice, cambia ese hábito. En GA4 das un nombre a cada dimensión personalizada y la vinculas a un parámetro que tu sitio o tu aplicación envía.
Fechas de fin de Universal Analytics
Fuente: Ayuda de Google Analytics, «Google Analytics 4 ha reemplazado a Universal Analytics»
La página de ayuda de Google sobre dimensiones y métricas agrupa las dimensiones integradas en 16 categorías: Atribución, Demografía, Comercio electrónico, Evento, Juegos, General, Geografía, Enlace, Página / pantalla, Plataforma / dispositivo, Editor, Tiempo, Origen del tráfico, Usuario, Duración de vida del usuario y Vídeo. La misma página enumera también 11 categorías de métricas, como Sesión, Ingresos y Publicidad. Mantén las dos listas separadas al buscar, porque una categoría de métricas no te ayudará a filtrar por país.

No necesitas memorizar la lista. Necesitas saber qué categoría contiene la respuesta a tu pregunta. Cuatro categorías cubren la mayor parte del trabajo en un sitio de contenido:
Después vienen las dimensiones de Evento y de Usuario. Las dimensiones de Evento describen una acción, como un clic en un botón o la reproducción de un vídeo. Las dimensiones de Usuario describen al visitante a lo largo de sus sesiones, como el origen que lo trajo por primera vez a tu sitio. Saber esta división te dice si una pregunta pertenece a una sesión, a un evento o a un usuario. Mezclar estos niveles es una de las causas más habituales de que un informe parezca incorrecto, y volvemos a ello en la sección de errores.

Cada dimensión tiene dos nombres. El nombre de la interfaz es el que ves en un informe. El nombre de API es el que envías a la API de datos de Google Analytics, y lo necesitas para exportaciones, scripts y paneles. Google documenta los nombres de API en su esquema de la API de datos. La tabla siguiente recoge las dimensiones que usan la mayoría de los sitios de contenido.
| Nombre en la interfaz | Nombre de API | Pregunta que responde |
|---|---|---|
| Origen de la sesión | sessionSource | Qué sitio o plataforma inició la sesión |
| Medio de la sesión | sessionMedium | Qué tipo de tráfico fue, como organic, referral o cpc |
| Grupo de canales predeterminado de la sesión | sessionDefaultChannelGroup | A qué grupo de canales pertenece la sesión |
| Página de destino | landingPage | La primera página de la sesión |
| Ruta de la página | pagePath | La parte de la ruta de cada página que abrió el visitante |
| País | country | De dónde procedía la actividad del usuario |
| Categoría de dispositivo | deviceCategory | Escritorio, tableta o móvil |
| Nombre del evento | eventName | Qué evento se registró |
| Fecha | date | La fecha del evento, en formato AAAAMMDD |

Tres reglas ayudan al pasar de la interfaz a la API. Primero, los nombres de API distinguen mayúsculas y minúsculas: sessionSource no es SessionSource. Segundo, cada dimensión adicional divide cada fila en más filas, lo que hace el resultado más difícil de leer, así que empieza con dos o tres. Tercero, una solicitud que nombra una dimensión que tu propiedad no conoce falla. Este último punto es el más importante en las dimensiones personalizadas.
Las dimensiones personalizadas siguen otro patrón. El esquema de Google las referencia por ámbito y nombre de parámetro. Una dimensión de ámbito evento se escribe customEvent: seguido del nombre del parámetro. Una dimensión de ámbito usuario se escribe customUser: seguido de su nombre de parámetro. El ejemplo siguiente pide el origen de la sesión y una dimensión personalizada de ámbito evento llamada author_name, de los últimos 28 días. Sustituye los nombres por los tuyos.
{
"dimensions": [
{ "name": "sessionSource" },
{ "name": "customEvent:author_name" }
],
"metrics": [{ "name": "sessions" }],
"dateRanges": [{ "startDate": "28daysAgo", "endDate": "yesterday" }]
}
Esta solicitud solo funciona si tu propiedad ha registrado author_name como dimensión personalizada de ámbito evento. Si no, la solicitud falla. Regístrala primero y luego consulta.
Nota
Las dimensiones registradas antes de octubre de 2020 usan una forma más larga que incluye el nombre del evento entre corchetes, como customEvent:parameter_name[event_name]. Si una consulta que funcionaba el año pasado falla ahora, comprueba si la dimensión es una de estas heredadas.
Una dimensión principal es aquella por la que se agrupa un informe. Cada fila es un valor de esa dimensión. Una dimensión secundaria añade un segundo desglose dentro de cada fila. La idea es sencilla, pero aquí es donde más gente se atasca, porque los mismos datos responden a una pregunta distinta según cuál dimensión vaya primero.
| Pregunta | Dimensión principal | Dimensión secundaria | Qué aprendes |
|---|---|---|---|
| ¿Qué páginas reciben visitas orgánicas? | Página de destino | Origen / medio de la sesión | Si la búsqueda es la fuente principal de cada página, o si la página depende de otros canales |
| ¿Los visitantes de un mercado usan sobre todo el móvil? | País | Categoría de dispositivo | La proporción de móvil en cada país, que indica dónde probar primero los diseños |
| ¿Qué campañas llegan a qué páginas? | Campaña de la sesión | Página de destino | Campañas que llevan a páginas que no coinciden con su oferta |
| ¿Qué navegadores usan los visitantes de un país? | Navegador | País | Problemas de compatibilidad que solo aparecen en un mercado |
En una tabla de Exploraciones puedes apilar más de dos dimensiones, pero la legibilidad cae rápido. Mantente en dos o tres por vista y pasa el resto a filtros. Un filtro quita filas, y una dimensión las divide. Usa los filtros para acotar la pregunta y las dimensiones para explicar la respuesta.
Toma la primera fila de la tabla anterior. Si la página de destino es la dimensión principal y el origen de la sesión la secundaria, cada fila es una página con su tráfico desglosado por origen. Invierte el orden, y cada fila es un origen con sus páginas debajo. Las cifras son idénticas. La pregunta es otra. Decide cuál necesitas antes de abrir el informe, y anótala en una frase.
Las dimensiones estándar cubren la mayoría de los informes. Necesitas una dimensión personalizada cuando la información vive en tu propio sistema, o en un parámetro que envías tú. Los casos típicos son el nombre del autor en un blog, el tipo de plan en una aplicación SaaS, una categoría de contenido o si el visitante había iniciado sesión. Antes de crear nada, hazte una pregunta: ¿puede responderla la lista integrada? Si la respuesta es sí, para ahí.
El ámbito determina qué describe la dimensión personalizada. Una dimensión de ámbito evento se asocia a un único evento, como un clic o una vista de página que lleva un parámetro. Una dimensión de ámbito usuario se asocia a un visitante y mantiene el mismo valor en todas sus sesiones, como un nivel de plan. Una dimensión de ámbito elemento se asocia a un único elemento dentro de un evento de comercio electrónico, como el color de un producto.
| Ámbito | Se asocia a | Uso típico | Propiedad estándar | Propiedad 360 |
|---|---|---|---|---|
| Evento | Un evento | Autor del artículo leído | 50 | 125 |
| Usuario | Un visitante | Nivel de plan, estado de inicio de sesión | 25 | 100 |
| Elemento | Un elemento de un evento de comercio electrónico | Marca o color del producto | 10 | 25 |
Límites de dimensiones personalizadas en una propiedad estándar
Fuente: Ayuda de Google Analytics, resumen de dimensiones y métricas personalizadas
Los límites se aplican por propiedad y cuentan cada dimensión registrada. La página Definiciones personalizadas de Administración muestra tu uso. Abre el enlace Información de cuota, arriba a la derecha, para ver cuántas plazas te quedan. Mantén esa página abierta cada vez que planees un cambio de medición.
Si alcanzas el límite, liberar una plaza no es inmediato. La página de ayuda de Google sobre los límites de dimensiones personalizadas indica que hay que esperar 48 horas tras eliminar dimensiones antes de poder añadir nuevas. Planifica tus nombres antes de empezar, y no crees una dimensión para una prueba puntual que vas a eliminar la semana siguiente.

Advertencia
Nunca envíes datos personales como valor de una dimensión. Los nombres, las direcciones de correo y los números de teléfono son información personal identificable, y las normas de Google prohíben enviarlos a Analytics. El nombre de un autor no supone problema. La dirección de correo de un cliente sí, aunque esté cifrada en tu código.
Estos pasos suponen que tu sitio o tu aplicación ya envía el parámetro. Si no llegan datos, la dimensión se crea pero no muestra nada. Sigue la lista en orden.
Crear una dimensión personalizada en cinco pasos
Fuente: Ayuda de Google Analytics, «[GA4] Acerca de las dimensiones y métricas personalizadas»
Abre DebugView y dispara el evento en tu sitio o en tu aplicación. Mira el evento y sus parámetros. Confirma que el valor es el que esperas, por ejemplo «Jane Doe» para un autor y no «undefined». Solo entonces crea la dimensión. Un parámetro que envía un valor incorrecto llenará tus informes de datos erróneos desde ese día, y los días anteriores no se pueden corregir.
El nombre del parámetro en la interfaz debe coincidir con el que envía tu código. Una letra de diferencia, una mayúscula o un espacio crean una dimensión que nunca se llena. Copia el nombre desde tu código en lugar de escribirlo de memoria. Usa minúsculas y guiones bajos, como en author_name, porque pegarás la misma cadena en las solicitudes de API más adelante.
Nota
La página de ayuda de Google sobre las dimensiones personalizadas de GA4 indica que los informes empiezan entre 24 y 48 horas después de crear una dimensión. No crees una dimensión la tarde del lanzamiento de una campaña esperando datos ese mismo día. Créala unos días antes y comprueba después.
Una vez que existen las dimensiones, puedes leerlas en cuatro sitios. Cada uno sirve para un trabajo distinto. Elegir la herramienta equivocada te cuesta tiempo, así que compáralas antes de construir nada.
| Método | Ideal para | Límite principal | Ejemplo |
|---|---|---|---|
| Informes estándar | Revisiones rápidas de tráfico, páginas y eventos | Diseños fijos con una dimensión principal y una secundaria | Adquisición de tráfico por origen de la sesión |
| Exploraciones | Tablas personalizadas, embudos y análisis de recorridos | Requiere configuración, y las tablas grandes se ralentizan | Página de destino por origen de la sesión y categoría de dispositivo |
| API de datos | Exportaciones, scripts y tus propios paneles | Requiere código, y cada dimensión debe estar registrada | Exportación semanal de sesiones por página a una hoja de cálculo |
| Looker Studio | Informes compartidos con clientes o responsables | Depende del conector y de su frecuencia de actualización | Panel mensual para clientes con el tráfico por canal |
Los informes estándar responden la primera pregunta que tienes cada mañana. Úsalos para detectar una caída y luego pasa a una herramienta más flexible para encontrar la causa. Su ventaja es la velocidad. Su debilidad es que no puedes elegir cualquier pareja de dimensiones, así que una pregunta que necesita tres dimensiones no cabe en un informe estándar.
Las Exploraciones te permiten crear una tabla con las dimensiones y métricas que elijas, y guardarla para más tarde. Es la herramienta para analizar páginas de destino, para comparar canales dentro de un mismo país y para comprobar que una dimensión personalizada se llena de verdad. Limita cada exploración a una pregunta. Una tabla que responde cinco preguntas suele no responder ninguna con claridad.
Consejo
Las dimensiones limpias empiezan con enlaces de campaña limpios. Los valores de origen y medio vienen de tus parámetros UTM, así que una diferencia de escritura como «Newsletter» y «newsletter» crea una segunda fila para el mismo canal. Crea tus enlaces con nuestro generador gratuito de enlaces UTM para mantener los nombres coherentes.
Usa la API cuando un informe se ejecuta cada semana, cuando alimentas un panel o cuando quieres comparar la salida de dos propiedades en un script. El patrón de solicitud que has visto antes en esta guía es la pieza básica. Cuando funcione en una prueba, pon el mismo JSON en tu script y mantén los nombres de las dimensiones en un solo lugar, para que un cambio de nombre no rompa diez consultas a la vez.
Looker Studio es la opción habitual cuando otra persona necesita leer los números. Se conecta a GA4 y presenta las dimensiones en gráficos y tablas. Sus límites vienen del conector y de su frecuencia de actualización, no de GA4 en sí. Si construyes un panel para un cliente, nuestra guía de Looker Studio para SEO cubre las fórmulas y los límites que importan para los datos de búsqueda, y nuestra guía de un panel de GA4 explica qué poner en la primera pantalla.
Los asistentes de IA envían visitantes que llegan por un enlace, y ese enlace lleva un origen de referencia. Lo ves en la dimensión origen de la sesión y en la página de destino. Algunas aplicaciones de IA no transmiten ningún referente, así que este método capta solo una parte del panorama. Nuestra entrada del glosario sobre tráfico oscuro de IA explica qué falta y por qué. Para la búsqueda orgánica en el mismo informe, nuestra guía de Google Analytics para SEO muestra cómo separarla del resto.
Aislar las visitas de IA en cuatro pasos
Lee el resultado con cuidado. Un aumento de sesiones de IA en una página indica que la página se usa, pero no dice si los visitantes compraron algo. Añade una métrica de conversión a la tabla antes de decidir que una página funciona. El artículo sobre medir las citas de IA con Google Analytics repasa la parte de conversiones.
Consejo
Si quieres el tráfico de Google y el de IA en una sola pantalla sin construir tú la exploración, el panel GEO / SEO de Sorank muestra ambos. Combina los datos de Google Search Console (clics, impresiones, CTR, posición) con las vistas de página que envían los asistentes de IA, tal como se registran en Google Analytics.
La mayoría de los problemas con las dimensiones aparecen como una columna vacía, como una columna de valores «(not set)» o como un informe que parece correcto pero responde a la pregunta equivocada. La tabla te indica la señal que debes buscar. Las secciones siguientes explican cada error.
| Error | Cómo detectarlo | Corrección |
|---|---|---|
| Crear una dimensión antes de que lleguen los datos | Cada fila muestra «(not set)» | Confirma el valor en DebugView y luego crea la dimensión |
| Nombre distinto entre el código y la interfaz | Sin datos 48 horas después | Copia el nombre del parámetro desde el código |
| Duplicar una dimensión integrada | Dos dimensiones dan las mismas filas | Revisa primero la lista estándar y luego elimina la copia |
| Valores de alta cardinalidad | Miles de filas, cada una con una sola sesión | Envía categorías y guarda los identificadores únicos en tu propio sistema |
| Datos personales en un valor | Valores que parecen correos o nombres completos | Elimina el parámetro y envía una categoría en su lugar |
| Esperar historial | Las fechas antiguas están vacías, las nuevas llenas | Compara solo desde la fecha de creación y anota el hueco |
El error: creas la dimensión y luego descubres que el parámetro nunca llegó a GA4. Se nota porque cada fila del informe muestra «(not set)». La corrección es invertir el orden. Confirma el valor en DebugView, registra la dimensión y espera las 24 a 48 horas que indica Google antes de juzgar el informe.
El error: el código envía author_name, pero la interfaz tiene Author_name o author name. La dimensión existe y se queda vacía. La señal: una definición personalizada correcta sin datos tras dos días. La corrección: abre el código, copia la cadena exacta y compruébala de nuevo en DebugView. Corregirla después no recupera los días perdidos, así que arréglala el día en que la encuentres.
El error: creas una dimensión personalizada llamada Country porque no revisaste la lista estándar. Lo ves en dos filas con los mismos valores. El coste es la cuota. Cada duplicado usa una de tus 50 plazas de ámbito evento, o una de tus 25 plazas de ámbito usuario, y esas plazas son las que necesitarás después para cosas que GA4 no puede darte. Revisa primero la lista estándar en los informes y luego decide.
El error: envías una dimensión con un valor único para cada visitante o cada pedido, como un ID de usuario, una URL completa con cadena de consulta o un número de pedido. Google aconseja evitar las dimensiones de alta cardinalidad en las propiedades estándar. La señal: una tabla con miles de filas, cada una con una sola sesión. La corrección es enviar una categoría en su lugar. Envía el tipo de plan, no el ID de usuario. Envía el tipo de contenido, no la URL completa. Guarda el identificador único en tu CRM, donde puedas cruzarlo con los datos tú mismo.
El error: una dimensión contiene una dirección de correo, un nombre o un teléfono, a menudo porque alguien usó una variable cómoda. La señal: un valor que parece una persona. La corrección es quitar el parámetro y enviar una categoría o un código interno anónimo. Consulta con tu responsable de protección de datos si tienes dudas. Cifrar una dirección de correo no la hace segura para enviarla.
El error: creas una dimensión en mayo y esperas que explique las sesiones de enero. Los informes solo muestran valores recogidos después de que la dimensión empezara a recibirlos. La señal: una columna vacía en las fechas anteriores. La corrección: indica la fecha de inicio en el título del informe y compara solo desde esa fecha. No presentes un gráfico de antes y después que empiece en medio de un hueco.
Una dimensión es un atributo de texto, como el país, el dispositivo o la ruta de página. Una métrica es un número, como las sesiones, los usuarios activos o las conversiones. Las dimensiones agrupan y etiquetan los números, así que la misma métrica se lee de forma distinta según las dimensiones con las que la combines.
Una propiedad estándar permite 50 dimensiones personalizadas de ámbito evento, 25 de ámbito usuario y 10 de ámbito elemento. Una propiedad 360 permite 125, 100 y 25. La página Definiciones personalizadas de Administración muestra cuántas has usado. Eliminar una no libera su plaza de inmediato, porque hay que esperar 48 horas antes de añadir otra.
Normalmente el parámetro no llega a GA4, o su nombre no coincide exactamente. Revisa DebugView, corrige el nombre en la interfaz o en tu código y espera de 24 a 48 horas desde la creación. Si los datos siguen sin aparecer, lo más probable es que el parámetro no se esté enviando.
Tu lista para esta semana
Empieza por una pregunta que hoy no puedes responder. Crea una dimensión para ella, comprueba los datos y solo entonces añade la siguiente.
Una dimensión es un atributo de texto, como el país, el dispositivo o la ruta de página. Una métrica es un número, como las sesiones, los usuarios activos o las conversiones. Las dimensiones agrupan y etiquetan los números.
Una propiedad estándar permite 50 dimensiones de ámbito evento, 25 de ámbito usuario y 10 de ámbito elemento. Una propiedad 360 permite 125, 100 y 25. La página Definiciones personalizadas de Administración muestra tu uso.
Normalmente el parámetro no llega a GA4, o su nombre no coincide exactamente. Revisa DebugView, corrige el nombre y espera de 24 a 48 horas desde la creación antes de juzgar el informe.
