Skip to main content
La convención es la respuesta del espacio de trabajo a “cómo luce un valor UTM bien formado”. Tiene cuatro ajustes, se aplica a cada enlace creado en el espacio de trabajo — desde la consola, el asistente, la API o el MCP — y está en la parte superior de la página de Reglas, https://app.utmkit.co/rules.

​
Los cuatro ajustes

  • Mayúsculas: lower, upper o any.
  • Separador: el carácter entre palabras, hyphen, underscore o any.
  • Parámetros requeridos: cualquiera de utm_source, utm_medium, utm_campaign, utm_term y utm_content que un enlace no pueda omitir.
  • Una violación: el modo. block rechaza el enlace; warn lo crea y reporta el problema.
Un valor pasa el formato cuando son palabras de letras a–z y dígitos unidas por el separador, sin nada antes, después o duplicado. spring-launch pasa con los valores por defecto; Spring Launch y spring--launch no. Un espacio de trabajo que nunca tocó la página corre con los valores por defecto: minúsculas, guion, nada requerido, bloqueo. La página lo dice claramente: son los valores por defecto, y están en vigor.

​
Cambiarla

Propietarios y administradores ven Editar la convención; todos los demás ven las reglas y no pueden cambiar nada. El editor cambia cómo debe lucir el siguiente enlace. Los enlaces ya creados conservan los valores incrustados en ellos; la auditoría es lo que encuentra los que ya no cumplen. También puedes pedirle al asistente que configure mayúsculas, un separador, parámetros requeridos, valores aprobados o una regla de dependencia con tus propias palabras, y te muestra la regla que registró como una tarjeta. Solo agrega: retirar un valor aprobado o quitar una regla de dependencia sigue siendo trabajo de esta página. Si un colega guarda la convención mientras tienes el editor abierto, tu guardado se rechaza y se te pide recargar y aplicar tu cambio de nuevo, en lugar de sobrescribir el suyo en silencio.
La convención también da forma a los valores derivados. Una campaña llamada “Spring Launch” aporta utm_campaign=spring-launch con los valores por defecto y SPRING_LAUNCH con mayúsculas y guion bajo. Ver Campañas.

​
Qué le pasa a un enlace que la rompe

En modo block el enlace no se crea. El rechazo nombra el parámetro, el valor y la regla que rompió, en una sola oración sobre la que puedes actuar:
  • Un valor con la forma incorrecta: utm_source ‘Newsletter’ no coincide con la convención de UTM de este espacio de trabajo (minúsculas, letras y dígitos unidos por ’-’).
  • Un parámetro requerido que falta: utm_medium es obligatorio según la convención de UTM de este espacio de trabajo y no fue proporcionado.
  • Un valor fuera de la lista aprobada, o uno que una regla de dependencia prohíbe: la oración enumera qué está permitido en su lugar. Ver Valores aprobados y Reglas de dependencia.
En modo warn el enlace se crea y la misma oración lo acompaña: el asistente la transmite en la conversación, y la API la devuelve junto al enlace. Warn no es “apagado”; es el modo para un espacio de trabajo que adopta reglas sobre enlaces que ya tiene. Un chequeo corre por encima de tus propias reglas. Un valor que sigue la convención pero que Google Analytics archivaría en el canal equivocado — utm_medium=newsletter, que cae en Unassigned en lugar de Email — se reporta con esa consecuencia y las grafías que funcionan, y se rechaza en modo bloqueo como cualquier otra violación.
Aprobar un valor o registrar una regla de dependencia debe respetar el formato por sí mismo: Facebook no se puede aprobar bajo una convención en minúsculas.

​
Desde la API y el MCP

GET /api/v1/rules/convention lee los cuatro ajustes y PUT /api/v1/rules/convention los cambia; el cuerpo es parcial por diseño, así que una regla que no nombres queda intacta. Las lecturas necesitan rules:read, las escrituras rules:write. Las herramientas del MCP son get_convention y set_convention; set_convention, como toda escritura de reglas, también requiere que quien tenga el token sea propietario o administrador, así que el token de un miembro se rechaza para su rol incluso cuando lleva el permiso.