Documentație

SDK 2.0 · INTEGRARE

Coș și evenimente

Conectați cele două apeluri documentate la vitrina dvs. și la analize.

Reapeluri acceptate

Apel inversCând trageSarcina utilă cheie
onTryOnButtonClickLa clic pe buton, înainte de deschiderea casetei de dialog.name
onAddToCartClickedCând experiența postează un mesaj de adăugare în coș; activați mai întâi adăugarea în coș.name, garments, setIsLoading, closePopUp, onError

Gestionați o cerere de coș

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ăsurați acțiunea corectă

Un apel invers cu clic pe buton măsoară intenția de a deschide proba de încercare; nu este dovada că a fost finalizată o încercare sau a avut loc o achiziție. Utilizați integrarea dvs. de analiză aprobată pentru rezultate din aval. Nu inventați apeluri de finalizare sau webhook-uri de server care sunt absente din API-ul publicat.

Verificări de acceptare

  • O operațiune de succes cu coșul adaugă produsul, varianta și cantitatea dorită.
  • O solicitare nereușită ține cumpărătorul informat și șterge starea de încărcare.
  • Clicurile duplicate nu creează mutații duplicate neintenționate în propriul dvs. handler.
  • Analytics conține numai metadate ale evenimentelor, fără imagini ale clienților, jetoane sau date personale inutile.
Referințe surse

Căutați titlurile paginilor și conținutul. Escape închide căutarea.

Alegeți limba.