> ## 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.

# Conversiones

> Una conversión es un resultado que tu propio servidor reporta contra un enlace — una compra, un registro, un lead — para que el informe diga qué enlaces produjeron resultados, no solo cuáles recibieron clics.

Todos los demás números de UTMKit son un clic, y un clic no es un resultado. Una **conversión** es lo que pasó después: el visitante que llegó por uno de tus enlaces compró algo, se registró, o se convirtió en un lead. Tus propios sistemas saben cuándo pasa eso — el checkout, el formulario de registro, el CRM — y una conversión es tu servidor avisándole a UTMKit, para que el número caiga junto al clic que lo causó.

Las conversiones se reportan solo a través de la API. No hay un formulario en la consola ni una herramienta MCP, porque una conversión es un evento de tu servidor, no algo que una persona escribe.

## Cómo encuentra una conversión su enlace

No se pone nada en el navegador del visitante; la redirección no crea ninguna cookie. En cambio, una vez que tu espacio de trabajo tiene un token que puede reportar conversiones, el destino de cada enlace lleva una pequeña referencia `_link` que nombra el enlace corto de origen — excepto un enlace de clic para chatear de WhatsApp, cuya ventana de chat no tiene cómo leerla. Tu página de destino la lee, y tu servidor la devuelve con la primera conversión de ese cliente.

A partir de ahí UTMKit recuerda qué enlace trajo a ese cliente, así que una compra meses después del registro se puede reportar solo con el identificador del cliente y aun así cuenta para el enlace que la originó. Esa memoria es también la única forma en que se puede reportar una conversión de un enlace de WhatsApp: con el identificador del cliente, contra el enlace que nombró una conversión anterior.

Algunas reglas que conviene saber antes de conectarlo:

* **Cada conversión lleva un identificador que tú eliges.** Reportar el mismo dos veces lo registra una sola vez y responde como aceptado. Reintentar es un comportamiento correcto, así que es seguro automatizarlo.
* **Un enlace retirado sigue tomando conversiones, y uno eliminado también mientras al menos uno de sus clics siga guardado.** El clic pasó y el resultado también.
* **Un valor y una moneda se guardan exactamente como se dan.** No se convierte nada entre monedas.
* **El espacio de trabajo viene del token.** Una referencia al enlace de otro espacio de trabajo se rechaza igual que lo haría un enlace desconocido, así que un token nunca puede escribir en los números de otra persona.
* **Las conversiones cuentan como eventos registrados**, igual que los clics, para el límite de tu plan, y cada token tiene un tope de cuántas puede reportar en una ventana de tiempo; un rechazo dice cuándo reintentar. Ver la [página de planes](https://app.utmkit.co/billing/plans) para el límite.
* **Una conversión no es una entrada del registro de actividad.** Es un hecho sobre un visitante, no un cambio que hizo un miembro.

## El token

Las conversiones necesitan un token de API con el permiso `conversions:write`, generado en la [página de tokens](https://app.utmkit.co/tokens) como cualquier otro. Un token que solo tiene ese permiso no puede hacer nada más — no puede listar, crear ni eliminar enlaces — lo que lo hace seguro para dárselo al desarrollador de un cliente. La hora de último uso del token en esa página distingue una integración funcionando de una silenciosa.

## Dónde se muestran las conversiones

El [informe](/es/analytics/the-report) tiene una tarjeta **Conversiones**, con el valor total cuando todas las conversiones comparten una moneda, y una columna de conversiones en su tabla. Una conversión cuenta en el período en que **pasó**, sin importar en qué período estuvo su clic, y la página lo indica junto al número. Agrupado por día o por cualquier parámetro UTM, cada fila lleva sus conversiones; agrupado por país, dispositivo, referente, disparador, tipo de evento o destino, la columna muestra un guion, porque una conversión nunca vio el navegador. Un período sin conversiones muestra cero en vez de ocultar la columna: una campaña que no produjo nada es el hallazgo.

Los mismos números aparecen en el [informe para clientes](/es/analytics/client-reports-and-branding) y en el correo del [informe programado](/es/analytics/scheduled-reports).

## Desde la API

Tu servidor reporta una conversión con `POST /api/v1/conversions`, usando un token que lleva el permiso `conversions:write`. La referencia de la API describe los campos y las dos respuestas: creada, o ya registrada cuando la llamada es un reintento. Deliberadamente no hay herramienta MCP para conversiones.
