Antes de começar
- A
clientIdemitido por SPREEAI para seu ambiente aprovado. - Uma peça de roupa que tenha sido processada, pertence à sua conta e está disponível para experimentação.
- Uma página de produto que você pode editar e um contêiner com um ID HTML exclusivo.
1. Instale
Terminais
npm install @spreeai/web-sdk@3.0.0A folha de estilo faz parte do pacote e deve ser incluída no seu pacote.
2. Adicione um contêiner
HTML
<div id="spreeai-try-on"></div>3. Inicialize e renderize
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() pode retornar null. Verifique o resultado antes da renderização e inicialize uma vez por página, em vez de cada botão.
4. Confira o resultado
- Carregue a página do produto. Uma peça de roupa válida e disponível resulta em um botão de teste.
- Abra o provador e confirme a peça e a cor pretendida.
- Feche e reabra-o. Verifique a experiência em um telefone e um desktop.
- Experimente uma peça de roupa indisponível em seu ambiente de teste. Confirme se seu produto normal e o caminho de checkout permanecem utilizáveis.
Para onde ir a seguir
Dados
Mapear produtos e variantes
Use IDs de vestuário SPREEAI e verifique a prontidão antes da renderização.
Finalizar compraConecte carrinho e eventos
Habilite adicionar ao carrinho e implemente seu gerenciador de vitrine.
FatoAdicionar orientação de tamanho
Ative recomendações suportadas e exibição de tamanho opcional.
OpçõesNavegue pela API
Revise a opção verificada completa e a superfície de retorno de chamada.