Construir con
SPREEAI.
Una ruta práctica desde la elección de la integración hasta el lanzamiento probado. Comience con un único proceso de comercio electrónico, utilice el acceso de prueba asignado y mantenga las credenciales fuera del código del navegador.
Elija la ruta de integración
Aplicación Shopify
Utilice la aplicación administrada cuando la tienda se ejecute en Shopify y no necesite un backend personalizado. El proceso de incorporación actual conecta la tienda después de los acuerdos y la suscripción; no requiere copiar las claves API en la pantalla de configuración.
- Instale la aplicación oficial SPREEAI y complete el flujo de consentimiento gestionado.
- Sincroniza un grupo de catálogo inicial y revisa los estados de preparación del producto.
- Personaliza la ubicación y el estilo en un tema duplicado.
- Validar los productos elegibles, las variantes, el comportamiento móvil y la opción de añadir al carrito.
- Publicar únicamente tras la aprobación de la marca y del control de calidad.
Guía de inicio rápido del SDK web
Usar @spreeai/web-sdk para la personalización de la ubicación, el estilo, los eventos, el tamaño y el comportamiento del carrito de compra.
npm install @spreeai/web-sdk@3.0.0
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";
// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}Inicialice una vez, renderice solo para un producto elegible y conecte las devoluciones de llamada del cliente documentadas a sus análisis existentes. Confirme la interfaz actual en el Referencia oficial de la API del SDK web
Acceso a la API
Utilice la referencia pública de Swagger únicamente para los flujos de trabajo del servidor aprobados durante la incorporación. Mantenga la información confidencial en su servidor, separe el acceso de prueba del de producción y limite las credenciales al entorno mínimo requerido.
Los puntos finales REST directos, los webhooks o los comportamientos de autenticación que no estén presentes en la referencia pública aprobada deben considerarse no disponibles hasta que el equipo de ingeniería de socios los confirme.
Línea base de activos de prendas de vestir
- JPEG o PNG; mínimo 2000 × 2000 píxeles, preferiblemente de aproximadamente 4K.
- Una prenda por imagen, centrada con bordes definidos e iluminación neutra y uniforme.
- Se requiere la vista frontal; se recomienda la vista posterior cuando esta opción esté habilitada.
- El nombre del archivo y el registro del catálogo incluyen un SKU, estilo o ID de prenda estable.
- No debe haber manos, perchas, accesorios de estilismo, marcas de agua ni prendas ajenas que obstruyan la imagen.
- Se verificó la asignación de variantes antes de habilitar la experiencia.
Control de calidad y lanzamiento
- Pruebe la experiencia completa del cliente en los navegadores móviles y de escritorio actuales.
- Verificar la asignación de productos y variantes, la disponibilidad de las prendas y el comportamiento del carrito de compra.
- Compruebe el acceso al teclado, el orden de enfoque, los nombres accesibles y el comportamiento de reserva.
- Mida el rendimiento de la página del producto antes y después de habilitar SPREEAI.
- Estados de carga, vacío, no disponible, tiempo de espera agotado y reintento del ejercicio.
- Confirmar el idioma de consentimiento y el manejo aprobado de las imágenes del cliente.
- Obtenga la aprobación de los departamentos de ingeniería, comercio, control de calidad y marca antes de comenzar la producción.
Solución de problemas
El botón no aparece
Confirme la inicialización del SDK, el identificador del cliente, el ID del elemento host, la elegibilidad del producto, la disponibilidad de la prenda y la asignación de variantes. A continuación, revise la consola del navegador y los errores de red sin compartir tokens.
Parece que el producto o la variante es incorrecto.
Compare los ID de producto y variante de la tienda con los registros enviados a SPREEAI. Confirme que la solicitud procesada cambia cuando el comprador cambia de variante.
La experiencia es lenta o no está disponible.
Pruebe un producto que ya esté listo, verifique el entorno activo, inspeccione las solicitudes bloqueadas y compárelo con una sesión de navegador limpia. Capture una marca de tiempo y una secuencia reproducible para brindar soporte.
Obtén asistencia para desarrolladores
Correo electrónico support@spreeai.com Incluya el entorno, el ID del producto o prenda, el navegador o dispositivo, la fecha y hora aproximadas, el comportamiento esperado y los pasos para reproducir el error. No incluya información confidencial ni imágenes de clientes.