Panggilan balik yang didukung
| Panggilan balik | Saat itu menyala | Muatan kunci |
|---|---|---|
onTryOnButtonClick | Saat tombol diklik, sebelum dialog terbuka. | name |
onAddToCartClicked | Saat pengalaman memposting pesan tambahkan ke keranjang; aktifkan add-to-cart terlebih dahulu. | name, garments, setIsLoading, closePopUp, onError |
Menangani permintaan keranjang
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);
}
},
},
});
}Ukur tindakan yang tepat
Callback klik tombol mengukur niat untuk membuka percobaan; ini bukan bukti bahwa percobaan telah selesai atau pembelian telah terjadi. Gunakan integrasi analitik yang Anda setujui untuk hasil hilir. Jangan menciptakan callback penyelesaian atau webhook server yang tidak ada dalam API yang dipublikasikan.
Pemeriksaan penerimaan
- Pengoperasian keranjang yang sukses akan menambah produk, varian, dan kuantitas yang diinginkan.
- Permintaan yang gagal membuat pembeli tetap mendapat informasi dan menghapus status pemuatan.
- Klik duplikat tidak membuat mutasi duplikat yang tidak diinginkan pada pengendali Anda sendiri.
- Analytics hanya berisi metadata peristiwa, tanpa gambar pelanggan, token, atau data pribadi yang tidak diperlukan.