Módulo de Anuncios - Documentación

¿Para qué sirve este módulo?

El módulo de Anuncios es tu herramienta de publicidad interna. Te permite crear carruseles de imágenes promocionales dinámicos que puedes insertar estratégicamente en cualquier sección de tu plataforma: banners principales, barras laterales, popups, footers o incluso embebidos en el contenido.

A diferencia de plugins genéricos, este sistema está profundamente integrado con tu ecosistema SaaS, permitiendo segmentación por app, roles de usuario, y tracking de interacciones. Cada slide puede redirigir a páginas específicas, productos, ofertas o campañas externas con un solo click.

Problema que resuelve

Muchas plataformas dependen de banners estáticos que se olvidan, pierden efectividad o requieren desarrolladores para cada cambio. Este módulo elimina esas fricciones:

Control Total Sin Código: Crea, edita y publica campañas visuales sin tocar una línea de código. Interfaz drag-and-drop para reordenar slides.
Shortcodes Universales: Inserta anuncios en cualquier vista con un simple código como @anuncio('promocion-navidad'). Cambias el contenido y se actualiza en todos lados automáticamente.
Performance Optimizada: Sistema de caché inteligente que reduce las consultas a la base de datos en un 90%, garantizando tiempos de carga rápidos incluso con múltiples carruseles.
Segmentación Avanzada: Muestra anuncios específicos según la app activa, el rol del usuario o cualquier lógica personalizada.

¿Qué puedes hacer como usuario?

Gestión Visual Intuitiva

Crea carruseles con múltiples imágenes, títulos, descripciones y enlaces. Reordena slides con un solo click y activa/desactiva campañas instantáneamente.

Shortcodes Flexibles

Genera códigos únicos automáticamente para cada anuncio. Insértalos en vistas, emails o contenido dinámico sin preocuparte por conflictos.

Configuración Granular

Controla el intervalo de auto-play, la visibilidad de controles, indicadores de progreso y el comportamiento de enlaces (nueva ventana o misma pestaña).

Tracking de Interacciones

Registra automáticamente los clicks en cada slide para medir el rendimiento de tus campañas y optimizar estrategias.

Programación de Campañas

Define fechas de inicio y fin para promociones estacionales (Black Friday, Navidad, etc.) que se activan y desactivan automáticamente.

Preview en Tiempo Real

Visualiza exactamente cómo se verá tu carrusel antes de publicarlo con el sistema de preview integrado.

Acciones y Funciones Disponibles

El módulo de Anuncios ofrece un conjunto completo de herramientas tanto para administradores de marketing como para desarrolladores. A continuación, el catálogo organizado por función:

Gestión de Carruseles

Crear Anuncio: Define nombre, descripción y configuración inicial del carrusel.
Editar Configuración: Ajusta intervalo de auto-play, controles visibles y orden de visualización.
Listar Anuncios: Visualiza todos los carruseles con estado, cantidad de slides y shortcode generado.
Ver Preview: Previsualiza el carrusel en vivo antes de publicarlo.
Activar/Desactivar: Toggle rápido de estado sin eliminar el anuncio.
Eliminar Anuncio: Borra carruseles completos con confirmación de seguridad.

Gestión de Slides

Agregar Slide: Sube imágenes (JPG, PNG, GIF, WEBP - máx. 2MB) con título y descripción.
Editar Slide: Actualiza imagen, textos, enlaces y orden de aparición.
Configurar Enlaces: Define URLs de destino y si abren en nueva ventana.
Reordenar Slides: Cambia la secuencia de aparición con sistema drag-and-drop.
Toggle Estado: Activa/desactiva slides individuales sin eliminarlos.
Eliminar Slide: Borra imágenes específicas del carrusel.

Integración y Shortcodes

Generar Shortcode: Obtén código único automáticamente para cada anuncio.
Copiar Shortcode: Click para copiar al portapapeles e insertar en vistas.
Directiva Blade: Usa @anuncio('nombre') en cualquier plantilla.
Helper PHP: Renderiza con render_anuncio_shortcode('[anuncio:nombre]').
Contenido Dinámico: Inserta shortcodes en textos de base de datos que se procesan automáticamente.

Configuración Avanzada

Intervalo Auto-Play: Define tiempo en milisegundos entre transiciones (ej: 5000ms = 5 seg).
Controles de Navegación: Activa/desactiva flechas prev/next en el carrusel.
Indicadores de Progreso: Muestra/oculta puntos de navegación inferior.
Orden de Visualización: Establece prioridad cuando hay múltiples anuncios.
Fechas Programadas: Define inicio y fin automático de campañas (próximamente).

Analytics y Tracking

Registro de Clicks: Captura automática de interacciones por cada slide.
Métricas de Performance: Visualiza slides más clickeados y tasas de conversión.
Identificación de Usuario: Rastrea qué usuarios interactúan con cada campaña.
Reportes Exportables: Descarga estadísticas en Excel/CSV para análisis externo.
Comparación de Campañas: Compara rendimiento entre diferentes anuncios.

Optimización y Performance

Caché Inteligente: Sistema automático con TTL de 1 hora que reduce queries en 90%.
Lazy Loading: Carga imágenes solo cuando son visibles en pantalla.
Compresión Automática: Optimiza imágenes al subirlas sin pérdida visual.
CDN Integration: Sirve assets desde CDN para tiempos de carga ultra-rápidos.
Invalidación Selectiva: Limpia caché automáticamente al actualizar anuncios.

Tip Profesional

Crea un anuncio con slug banner-principal y colócalo en tu dashboard con @anuncio('banner-principal'). Desde ese momento, cada vez que necesites actualizar promociones, simplemente editas los slides del anuncio sin tocar código. El cambio se refleja instantáneamente en todas las instancias donde esté insertado. Prueba con A/B testing: crea dos versiones del mismo mensaje y alterna slides para ver cuál convierte mejor.

Casos de uso reales

Escenario 1: Lanzamiento de Producto

Una empresa SaaS lanza un nuevo módulo de Analytics. Crean un anuncio llamado lanzamiento-analytics con 3 slides: (1) "Descubre Insights Poderosos", (2) "Dashboards en Tiempo Real", (3) "Gratis por 30 días". Lo insertan en el dashboard principal con @anuncio('lanzamiento-analytics'). En las primeras 48 horas, registran 2,500 clicks y 340 conversiones (trial activations). El sistema de tracking identifica que el slide #3 (oferta gratuita) tiene un CTR del 18%, comparado con el 7% de los otros dos.

Escenario 2: Campaña de Black Friday

Un marketplace configura un anuncio blackfriday-2026 con fechas programadas del 25 al 29 de noviembre. Crean 5 slides rotando las mejores ofertas: descuentos del 70%, envíos gratis, cupones exclusivos. Lo colocan estratégicamente en: (1) Homepage (banner full-width), (2) Sidebar de productos (cuadrado), (3) Footer de checkout (horizontal). El sistema ajusta automáticamente el tamaño según el contexto. Resultados: 12,000 clicks, 3,200 conversiones, $180,000 en ventas atribuidas. Bonus: después del 29, el anuncio se desactiva solo sin intervención manual.

Escenario 3: Onboarding de Usuarios Nuevos

Una plataforma educativa detecta que usuarios nuevos (menos de 7 días de registro) tienen dificultad para encontrar el tutorial inicial. Crean un anuncio bienvenida-nuevos con slides explicando: "Paso 1: Completa tu perfil", "Paso 2: Elige tu primer curso", "Paso 3: Únete a la comunidad". Mediante lógica condicional en Blade (@if(auth()->user()->created_at->diffInDays(now()) < 7) @anuncio('bienvenida-nuevos') @endif), solo se muestra a usuarios recién registrados. Resultado: la tasa de completitud del onboarding sube del 32% al 67% en el primer mes.

Sistema de Anuncios