SPREEAI/Kehittäjät/Dokumentaatio

Rakenna
SPREEAI.

Käytännöllinen polku integraatiovalinnasta testattuun julkaisuun. Aloita yhdellä kauppakokemuksella, käytä myönnettyjä testikäyttöoikeuksia ja pidä tunnistetiedot poissa selainkoodista.

YleisöopasVerkko-SDK v3.0.0Päivitetty lokakuussa 2026

Valitse integraatiopolku

PolkuParasEnsimmäinen toimenpide
Shopify SovellusNopea hallitun myymälän pystytysAsenna sovellus
Verkko-SDKMukautettu tai headless-verkkoLue SDK-opas
iOS / AndroidNatiiviostossovelluksetValitse natiivi opas
Julkiset API:tHyväksytyt palvelinpuolen työnkulutAvaa hyväksytty viite
Amazonin kumppaniverkostoMarketplace-integraatioTulossa pian
Valtakirjojen turvallisuus. Esimerkeissä käytetään vain paikkamerkkejä. SPREEAI myöntää hyväksytyn käyttöoikeuden käyttöönoton aikana. Älä koskaan julkaise asiakassalaisuutta, API-avainta, tunnusta, yksityistä isäntänimeä tai asiakastietoja.

Shopify Sovellus

Käytä hallittua sovellusta, kun kauppa toimii Shopify -ympäristössä eikä tarvitse mukautettua taustajärjestelmää. Nykyinen käyttöönottoprosessi yhdistää kaupan sopimusten ja tilauksen jälkeen; se ei vaadi API-avainten kopioimista asennusnäyttöön.

  1. Asenna virallinen SPREEAI-sovellus ja suorita hallittu suostumusprosessi loppuun.
  2. Synkronoi alkuperäinen luetteloryhmä ja tarkista tuotteiden valmiustilat.
  3. Mukauta sijoittelua ja tyyliä kopioidussa teemassa.
  4. Vahvista kelvolliset tuotteet, variantit, mobiilikäyttäytyminen ja ostoskoriin lisääminen.
  5. Julkaise vasta brändin ja laadunvarmistuksen hyväksynnän jälkeen.

Avaa virallinen Shopify -aloitusopas

Web SDK:n pika-aloitusopas

Käyttää @spreeai/web-sdk mukautettuun sijoitteluun, tyyliin, tapahtumiin, kokoon ja ostoskorin toimintaan.

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

Alusta kerran, renderöi vain kelvolliselle tuotteelle ja yhdistä dokumentoidut asiakaskutsut olemassa olevaan analytiikkaasi. Vahvista nykyinen käyttöliittymä kohdassa virallinen Web SDK API -viite

API-käyttöoikeus

Käytä julkista Swagger-viittausta vain käyttöönoton aikana hyväksytyille palvelinpuolen työnkuluille. Pidä salaisuudet palvelimellasi, erota testi- ja tuotantokäyttöoikeudet ja käytä tunnistetietoja vain vaaditussa ympäristössä.

Hyväksytyssä julkisessa viitteessä puuttuvia suoria REST-päätepisteitä, webhookeja tai todennuskäytäntöjä tulisi käsitellä ei-käytettävinä, kunnes Partner Engineering vahvistaa ne.

Avaa hyväksytty julkinen API-viite

Vaatevarojen perustiedot

  • JPEG tai PNG; vähintään 2 000 × 2 000 pikseliä, suositeltava resoluutio noin 4K.
  • Yksi vaatekappale kuvaa kohden, keskitettynä, puhtailla reunoilla ja neutraalilla, tasaisella valaistuksella.
  • Etunäkymä vaaditaan; takaapäin suositeltavaa, kun kyseinen kokemus on käytössä.
  • Tiedostonimeen ja luettelotietueeseen sisältyvä vakaa SKU, tyyli tai vaatetunnus.
  • Ei käsiä, henkareita, stailausvälineitä, vesileimoja tai muita asiaankuulumattomia vaatteita, jotka estävät esineen liikkumisen.
  • Varianttien yhdistäminen tarkistettu ennen kokemuksen käyttöönottoa.

Laadunvarmistus ja julkaisu

  • Testaa koko asiakaspolku nykyisillä mobiili- ja tietokoneselaimilla.
  • Tarkista tuote- ja varianttikartoitus, vaatteiden valmius ja ostoskorin toiminta.
  • Tarkista näppäimistön käyttö, kohdistusjärjestys, helppokäyttöiset nimet ja varatoimintojen toiminta.
  • Mittaa tuotesivun suorituskykyä ennen SPREEAI:n käyttöönottoa ja sen jälkeen.
  • Harjoituksen lataus-, tyhjä-, ei-käytettävissä-, aikakatkaisu- ja uudelleenyritystilat.
  • Vahvista suostumuksen teksti ja asiakaskuvien hyväksytty käsittely.
  • Hanki suunnittelun, kaupan, laadunvarmistuksen ja brändin hyväksyntä ennen tuotantoa.

Vianmääritys

Painike ei tule näkyviin

Vahvista SDK:n alustus, asiakastunnus, isäntäelementin tunnus, tuotteen kelpoisuus, vaatteen valmius ja varianttien yhdistäminen. Tarkista sitten selainkonsolin ja verkon virheet jakamatta tokeneita.

Väärä tuote tai versio näkyy

Vertaa myymälän tuote- ja varianttitunnuksia SPREEAI:aan lähetettyihin tietueisiin. Varmista, että renderöity pyyntö muuttuu, kun ostaja vaihtaa varianttia.

Kokemus on hidas tai ei saatavilla

Testaa tunnetusti käyttövalmis tuotetta, tarkista aktiivinen ympäristö, tutki estettyjä pyyntöjä ja vertaa puhdasta selainistuntoa. Tallenna aikaleima ja toistettavissa oleva sekvenssi tukea varten.

Hanki kehittäjätukea

Sähköposti support@spreeai.com ympäristön, tuote- tai vaatetunnuksen, selaimen tai laitteen, arvioidun aikaleiman, odotetun toiminnan ja kopiointivaiheiden kanssa. Älä sisällytä salaisuuksia tai asiakaskuvia.

Dokumentaatio

Valitse kielesi.