Probador virtual con IA para WooCommerce — Documentación

Qué hace el plugin

DF Google Try-On añade un botón de prueba virtual a tus fichas de producto de WooCommerce. La clienta sube una foto o usa su webcam, y la inteligencia artificial genera una imagen de ella con la prenda puesta. La vista previa aparece en una ventana modal, sin salir nunca de la ficha de producto.

Requisitos

• WordPress 6.2 o superior, WooCommerce 7.0 o superior
• PHP 7.4 o superior, con la extensión OpenSSL activada
• Un proyecto de Google Cloud con la facturación activa
• La API de Vertex AI activada en ese proyecto
• Una cuenta de servicio con el rol Vertex AI User

Paso 1 — Preparar Google Cloud

Activar la API de Vertex AI

En la consola de Google Cloud, selecciona tu proyecto, abre la biblioteca de API y activa Vertex AI API. Comprueba que la facturación está activa en el proyecto: sin ella, todas las llamadas fallarán.

Crear la cuenta de servicio

1. Abre IAM y administración, y luego Cuentas de servicio.
2. Crea una cuenta de servicio (el nombre da igual, por ejemplo woocommerce-tryon).
3. Asígnale el rol Vertex AI User. No concedas un rol más amplio del necesario.
4. En la pestaña Claves, crea una clave de tipo JSON y descarga el archivo.

Elegir una región

El modelo debe estar disponible en la región que indiques. El valor por defecto us-central1 es el más seguro. Si quieres una región europea, comprueba antes la disponibilidad regional del modelo Virtual Try-On en la documentación de Google, ya que la cobertura evoluciona.

Paso 2 — Instalar el plugin

1. En WordPress, ve a Plugins, Añadir nuevo, Subir plugin.
2. Selecciona el archivo ZIP suministrado, instala y activa.
3. Aparece un nuevo menú: WooCommerce, Google Try-On.

Paso 3 — Configurar

Todos los ajustes están en WooCommerce, Google Try-On.

Conexión con Google

• ID del proyecto GCP: el identificador del proyecto, no su nombre visible.
• Región: por ejemplo us-central1.
• JSON de la cuenta de servicio: pega el contenido completo del archivo descargado. El plugin valida el JSON al guardar y rechaza una clave mal formada.

Al guardar, la caché del token de acceso se vacía automáticamente, por lo que un cambio de credenciales surte efecto de inmediato.

Visualización

• Activar la prueba virtual: interruptor general. Mientras esté desmarcado, no se muestra nada en la tienda.
• Texto del botón: el texto que aparece en la ficha de producto.
• Categorías elegibles: limita el widget a ciertas categorías. Déjalo vacío para permitir todos los productos.

Seguridad y costes

• Filtro de seguridad: el nivel de filtrado que Google aplica a las imágenes. En una tienda pública se recomienda el ajuste más estricto.
• Marca de agua: añade la marca de agua SynthID de Google a las imágenes generadas. Recomendado, para señalar que se trata de una imagen sintética.
• Límite mensual: número máximo de pruebas correctas por mes natural. Pon 0 para no limitar, pero recuerda que cada generación se factura.
• Texto de consentimiento: el mensaje mostrado junto a la casilla obligatoria.

El contador del mes en curso aparece en la parte superior de la página de ajustes.

Paso 4 — Controlar la visualización producto a producto

En una ficha de producto, en la pestaña General de los datos del producto, el ajuste Prueba virtual ofrece tres valores:

• Auto: sigue las categorías configuradas globalmente.
• Mostrar siempre: fuerza la visualización, incluso fuera de las categorías elegibles.
• No mostrar nunca: oculta el widget, sea cual sea la configuración global.

Cómo funciona por dentro

El recorrido de una prueba es el siguiente:

1. La clienta abre la ventana y aporta una foto, por subida o captura con webcam. La imagen se redimensiona en el navegador, por su lado más largo, antes de cualquier envío.
2. Marca la casilla de consentimiento, obligatoria: sin ella, el servidor rechaza la petición.
3. El servidor verifica el token de seguridad, el producto, la limitación por dirección IP y el límite mensual.
4. El plugin firma un JWT en RS256 con la clave privada de la cuenta de servicio, lo intercambia por un token de acceso OAuth2 y lo guarda en caché hasta poco antes de su caducidad.
5. La foto y la imagen del producto se envían al modelo de Vertex AI, que devuelve la imagen generada.
6. La imagen se devuelve al navegador y se muestra en la ventana.

La imagen de la prenda nunca la aporta el navegador: siempre se lee en el servidor desde la ficha de producto. Esto impide que un visitante desvíe el servicio para probar una imagen arbitraria.

Datos personales y RGPD

La foto de la clienta es un dato personal. El plugin está diseñado en consecuencia:

• La foto nunca se guarda en tu servidor, ni en la biblioteca de medios ni en la base de datos. Pasa por la memoria durante el tiempo de la llamada.
• La imagen generada se devuelve directamente al navegador y tampoco se almacena.
• Antes de cualquier tratamiento debe marcarse una casilla de consentimiento explícito, cuyo texto rediges tú.
• La foto se transmite a Google, que actúa como encargado del tratamiento. Menciona esta transferencia en tu política de privacidad, indicando la finalidad y el destinatario.

Controlar los costes

Cada prueba correcta corresponde a una generación de imagen facturada por Google. Hay tres salvaguardas integradas:

• El límite mensual, que bloquea nuevas generaciones una vez alcanzado.
• Una limitación por dirección IP, que impide llamadas en ráfaga.
• El uso exclusivo de la imagen de producto en el servidor, que descarta cualquier uso indebido del servicio.

El contador se reinicia automáticamente al comenzar cada mes natural. En paralelo, vigila el presupuesto en la consola de Google Cloud, donde puedes definir alertas de facturación.

Resolución de problemas

El botón no aparece

Comprueba, por orden: el interruptor general está activado, el ID de proyecto y el JSON están rellenados, el producto pertenece a una categoría elegible o está forzado a Mostrar siempre, y el producto tiene realmente una imagen principal.

Mensaje de error de autenticación

La clave JSON es inválida o incompleta, o la cuenta de servicio no tiene el rol Vertex AI User. Vuelve a pegar el archivo completo y comprueba el rol en la consola de Google Cloud. Confirma también que la extensión OpenSSL está disponible en tu alojamiento.

No se genera ninguna imagen

El modelo puede rechazar una foto demasiado oscura, borrosa, recortada en la cara o con varias personas. Pide una foto nítida, bien iluminada, preferiblemente de cuerpo entero y de frente. Un filtro de seguridad muy estricto también puede bloquear algunas imágenes.

Error de región o modelo no encontrado

El modelo no está disponible en la región indicada. Vuelve a us-central1 y comprueba la disponibilidad regional del modelo en la documentación de Google.

El servicio indica estar al límite de capacidad

Se ha alcanzado el límite mensual. Auméntalo en los ajustes o espera al mes siguiente. El contador del mes en curso está en la parte superior de la página de ajustes.

Preguntas frecuentes

¿Hace falta Composer?

No. El plugin usa un autoloader nativo y firma la autenticación de Google en PHP puro, mediante OpenSSL.

¿Es compatible con HPOS?

Sí, se declara la compatibilidad con el almacenamiento de pedidos de alto rendimiento.

¿Funciona en móvil?

Sí. La captura usa la cámara frontal cuando el navegador lo permite, y la subida de foto siempre está disponible.

¿Se puede probar algo que no sea ropa?

El modelo está entrenado para prendas puestas. Los resultados con accesorios, calzado u objetos son mucho menos fiables. Limita el widget a tus categorías de ropa.

¿Qué ocurre si desinstalo el plugin?

La desinstalación elimina los ajustes, el token en caché y los contadores mensuales. El ajuste por producto se conserva, para no perder nada si reinstalas.