Cómo llevan los parámetros de evento de GA4 el detalle de cada evento

¿Qué son los parámetros de evento de GA4?

Cada evento que registra Google Analytics 4 lleva parámetros de evento de GA4, los pares clave-valor que dicen qué enlace se pulsó, cuánto valió una compra o qué producto vio un visitante. El nombre del evento dice qué pasó. Los parámetros dan los detalles. La guía para desarrolladores de Google lo resume en una línea: "Parameters provide additional information about the ways users interact with your website."

El centro de ayuda de Google hace la misma división entre las tres capas de datos de GA4: "Events measure what users do on your website or app, like clicking a link or watching a video. Event parameters provide more details about these actions, like which link was clicked or how much of the video a user watched. User properties tell you more about the users themselves." Si el propio modelo de eventos es nuevo para ti, empieza por el seguimiento de eventos y vuelve aquí para la capa de parámetros.

¿Qué parámetros recoge GA4 sin ningún código?

GA4 añade un conjunto de parámetros a cada evento de un flujo web, incluidos los eventos personalizados, antes de que escribas una sola línea de código de tracking. La lista de Google de parámetros "collected by default with every event, including custom events" nombra language, page_location, page_referrer, page_title y screen_resolution para los flujos web. GA4 también genera ga_session_id y ga_session_number con cada sesión y envía engagement_time_msec con eventos como user_engagement y page_view.

Los eventos recomendados añaden un segundo nivel: parámetros a los que Google ya ha puesto nombre y que ya ha conectado con los informes predefinidos. El evento purchase es el que más equipos usan:

La referencia de Google añade una regla que rompe los informes de ingresos si se ignora: "If you set value then currency is required for revenue metrics to be computed accurately." Los parámetros de los eventos recogidos automáticamente y de los eventos recomendados rellenan dimensiones y métricas predefinidas. Todo lo que inventes tú no.

¿Cómo envías un parámetro de evento personalizado?

Envías un parámetro de evento personalizado añadiéndolo como par clave-valor en el tercer argumento de la llamada gtag('event', ...). La guía de Google da la estructura como gtag('event', '<event_name>', {<event_parameters>}); con este ejemplo:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

Aquí app_name y screen_name son los nombres de los parámetros, y myAppName y Home son los valores. Para añadir un parámetro a todos los eventos de una página, ponlo en el comando config, como en gtag('config', 'G-XXXXXXXXXX', {'page_title': 'Contact Us', 'currency': 'EUR'}). Google desaconseja la tercera opción para valores personalizados: "The set command may not reliably propagate custom parameters to all Google Analytics measurement streams." Usa event o config para todo lo que hayas inventado.

Comprueba el resultado en el informe Realtime o en DebugView. Google lo explica así: "These reports show data as it arrives." DebugView muestra el conjunto combinado, incluidos los valores aplicados de forma global, en la pestaña Parameters del evento.

¿Por qué un parámetro personalizado no aparece en los informes de GA4?

Un parámetro personalizado no aparece en los informes de GA4 porque Google solo informa sobre él después de que lo registres como dimensión o métrica personalizada. La guía para desarrolladores lo dice sin rodeos: "Without this registration, the parameter data is collected but isn't available for reporting." Realtime y DebugView muestran el valor en bruto, y por eso un parámetro puede parecer correcto en las pruebas y seguir sin aparecer en ninguna exploración una semana después.

Registrarlo lleva dos minutos en la pantalla de administración. La página de ayuda de Google enumera los pasos:

1. En Admin, en Data display, haz clic en Custom definitions.
2. Abre la pestaña Custom dimensions y haz clic en Create custom dimensions.
3. Escribe un Dimension name. Google permite guiones bajos y espacios, pero no guiones.
4. Pon Scope en Event.
5. En Event parameter, escribe el nombre del parámetro exactamente como lo envía tu código.
6. Haz clic en Save.

Hay dos campos que no se pueden deshacer. Google marca tanto Scope como Event parameter con "You can't change this field after you save the new dimension." Una errata en el nombre del parámetro obliga a borrar la dimensión y crearla de nuevo. Después de guardar, Google dice que puedes añadir la dimensión a los informes "after 24-48 hours from when the custom data was sent and the custom dimension was created." Durante ese plazo, la dimensión muestra una de las causas documentadas de (not set) en GA4. Las páginas de Google no dicen nada sobre rellenar valores recogidos antes de que existiera la dimensión, así que registra la dimensión el mismo día en que publiques el parámetro.

Los números siguen otro camino. Un parámetro que mide una cantidad, como los segundos vistos o los artículos de un carrito, va en una métrica personalizada. La regla de Google es que para "categorical data, however, such as what text was clicked or which page was viewed, it's more appropriate to use an event-scoped custom dimension."

¿Qué límites se aplican a los parámetros de evento de GA4?

Los parámetros de evento de GA4 tienen un límite de 25 por evento, 40 caracteres por nombre y 100 caracteres por valor, y Google no registra nada que supere esos límites. La página de límites de recogida dice: "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."

Google dice que pasar a Analytics 360 te permite "increase certain limits (but not event/parameter character limits)", así que las longitudes de nombre y de valor son las mismas en todas las propiedades. El límite que más aprieta en la mayoría de los sitios son las 50 dimensiones personalizadas con ámbito de evento, no los 25 parámetros por evento, porque cada dimensión cubre un nombre de parámetro en todos los eventos que lo envían. Llegar al tope de dimensiones también tiene un coste: Google dice que "you'll need to wait 48 hours after deleting dimensions to add new ones."

¿Qué nombres de parámetro reserva GA4?

GA4 reserva cinco prefijos y una lista de nombres para los parámetros de evento, y un nombre reservado no puede respaldar una dimensión personalizada. Las reglas de nombres de Google dicen que los nombres de parámetro "can't begin with" un guion bajo, firebase_, ga_, google_ o gtag.. Los nombres reservados para dimensiones y métricas personalizadas son cid, currency, customer_id, customerid, dclid, gclid, session_id, sessionid, sfmc_id, sid, srsltid, uid, user_id y userid.

Las mayúsculas importan en los eventos, y aplicar la misma costumbre a los parámetros es lo más seguro. Las reglas de Google dicen "Event names are case sensitive. For example, my_event and My_Event are distinct events." Elige un estilo, como snake case en minúsculas, y mantenlo en eventos y parámetros para que Plan y plan nunca acaben como dos columnas.

¿Qué no deberías enviar nunca como parámetro de evento?

Nunca deberías enviar datos personales ni identificadores únicos como parámetros de evento de GA4. La política de Google pide que "no data be passed to Google that Google could use or recognize as personally identifiable information (PII)", y pone como ejemplos las direcciones de email, los números de móvil personales y los números de la seguridad social. La fuga habitual es un valor de formulario o una query string de la URL copiados en un parámetro, algo que explica la sección sobre eventos y parámetros de cómo recoge Google Analytics los datos de los usuarios.

Los valores únicos causan un segundo problema aunque no sean personales. Google pide a las propiedades estándar que no creen "unnecessary high-cardinality custom dimensions" y da tres ejemplos: un ID único por usuario, un ID único por sesión y una marca de tiempo. Esas dimensiones "may negatively impact your reports and explorations, and cause data to be condensed under the (other) row." Envía categorías, como plan: pro o method: google, no valores que cambian en cada hit.

Una regla de interpretación pilla desprevenidos a muchos equipos. Google avisa de 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", así que un valor de texto como "94E40" se lee como notación científica. Pon un prefijo a los códigos que parecen numéricos, como sku_94E40, para que sigan siendo texto.

¿Cómo gestiona Flowsery los datos de eventos personalizados?

Flowsery registra un evento personalizado con una sola llamada como window.flowsery("signup"), sin gestor de etiquetas y sin ningún paso de registro de dimensiones personalizadas entre el código y el panel. Su seguimiento de objetivos y eventos cubre clics en botones, envíos de formularios, descargas de archivos y reproducciones de vídeo, te permite asignar valores de ingresos a los eventos y muestra cada uno en un feed de eventos en tiempo real en cuanto se dispara, así que compruebas el tracking en el momento en que lo publicas. Los eventos se registran sin cookies ni datos personales. Si vas a sacar un plan de eventos de GA4, la comparativa de seguimiento de eventos personalizados en analítica privada frente a GA4 explica qué costumbres de GA4 conviene dejar por el camino.

Preguntas frecuentes

¿Cuántos parámetros de evento puede tener un evento de GA4?

Un evento de GA4 puede llevar 25 parámetros de evento en una propiedad estándar. Google no registra los parámetros que pasan de ese límite, así que los valores de más nunca llegan a los informes. Analytics 360 amplía algunos límites, pero no el tope de 40 caracteres por nombre ni el de 100 caracteres por valor.

¿Por qué veo mi parámetro en DebugView pero no en los informes?

DebugView y Realtime muestran los parámetros en bruto a medida que llegan, mientras que los informes estándar y las exploraciones solo muestran los parámetros personalizados que hayas registrado como dimensiones o métricas personalizadas. Registra el parámetro en Admin, Custom definitions, y espera entre 24 y 48 horas a que aparezcan los datos.

¿Qué diferencia hay entre un parámetro de evento y una dimensión personalizada?

Un parámetro de evento es el par clave-valor que tu código envía con un evento. Una dimensión personalizada es el campo de informe que creas en GA4 y que lee un nombre de parámetro en todos los eventos que lo envían. Una sola dimensión personalizada con ámbito de evento cubre un parámetro en tantos eventos como quieras.

¿Las dimensiones personalizadas se aplican a datos recogidos antes de crearlas?

Las páginas de ayuda de Google no dicen que las dimensiones personalizadas rellenen datos anteriores. Dicen que puedes usar una dimensión entre 24 y 48 horas después de que se enviaran los datos y se creara la dimensión. Registra la dimensión el día en que publiques el parámetro para evitar un hueco.

¿Puedo enviar un ID de usuario como parámetro de evento?

No registres un ID de usuario como dimensión personalizada con ámbito de evento. user_id está en la lista de nombres reservados de Google, y Google pone un ID único por usuario como ejemplo de dimensión de alta cardinalidad que hay que evitar. Para ese caso, Google remite a su función User-ID.

¿Qué pasa con un valor de parámetro de más de 100 caracteres?

GA4 no registra un valor de parámetro que supere el límite de ese parámetro. El límite es de 100 caracteres para la mayoría de los parámetros, con excepciones de 300 para page_title, 420 para page_referrer y 1,000 para page_location. Recorta los valores largos o conviértelos en categorías cortas antes de enviarlos.

¿Puedo usar el comando set de gtag para enviar un parámetro personalizado?

Google lo desaconseja. El comando set puede no propagar de forma fiable los parámetros personalizados a todos los flujos de medición de Google Analytics. Envía los valores personalizados con event o config, los dos comandos que Google recomienda para eso.

¿Cuántos parámetros personalizados puede llevar un artículo de ecommerce?

La tabla de límites fija los parámetros personalizados a nivel de artículo en 27 por evento de ecommerce, además de los parámetros de artículo que GA4 ya exige, como item_id e item_name. Ese límite es independiente del tope de 25 parámetros por evento.

¿Puede el nombre de una dimensión personalizada incluir un guion?

La regla de Google en el panel de administración permite guiones bajos y espacios en el nombre de una dimensión personalizada, pero no guiones. Usa letras, números, guiones bajos y espacios para evitar un error de validación al guardarla.

¿Qué pasa si borro una dimensión personalizada por error?

La espera se aplica cuando ya has llegado al límite de dimensiones personalizadas. La nota de Google dice: "If you hit the limit for custom dimensions, you'll need to wait 48 hours after deleting dimensions to add new ones." Con los 50 huecos de ámbito de evento ocupados, borrar la equivocada para hacer sitio cuesta dos días antes de poder recrearla.