Dokümantasyon

SDK 2.0 · ENTEGRASYON

Sepet ve etkinlikler

Belgelenen iki geri aramayı vitrininize ve analizlerinize bağlayın.

Desteklenen geri aramalar

Geri aramaAteşlendiğindeAnahtar yükü
onTryOnButtonClickDüğmeye tıklandığında, diyalog açılmadan önce.name
onAddToCartClickedDeneyim sepete ekle mesajı gönderdiğinde; önce sepete eklemeyi etkinleştirin.name, garments, setIsLoading, closePopUp, onError

Bir sepet isteğini işleme

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

Doğru eylemi ölçün

Düğme tıklamasıyla geri arama, denemeyi açma niyetini ölçer; bir denemenin tamamlandığının veya bir satın alma işleminin gerçekleştiğinin kanıtı değildir. Aşağı yönlü sonuçlar için onaylı analitik entegrasyonunuzu kullanın. Yayınlanan API'de bulunmayan tamamlama geri aramalarını veya sunucu web kancalarını icat etmeyin.

Kabul kontrolleri

  • Başarılı bir sepet işlemi, amaçlanan ürünü, çeşidi ve miktarı ekler.
  • Başarısız bir istek, müşteriyi bilgilendirir ve yükleme durumunu temizler.
  • Yinelenen tıklamalar, kendi işleyicinizde istenmeyen yinelenen mutasyonlar yaratmaz.
  • Analizler, müşteri görselleri, belirteçler veya gereksiz kişisel veriler olmadan yalnızca etkinlik meta verilerini içerir.
Kaynak referansları

Sayfa başlıklarını ve içeriğini arayın. Kaçış aramayı kapatır.

Dilinizi seçin.