Marketing - distribuidordeherramientases-wq/seo-taxonomy GitHub Wiki

Marketing

Ruta administrativa: SEO Taxonomy → Herramientas → Marketing

Marketing agrupa la gestión comercial del sitio. Las pestañas disponibles dependen de los módulos activos. Actualmente incluye, entre otras funciones, Campañas, Redes sociales / Programador y opciones de estilo visual.

Esta página documenta especialmente el flujo de Campañas, ampliado en la versión 2.3.8.1.

Campañas

Ruta: SEO Taxonomy → Herramientas → Marketing → Campañas

La pantalla clasifica las campañas en:

  • En curso
  • Próximas
  • Finalizadas
  • Deshabilitadas

Cada campaña muestra su nombre, edición, periodo, número de productos, tipo y recurrencia.

Crear una campaña

Nueva campaña crea una campaña nueva.

Campos:

  • Nombre
  • Edición
  • Tipo
    • Calendario comercial
    • Táctica / puntual
    • Producto estrella
  • Repetición
    • No recurrente
    • Anual
    • Nueva edición manual
  • Creatividad social
    • Diseño 1 · Tarjeta oscura
    • Diseño 2 · Oferta clara
    • Diseño 3 · Banner intenso
  • Inicio
  • Fin
  • Campaña habilitada

Al crearla se generan referencias internas estables:

  • campaign_key: identificador portable de la campaña.
  • series_key: identifica la serie a la que pertenece.

En campañas existentes ambos valores se muestran como solo lectura.

Editar una campaña

Guardar cambios actualiza la campaña existente.

Se pueden modificar nombre, edición, tipo, repetición, creatividad social, fechas y estado habilitado.

Si se cambian las fechas, el sistema comprueba que ninguno de sus productos solape con otra campaña habilitada.

Productos de la campaña

La tabla muestra:

  • producto;
  • SKU;
  • precio habitual;
  • oferta actual;
  • precio de campaña;
  • estado Aplicado;
  • casilla Quitar.

Guardar productos y precios

Guardar productos y precios actualiza el precio de campaña de cada producto y retira únicamente los marcados con Quitar.

Si un producto tenía la campaña aplicada, antes de retirarlo se intenta restaurar su oferta anterior.

Añadir productos

El catálogo no se carga completo para evitar una consulta masiva.

Utilizar Buscar por nombre o SKU, seleccionar uno o varios resultados e indicar Precio campaña.

Añadir seleccionados añade el producto o actualiza su precio si ya estaba asociado.

Los productos variables quedan fuera de esta versión del flujo.

Protección frente a solapamientos

Un producto no puede participar en dos campañas habilitadas cuyos periodos se solapen.

La validación se aplica tanto al añadir productos como al modificar fechas o importar información.

Imágenes de las tarjetas públicas

Las franjas públicas de campaña utilizan el mismo resolvedor compartido de imágenes que otras plantillas del catálogo.

Orden de resolución:

  1. imagen local de Media, si el producto dispone de una;
  2. imágenes externas activas del proveedor asociadas al producto;
  3. compatibilidad con el resolvedor externo de proveedor;
  4. logo/placeholder como último recurso.

Las imágenes externas se cargan directamente desde su URL de proveedor: no se descargan ni se copian automáticamente a Media. Esto permite mostrar productos cuyo catálogo gráfico se mantiene fuera del alojamiento local.

Si una URL externa falla en el navegador, la tarjeta intenta la siguiente imagen disponible del proveedor antes de caer al recurso de sustitución.

Importar / Exportar campañas

La versión 2.3.8.1 permite transportar la campaña completa, no solo el calendario.

Se admiten:

  • JSON como formato canónico;
  • CSV para revisión y edición externa.

Formato actual

Los registros se distinguen por record_type:

  • campaign
  • product

Columnas CSV actuales:

record_type
campaign_key
series_key
name
edition
campaign_type
social_creative_template
start_at
end_at
recurrence
enabled
product_id
sku
campaign_price
position

Ejemplo estructural:

record_type;campaign_key;series_key;name;edition;campaign_type;social_creative_template;start_at;end_at;recurrence;enabled;product_id;sku;campaign_price;position
campaign;otono-2026;otono;Otoño;2026;calendar;design_1;2026-10-01T00:00:00+02:00;2026-10-31T23:59:59+01:00;none;1;;;;
product;otono-2026;;;;;;;;;;12345;SKU-EJEMPLO;49.90;1

Los valores del ejemplo son ilustrativos.

Importar / actualizar

La importación realiza alta/actualización por campaign_key.

Por defecto trabaja en modo fusión:

  • crea campañas inexistentes;
  • actualiza campañas existentes;
  • añade productos;
  • actualiza precio y posición de productos ya asociados;
  • no elimina productos que falten en el archivo;
  • no elimina campañas que no aparezcan en el archivo.

Sustituir completamente los productos

La casilla Sustituir completamente los productos de las campañas incluidas convierte las filas de producto de cada campaña incluida en la lista definitiva.

En este modo, los productos asociados localmente que no aparezcan en el archivo se retiran de esa campaña.

Usar esta opción solo cuando el archivo sea deliberadamente completo.

Compatibilidad con archivos antiguos

El importador mantiene compatibilidad con los CSV/JSON anteriores que solo contenían calendario.

También reconoce archivos antiguos de productos sin record_type:

  • si encuentra datos como product_id, SKU o campaign_price y no hay datos obligatorios de campaña, interpreta la fila como producto;
  • en caso contrario la interpreta como campaña.

Para resolver el producto utiliza:

  1. product_id;
  2. SKU como respaldo.

Crear nueva edición

Crear nueva edición (+1 año) crea otra campaña de la misma serie desplazada un año.

Conserva la identidad de serie, pero crea otro ID y otra campaign_key.

No copia productos ni precios.

La nueva edición debe completarse de forma independiente.

Vaciar productos

Vaciar productos elimina todos los productos asociados, pero conserva:

  • la campaña;
  • nombre;
  • edición;
  • tipo;
  • fechas;
  • configuración social.

Antes de eliminar una relación cuyo precio siga aplicado, se intenta restaurar la oferta anterior del producto.

La interfaz solicita confirmación.

Eliminar campaña

Eliminar campaña elimina definitivamente la campaña.

El proceso seguro es:

  1. cancelar las acciones programadas de aplicación y restauración;
  2. localizar los productos asociados;
  3. restaurar los precios que todavía tengan la campaña aplicada;
  4. eliminar las relaciones campaña-producto;
  5. eliminar la campaña.

La interfaz solicita confirmación antes de ejecutar el borrado.

Una campaña finalizada legítima puede conservarse como histórico comercial. El borrado está pensado principalmente para pruebas, errores o campañas creadas accidentalmente.

Aplicación y restauración automática de precios

Cuando una campaña habilitada entra en vigor, el sistema aplica a cada producto:

  • precio de campaña;
  • fecha de inicio;
  • fecha de finalización.

Antes guarda una instantánea de:

  • oferta anterior;
  • fecha de inicio anterior;
  • fecha de finalización anterior.

Cuando termina o se deshabilita la campaña, intenta restaurar esos valores.

Protección de cambios manuales

Si alguien modifica manualmente la oferta mientras la campaña está activa y el precio actual ya no coincide con el precio de campaña, la restauración automática no pisa ese cambio manual.

Flujo recomendado

Para una campaña normal:

  1. definir fechas y tipo;
  2. seleccionar productos a partir de criterios comerciales;
  3. fijar precios de campaña;
  4. importar en modo fusión;
  5. revisar productos y precios;
  6. exportar una copia si se necesita trazabilidad;
  7. probar primero en STAGING cuando el cambio sea masivo;
  8. promover a producción tras validar;
  9. conservar las campañas finalizadas como histórico salvo que exista un motivo para borrarlas.

Relación con otros módulos

Las campañas pueden alimentar o integrarse con:

  • Redes sociales / Programador, para publicaciones comerciales;
  • Analista, para propuestas basadas en señales internas y demanda;
  • Ojeador, como fuente de información de competitividad y mercado;
  • feeds comerciales, mediante el precio de oferta y su periodo de vigencia;
  • plantillas públicas de campaña en la tienda.

La selección de productos y precios sigue siendo una decisión comercial; el módulo se encarga de almacenar, programar, aplicar y restaurar la campaña.

Manual operativo

Ruta: TaxoCommerce SEO → Herramientas → Marketing

Pestañas

Marketing, Campañas, Informes, Identidad / Cabecera, Redes sociales, Sitemaps, Estilo visual.

Marketing

Gestiona asignaciones editoriales por Cluster. Puede mostrar Asignar todas las categorías favoritas, selectores jerárquicos, Guardar selección y Asignar automáticamente. Las acciones de asignación modifican relaciones.

Campañas

Permite importar/exportar el calendario, crear o editar campañas y asociar productos.

Campos habituales: Nombre, Identificador, Serie, Edición, Tipo, Repetición, Creatividad social, Inicio, Fin y checkbox Campaña habilitada. Guardar campaña persiste. Crear nueva edición (+1 año) crea otra edición.

En productos: buscador por nombre/SKU, checkboxes, Precio campaña, Añadir seleccionados, Guardar productos y precios y Quitar.

Exportaciones: JSON y CSV. La importación modifica el calendario tras seleccionar archivo.

Identidad / Cabecera

Campos: Título del sitio, Descripción corta, Título SEO de portada, Meta description. Controles de medios: Subir o elegir en Medios, Quitar. Guardar identidad y SEO afecta a la configuración pública.

Redes sociales

Subpestañas: Plantillas, Automatización, Programador, Conexiones, Informes.

Plantillas

Define formato por red y tipo de contenido. Guardar plantillas persiste.

Automatización

Checkboxes para tipos de contenido y redes de destino. Guardar automatización guarda la regla. Solo actúa cuando el contenido entra en el estado previsto.

Programador

CSV: Validar CSV antes de importar, Descargar plantilla CSV, Exportar contenidos, Exportar agenda, Exportar historial e Importar programaciones tras validar.

Reglas horarias:

  • ofertas de campaña: 18:00;
  • entradas de la categoría Noticias: 20:00;
  • resto de entradas y páginas/landings: 22:00.

La franja de las 22:00 es una cola editorial compartida por red: admite como máximo una pieza al día y alterna entradas y páginas/landings cuando hay contenido de ambos tipos. Si solo queda un tipo disponible, continúa con ese tipo.

En las filas de Noticias aparece la casilla Prioritaria. Las prioritarias ocupan primero los huecos futuros de Noticias de cada red y adelantan a las no prioritarias, que se desplazan detrás. Ofertas y Noticias pueden convivir el mismo día.

El CSV admite la columna opcional prioridad (si, 1, true, prioritaria). La hora se normaliza automáticamente según el tipo: 20:00 para Noticias y 22:00 para el resto de entradas y páginas/landings.

Filtros: Tipo y búsqueda. Cada fila permite elegir redes con checkboxes, fecha/hora, Programar, Publicar ahora y cancelar programaciones.

Las ofertas de campañas usan una regla comercial propia: se programan automáticamente a las 18:00. Noticias y la cola editorial de las 22:00 no bloquean la oferta. Se mantiene como límite una oferta de campaña por día y por red; si ese día ya contiene otra oferta, se utiliza el siguiente día disponible dentro del periodo de campaña.

La automatización al publicar contenido en WordPress respeta las mismas franjas: Noticias entran en la cola de las 20:00 y el resto de entradas/páginas en la cola de las 22:00, en lugar de enviarse inmediatamente a la red social.

Conexiones

Tarjeta por proveedor con estado Conectado/Sin conectar. Las credenciales se detallan en Conexiones y credenciales.

Informes

Métricas de publicación y botón Actualizar métricas cuando la API lo permite.

Sitemaps

Regenerar y validar sitemaps, Actualizar inventario, Escanear sitemap completo, Test de carga seguro, Parar proceso. Tabla de XML/URLs/auditadas/OK/avisos/errores/cobertura/tamaño/modificado y estado del Runner GitHub.

Estilo visual

Secciones: Colores, Tipografía, Componentes, Productos, Carrito, Checkout, Soluciones, FAQs, Navegación y Pie.

Checkboxes visibles incluyen color personalizado en enlaces/negritas, colores propios de botones de carrito/checkout e indicador de submenú.

Acciones: Guardar y publicar estilo, Importar configuración JSON, Importar y publicar, Restaurar diseño original, Restaurar valores predeterminados. La previsualización permite revisar página, carrito y checkout.

Informes

La pestaña Informes dispone de dos vistas:

  • Campañas: visitas de franja y redes, interacción, pedidos/facturación atribuidos y ventas observadas de los productos durante las fechas.
  • Redes sociales: publicaciones, visitas web, interacción, pedidos, facturación y conversión por red y publicación.

La atribución es de última interacción válida con ventana de 30 días y se guarda en metadatos privados del pedido. No se almacenan datos personales adicionales para este informe.