Tài liệu

SDK 2.0 · TÍCH HỢP

Giỏ hàng & sự kiện

Kết nối hai lệnh gọi lại được ghi lại với mặt tiền cửa hàng và số liệu phân tích của bạn.

Cuộc gọi lại được hỗ trợ

Gọi lạiKhi nó bắnTải trọng chính
onTryOnButtonClickKhi nhấp vào nút, trước khi hộp thoại mở ra.name
onAddToCartClickedKhi trải nghiệm đăng thông báo thêm vào giỏ hàng; trước tiên hãy bật tính năng thêm vào giỏ hàng.name, garments, setIsLoading, closePopUp, onError

Xử lý yêu cầu giỏ hàng

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

Đo lường hành động đúng đắn

Lệnh gọi lại bằng nút bấm đo lường ý định mở bản dùng thử; nó không phải là bằng chứng cho thấy việc thử đã hoàn tất hoặc việc mua hàng đã diễn ra. Sử dụng tích hợp phân tích đã được phê duyệt của bạn để có kết quả tiếp theo. Không tạo ra các lệnh gọi lại hoàn thành hoặc webhooks máy chủ không có trong API đã xuất bản.

Kiểm tra chấp nhận

  • Hoạt động giỏ hàng thành công sẽ bổ sung thêm sản phẩm, mẫu mã và số lượng dự kiến.
  • Một yêu cầu không thành công sẽ giúp người mua hàng được thông báo và xóa trạng thái tải.
  • Các nhấp chuột trùng lặp không tạo ra các đột biến trùng lặp ngoài ý muốn trong trình xử lý của riêng bạn.
  • Phân tích chỉ chứa siêu dữ liệu sự kiện, không có hình ảnh khách hàng, mã thông báo hoặc dữ liệu cá nhân không cần thiết.
Nguồn tham khảo

Tìm kiếm tiêu đề và nội dung trang. Thoát kết thúc tìm kiếm.

Chọn ngôn ngữ của bạn.