Cómo definir propiedades de usuario de GA4 y usarlas en informes

¿Qué son las propiedades de usuario de GA4?

Google Analytics 4 usa las propiedades de usuario de GA4 para describir a la persona que hay detrás de los eventos, como un nivel de plan, un idioma preferido o un rol, y aplica cada valor a todos los eventos posteriores de ese usuario. La página de ayuda de Google las define como "attributes that describe groups of your user base", con las preferencias de idioma y las ubicaciones geográficas como ejemplos. Úsalas para datos que se mantienen a lo largo de muchos eventos y deja los detalles de cada acción en los parámetros de evento.

Una propiedad de usuario solo aparece en los informes después de que la registras como dimensión personalizada con alcance de usuario. Google lo dice sin rodeos: "To report on the data you collect through user properties, create user-scoped custom dimensions." Su página de ayuda sobre dimensiones personalizadas añade que "User properties become aliases for user-scoped custom dimension slots", así que trabajas con nombres con significado como customer_tier en vez de huecos numerados.

GA4 también rellena por su cuenta un conjunto de dimensiones de usuario, como Country, Language y Device category. Esas dimensiones predefinidas cubren los casos habituales. Las propiedades de usuario personalizadas son para datos que solo conoce tu sitio, como si un visitante está en un plan gratuito o de pago.

¿En qué se diferencian las propiedades de usuario de los parámetros de evento?

Las propiedades de usuario describen al usuario y se trasladan a los eventos futuros, mientras que los parámetros de evento describen un evento y se quedan ahí. La página de Google sobre dimensiones personalizadas traza la línea en dos frases: los parámetros de evento "provide more details about these actions, like which link was clicked", y "User properties tell you more about the users themselves."

El límite de 36 caracteres por valor significa etiquetas de categoría cortas, no texto libre. Si todavía estás decidiendo qué datos merecen un hueco, empieza por las decisiones que deberían informar, como explica la guía de implementación de analítica personalizada.

¿Cómo defines propiedades de usuario con gtag?

Defines propiedades de usuario con la etiqueta de Google llamando al comando set con un objeto user_properties, que aplica los valores a todos los eventos de la página. La página de ayuda de Google da este ejemplo:

gtag('set', 'user_properties', {
  favorite_composer: 'Mahler',
  favorite_instrument: 'double bass',
  season_ticketholder: 'true'
});

Para limitar los valores a un flujo de datos, Google muestra el mismo objeto dentro de un comando config: gtag('config', 'STREAM_ID', { 'user_properties': { ... } }). Ejecuta la llamada en cuanto tu página conozca el valor, por ejemplo justo después del inicio de sesión.

La página de ayuda de Google enumera otras dos formas de definirlas:

1. Google Tag Manager. En una etiqueta Google Analytics 4 Event, "add a row in the User Properties section for each parameter you want to include."
2. Firebase para apps móviles. Después de instalar el SDK de Google Analytics for Firebase, sigue la documentación "Set user properties" de Firebase.

El código de servidor puede enviar propiedades de usuario por el Measurement Protocol en un objeto user_properties, donde cada propiedad tiene un campo value. La guía para desarrolladores de Google indica que puedes enviar propiedades de usuario sin ningún evento, y que "Google Analytics uses the most recent value of a user property for each user."

¿Cómo ves una propiedad de usuario de GA4 en los informes?

Ves una propiedad de usuario de GA4 en los informes creando una dimensión personalizada con alcance de usuario en Admin, dentro de Data display, Custom definitions, con el rol Editor o superior en la propiedad. El procedimiento de Google:

1. En Admin, dentro de Data display, haz clic en Custom definitions.
2. Abre la pestaña Custom dimensions y haz clic en Create custom dimensions.
3. Escribe un nombre para la dimensión. No se permiten guiones, pero sí guiones bajos y espacios.
4. Pon Scope en User. Google dice que el alcance no se puede cambiar después de guardar.
5. Escribe el nombre de la propiedad de usuario exactamente como lo envía tu código. Este campo también queda fijo una vez guardado.
6. Haz clic en Save.

Las páginas de Google no coinciden en el orden. La página sobre recogida de datos de usuario dice que crees la dimensión "Before you set user properties", mientras que la página sobre cómo crear la dimensión dice que primero añadas la propiedad a tu código y la confirmes en la tarjeta "Users by User property" del informe Realtime. Google dice que la dimensión llega a los informes entre 24 y 48 horas después, así que regístrala el mismo día en que publiques la propiedad. Una vez creada, puedes usarla en comparaciones, filtros, exploraciones y condiciones de audiencia.

¿Qué límites se aplican a las propiedades de usuario de GA4?

Una propiedad estándar de GA4 acepta 25 propiedades de usuario y una propiedad de Google Analytics 360 acepta 100, con nombres de hasta 24 caracteres y valores de hasta 36 caracteres. La página de límites de recogida de Google dice que Analytics "doesn't process the 26th user property" en una propiedad estándar.

Los nombres siguen tres reglas más de la guía para desarrolladores y de las páginas de ayuda de Google:

• Nombres reservados. No se pueden usar first_open_time, first_visit_time, last_deep_link_referrer, user_id ni first_open_after_install.
• Prefijos reservados. Los nombres no pueden empezar por google_, ga_ ni firebase_.
• Distinción entre mayúsculas y minúsculas. Google advierte de que "setting two user properties whose names differ only in case results in two distinct user properties being logged."

Una cuarta trampa está en la dimensión personalizada. Google dice que "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text." Un código de nivel como 94E40 se convierte en notación científica, así que pon una letra delante de los códigos.

¿Qué propiedades de usuario recoge GA4 automáticamente?

GA4 recoge automáticamente un conjunto de dimensiones de usuario predefinidas, y Google dice que con gtag.js o el SDK "you don't need to write additional code to collect" esos datos. En sitios web incluyen Age, Gender, Interests, Language, Country, Region, City, Browser, Device category, Device brand, Operating system y Platform. Los flujos de apps añaden App store, App version, Device model y New/Established.

No gastes uno de tus 25 huecos en copiarlas. La página de Google sobre dimensiones personalizadas con alcance de usuario dice: "Don't create a custom user property if a predefined user dimension already exists."

Age, Gender e Interests traen una pega. Google dice que "must meet the Analytics data thresholds to see demographic and interest data", y Google oculta esas filas cuando un grupo es lo bastante pequeño como para identificar a personas. La página sobre los umbrales de datos de GA4 explica cuándo pasa y qué lo reduce.

¿Cuándo empieza a aplicarse una propiedad de usuario de GA4?

Una propiedad de usuario de GA4 se aplica desde el momento en que se define a todos los eventos futuros de ese usuario, incluidas las sesiones posteriores, y nunca a los eventos anteriores. Lo dice Google: "The user property will not apply to events that happened before the user property was set."

Si un visitante lee cinco páginas y solo después recibe customer_tier al registrarse, esas cinco páginas vistas no llevan ningún nivel. Define la propiedad en cada carga de página para un usuario con sesión iniciada.

GA4 también elimina duplicados. Google dice que Analytics recoge una propiedad de usuario cuando se "set for the first time on a page" o cuando cambia su valor, así que repetir la misma llamada set en una página no envía datos extra.

¿Pueden las propiedades de usuario de GA4 contener datos personales?

Las propiedades de usuario de GA4 no deben contener información de identificación personal, porque la política de Google prohíbe enviarla. La página de ayuda de Google dice que sus "policies mandate that no data be passed to Google that Google could use or recognize as personally identifiable information (PII)", y cita como ejemplos "email addresses, personal mobile numbers, and social security numbers". Su lista de funciones que requieren especial cuidado incluye "All custom dimensions", lo que abarca cada propiedad de usuario registrada.

Limita los valores a categorías como pro, trial o admin. Para un identificador de cuenta estable, Google remite a la función User-ID en vez de a una propiedad de usuario, y su página de dimensiones personalizadas advierte contra "a custom dimension for a unique ID per user." Incluso un ID que no nombra a nadie puede contar como dato personal según la ley de privacidad, como explica la guía sobre identificadores de analítica y datos personales.

¿Cómo asocia Flowsery datos a un usuario con sesión iniciada?

Flowsery asocia datos a un usuario con sesión iniciada con una sola llamada identify(), que su documentación del SDK describe como una forma de "Identify the current visitor with user details." El ejemplo documentado pasa un ID de usuario, un email y un nombre: flowsery.identify({ userId: 'user_123', email: 'user@example.com', name: 'John Doe' }). Después, la API de visitantes de Flowsery devuelve el ID, el nombre y el email de ese usuario en un campo de perfil, que es null para los visitantes anónimos. El tráfico anónimo funciona de otra forma. Con la opción "Cookieless", Flowsery funciona con un hash de visitante que rota cada día y no guarda datos personales, así que no vincula a un visitante anónimo entre días ni dispositivos. Los eventos personalizados aceptan metadatos opcionales: la etiqueta de script registra uno con window.flowsery("signup") y el SDK de npm con flowsery.trackEvent('signup'), como parte del seguimiento de objetivos y eventos de Flowsery. Los eventos aparecen en el feed de eventos en tiempo real de Flowsery a medida que se disparan, sin ningún paso de registro entre medias.

Preguntas frecuentes

¿Qué diferencia hay entre una propiedad de usuario y una dimensión personalizada con alcance de usuario?

Una propiedad de usuario es el valor que envía tu código, como customer_tier. Una dimensión personalizada con alcance de usuario es el registro en Admin de GA4 que hace visible esa propiedad en los informes. Necesitas las dos, y Google dice que la dimensión llega a los informes entre 24 y 48 horas después de crearla.

¿Cuántas propiedades de usuario puede tener una propiedad de GA4?

Una propiedad estándar puede tener 25 propiedades de usuario y una propiedad de Google Analytics 360 puede tener 100. Analytics no procesa la propiedad de usuario número 26 en una propiedad estándar. Las dimensiones personalizadas con alcance de usuario siguen los mismos topes de 25 y 100.

¿Las propiedades de usuario de GA4 se aplican a eventos pasados?

No. Google dice que una propiedad de usuario se aplica a todos los eventos futuros de ese usuario, incluidas las sesiones posteriores, pero "will not apply to events that happened before the user property was set." Define la propiedad en cuanto conozcas el valor.

¿Cómo cambio una propiedad de usuario de GA4?

Envía la propiedad otra vez con el nuevo valor. La guía para desarrolladores de Google dice que Analytics "uses the most recent value of a user property for each user", y GA4 vuelve a recoger la propiedad cada vez que cambia su valor. Los eventos anteriores conservan el valor que tenían cuando se enviaron.

¿Puedo usar user_id como nombre de propiedad de usuario?

No. user_id es uno de los cinco nombres reservados, junto con first_open_time, first_visit_time, last_deep_link_referrer y first_open_after_install. Los nombres tampoco pueden empezar por google_, ga_ ni firebase_. Usa la función User-ID para los IDs de cuenta.

¿Dónde compruebo que una propiedad de usuario está llegando?

Abre el informe Realtime y mira la tarjeta "Users by User property". Google dice que la tarjeta "shows the number of people who are grouped into each user property." Confirma ahí la propiedad antes de crear informes con ella.

¿Puedo definir propiedades de usuario de GA4 en Google Tag Manager?

Sí. En una etiqueta Google Analytics 4 Event, añade una fila en la sección User Properties por cada propiedad que quieras enviar. Después regístrala como dimensión personalizada con alcance de usuario, o no aparecerá en los informes.

¿Por qué falta mi propiedad de usuario de GA4 en los informes?

Una propiedad de usuario no aparece en los informes hasta que su dimensión personalizada existe y ha terminado de procesarse. Google indica que la dimensión llega a los informes entre 24 y 48 horas después de crearla. Comprueba que el alcance sea User y que el nombre coincida exactamente con el que envía tu código, porque ambos quedan fijos al guardar.

¿Puede una propiedad de usuario de GA4 contener un correo electrónico?

No. La política de Google prohíbe enviar datos que pueda reconocer como información de identificación personal y cita las direcciones de correo como ejemplo. Limita los valores a categorías cortas como pro, trial o admin.

¿Debo crear una propiedad de usuario para País o Idioma?

No hace falta. GA4 ya recoge dimensiones de usuario predefinidas como Country, Language y Device category, y Google recomienda no crear una personalizada si una predefinida ya cubre el dato. Reserva tus 25 plazas para datos que solo conoce tu sitio.