Sestavte s
SPREEAI.
Praktická cesta od volby integrace k testovanému spuštění. Začněte s jednou obchodní cestou, použijte vydaný testovací přístup a vyhněte se přihlašovacím údajům v kódu prohlížeče.
Vyberte cestu integrace
Shopify Aplikace
Používejte spravovanou aplikaci, když obchod běží na Shopify a nepotřebuje vlastní backend. Aktuální proces onboardingu propojuje obchod po uzavření smluv a předplatného; nevyžaduje kopírování klíčů API do obrazovky nastavení.
- Nainstalujte si oficiální aplikaci SPREEAI a dokončete proces spravovaného souhlasu.
- Synchronizujte počáteční skupinu katalogů a zkontrolujte stavy připravenosti produktů.
- Přizpůsobte si umístění a styl v duplikovaném motivu.
- Ověřte vhodné produkty, varianty, chování na mobilních zařízeních a přidání do košíku.
- Publikovat až po schválení značky a kontroly kvality.
Rychlý start pro webové SDK
Použití @spreeai/web-sdk pro vlastní umístění, styling, události, velikosti a chování košíku.
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,
});
}
Inicializujte jednou, vykreslete pouze pro vhodný produkt a propojte zdokumentované zpětné volání klientů s vaší stávající analytikou. Potvrďte aktuální rozhraní v oficiální referenční příručka k webovému rozhraní SDK API
Přístup k API
Veřejnou referenci Swagger používejte pouze pro pracovní postupy na straně serveru schválené během zavádění. Udržujte tajné informace na serveru, oddělte testovací a produkční přístup a přihlašovací údaje upravte na minimální požadované prostředí.
Přímé koncové body REST, webhooky nebo ověřovací chování, které nejsou přítomny ve schválené veřejné referenci, by měly být považovány za nedostupné, dokud je nepotvrdí partnerský technický tým.
Základní stav aktiv oděvů
- JPEG nebo PNG; minimálně 2 000 × 2 000 pixelů, preferováno přibližně 4K.
- Jeden oděv na obrázek, vycentrovaný s čistými okraji a neutrálním, rovnoměrným osvětlením.
- Pohled zepředu je vyžadován; pokud je tato funkce povolena, doporučuje se pohled zezadu.
- Stabilní SKU, styl nebo ID oděvu zahrnuté v názvu souboru a záznamu katalogu.
- Žádné ruce, ramínka, stylingové rekvizity, vodoznaky ani nesouvisející oděvy, které by blokovaly položku.
- Před aktivací prostředí bylo zkontrolováno mapování variant.
Kontrola kvality a spuštění
- Otestujte kompletní zákaznickou cestu v aktuálních mobilních a stolních prohlížečích.
- Ověřte mapování produktů a variant, připravenost oděvů a chování košíku.
- Zkontrolujte přístup z klávesnice, pořadí fokusu, přístupné názvy a chování při záložních funkcích.
- Změřte výkon stránky produktu před a po aktivaci SPREEAI.
- Stavy načítání cvičení, prázdné, nedostupné, časový limit a opakování.
- Potvrďte znění souhlasu a schválené nakládání se snímky zákazníka.
- Před zahájením výroby si zajistěte schválení inženýrských, obchodních, kontrolních a značkových pracovníků.
Odstraňování problémů
Tlačítko se nezobrazuje
Potvrďte inicializaci SDK, identifikátor klienta, ID hostitelského prvku, způsobilost produktu, připravenost oděvu a mapování variant. Poté zkontrolujte chyby konzole prohlížeče a sítě bez sdílení tokenů.
Zobrazuje se nesprávný produkt nebo varianta
Porovnejte ID produktů a variant z prodejny se záznamy odeslanými na SPREEAI. Potvrďte, že se vykreslený požadavek změní, když nakupující změní variantu.
Prostředí je pomalé nebo nedostupné
Otestujte produkt, o kterém se ví, že je připraven k testování, ověřte aktivní prostředí, zkontrolujte blokované požadavky a porovnejte čistou relaci prohlížeče. Zaznamenejte časové razítko a reprodukovatelnou sekvenci pro účely podpory.
Získejte podporu pro vývojáře
E-mail support@spreeai.com s ID prostředí, produktu nebo oděvu, prohlížečem nebo zařízením, přibližným časovým razítkem, očekávaným chováním a kroky reprodukce. Neuvádějte tajné informace ani obrázky zákazníků.