Crear enlaces UTM de campaña
Un panel de analítica se fragmenta en cien variantes casi idénticas de un mismo nombre de campaña en cuanto dos personas escriben utm_source a mano cada una a su manera. Este endpoint construye URLs etiquetadas a partir de campos estructurados y analiza enlaces existentes para devolverlos separados en sus partes, así cada campaña aparece exactamente una vez en los reportes.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
El error de tipeo que divide su reporte de tráfico
Los equipos de marketing rara vez pierden la disciplina de UTM a propósito: alguien escribe 'Newsletter', otra persona escribe 'newsletter', un tercero escribe 'news_letter', y de repente una sola campaña aparece como tres filas distintas en la herramienta de analítica, cada una con una fracción del tráfico real. Multiplique eso por docenas de campañas y cientos de enlaces compartidos por distintos miembros del equipo, y el panel deja de responder la pregunta para la que fue construido. dev.utm elimina el paso humano de escritura justo en la parte del proceso donde la consistencia realmente importa.
Construir y leer enlaces desde un solo endpoint
Envíe POST a /dev/utm con una URL base y los campos de campaña (source, medium, nombre de campaña y, opcionalmente, term y content) para recibir una URL etiquetada y codificada correctamente; o envíe una URL ya etiquetada para que se analice y devuelva separada en sus parámetros individuales. La llamada devuelve un task_id de inmediato, y el resultado llega por webhook firmado o mediante un enlace firmado válido por 24 horas, así el mismo endpoint sirve tanto para generar enlaces nuevos como para auditar un lote de enlaces que alguien más ya creó.
Por qué cinco parámetros se volvieron el estándar de la industria
Los parámetros Urchin Traffic Monitor son anteriores a la plataforma de analítica con la que la mayoría de la gente los asocia hoy; se adoptaron temprano como una forma simple e independiente del proveedor de etiquetar una URL con el origen de un visitante, y la forma de cinco parámetros (source, medium, campaign, term, content) se ha mantenido en cada herramienta de analítica importante desde entonces porque encaja de forma natural con cómo los mercadólogos realmente piensan una campaña. Pero la convención solo funciona si los valores que entran se aplican de la misma manera cada vez, que es exactamente la parte que la escritura manual arruina.
Dónde elimina fricción en un flujo de marketing
Una herramienta de calendario de contenido puede generar un enlace etiquetado automáticamente en el momento en que se programa una publicación social, una plataforma de correo puede etiquetar cada enlace saliente de una campaña sin pedirle a un redactor que recuerde la convención de nombres, y un servicio acortador de enlaces puede validar que las URLs entrantes cumplan las reglas internas antes de que se publiquen. Como se cobra por solicitud sin compromiso mínimo, un equipo puede pasar cada enlace saliente por el endpoint como práctica habitual, en lugar de reservar la disciplina de UTM solo para las campañas que alguien recuerda etiquetar a mano.
Qué puede hacer con ella
Generación automática de enlaces de campaña
Una herramienta de programación de redes sociales construye una URL correctamente etiquetada para cada publicación programada, así el reporte semanal no requiere etiquetado manual de enlaces.
Auditoría de enlaces antes de un lanzamiento
Un equipo de operaciones de marketing analiza un lote de enlaces enviados por distintos colaboradores para detectar valores de source o medium inconsistentes antes de que la campaña salga en vivo.
Integración con plataforma de correo
Una herramienta de envío de correos etiqueta automáticamente cada enlace de una plantilla de boletín, así el rendimiento de la campaña se agrupa correctamente en la analítica.
Seguimiento de enlaces de afiliados y socios
Un programa de socios genera una URL etiquetada única por cada afiliado, así el tráfico de cada socio se atribuye correctamente sin depender de que el socio construya el enlace bien.
Preguntas frecuentes
¿Cómo construyo una URL con UTM usando la API?
Envíe la URL base y los campos de campaña por POST a /dev/utm, guarde el task_id devuelto y reciba la URL etiquetada por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API constructora de UTM?
No, no hay plan gratuito ni prueba; cuesta $0.002 por solicitud, y una solicitud fallida nunca se cobra.
¿Puede analizar un enlace UTM existente y separarlo en sus partes?
Sí, envíe una URL ya etiquetada y el endpoint devuelve los valores individuales de source, medium, campaign, term y content.
¿Impone una convención de nombres?
Construye y analiza parámetros UTM estándar de forma consistente; si su equipo tiene reglas propias de nombres, aplicarlas a través de un solo endpoint es lo que mantiene cada enlace uniforme.
¿Codifica la URL automáticamente?
Sí, los espacios y caracteres especiales en los valores de campaña se codifican correctamente para que la URL resultante sea válida en cualquier navegador o herramienta de analítica.
¿Puedo generar enlaces UTM por lote?
Sí, envíe una tarea asíncrona por URL y reciba cada resultado por webhook, lo cual sirve para generar de una vez los enlaces de todo un calendario de campañas.
¿Ya está disponible este endpoint?
Sí, /dev/utm está activo y aceptando solicitudes ahora mismo.
¿Se guardan las URLs que envío?
No, las URLs enviadas y generadas se eliminan después del período de retención y nunca se usan para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/dev/utm \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/dev/utm", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/utm",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/utm", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/utm", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"items": [
"valor-1",
"valor-2"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.utm",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |