Dokumentasjon

SDK 2.0 · INTEGRASJON

Handlevogn og arrangementer

Koble de to dokumenterte tilbakeringingene til butikkfronten og analyser.

Støttede tilbakeringinger

TilbakeringingNår det brennerNøkkel nyttelast
onTryOnButtonClickPå knappeklikk, før dialogen åpnes.name
onAddToCartClickedNår opplevelsen legger ut en melding om tillegg i handlekurven; aktiver legge til handlekurv først.name, garments, setIsLoading, closePopUp, onError

Håndter en handlevognforespørsel

TypeScript
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "YOUR_READY_GARMENT_ID" }],
    enableAddToCart: true,
    events: {
      onTryOnButtonClick: ({ name }) => {
        // Forward this non-sensitive event to your analytics layer.
        console.info(name);
      },
      onAddToCartClicked: async ({
        garments, setIsLoading, closePopUp, onError,
      }) => {
        setIsLoading(true);
        try {
          // Implement this endpoint in YOUR storefront backend.
          // Validate and map these garment IDs to your own cart variants.
          const response = await fetch("/api/cart/from-spreeai", {
            method: "POST",
            headers: { "Content-Type": "application/json" },
            body: JSON.stringify({ garments }),
          });
          if (!response.ok) throw new Error("Cart request failed");
          closePopUp();
        } catch {
          onError("Could not add to bag. Please try again.");
        } finally {
          setIsLoading(false);
        }
      },
    },
  });
}

Mål riktig handling

Et knapp-klikk tilbakeringing måler intensjon om å åpne prøve-på; det er ikke bevis på at en fullført prøvetur eller et kjøp har skjedd. Bruk din godkjente analyseintegrasjon for nedstrømsresultater. Ikke oppfinn tilbakeringing av fullføring eller serverwebhooks som er fraværende i det publiserte API.

Akseptsjekker

  • En vellykket vognoperasjon legger til det tiltenkte produktet, varianten og kvantiteten.
  • En mislykket forespørsel holder kunden informert og sletter lastestatus.
  • Dupliserte klikk skaper ikke utilsiktede dupliserte mutasjoner i din egen behandler.
  • Analytics inneholder kun hendelsesmetadata, uten kundebilder, tokens eller unødvendige personlige data.
Kildereferanser

Søk på sidetitler og innhold. Escape stenger søket.

Velg språket ditt.