Construiește cu
SPREEAI.

Aplicație Shopify

Folosește aplicația gestionată atunci când magazinul rulează pe Shopify și nu necesită un backend personalizat. Fluxul actual de integrare conectează magazinul după încheierea acordurilor și abonamentului; nu necesită copierea cheilor API în ecranul de configurare.

1. Instalați aplicația oficială SPREEAI și finalizați fluxul de gestionare a consimțământului.
2. Sincronizați un grup inițial de catalog și verificați stările de pregătire ale produselor.
3. Personalizați plasarea și stilul într-o temă duplicată.
4. Validați produsele eligibile, variantele, comportamentul pe mobil și adăugarea în coș.
5. Publicați numai după aprobarea mărcii și a asigurării calității.

Deschideți ghidul oficial de integrare Shopify

Ghid de pornire rapidă pentru SDK-ul web

Utilizare @spreeai/web-sdk pentru plasare personalizată, stilizare, evenimente, dimensionare și comportament în coș.

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,
  });
}

Inițializați o singură dată, redați doar pentru un produs eligibil și conectați apelurile de apel ale clienților documentate la analizele existente. Confirmați interfața curentă în referință oficială a API-ului Web SDK

Acces API

Folosește referința publică Swagger doar pentru fluxurile de lucru pe server aprobate în timpul integrării. Păstrează secretele pe server, accesul separat pentru testare și producție și acreditările de domeniu pentru mediul minim necesar.

Punctele finale REST directe, webhook-urile sau comportamentele de autentificare care nu sunt prezente în referința publică aprobată trebuie tratate ca indisponibile până când ingineria parteneră le confirmă.

Deschideți referința API publică aprobată

Linia de bază a activelor de îmbrăcăminte

• JPEG sau PNG; minimum 2.000 × 2.000 px, de preferință aproximativ 4K.
• Un articol vestimentar per imagine, centrat, cu margini curate și iluminare neutră și uniformă.
• Vedere frontală obligatorie; vedere din spate recomandată atunci când este activată această experiență.
• SKU stabil, stil sau ID articol de îmbrăcăminte inclus în numele fișierului și în înregistrarea din catalog.
• Fără mâini, umerașe, recuzită de styling, filigrane sau articole de îmbrăcăminte fără legătură care să blocheze articolul.
• Maparea variantelor a fost verificată înainte de activarea experienței.

Asigurarea calității și lansarea

• Testează întreaga experiență a clientului pe browserele mobile și desktop actuale.
• Verificați maparea produselor și variantelor, disponibilitatea articolelor de îmbrăcăminte și comportamentul coșului.
• Verificați accesul de la tastatură, ordinea focalizării, numele accesibile și comportamentul de rezervă.
• Măsurați performanța paginii de produs înainte și după activarea SPREEAI.
• Încărcare exercițiu, stări gol, indisponibil, timeout și reîncercare.
• Confirmați formularea consimțământului și gestionarea aprobată a imaginilor clienților.
• Obțineți aprobarea departamentelor de inginerie, comerț, asigurarea calității și brand înainte de producție.

Depanare

Butonul nu apare

Confirmați inițializarea SDK-ului, identificatorul clientului, ID-ul elementului gazdă, eligibilitatea produsului, disponibilitatea articolului de îmbrăcăminte și maparea variantelor. Apoi verificați erorile din consolă și rețea fără a partaja token-uri.

Apare produsul sau varianta greșită

Comparați ID-urile produselor și variantelor din magazinul fizic cu înregistrările trimise către SPREEAI. Confirmați că solicitarea redată se modifică atunci când cumpărătorul schimbă variantele.

Experiența este lentă sau indisponibilă

Testați un produs cunoscut ca fiind gata de utilizare, verificați mediul activ, inspectați cererile blocate și comparați o sesiune curată de browser. Capturați o marcă temporală și o secvență reproductibilă pentru asistență.

Obțineți asistență pentru dezvoltatori

E-mail support@spreeai.com cu mediul, ID-ul produsului sau al articolului de îmbrăcăminte, browserul sau dispozitivul, marcajul temporal aproximativ, comportamentul așteptat și pașii de reproducere. Nu includeți secrete sau imagini ale clienților.