Cómo sobrevive una convención de nombres de eventos a su primer renombrado

¿Por qué importa una convención de nombres de eventos?

Elegir una convención de nombres de eventos sale barato el día uno y caro el día doscientos, porque Google Analytics 4 nunca aplica un renombrado a datos que ya recogió. Cada nombre inconsistente que envías se convierte en una segunda fila permanente en cada informe que agrupa por evento, y la única forma de fusionar esas filas después es recalcular los datos tú mismo en un almacén.

El fallo no es teórico ni ordenado. Tres desarrolladores instrumentan el mismo botón en tres sprints y acabas con signup_click, SignupClick y click_signup. GA4 trata los tres como eventos separados, porque "event names are case sensitive. For example, my_event and My_Event are distinct events." Tu embudo se parte en tres, tu recuento de eventos clave es un tercio de la verdad, y nadie lo nota hasta que alguien compara el panel con Stripe. La disciplina más amplia está cubierta en seguimiento de eventos; esta página va de los nombres en sí.

¿Qué nombres rechaza GA4 de plano?

GA4 rechaza los nombres y prefijos reservados, y las reglas de nombres de evento de Google dicen la consecuencia sin rodeos: "If you try to use a reserved prefix or name, Analytics will display an error message." Las reglas que aplican a cada nombre son cortas:

• "Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces."
• "Event names are case sensitive."
• "Event names can include English and non-English words and letters."

Para los flujos de datos web, Google reserva query_id como prefijo y reserva diecinueve nombres de evento de plano. Los que muerden a un equipo de implementación son los que suenan plausibles y a los que irías de forma natural:

Reservado en web	Por qué habrías ido a por él
click	El nombre obvio para cualquier manejador de clic
error	El nombre obvio para un fallo del lado del cliente
scroll	El nombre obvio para un evento de profundidad de scroll
file_download	El nombre obvio para una descarga de PDF
page_view	El nombre obvio para una vista de página virtual en una single-page app
session_start	El nombre obvio para un equivalente de apertura de app
user_engagement	El nombre obvio para un evento de tiempo de permanencia
video_start	El nombre obvio para un evento de reproductor
ad_impression	El nombre obvio para un hueco de anuncio propio

La mayoría de esos ya te los envía la medición mejorada, y por eso están reservados. Revisa qué recoge tu propiedad sin configuración antes de nombrar nada, y mira autocapture para saber qué detecta y qué no la recolección automática.

La referencia del Measurement Protocol añade una segunda lista más larga que se aplica cuando envías eventos del lado del servidor, e incluye first_open, first_visit, app_exception, os_update y toda la familia firebase_, y señala que "ad_impression, in_app_purchase and screen_view events are only allowed for App streams".

Los parámetros llevan sus propias reservas. El nombre firebase_conversion está reservado, y los nombres de parámetro "cannot begin with" _, firebase_, ga_, google_ o gtag.. Los nombres de propiedad de usuario no pueden empezar por _, firebase_, ga_ ni google_, y los nombres first_open_time, first_visit_time, last_deep_link_referrer, user_id y first_open_after_install están tomados.

¿Qué límites de longitud se aplican?

Cuarenta caracteres para el nombre de evento, y el castigo por pasarse es más raro que un simple rechazo. Los límites de recolección de eventos de Google indican que un nombre de evento llega a "40 characters", y luego añaden: "If you mark an event as a key event and the event exceeds 40 characters, then the event will not be reported as a key event because the appended _c will be missing." El evento se sigue recogiendo. Simplemente deja de poder contarse como evento clave, en silencio, porque GA4 añade _c internamente y el nombre resultante se desborda.

Los límites de alrededor moldean una convención tanto como el límite del nombre:

Límite	Valor
Longitud del nombre de evento	40 caracteres
Nombres de evento distintos, flujo web	Sin límite
Nombres de evento distintos, flujo de app	500 por usuario de app
Parámetros de evento por evento	25
Longitud del nombre de parámetro	40 caracteres
Longitud del valor de parámetro	100 caracteres
Valor de page_title	300 caracteres
Valor de page_referrer	420 caracteres
Valor de page_location	1.000 caracteres
Propiedades de usuario por propiedad	25
Longitud del nombre de propiedad de usuario	24 caracteres
Longitud del valor de propiedad de usuario	36 caracteres

El valor de parámetro de 100 caracteres es el que pilla a los equipos. Un nombre de producto, una consulta de búsqueda o una cadena de error de formulario lo superarán, y lo que se corta es el valor en vez de rechazarse el evento. El nombre de propiedad de usuario de 24 caracteres es todavía más justo, y es dieciséis caracteres más corto que el límite del nombre de evento, lo que es buena razón para no replicar nombres de evento dentro de nombres de propiedad de usuario.

El recuento ilimitado de nombres de evento distintos en web es una trampa y no una licencia. Nada te impide enviar cuatrocientos nombres de evento; simplemente los informes se vuelven inutilizables, y cada uno tiene que registrarse como definición personalizada antes de aparecer en la mayoría de análisis. Ese coste de registro está cubierto en configurar dimensiones personalizadas.

¿Va primero el objeto o la acción?

El consejo común es objeto primero, cart_added y video_played, con el argumento de que los informes ordenan alfabéticamente y los nombres con objeto delante agrupan todos los eventos de una misma cosa. Es buen consejo y discrepa de Google.

Los eventos recomendados de Google van con la acción primero. Solo el conjunto de retail dice add_payment_info, add_shipping_info, add_to_cart, add_to_wishlist, begin_checkout, purchase, refund, remove_from_cart, select_item, view_item, y el conjunto general añade earn_virtual_currency, join_group, login, search, select_content, share, sign_up, spend_virtual_currency, tutorial_begin y tutorial_complete.

Eso importa porque los eventos recomendados no son cosméticos. Google los describe como "standardized events for different business verticals (e.g., retail, travel, games) that unlock prebuilt reporting panels", mientras que los eventos personalizados son "events that you define yourself because no prepopulated automatic, enhanced, or recommended event fits your needs" y son "accessible using custom reports". Renombrar add_to_cart a cart_added por coherencia interna te cuesta los informes de ecommerce prefabricados.

La regla viable es por tanto separar por origen y no por gusto. Usa la grafía de Google donde exista un evento recomendado, exactamente como está publicada, y aplica tu propio patrón de objeto primero solo a los eventos que Google no define. Una convención que produce add_to_cart junto a pricing_table_viewed parece inconsistente sobre el papel y es la única versión que conserva a la vez los informes y el orden de clasificación. Elijas el orden que elijas, snake_case en minúsculas es la única capitalización que esquiva la trampa de la sensibilidad a mayúsculas, ya que una convención donde cualquier carácter puede variar de caja es una convención que acabará incumpliéndose.

Elegir el orden del nombre del evento

1

Revisar la lista de eventos recomendados. Comprobar si Google ya define un evento para lo que quieres medir, como add_to_cart o begin_checkout.

2

Coincidencia encontrada. Usar la grafía exacta de Google, con la acción primero, para conservar los informes de ecommerce prediseñados.

3

Sin coincidencia. Aplicar tu propio patrón de objeto primero a partir de una lista cerrada de verbos y objetos.

¿Qué cuesta renombrar un evento después del lanzamiento?

Te cuesta el histórico, de forma permanente, y te cuesta uno de cincuenta huecos. La documentación de Google sobre renombrar eventos es inequívoca sobre lo primero: "Modified and new events do not apply to historical data." La modificación reescribe los eventos solo hacia adelante. Cada fila que ya está en la propiedad conserva el nombre viejo, y no existe reprocesamiento que lo arregle.

A su lado hay dos restricciones más. "An hour or more passes before modifications take effect", así que el arreglo no es inmediato ni siquiera después de hacerlo. Y "you can modify up to 50 existing events and create up to 50 events based on existing events", lo que significa que la función de modificación es un kit de reparación y no una capa de nombres en la que apoyarte indefinidamente.

El coste práctico de un solo renombrado es, entonces:

• Una separación permanente en cada informe que agrupa por nombre de evento, en la fecha del cambio.
• Cualquier definición de evento clave, audiencia o embudo que referencie el nombre viejo tiene que duplicarse sobre el nuevo, o deja de contar. La diferencia entre los dos conceptos está expuesta en eventos clave frente a conversiones.
• Las comparaciones interanuales que cruzan la frontera hay que coserlas a mano.
• Uno de los cincuenta huecos de modificación, consumido mientras el nombre viejo siga llegando desde una página cacheada o una compilación de app sin publicar.

Nada de eso se recupera pagando más ni esperando más, que es todo el argumento para pasar una tarde con el documento de nombres antes de enviar la primera etiqueta.

¿Cómo es una convención que funciona?

Una convención son cuatro decisiones escritas, no una lista de nombres. Toma cada una una vez y la lista se genera sola.

Capitalización: solo snake_case en minúsculas, para nombres y parámetros por igual. Letras, números y guiones bajos es todo lo que GA4 acepta de todos modos, y las minúsculas eliminan la única forma en que dos eventos idénticos pueden divergir.

Vocabulario: una lista cerrada de verbos y una lista cerrada de objetos. view, select, add, remove, submit, start, complete cubre la mayoría de sitios. Dos verbos que significan lo mismo es como signup_submit y signup_complete acaban los dos en producción.

Orden: la grafía de Google donde exista un evento recomendado, objeto primero en todo lo demás, y la excepción escrita en el documento para que el siguiente ingeniero no la normalice en silencio.

Colocación del detalle: el detalle variable va en parámetros, nunca en el nombre. form_submit con un parámetro form_name es un evento que puedes filtrar; newsletter_form_submit, contact_form_submit y demo_form_submit son tres eventos que no puedes comparar sin construir un informe por formulario, y queman tres de tus registros de definición personalizada en vez de uno.

Longitud: mantén los nombres por debajo de 40 caracteres con margen, porque el castigo del evento clave añade _c a lo que elegiste y el fallo es silencioso.

Preguntas frecuentes

¿Qué caracteres puede contener un nombre de evento de GA4?

Letras, números y guiones bajos, y el nombre debe empezar por una letra. Google enuncia la regla como "Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces." Se permiten letras no inglesas: "Event names can include English and non-English words and letters."

¿Los nombres de evento de GA4 distinguen mayúsculas?

Sí. Las reglas de nombres de Google indican que "event names are case sensitive. For example, my_event and My_Event are distinct events." No hay paso de normalización, así que dos grafías del mismo evento producen dos filas independientes en cada informe que agrupa por nombre de evento.

¿Qué pasa si envío un nombre de evento reservado?

Analytics lo rechaza y saca un error. Las reglas de nombres de evento dicen que "if you try to use a reserved prefix or name, Analytics will display an error message". Los nombres reservados en web incluyen click, error, scroll, file_download, page_view, session_start, user_engagement y video_start.

¿Debería usar objeto_acción o acción_objeto?

Usa la grafía exacta de Google para sus eventos recomendados, que van con la acción primero, y objeto primero para todo lo demás. El conjunto recomendado de Google incluye add_to_cart, begin_checkout, select_item y view_item, y renombrarlos renuncia a los paneles de informe prefabricados que Google les asocia.

¿Puedo renombrar un evento de GA4 después del lanzamiento?

Puedes renombrarlo hacia adelante y nunca hacia atrás. Google afirma que "modified and new events do not apply to historical data", que "an hour or more passes before modifications take effect", y que "can modify up to 50 existing events and create up to 50 events based on existing events".

¿Cuánto puede medir un nombre de evento de GA4?

40 caracteres. Pasarse tiene una consecuencia concreta más allá del rechazo: Google advierte de que "if you mark an event as a key event and the event exceeds 40 characters, then the event will not be reported as a key event because the appended _c will be missing".

¿Qué pasa si un equipo usa nombres de eventos incoherentes?

GA4 trata cada variante como un evento distinto, porque los nombres de evento distinguen mayúsculas de minúsculas. Si tres desarrolladores llaman al mismo botón signup_click, SignupClick y click_signup, el resultado son tres filas separadas en cada informe, el funnel se divide en tres y el recuento de eventos clave cae a un tercio del valor real. Casi nadie lo nota hasta que alguien compara el panel con otra fuente de datos como Stripe.

¿Hay un límite de cuántos nombres de evento puedo enviar a GA4?

Un flujo web no tiene límite en la cantidad de nombres de evento distintos, pero esa ausencia de límite juega en tu contra. Los nombres de evento aparecen por sí solos, pero cada parámetro que les adjuntas necesita una ranura de definición personalizada, así que cuatrocientos nombres solo compran informes que nadie puede leer. Un flujo de app sí impone un tope, de 500 eventos distintos por usuario de la app.

¿Cuál es la diferencia entre un evento personalizado y un evento recomendado?

Un evento recomendado es uno de los nombres estandarizados de Google para un sector como retail o viajes, y Google dice que desbloquea paneles de informes prediseñados. Un evento personalizado lo defines tú porque ningún evento automático, mejorado o recomendado se ajusta a tu caso, y solo aparece en informes personalizados que construyes tú. Renombrar add_to_cart a cart_added por coherencia interna te cuesta el panel prediseñado que trae asociado.

¿Los eventos clave siguen contando después de renombrar el evento al que apuntan?

No de forma automática. Cualquier definición de evento clave, audiencia o embudo que apuntara al nombre antiguo tiene que duplicarse sobre el nombre nuevo, o deja de contar en cuanto el cambio surte efecto. Esa duplicación no consume ninguna ranura de modificación; solo el propio renombrado gasta una de las cincuenta que permite GA4.