Nejrychlejší cesta
SPREEAI pro vývojáře
Postavte zkušební kabinku
do každé obrazovky.
Propojte svůj katalog. Tvořte zákaznickou cestu. Vneste Always On do svého obchodu s integrační cestou, která vyhovuje vašemu týmu.
Vyberte si svou cestu
Začněte tam, kde je vaše
Obchodní zásobník žije.
Použijte Shopify pro spravované nastavení nebo integrujte s našimi SDK a API. Vyberte si funkce, které vaše firma potřebuje, a zachovejte nákupní cestu vaší značky.
Vlastní web
Webová SDK
Ovládejte umístění, styl, události, velikosti a chování při přidávání do košíku.JavaScript + TypeScript DokumentyNativní mobilní aplikace
SDK pro iOS
Přeneste zážitek SPREEAI do stávajícího nákupního procesu v systému iOS.Otevřít průvodce iOS DokumentyNativní mobilní aplikace
SDK pro Android
Integrujte vyzkoušení do prostředí produktů pro Android s nativním ovládáním.Otevřít průvodce Androidem Přístup pro partneryZakázkové systémy
Veřejná API
Pro pracovní postupy na straně serveru a katalogu použijte schválenou referenční příručku API.Referenční příručka k otevřenému APITržiště
Partnerská síť Amazonu
Brzy k dispozici v partnerské síti Amazon a na dalších platformách s dalšími možnostmi integrace SPREEAI do vašeho commerce stacku.Aktualizace se zde objeví jako prvníRychlý start pro webové SDK
Vaše první integrace.
Jednou se ověřte a poté vykreslete zkušební verzi nebo upravte velikost kdekoli na stránce. Používejte testovací přihlašovací údaje vydané během registrace a nikdy nevkládejte tajný klíč klienta do kódu prohlížeče.
npm install @spreeai/web-sdk@3.0.0
# or
yarn add @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,
});
}
// Pass events inside renderTryOnButton's options.
await sdk?.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
events: {
onTryOnButtonClick: (event) => {
console.info(event.name);
},
onAddToCartClicked: (event) => {
// Connect event.garments to your storefront's cart.
},
},
});
Integrační model
Čtyři systémy.
Jeden moment pro zákazníka.
ID produktů, varianty, obrázky a kontext merchandisingu.
Oděvy procházejí stavy zpracování, kontroly a připravenosti.
Váš obchod požaduje zážitek pro vhodný produkt.
Vyzkoušejte si, najděte velikost, dokončete vzhled a vraťte se k pokladně.
Cílená cesta k uvedení na trh
Připravte se. Připojte se.
Jděte žít s důvěrou.
Tři milníky s praktickým kontrolním seznamem pro každý z nich.
- 01 · Připravte se
Jasný výchozí bod.
Slaďte cestu, přístup a katalog.
Kontrolní seznam přípravy
- Vyberte jeden kanál, skupinu katalogů a měřítko úspěšnosti.
- Potvrďte přístup partnera, jeho přihlašovací údaje a pracovní oprávnění.
- Poskytněte čisté obrázky oděvů sladěné s kódem SKU.
- 02 · Připojit
Ať to působí domorodě.
Vestavěné stagingové testování. Otestujte celou cestu.
Kontrolní seznam integrace
- Vykreslete pro vybrané produkty a propojte varianty a chování košíku.
- Přizpůsobte zážitek značce.
- Zkontrolujte stavy mobilních zařízení, stolních počítačů, přístupnosti, výkonu a selhání.
- 03 · Spuštění
Poučte se z reálného používání.
Povolte hotové produkty a změřte.
Kontrolní seznam spuštění
- Potvrďte připravenost produktu a publikujte připravené prostředí.
- Sledujte přijetí, dokončení a konverzi.
- Použijte výsledky k nasměrování další kategorie nebo cesty.
Základní hodnota aktiv
Dobrý vstup vede k lepšímu výsledku.
- JPEG nebo PNG
- Minimálně 2 000 × 2 000 pixelů
- Vyžadován čelní pohled
- Doporučený pohled zezadu
- Neutrální, rovnoměrné osvětlení
- SKU nebo ID stylu v názvu souboru
Referenční číslo pro vývojáře
Najděte další
užitečná odpověď.
Začínáme
Pochopte přístup, podporované platformy a první rozhodnutí, která musí váš tým učinit.
Oficiální reference Spravovaná integraceShopify nástupní program
Nainstalujte aplikaci, přijměte smlouvy, synchronizujte oděvy, upravte tlačítko a spusťte ji.
Oficiální reference Webová SDKPovrch API
Projděte si inicializaci, možnosti vykreslování, dimenzování, přizpůsobení a typovaná rozhraní.
Oficiální reference Partnerské APIReferenční informace o veřejném API
Prozkoumejte schválené serverové rozhraní dostupné pro ověřené partnery.
Odkaz na Swaggera KvalitníOděvní aktiva
Připravte si obrázky a metadata produktů, které hladce projdou procesem zpracování a kontroly.
Průvodce SPREEAI VýrobaKontrola kvality a spuštění
Použijte kontrolní seznam sdíleného prohlížeče, výkonu, přístupnosti a spuštění.
Průvodce SPREEAI PodporaOdstraňování problémů
Vyřešte nejběžnější problémy s ověřováním, oprávněností, vykreslováním a výkonem.
Průvodce SPREEAI DokumentaceImplementační průvodci
Procházejte veřejné rychlé starty, standardy aktiv, kontrolní seznamy spuštění a pokyny k řešení problémů.
Otevřít dokumentaciNeexistují žádné odpovídající zdroje pro vývojáře. Zkuste „Shopify“, „SDK“, „assets“ nebo „QA“.
Vytvořit pro produkční prostředí
Detaily, které chrání
zkušenost zákazníka.
Zabezpečení
Uchovávejte tajemství na straně serveru, používejte pouze vydaná prostředí a střídejte přihlašovací údaje v rámci partnerského pracovního postupu.
Soukromí
Vyžádejte si snímky zákazníků s jasným souhlasem a slaďte nakládání s daty se schváleným integračním plánem.
Výkon
Načtěte uživatelské prostředí tam, kde je potřeba, otestujte reálná zařízení a sledujte regrese na produktových stránkách.
Přístupnost
Zachovat přístup z klávesnice, pořadí fokusu, přístupné názvy a použitelnou cestu, i když je rozhraní nedostupné.
Často kladené otázky pro vývojáře
Otázky před
první commit.
Kterou integraci bychom si měli zvolit?
Pro nejrychlejší spravovanou cestu použijte aplikaci Shopify, pro vlastní nebo bezhlavé umístění na webu použijte webovou sadu SDK, pro prostředí aplikací použijte nativní sady SDK a pro pracovní postupy na straně serveru dohodnuté během zavádění systému použijte schválenou referenci API.
Odkud pocházejí pověřovací listiny?
SPREEAI vydává ID partnera a schválené přihlašovací údaje během registrace. Sada SDK prohlížeče používá ID klienta a ID partnera. Nikdy nevkládejte tajný klíč klienta do kódu front-endu.
Vyžaduje aplikace Shopify klíče API?
Aktuální proces zavádění aplikace Shopify propojuje obchod po kroku požadovaných smluv a předplatného; spravovaná aplikace nevyžaduje kopírování klíčů do obrazovky nastavení.
Proč se tlačítko Vyzkoušet nezobrazuje?
Ověřte, že zpracování oděvu bylo dokončeno, je povoleno vyzkoušení, je namapováno na aktivní produkt nebo variantu a že je v šabloně produktu přítomen blok aplikace nebo kontejner SDK.
Které klientské akce jsou k dispozici?
Zdokumentované zpětné volání SDK zahrnují kliknutí na tlačítko Try-On a interakce s přidáním do košíku. Propojte je s analytickou vrstvou, aniž byste zahrnuli obrázky zákazníků nebo zbytečné osobní údaje.
Jsou k dispozici webhooky serveru?
Webhooky typu Server-push nejsou součástí aktuálně publikované dokumentace SDK. Než se na ně spolehnete, ověřte si rozsah jakýchkoli požadavků na události na straně serveru s partnerským technickým oddělením.
Kde vývojáři získají pomoc?
Použijte technickou podporu uvedenou během nástupu nebo e-mail support@spreeai.comUveďte prostředí, ID produktu, prohlížeč nebo zařízení, časové razítko a stručnou cestu reprodukce – nikdy neposílejte tajné kódy.
Kdy bude k dispozici podpora partnerské sítě Amazon?
Integrace s partnerskou sítí Amazon je ve vývoji. Je záměrně označena jako „Již brzy“, dokud nebude připraveno rozhraní pro onboarding a produkční prostředí pro externí vývojáře.
Připraveni stavět?