Bygg med
SPREEAI.

Shopify App

Använd den hanterade appen när butiken körs på Shopify och inte behöver en anpassad backend. Det nuvarande onboarding-flödet ansluter butiken efter avtal och prenumeration; det kräver inte att API-nycklar kopieras till installationsskärmen.

1. Installera den officiella SPREEAI-appen och slutför det hanterade samtyckesflödet.
2. Synkronisera en initial kataloggrupp och granska produktens beredskapstillstånd.
3. Anpassa placering och stil i ett duplicerat tema.
4. Validera kvalificerade produkter, varianter, mobilbeteende och lägg till i varukorgen.
5. Publicera endast efter godkännande av varumärke och kvalitetssäkring.

Öppna den officiella Shopify introduktionsguiden

Snabbstart för webb-SDK

Använda @spreeai/web-sdk för anpassad placering, styling, evenemang, storlek och varukorgsbeteende.

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

Initiera en gång, rendera endast för en kvalificerad produkt och anslut dokumenterade klientåteranrop till din befintliga analys. Bekräfta det aktuella gränssnittet i officiell API-referens för webb-SDK

API-åtkomst

Använd den offentliga Swagger-referensen endast för serversidiga arbetsflöden som godkänts under onboarding. Behåll hemligheter på din server, separera test- och produktionsåtkomst och omfatta autentiseringsuppgifterna till den lägsta miljön som krävs.

Direkta REST-slutpunkter, webhooks eller autentiseringsbeteenden som inte finns i den godkända offentliga referensen bör behandlas som otillgängliga tills Partner Engineering bekräftar dem.

Öppna den godkända offentliga API-referensen

Baslinje för klädtillgångar

• JPEG eller PNG; minst 2 000 × 2 000 px, cirka 4K är att föredra.
• Ett plagg per bild, centrerat med rena kanter och neutral, jämn belysning.
• Framifrån krävs; bakifrån rekommenderas när den upplevelsen är aktiverad.
• Stabilt SKU, stil- eller plagg-ID inkluderat i filnamnet och katalogposten.
• Inga händer, galgar, stylingtillbehör, vattenmärken eller andra plagg som blockerar plagget.
• Variantmappning kontrollerades innan upplevelsen aktiverades.

QA och lansering

• Testa hela kundresan på nuvarande mobila och stationära webbläsare.
• Verifiera produkt- och variantmappning, plaggberedskap och varukorgsbeteende.
• Kontrollera tangentbordsåtkomst, fokusordning, tillgängliga namn och alternativa funktioner.
• Mät produktsidans prestanda före och efter aktivering av SPREEAI.
• Övningens status för inläsning, tom, otillgänglig, timeout och återförsök.
• Bekräfta samtyckestext och godkänd hantering av kundbilder.
• Få godkännande från teknik, handel, kvalitetssäkring och varumärke före produktion.

Felsökning

Knappen visas inte

Bekräfta SDK-initiering, klient-ID, värdelement-ID, produktbehörighet, plaggberedskap och variantmappning. Kontrollera sedan webbläsarkonsol- och nätverksfel utan att dela tokens.

Fel produkt eller variant visas

Jämför butikens produkt- och variant-ID:n med posterna som skickats till SPREEAI. Bekräfta att den återgivna begäran ändras när kunden ändrar varianter.

Upplevelsen är långsam eller otillgänglig

Testa en produkt som är känd som färdig, verifiera den aktiva miljön, inspektera blockerade förfrågningar och jämför en ren webbläsarsession. Registrera en tidsstämpel och en reproducerbar sekvens för support.

Få utvecklarsupport

E-post support@spreeai.com med miljö, produkt- eller plagg-ID, webbläsare eller enhet, ungefärlig tidsstämpel, förväntat beteende och reproduktionssteg. Inkludera inte hemligheter eller kundbilder.