Valide convenciones de nombres de campañas UTM
Compruebe un nombre como summer-sale-q3 contra la convención de nombres que eligió su equipo y vea qué reglas se cumplen y cuáles fallan, para que una mayúscula o un espacio no partan sus informes en dos. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Nombre de la campaña
- summer-sale-q3
- Patrón
- lowercase-hyphenated-by-quarter
- Esperado
- lowercase hyphenated text ending in q1, q2, q3, or q4
Un nombre de campaña UTM coherente mantiene los informes analíticos fáciles de buscar, comparar y administrar. Este validador comprueba un nombre con la convención que usted seleccione y explica qué reglas se cumplen o fallan. Elija un patrón compatible para nombres en minúsculas con guiones, sufijos trimestrales, guiones bajos, mayúsculas o identificadores alfanuméricos compactos. El resultado es determinista: el mismo nombre y patrón siempre generan la misma respuesta. Úselo antes de publicar un enlace, durante una revisión o como control de un flujo automatizado.
Elija una convención acorde con su sistema de informes
Una convención solo resulta útil cuando todos pueden aplicarla sin conjeturas. Seleccione el patrón compatible que refleje la norma documentada de su equipo. lowercase-hyphenated acepta nombres como spring-launch y partner-webinar-2026, pero rechaza espacios, guiones bajos, mayúsculas, separadores dobles y puntuación. Use lowercase-hyphenated-by-quarter cuando el nombre deba terminar en q1, q2, q3 o q4, como summer-sale-q3.
La opción de mayúsculas sirve para taxonomías como EMEA-PRODUCT-Q4, mientras que alphanumeric no permite separadores. Indicar el patrón es obligatorio porque un nombre aislado no puede juzgarse: summer-sale y SUMMER-SALE pueden ser correctos bajo normas distintas. Incluya el patrón elegido en el briefing, generador o formulario para que todos revisen el mismo estándar escrito.
Así evita que un valor predeterminado silencioso apruebe nombres con una convención que su equipo nunca pretendió utilizar.
Interprete el resultado y corrija los fallos
La respuesta contiene el nombre enviado, el patrón normalizado, un indicador general de validez, una lista de comprobaciones, las infracciones y una descripción breve del formato esperado. Un resultado válido significa que el nombre completo satisface todos los requisitos. Un resultado falso ofrece más información que un rechazo genérico.
Por ejemplo, Summer-Sale-Q3 frente a lowercase-hyphenated-by-quarter falla en minúsculas y en el sufijo trimestral, porque se exige una q minúscula. Un nombre con espacios incumple el separador y uno terminado en q5 queda fuera del intervalo permitido. Use violations para mensajes breves o decisiones automáticas y checks para mostrar reglas aprobadas y fallidas.
El validador elimina espacios exteriores, pero no reescribe el nombre ni propone sustituciones. Esto protege los identificadores analíticos frente a cambios no revisados. Corrija el valor original, valide de nuevo y publique únicamente cuando valid sea true.
Si falta el patrón, está vacío o no se admite, la solicitud devuelve un error de entrada en vez de aplicar una convención implícita.
Valide antes de que los enlaces empiecen a circular
El mejor momento para validar un nombre UTM es justo antes de generar o aprobar la URL de seguimiento. En un formulario, ejecute la comprobación al salir del campo y muestre junto a él las reglas fallidas. En una canalización de publicación, trate valid false como un fallo de revisión antes de copiar enlaces en anuncios, boletines, redes sociales, códigos QR o materiales de socios.
Guarde el patrón junto con las normas internas para reproducir la decisión. El servicio realiza comprobaciones locales acotadas, sin red, azar ni reglas temporales, por lo que ofrece resultados estables. Solo valida el componente de campaña: no crea URLs, comprueba destinos ni evalúa la estrategia de la taxonomía.
Qué puede hacer con ella
Revise un lanzamiento trimestral
Exija un sufijo q1 a q4 en minúsculas para agrupar correctamente los informes por trimestre.
Controle un flujo automatizado
Valide identificadores generados antes de distribuir URLs en anuncios, correo, redes o socios.
Preguntas frecuentes
¿Qué patrones se admiten?
Se admiten lowercase-hyphenated-by-quarter, lowercase-hyphenated, lowercase-underscore-separated, uppercase-hyphenated y alphanumeric.
¿El validador corrige un nombre inválido?
No. Informa de las reglas incumplidas sin cambiar silenciosamente un identificador que puede requerir aprobación.
¿Los sufijos trimestrales distinguen mayúsculas?
Sí. La convención trimestral exige una q minúscula final seguida de 1, 2, 3 o 4.
¿Por qué hay que elegir una convención antes de validar?
Porque un nombre no se puede juzgar solo: summer-sale y SUMMER-SALE pueden ser correctos según reglas distintas. Al exigir la convención, ningún criterio por defecto aprueba en silencio un nombre con una norma que su equipo nunca quiso usar.
¿Por qué conviene validar el nombre antes de compartir el enlace?
Porque cambiar el nombre de campaña después de distribuir los enlaces divide las mediciones en valores separados. Incluso una simple diferencia de mayúsculas crea otra fila en los informes, así que el mejor momento para revisarlo es justo antes de crear el enlace de seguimiento.
Herramientas relacionadas
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, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/seo/utm-campaign-name-validate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}'const res = await fetch("https://api.kit.forhosting.com/seo/utm-campaign-name-validate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"campaign_name": "summer-sale-q3",
"pattern": "lowercase-hyphenated-by-quarter"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/utm-campaign-name-validate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"campaign_name": "summer-sale-q3",
"pattern": "lowercase-hyphenated-by-quarter"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/utm-campaign-name-validate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/utm-campaign-name-validate", 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
{
"campaign_name": "summer-sale-q3",
"pattern": "lowercase-hyphenated-by-quarter"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.utm_campaign_name_validate",
"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. |
Notas técnicas
Elija una convención acorde con su sistema de informes
Para identificadores de estilo snake, lowercase-underscore-separated admite lifecycle_email_q2.
Valide antes de que los enlaces empiecen a circular
En una hoja de cálculo o proceso masivo, llame a la API por cada nombre y devuelva las filas inválidas a sus responsables. La validación temprana importa porque cambiar utm_campaign después de distribuirlo fragmenta las mediciones; incluso una diferencia de mayúsculas puede crear otra fila. El navegador sirve para revisiones manuales y cada solicitud API cuesta $0.002.
Casos de integración
Proteja un formulario de campañas
Rechace valores utm_campaign incoherentes antes de publicar o exportar un enlace de seguimiento.
Preguntas técnicas
¿Qué ocurre si omito el patrón?
La solicitud devuelve un error invalid_input porque la validación exige una convención explícita.
¿Cuánto cuesta una validación por API?
Cada solicitud API cuesta $0.002. También puede usar el navegador para una comprobación manual rápida.