Gestión de imágenes en el servidor de DANAconnect: buenas prácticas de nombres y organización

Objetivo: evitar confusiones y envíos incorrectos de imágenes mediante una convención clara de nombres y una organización consistente en el servidor de imágenes de DANAconnect.

Resumen rápido

• Usa nombres únicos y descriptivos. Ej.: header_newsletter_agosto_2025.png, logo_dana_2025.png.
• Evita numeraciones genéricas y caracteres raros: Header (1).png, Banner_final_v2_DEF(OK).jpg.
• Organiza por conversación/campaña y por fecha cuando aplique.
• No sobrescribas archivos ya utilizados en producción. Versiona: v1, v2 o fecha.
• Para cambios urgentes, cambia el nombre del archivo y actualiza la referencia en la comunicación para evitar caché.

Antes de empezar

• Define una convención de nombres para tu equipo y úsala siempre.
• Prepara un registro interno (sheet o doc) con nombre del archivo, campaña, autor, fecha y URL.
• Siempre intenta utilizar archivos png para tus imágenes.

Paso 1: Define una convención de nombres estable

1. Estructura recomendada:

{tipo}{proyecto/campaña}{detalleOpcional}_{aaaa-mm-dd|vN}.{ext}

• tipo: header, logo, banner, icon, bg.
• proyecto/campaña: newsletter_agosto_2025, onboarding, promo_back2school.
• detalleOpcional: es, mobile, retina, dark, etc.
• aaaa-mm-dd|vN: fecha o versión (v1, v2).
• ext: png.

2. Reglas simples:

• Minúsculas, guiones bajos o medios.
• Sin espacios ni paréntesis.
• Nada de acentos ni caracteres especiales.

Ejemplos correctos

• header_newsletter_agosto_2025.png
• logo_dana_2025.png
• banner_onboarding_mobile_.png
• icon_pago_dark_2025-08-15.png

Ejemplos a evitar

• Header (1).png
• Header(2).png
• BANNER FINAL DEFINITIVO OK (1).png
• logo-dana-último!.png

Paso 2: Organiza por conversación/campaña

• Crea una carpeta o categoría lógica por conversación/campaña.
• Dentro, separa por canal o formato si lo necesitas (email, landing).
• Mantén una tabla de mapeo: nombre del archivo → pieza donde se usa.

Sugerencia: añade la fecha de envío o el ID de conversación en el nombre cuando la campaña sea recurrente.

Paso 3: Sube con nombres únicos y consistentes

• Antes de subir, confirma que no existe un nombre idéntico.
• Si es un reemplazo funcional de una imagen ya usada en producción, no sobrescribas: crea una nueva versión (v2) y actualiza el enlace en la comunicación.

Paso 4: Versiona cambios y evita la caché

• Cambios urgentes o de último minuto: publica con nombre nuevo.
• Ej.: header_newsletter_agosto_2025_v2.png.
• Actualiza la referencia en la pieza. Esto previene que la red de entrega use una imagen antigua en caché.

Paso 5: Verifica antes de enviar

• Previsualiza la comunicación y valida:
• ¿La imagen cargó donde debe?
• ¿El nombre coincide con la versión esperada?
• ¿El peso y dimensiones son correctos para el canal?

Recomendaciones técnicas

• Formatos: usa PNG.
• Dimensiones y peso: ajusta al tamaño real de uso, evita megapíxeles inútiles.
• Accesibilidad: mantén textos alternativos coherentes donde aplique.
• Cohesión visual: versiona por variantes (_dark, _mobile) en lugar de nombres vagos.

Qué no hacer

• No uses Header (1).png, Header(2).png, banner_final_def_ok.png.
• No reutilices el mismo nombre para archivos distintos.
• No sobrescribas una imagen ya publicada en una campaña activa.
• No mezcles idiomas y acentos al azar en los nombres.
• No subas imágenes gigantes para usos pequeños.

Ejemplos prácticos

Malas prácticas

• Header (1).png
• header.png
• banner_final_def_OK(3).jpg

Buenas prácticas

• header_newsletter_agosto_2025.png
• logo_dana_2025.svg
• banner_onboarding_mobile_v1.webp
• header_registro_evento_2025-08-15_v3.png

Preguntas frecuentes

¿Qué pasa si repito el nombre del archivo?

Puedes provocar que se envíe una imagen equivocada o que se sirva en caché la versión anterior. Usa un nombre nuevo.

¿Cómo versiono mejor: fecha o v1/v2?

Ambos sirven. Si hay múltiples cambios en un día, usa vN. Si hay hitos fechados, agrega aaaa-mm-dd.

Actualizado el: 15/08/2025