ডকুমেন্টেশন

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 থেকে অনুপস্থিত সম্পূর্ণ কলব্যাক বা সার্ভার ওয়েবহুক উদ্ভাবন করবেন না।

গ্রহণযোগ্যতা চেক

  • একটি সফল কার্ট অপারেশন উদ্দিষ্ট পণ্য, বৈকল্পিক এবং পরিমাণ যোগ করে।
  • একটি ব্যর্থ অনুরোধ ক্রেতাকে অবহিত রাখে এবং লোডিং অবস্থা সাফ করে।
  • ডুপ্লিকেট ক্লিক আপনার নিজের হ্যান্ডলারে অনিচ্ছাকৃত ডুপ্লিকেট মিউটেশন তৈরি করে না।
  • বিশ্লেষণে গ্রাহকের ছবি, টোকেন বা অপ্রয়োজনীয় ব্যক্তিগত ডেটা ছাড়া শুধুমাত্র ইভেন্ট মেটাডেটা থাকে।
উৎস উল্লেখ

পৃষ্ঠার শিরোনাম এবং বিষয়বস্তু অনুসন্ধান করুন। Escape অনুসন্ধান বন্ধ করে।

আপনার ভাষা নির্বাচন করুন।