Antes de empezar
- A
clientIdemitido por SPREEAI para su entorno aprobado. - Una prenda que ha finalizado la ingestión, pertenece a tu cuenta y está disponible para probársela.
- Una página de producto que puede editar y un contenedor con una ID HTML única.
1. Instalar
terminales
npm install @spreeai/web-sdk@3.0.0La hoja de estilo es parte del paquete y debe incluirse en su paquete.
2. Agrega un contenedor
HTML
<div id="spreeai-try-on"></div>3. Inicializar y renderizar
TypeScript
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";
// Add <div id="spreeai-try-on"></div> to your product page.
const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "YOUR_READY_GARMENT_ID" }],
});
} else {
// Keep the normal product and purchase journey available.
console.warn("SPREEAI could not initialize.");
}init() puede regresar null. Verifique el resultado antes de renderizar e inicialícelo una vez por página en lugar de para cada botón.
4. Comprueba el resultado
- Cargue la página del producto. Una prenda válida y disponible genera un botón de prueba.
- Abra el probador y confirme la prenda y el color deseados.
- Ciérrelo y vuelva a abrirlo. Comprueba la experiencia en un teléfono y una computadora de escritorio.
- Pruebe una prenda que no esté disponible en su entorno de prueba. Confirme que su producto normal y la ruta de pago siguen siendo utilizables.
Adónde ir a continuación
Datos
Mapa de productos y variantes
Utilice las identificaciones de prendas SPREEAI y verifique que estén listas antes de renderizar.
PagarConectar carrito y eventos
Habilite Agregar al carrito e implemente su controlador de escaparate.
En formaAgregar guía de tallas
Habilite las recomendaciones admitidas y la visualización de tamaño opcional.
OpcionesExplorar la API
Revise la opción verificada completa y la superficie de devolución de llamada.