Da Web SDK v2
| Cambiamento | Azione |
|---|---|
| partnerId rimosso da init | Passa solo clientId. Risolvi la configurazione del partner tramite l'autenticazione. |
| features.loadingScreen rimosso | Rimuovi le opzioni personalizzate della schermata di caricamento e il tipo rimosso. |
| L'origine ospitata predefinita è ora vton.spreeai.com | Esamina gli override baseURL espliciti e le regole frame-src CSP con l'ambiente approvato. |
| Il layout della finestra di dialogo è stato modificato | Ricontrolla il CSS della finestra di dialogo personalizzata, il comportamento a schermo intero mobile e la gestione dello scorrimento/messa a fuoco. |
Inizializzazione corrente
TypeScript
import { init } from "@spreeai/web-sdk";
const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "YOUR_READY_GARMENT_ID" }],
features: { tryOnButton: { text: "Try it on you" } },
});
}Dall'eredità v1
Sostituisci il singolo tryOnButton() chiama con uno init() chiamata e uno o più sdk.renderTryOnButton() chiamate. Sostituisci il vecchio ingresso per capo singolo con garments. Aggiorna la gestione del carrello per a garments matrice piuttosto che un singolo indumento.
Lista di controllo della migrazione
- Registrare il pacchetto installato, la build ospitata funzionante e la configurazione approvata.
- Pin v3.0.0 e compila l'integrazione aggiornata nello staging.
- Verifica autenticazione, capo singolo, abbinamento varianti e fallback outfit.
- Testare la visualizzazione delle taglie, i consigli sulle taglie e la gestione del carrello solo dove supportato.
- Corri la check-list di produzione su desktop e dispositivi mobili.
- Promuovere attraverso il processo approvato. Mantenere un pacchetto funzionante e una configurazione noti disponibili per il rollback.
Rollback
Se l'autenticazione, l'idoneità del prodotto o il comportamento di acquisto regrediscono, interrompi l'implementazione e ripristina l'ultimo pacchetto compatibile e la configurazione verificati. Conserva le fasi di riproduzione e gli ID di correlazione. Conferma l'esperienza ripristinata anziché fare affidamento solo su una distribuzione riuscita.