> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utmkit.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Campañas

> Una campaña agrupa los enlaces de un espacio de trabajo bajo un nombre y le da al informe algo por lo cual filtrar.

Una campaña es el contenedor bajo el que cuelgan tus enlaces. Hace dos cosas: agrupa enlaces para
que "todo lo del lanzamiento de primavera" sea una sola lista, y su nombre es el `utm_campaign`
por defecto de los enlaces creados dentro de ella, así el informe se puede acotar a esa campaña.

Las campañas viven en [https://app.utmkit.co/campaigns](https://app.utmkit.co/campaigns). Cualquiera en el espacio de trabajo puede
ver la lista; propietarios, administradores y miembros pueden crear, renombrar y eliminar. Un
observador ve la lista y nada más.

## Crear una campaña

<Steps>
  <Step title="Abre Campañas y elige Nueva campaña">
    Dale un nombre y, si quieres, una descripción.
  </Step>

  <Step title="Revisa el valor derivado">
    Después de guardar, la fila dice **Se agrega a los enlaces como utm\_campaign=…**, reescrito para seguir la
    [convención](/es/rules/the-convention) del espacio de trabajo: "Spring Launch" se convierte en
    `spring-launch` bajo las reglas por defecto. Ese valor se valida contra las reglas al guardar. Si
    `utm_campaign` tiene [valores aprobados](/es/rules/approved-values), un nombre que no produzca uno
    de ellos se rechaza, con los valores aprobados en el mensaje.
  </Step>
</Steps>

Los nombres son únicos por espacio de trabajo y se comparan sin distinguir mayúsculas de
minúsculas. Pedir una campaña que ya existe te da la que ya existe en lugar de un duplicado, por
lo que la consola dice que la campaña "está lista para usar" en ambos casos. También puedes crear
una pidiéndole [al asistente](/es/get-started/the-assistant) un enlace bajo una campaña nueva, y
pedirle que renombre una campaña o mueva enlaces dentro o fuera de una de la misma forma en que lo
harías en esta página.

## Renombrar, y qué no cambia al renombrar

Edita una campaña para cambiar su nombre o descripción. Renombrar cambia el `utm_campaign` por
defecto de los enlaces creados de ahí en adelante. **Los enlaces ya creados conservan el valor con
el que nacieron**: está incrustado en su destino, ya publicado en la red global y ya contado en
tus informes. Reescribirlo dividiría el historial de una campaña en dos en el momento en que
alguien corrige un error de tipeo. El editor lo dice antes de que guardes.

## Los enlaces de una campaña

Cada fila cuenta los enlaces que contiene y ofrece dos atajos. **Ver sus enlaces** abre la lista de
enlaces en [https://app.utmkit.co/links](https://app.utmkit.co/links) ya acotada a esa campaña, y **Ver sus números** abre
[el informe](/es/analytics/the-report) filtrado a ella.

En la fila de un enlace y en las tarjetas que muestra el asistente cuando cambia algo, el nombre
de una campaña es un enlace a la campaña. Pasa el cursor sobre él (o tócalo en un teléfono) para
ver un adelanto de su valor de `utm_campaign`, cuántos enlaces contiene, y sus clics y
conversiones, con atajos a sus enlaces y a su analítica, sin salir de la página.

## Eliminar una campaña

Eliminar una campaña quita la agrupación y nada más. Sus enlaces siguen funcionando, siguen
redirigiendo y conservan el `utm_campaign` que llevan; simplemente dejan de pertenecer a un
contenedor. La confirmación indica cuántos enlaces son, así que una campaña con cuarenta enlaces
se lee distinto de una vacía.

<Note>
  Una campaña cuyo nombre las reglas de hoy rechazarían sigue listada tal cual está. Las reglas se
  aplican cuando se elige un nombre, no retroactivamente; la [auditoría](/es/rules/audit-existing-urls)
  es lo que encuentra enlaces que ya no cumplen.
</Note>

## Desde la API y el MCP

`GET /api/v1/campaigns` lista las campañas del espacio de trabajo con su conteo de enlaces,
`POST /api/v1/campaigns` crea una (un nombre repetido devuelve la campaña existente),
`GET /api/v1/campaigns/{id}` lee una, y `PATCH /api/v1/campaigns/{id}` la renombra o le cambia la
descripción — ambos campos son opcionales en `PATCH`, y los enlaces existentes conservan su
`utm_campaign` exactamente como en la consola. No hay operación de eliminación; eliminar es trabajo
de la consola. Las lecturas necesitan `campaigns:read` y las escrituras `campaigns:write`. Sobre
el MCP las herramientas son `list_campaigns`, `get_campaign` y `create_campaign`, bajo los mismos
dos permisos.