El cargador lee dos columnas del archivo: la dirección y el alias que quieras. Todo lo demás —grupo, etiquetas, parámetros UTM— se define una sola vez para todo el lote en el formulario, no fila por fila.
Eso es lo primero que conviene saber antes de montar el archivo. De ahí salen el formato, los límites y la mitad de los motivos por los que después se caen filas.
A continuación: cómo armar un archivo que pase entero, qué hacer cuando cada enlace necesita parámetros distintos, cuántas filas entran de una vez y cómo leer el informe cuando algunos enlaces no se crean.
Qué archivo acepta el cargador
Sirve un CSV o un archivo de texto corriente. El análisis es tolerante, y un par de detalles te ahorran trabajo.
El separador se detecta solo. El cargador mira la primera línea y elige entre coma, punto y coma o tabulador el que aparezca más veces. Esto importa porque Excel en español guarda el CSV con punto y coma, y ese archivo no hay que rehacerlo. Una exportación de Google Sheets con comas vale igual, y también una columna copiada directamente de una hoja de cálculo, que llega separada por tabuladores.
La fila de encabezado es opcional. Si la primera línea empieza por url, alias o link, se considera encabezado y no entra en el lote. Sin encabezado, la primera columna es la dirección y la segunda el alias.
Una sola columna está bien. Una lista de direcciones, una por línea, sin separador alguno, se acepta tal cual.
url;alias
https://example.com/catalogo/rebajas/zapatos-2026;zapatos
https://example.com/catalogo/rebajas/bolsos-2026;bolsos
https://example.com/catalogo/rebajas/abrigos-2026
Una dirección que contenga una coma hay que ponerla entre comillas. Es el comportamiento normal del CSV, pero es justo donde tropiezan las exportaciones con parámetros:
"https://example.com/buscar?tags=rebajas,nuevo";rebajas-nuevo
Sin las comillas la fila se parte en esa coma y un trozo de la dirección acaba en el alias. Una comilla doblada dentro de un valor ("") significa una comilla literal; otra vez, CSV estándar.
Las líneas vacías se omiten, así que no hace falta limpiar los saltos de línea del final del archivo.
Los alias se pueden dejar vacíos de forma selectiva: el tercer enlace del ejemplo no tiene ninguno y se le generará un código. Mezclar filas con alias y sin alias está permitido.
Cuando cada enlace necesita parámetros distintos
Grupo, etiquetas y parámetros UTM se aplican a todo el lote de golpe. Es cómodo cuando subes un catálogo o un envío, y se convierte en limitación en cuanto la lista abarca varias campañas.
Dos soluciones que funcionan.
Meter los parámetros dentro de las direcciones. Las etiquetas UTM son parámetros de consulta normales, así que pueden variar en cada fila si los añades en las direcciones mismas:
url
https://example.com/a?utm_source=newsletter&utm_campaign=junio
https://example.com/b?utm_source=telegram&utm_campaign=junio
Armar esa columna en una hoja de cálculo es una fórmula de concatenación. Si los parámetros UTM no te resultan familiares, en el blog hay una guía aparte sobre cómo etiquetar campañas.
Dividir en varios lotes. Un lote por campaña: cada uno con sus etiquetas y su grupo, y después puedes leer las estadísticas por grupo en vez de desmenuzar una lista larga. Esta vía suele quedar más limpia cuando las campañas son pocas.
Cuántos enlaces entran de una vez
Hay tres límites, y son de naturaleza distinta.
| Cuántos | |
|---|---|
| Filas en una carga | 1000 |
| Cargas simultáneas | 3 |
| Enlaces en una petición a la API | 100 |
Si el archivo tiene más de mil filas, divídelo: las filas que sobren simplemente no entrarán en la carga. Tres cargas simultáneas es un techo sobre trabajos sin terminar, no una cuota diaria: en cuanto uno acaba, puedes lanzar el siguiente.
El volumen mensual es otro asunto y depende del plan. En el plan gratuito el acortamiento masivo no está disponible. Pro permite 100 enlaces al mes, suficiente para probarlo con una lista real y ver si necesitas el volumen. Premium no tiene tope mensual, pero sí un techo diario de 30 000 enlaces.
Por qué algunas filas no se crean
Una fila mala no cancela el lote. La carga llega hasta el final y cada fila lleva su propio resultado. Hay tres estados, y distinguirlos sirve porque se arreglan de maneras diferentes.
Rechazada en la validación. La fila no pasó las comprobaciones, y eso se ve justo después de analizar el archivo, antes de acortar nada. Normalmente una dirección mal formada, un alias demasiado largo, o basura donde debería haber una URL.
No creada. La fila era correcta, pero el enlace no salió; por ejemplo, el alias pedido ya estaba ocupado.
Creada. Listo: el enlace corto está junto a la fila.
Causas habituales y qué hacer con ellas:
| Qué se ve | Qué ocurre | Qué hacer |
|---|---|---|
| Fila rechazada, la dirección parece correcta | falta el esquema: example.com en vez de https://example.com |
añadir https:// con una fórmula a toda la columna |
| Se rechaza una fila de cada dos | direcciones con comas sin comillas | poner comillas o guardar el archivo con punto y coma |
| En el alias apareció un trozo del enlace | misma causa: la fila se partió en el separador | lo mismo |
| Alias cortado | alias más largo de lo permitido | acortar a 10 caracteres |
| No creada, alias ocupado | ese código ya existe | cambiar el alias o dejar el campo vacío |
| Se cargaron menos filas de las que tiene el archivo | el archivo pasa de 1000 filas | dividir el archivo |
Una costumbre que conviene adquirir: pasa primero las diez primeras filas del archivo. Un problema sistemático de la exportación —esquema equivocado, separador equivocado, una columna de más— se manifiesta en diez filas igual que en mil, y se desenreda mucho antes.
Si la lista la genera un programa
Cuando los enlaces los prepara tu código y no una persona con una hoja de cálculo, existe un método por lotes en la API: hasta 100 enlaces en una petición, con respuesta por elemento y el mismo reparto entre creados, no creados y rechazados.
Aquí hay un detalle poco evidente con el que es fácil darse. Un lote gasta límite de peticiones por enlace, no como una sola petición. Un lote de 100 enlaces consume 100 unidades. De lo contrario el método por lotes se convertiría en una forma de saltarse el límite de frecuencia, y un cliente podría crear miles de enlaces por minuto. Si el límite restante no cubre el lote completo, la petición se rechaza entera y no se crea nada, así que conviene comprobar el resto antes de enviar, no después.
Los parámetros comunes funcionan igual que en el formulario: el bloque defaults se fusiona con cada fila y los campos de la propia fila lo sobrescriben. Un valor vacío en la fila significa «sin especificar», así que se toma el de defaults, exactamente como una celda vacía en una exportación. El endpoint y el esquema de respuesta están descritos en la documentación de la API.
Qué hacer con la lista terminada
Los enlaces cortos de un lote no se diferencian en nada de los creados uno a uno: cada uno tiene sus estadísticas de clics, su geografía y sus fuentes. Si asignaste un grupo común al lote, leer las estadísticas por ese grupo resulta cómodo: muestra cómo rindió el catálogo entero o el envío entero como unidad.
Dos pasos que se amortizan justamente en listas grandes:
- tu propio dominio. En un lote de mil enlaces el nombre de dominio se cruza con el lector mil veces, y eso es una parte visible del aspecto de un envío. Cómo conectarlo y qué cambia está en el artículo sobre dominios personalizados;
- etiquetar antes de subir, no después. Cambiar los parámetros UTM de mil enlaces ya creados cuesta más que montar antes una columna etiquetada en la hoja de cálculo. La lógica general de etiquetado de campañas está en el texto sobre enlaces cortos en marketing.
En resumen
Monta un archivo de una o dos columnas, con las direcciones llevando el esquema https:// y los valores con comas entre comillas. Define los parámetros comunes en el lote; los que varíen, mételos en las direcciones o repártelos en varias cargas. Prueba con diez filas, luego sube el resto y lee el informe fila por fila.
La sección en sí y el orden paso a paso están en la página del acortador masivo de enlaces; la carga masiva está disponible en los planes de pago, así que para el primer lote hará falta una cuenta Pro o superior.
