دستاویزات

SDK 2.0 · انضمام

کارٹ اور واقعات

دو دستاویزی کال بیکس کو اپنے اسٹور فرنٹ اور اینالیٹکس سے مربوط کریں۔

تائید شدہ کال بیکس

کال بیکجب آگ لگتی ہے۔کلیدی پے لوڈ
onTryOnButtonClickڈائیلاگ کھلنے سے پہلے بٹن پر کلک کریں۔name
onAddToCartClickedجب تجربہ ایک اضافی ٹوکری پیغام پوسٹ کرتا ہے؛ پہلے ایڈ ٹو ٹوکری کو فعال کریں۔name, garments, setIsLoading, closePopUp, onError

کارٹ کی درخواست کو ہینڈل کریں۔

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

صحیح عمل کی پیمائش کریں۔

ایک بٹن پر کلک کرنے والا کال بیک ٹرائی آن کھولنے کے ارادے کی پیمائش کرتا ہے۔ یہ اس بات کا ثبوت نہیں ہے کہ کوشش مکمل ہو گئی ہے یا خریداری ہوئی ہے۔ ڈاؤن اسٹریم نتائج کے لیے اپنا منظور شدہ تجزیاتی انضمام استعمال کریں۔ مکمل کال بیکس یا سرور ویب ہکس ایجاد نہ کریں جو شائع شدہ API سے غائب ہیں۔

قبولیت کے چیک

  • ایک کامیاب کارٹ آپریشن مطلوبہ مصنوعات، مختلف قسم اور مقدار کو شامل کرتا ہے۔
  • ایک ناکام درخواست خریدار کو باخبر رکھتی ہے اور لوڈنگ کی حالت کو صاف کرتی ہے۔
  • ڈپلیکیٹ کلکس آپ کے اپنے ہینڈلر میں غیر ارادی ڈپلیکیٹ تغیرات پیدا نہیں کرتے ہیں۔
  • تجزیات میں گاہک کی تصاویر، ٹوکنز یا غیر ضروری ذاتی ڈیٹا کے بغیر صرف ایونٹ کا میٹا ڈیٹا ہوتا ہے۔
ماخذ حوالہ جات

صفحہ کے عنوانات اور مواد تلاش کریں۔ فرار تلاش کو بند کرتا ہے۔

اپنی زبان کا انتخاب کریں۔