Dokumentation

SDK 2.0 · INTEGRATIONER

Kurv & arrangementer

Forbind de to dokumenterede tilbagekald til din butiksfacade og analyser.

Understøttede tilbagekald

TilbagekaldNår det brænderNøgle nyttelast
onTryOnButtonClickKlik på knappen, før dialogen åbnes.name
onAddToCartClickedNår oplevelsen sender en meddelelse om tilføjelse til kurv; aktiver først tilføjelsesvogn.name, garments, setIsLoading, closePopUp, onError

Håndter en indkøbskurvsanmodning

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 den rigtige handling

Et knap-klik tilbagekald måler hensigten om at åbne try-on; det er ikke bevis for, at en prøvetur er gennemført eller et køb fandt sted. Brug din godkendte analyseintegration til downstream-resultater. Opfind ikke færdiggørelses-tilbagekald eller server-webhooks, der er fraværende i den offentliggjorte API.

Acceptkontrol

  • En vellykket vognoperation tilføjer det påtænkte produkt, variant og mængde.
  • En mislykket anmodning holder shopper informeret og rydder indlæsningstilstand.
  • Duplikerede klik skaber ikke utilsigtede duplikerede mutationer i din egen handler.
  • Analytics indeholder kun hændelsesmetadata uden kundebilleder, tokens eller unødvendige personlige data.
Kildehenvisninger

Søg sidetitler og indhold. Escape lukker søgning.

Vælg dit sprog.