Probador Virtual con IA para Shopware 6 — Guía
Instala y configura el módulo de prueba virtual con IA para Shopware 6: Google Cloud, Vertex AI, RGPD y resolución de problemas.
Este módulo añade un widget de prueba virtual a las páginas de producto de Shopware 6. El cliente añade una foto de sí mismo y Google Vertex AI genera una vista previa de la prenda puesta. Compatible con Shopware 6.5, 6.6 y 6.7.
Cómo funciona
El widget aparece en la página de producto, bajo el botón de compra. El cliente sube una foto (o la toma con la cámara en móvil). La foto se reduce en el navegador y se envía a tu servidor. El servidor recupera la imagen del producto, llama a la API de Google Vertex AI (modelo virtual-try-on-001) y devuelve la vista previa generada.
Es un render generativo, no una prueba de realidad aumentada en tiempo real. Cada vista previa es una llamada a la API que devuelve una imagen en unos segundos.
Requisitos de Google Cloud
El módulo se basa en Vertex AI. Se necesita una configuración única en Google Cloud.
1. Crear un proyecto y activar la facturación
- Crea o selecciona un proyecto en la consola de Google Cloud.
- Activa la facturación en el proyecto (obligatorio para Vertex AI).
2. Activar la API de Vertex AI
Activa la API de Vertex AI (aiplatform.googleapis.com) para el proyecto.
3. Crear una cuenta de servicio
- Crea una cuenta de servicio.
- Asígnale el rol Vertex AI User (roles/aiplatform.user).
- Crea una clave JSON y descárgala.
Instalación
Instala el módulo como cualquier extensión de Shopware (sube el ZIP en Extensiones y luego Mis extensiones, o coloca la carpeta en custom/plugins/DfVirtualTryOn), y después desde la línea de comandos:
bin/console plugin:refresh
bin/console plugin:install --activate DfVirtualTryOn
bin/console cache:clearNo se necesita compilar el storefront: el widget es autónomo, con estilos y JavaScript incluidos.
Configuración
En la administración de Shopware, abre la configuración del módulo y completa:
- ID del proyecto de Google Cloud: el identificador de tu proyecto.
- Región: una región donde el modelo esté disponible (us-central1 por defecto).
- Modelo: virtual-try-on-001 (recomendado).
- Clave JSON de la cuenta de servicio: pega el archivo JSON descargado completo.
- Número de imágenes: de 1 a 4 vistas previas por prueba.
- Exigir consentimiento: activado por defecto, recomendado.
- URL de la política de privacidad: se muestra en el aviso de consentimiento.
- Etiqueta del botón: opcional, sustituye el texto traducido por defecto.
La región importa: el modelo no está disponible en todas partes. Si eliges una región que no lo aloja, las llamadas fallan con un error de «modelo no encontrado». En caso de duda, usa us-central1.
Privacidad y RGPD
Las fotos de los clientes son datos personales. Este módulo envía la foto solo a Google Vertex AI para generar la vista previa, no almacena la foto ni el resultado en tu servidor, puede exigir un consentimiento explícito antes de cada generación, y permite enlazar tu política de privacidad en el aviso de consentimiento.
Sigues siendo el responsable del tratamiento. Actualiza tu política de privacidad para indicar que las imágenes de prueba se procesan en Google Cloud.
Coste
Vertex AI factura cada imagen generada (tarifas de Imagen). Estos cargos están en Google Cloud, al margen del precio del módulo. Ajusta el número de imágenes a 1 para controlar el coste.
Consejos para buenos resultados
- Usa una foto nítida, bien iluminada, de cuerpo entero.
- Prefiere imágenes de producto limpias (en plano o sobre modelo).
- Las prendas superiores, inferiores y de una pieza como los vestidos ofrecen los mejores resultados.
Resolución de problemas
- No autorizado: la cuenta de servicio no tiene el rol Vertex AI User, o la clave es incorrecta.
- Modelo no encontrado en la región: la región no ofrece el modelo. Usa us-central1.
- Sin configurar: el ID del proyecto o la clave JSON está vacío.
- Límite de peticiones: cuota de Vertex AI superada. Reinténtalo más tarde o solicita un aumento de cuota.