Tržiště
SPREEAI pro vývojáře
Postavte zkušební kabinku
do každé obrazovky.
Začněte se Shopify, Web SDK nebo schválenou API integrací. Tento hub provede váš tým od prvního rozhodnutí až po otestované spuštění.
- 04
- integrační cesty
- v2.1
- aktuální Web SDK
- 01
- startovací kontrolní seznam
Zvol si svou cestu
Začněte tam, kde vaše
Commerce stack žije.
Zvolte nejrychlejší cestu, která vyhovuje vašemu obchodu. Jakmile se vaše zkušenosti rozrostou, můžete přejít zmanaged aplikace na vlastní integraci přes SDK nebo API.
ŽivěJiž brzy
Nejrychlejší cesta
Aplikace Shopify
Instalace, synchronizace oděvů, přizpůsobení a spuštění bez vlastního backendu.Nejlepší pro obchody na Shopify ↗ v2.1.0Vlastní web
Webové SDK
Ovládejte umístění, styl, události, velikost a chování tlačítka pro přidání do košíku.JavaScript + TypeScript ↗ DokumentyNativní mobilní
iOS SDK
Integrujte zážitek SPREEAI do stávajícího nákupního procesu v systému iOS.Otevřít příručku pro iOS ↗ DokumentyNativní mobilní
Android SDK
Integrujte zkoušení do prostředí produktu pro Android pomocí nativních ovládacích prvků.Otevřít příručku pro Android ↗ Přístup pro partneryVlastní systémy
Veřejná API
Pro servery a katalogové pracovní postupy použijte schválenou referenční příručku API.Odkaz na rozhraní API ↗Rychlý start s Web SDK
Od instalace po
funkční tlačítko.
Autentizujte se jednou, poté vykreslete zkoušení nebo velikosti kdekoliv na stránce. Použijte testovací pověření vydaná během onboardingu a nikdy neumisťujte klientský tajný klíč (client secret) do kódu prohlížeče.
npm install @spreeai/web-sdk
# nebo
yarn add @spreeai/web-sdkimport { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "your-client-id",
partnerId: "your-partner-id",
});
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// Připojte k vašemu stávajícímu pracovnímu postupu košíku.
},
}Integrační model
Čtyři systémy.
Jeden zákaznický okamžik.
ID produktů, varianty, obrázky a kontext merchandisingu.
Oděvy procházejí stavy zpracování, kontroly a připravenosti.
Váš výkladní skříň si vyžádá prostředí pro způsobilý produkt.
Vyzkoušejte, najděte svou velikost, doplňte svůj vzhled a vraťte se k pokladně.
Výrobní cesta
Vezměte integraci
přes cílovou čáru.
Čisté spuštění je víc než jen fungující tlačítko. Použijte tuto posloupnost k zarovnání přístupu, zdrojů, chování, kvality a měření.
- 01Vlastník · Produkt + obchod
Vymezit první cestu
Vyberte jeden kanál, skupinu v katalogu, zákaznický moment a ukazatel úspěchu.
- 02Vlastník · Inženýrství
Připravit přístup
Potvrďte ID partnera, schválené přihlašovací údaje klienta, oprávnění obchodu a testovací prostředí.
- 03Vlastník · Katalogový tým
Odevzdat čisté podklady
Jeden kus oblečení na obrázek, vyžadován pohled zezadu, vysoké rozlišení, čisté osvětlení a názvy souborů odpovídající SKU.
- 04Vlastník · Front-end
Integrovat do stagingu
Vykreslit pouze u způsobilých produktů, propojit varianty a chování košíku a přizpůsobit vstupní bod značce.
- 05Vlastník · QA + značka
Spustit QA spuštění
Testujte mobilní zařízení a počítače, pokrytí prohlížeči, přístupnost, výkon, vizuální věrnost a chybové stavy.
- 06Vlastník · Obchod + analytika
Aktivovat a měřit
Zapněte hotové produkty, publikujte připravenou verzi a sledujte zavádění, dokončování a konverzi.
Základní stav majetku
Kvalitní vstup přináší lepší výsledek.
- JPEG nebo PNG
- minimálně 2 000 × 2 000 px
- Vyžadován pohled zepředu
- Doporučený pohled zezadu
- Neutrální, rovnoměrné osvětlení
- SKU nebo ID stylu v názvu souboru
Vývojářská příručka
Najít další
užitečná odpověď.
Začít zde
Začínáme
Pochopte přístup, podporované platformy a první rozhodnutí, která váš tým musí učinit.
Oficiální odkaz ↗ Spravovaná integraceÚvodní nastavení Shopify
Nainstalujte aplikaci, přijměte smlouvy, synchronizujte oblečení, přizpůsobte tlačítko a spusťte vysílání.
Oficiální odkaz ↗ Webové SDKAPI rozhraní
Zkontrolujte inicializaci, možnosti vykreslování, změnu velikosti, přizpůsobení a typová rozhraní.
Oficiální odkaz ↗ Partnerské APIReferovém rozhraní veřejného API
Prozkoumejte schválené rozhraní na straně serveru dostupné ověřeným partnerům.
Dokumentace Swagger ↗ KvalitaSoučásti oděvu
Připravte produktové snímky a metadata, které hladce projdou procesem nahrávání a kontroly.
Průvodce SPREEAI ↗ VýrobaZajištění kvality a spuštění
Použijte sdílený kontrolní seznam pro prohlížeč, výkon, přístupnost a spuštění.
Průvodce SPREEAI ↗ PodporaŘešení problémů
Vyřešte nejčastější problémy s ověřováním, oprávněními, vykreslováním a výkonem.
Průvodce SPREEAI ↗ DokumentaceImplementační příručky
Procházejte veřejné rychlé starty, standardy aktiv, kontrolní seznamy pro spuštění a pokyny pro řešení potíží.
Otevřít dokumentaci ↗Žádné odpovídající vývojářské prostředky. Vyzkoušejte “Shopify”, “SDK”, “assets” nebo “QA”.”
Sestavit pro produkci
Podrobnosti, které chrání
zákaznická zkušenost.
Bezpečnost
Uchovávejte tajemství na straně serveru, používejte pouze vydaná prostředí a rotujte pověření prostřednictvím partnerského pracovního postupu.
Soukromí
Vyžádejte si fotografie zákazníků s výslovným souhlasem a slaďte zpracování dat se svým schváleným plánem integrace.
Výkon
Nahrajte uživatelskou zkušenost tam, kde je potřeba, otestujte reálná zařízení a sledujte regrese na stránce produktu.
Přístupnost
Zachovejte přístup z klávesnice, pořadí zaměření, přístupné názvy a použitelnou cestu, když je prostředí nedostupné.
Časté dotazy pro vývojáře
Otázky předem
První commit.
Kterou integraci bychom si měli vybrat?
Použijte aplikaci Shopify App pro nejrychlejší spravovanou cestu, Web SDK pro vlastní nebo headless webové umístění, nativní SDK pro aplikace a schválenou API dokumentaci pro serverové pracovní postupy odsouhlasené během integrace.
Odkud pocházejí pověření?
Společnost SPREEAI vydává ID partnera a schválené přihlašovací údaje během procesu onboarding. Prohlížečové SDK používá ID klienta a ID partnera. Nikdy nevkládejte klientský tajný klíč (client secret) do kódu front-endu.
Vyžaduje aplikace Shopify klíče API?
Aktuální proces registrace aplikace Shopify propojuje obchod až po kroku s požadovanými dohodami a předplatným; spravovaná aplikace nevyžaduje kopírování klíčů do instalační obrazovky.
Proč se tlačítko Vyzkoušet nezobrazuje?
Potvrďte, že oděv dokončil zpracování, je povolen pro zkoušení (Try-On), odpovídá aktivnímu produktu nebo variantě a že blok aplikace nebo kontejner SDK je přítomen na šabloně produktu.
Jaké klientské události jsou k dispozici?
Dokumentovaná zpětná volání SDK pokrývají kliknutí na tlačítko Vyzkoušet a interakce přidání do košíku. Propojte je se svou analytickou vrstvou, aniž byste zahrnovali snímky zákazníků nebo zbytečné osobní údaje.
Jsou webhooks pro servery k dispozici?
Webhooky s podporou server-push nejsou součástí aktuálně publikované dokumentace SDK. Než se na jakýkoli požadavek na událost na straně serveru spolehnete, konzultujte jej s týmem Partner Engineering.
Kde vývojáři získávají pomoc?
Použijte kanál technické podpory poskytnutý během onboarding procesu nebo e-mailem support@spreeai.com. Zahrňte prostředí, ID produktu, prohlížeč nebo zařízení, časové razítko a stručný postup reprodukce – nikdy neposílejte citlivé údaje.
Kdy bude k dispozici podpora pro Amazon Partner Network?
Integrace do sítě Amazon Partner Network je ve vývoji. Je záměrně označena jako Připravujeme, dokud nebude onboarding a produkční rozhraní připraveno pro externí vývojáře.
Jste připraveni stavět?