SPREEAI/ডেভেলপাররা/ডকুমেন্টেশন

নির্মাণ করুন
SPREEAI.

ইন্টিগ্রেশন নির্বাচন থেকে পরীক্ষিত লঞ্চ পর্যন্ত একটি বাস্তবসম্মত পথ। একটি কমার্স জার্নি দিয়ে শুরু করুন, ইস্যু করা টেস্ট অ্যাক্সেস ব্যবহার করুন এবং ক্রেডেনশিয়াল ব্রাউজার কোড থেকে দূরে রাখুন।

জনসাধারণের নির্দেশিকাওয়েব এসডিকে v3.0.0অক্টোবর ২০২৬-এ হালনাগাদ করা হয়েছে

ইন্টিগ্রেশন পথ বেছে নিন

পথসেরাপ্রথম পদক্ষেপ
Shopify অ্যাপদ্রুত পরিচালিত স্টোরফ্রন্ট সেটআপঅ্যাপটি ইনস্টল করুন
ওয়েব এসডিকেকাস্টম বা হেডলেস ওয়েবএসডিকে গাইডটি পড়ুন
iOS / অ্যান্ড্রয়েডনেটিভ শপিং অ্যাপএকজন স্থানীয় গাইড বেছে নিন
পাবলিক এপিআইঅনুমোদিত সার্ভার-সাইড ওয়ার্কফ্লোঅনুমোদিত রেফারেন্স খুলুন
অ্যামাজন পার্টনার নেটওয়ার্কমার্কেটপ্লেস ইন্টিগ্রেশনশীঘ্রই আসছে
পরিচয়পত্রের নিরাপত্তা। উদাহরণগুলিতে শুধুমাত্র প্লেসহোল্ডার ব্যবহার করা হয়েছে। SPREEAI অনবোর্ডিংয়ের সময় অনুমোদিত অ্যাক্সেস প্রদান করে। কখনও ক্লায়েন্ট সিক্রেট, এপিআই কী, টোকেন, প্রাইভেট হোস্টনেম বা গ্রাহকের ডেটা প্রকাশ করবেন না।

Shopify অ্যাপ

যখন স্টোরটি Shopify এ চলে এবং কোনো কাস্টম ব্যাকএন্ডের প্রয়োজন হয় না, তখন ম্যানেজড অ্যাপটি ব্যবহার করুন। বর্তমান অনবোর্ডিং ফ্লোটি চুক্তি এবং সাবস্ক্রিপশনের পরে স্টোরটিকে সংযুক্ত করে; এর জন্য সেটআপ স্ক্রিনে API কী কপি করার প্রয়োজন হয় না।

  1. অফিসিয়াল SPREEAI অ্যাপটি ইনস্টল করুন এবং পরিচালিত সম্মতি প্রক্রিয়াটি সম্পূর্ণ করুন।
  2. একটি প্রাথমিক ক্যাটালগ গ্রুপ সিঙ্ক করুন এবং পণ্যের প্রস্তুতির অবস্থা পর্যালোচনা করুন।
  3. একটি ডুপ্লিকেট থিমে প্লেসমেন্ট এবং স্টাইলিং কাস্টমাইজ করুন।
  4. যোগ্য পণ্য, ভ্যারিয়েন্ট, মোবাইলের আচরণ যাচাই করুন এবং কার্টে যোগ করুন।
  5. ব্র্যান্ড এবং গুণমান নিশ্চিতকরণ (QA) বিভাগের অনুমোদন পাওয়ার পরেই প্রকাশ করুন।

অফিসিয়াল Shopify অনবোর্ডিং গাইডটি খুলুন

ওয়েব এসডিকে কুইকস্টার্ট

ব্যবহার @spreeai/web-sdk কাস্টম প্লেসমেন্ট, স্টাইলিং, ইভেন্ট, সাইজিং এবং কার্ট আচরণের জন্য।

npm install @spreeai/web-sdk@3.0.0

import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

একবার শুরু করুন, শুধুমাত্র একটি যোগ্য পণ্যের জন্য রেন্ডার করুন এবং আপনার বিদ্যমান অ্যানালিটিক্সের সাথে নথিভুক্ত ক্লায়েন্ট কলব্যাকগুলি সংযুক্ত করুন। বর্তমান ইন্টারফেসটি নিশ্চিত করুন। অফিসিয়াল ওয়েব এসডিকে এপিআই রেফারেন্স

এপিআই অ্যাক্সেস

অনবোর্ডিংয়ের সময় অনুমোদিত সার্ভার-সাইড ওয়ার্কফ্লোর জন্য শুধুমাত্র পাবলিক সোয়াগার রেফারেন্স ব্যবহার করুন। আপনার সার্ভারে সিক্রেট রাখুন, টেস্ট এবং প্রোডাকশন অ্যাক্সেস আলাদা রাখুন, এবং ক্রেডেনশিয়াল ন্যূনতম প্রয়োজনীয় এনভায়রনমেন্টের মধ্যে সীমাবদ্ধ রাখুন।

অনুমোদিত পাবলিক রেফারেন্সে অন্তর্ভুক্ত নয় এমন সরাসরি REST এন্ডপয়েন্ট, ওয়েবহুক বা অথেনটিকেশন বিহেভিয়ারগুলোকে পার্টনার ইঞ্জিনিয়ারিং দ্বারা নিশ্চিত না হওয়া পর্যন্ত অনুপলব্ধ হিসেবে গণ্য করা উচিত।

অনুমোদিত পাবলিক এপিআই রেফারেন্সটি খুলুন

পোশাক সম্পদের ভিত্তিরেখা

  • JPEG বা PNG; ন্যূনতম ২,০০০ × ২,০০০ পিক্সেল, তবে প্রায় ৪কে (4K) হলে ভালো।
  • প্রতিটি ছবিতে একটি করে পোশাক, যা মাঝখানে পরিচ্ছন্ন কিনারা এবং স্বাভাবিক ও সুষম আলোতে সাজানো থাকবে।
  • সম্মুখ দৃশ্য আবশ্যক; যখন সেই অভিজ্ঞতাটি সক্রিয় করা হয়, তখন পশ্চাৎ দৃশ্য দেখা বাঞ্ছনীয়।
  • ফাইলের নাম এবং ক্যাটালগ রেকর্ডে স্থিতিশীল SKU, স্টাইল বা পোশাক আইডি অন্তর্ভুক্ত থাকে।
  • হাত, হ্যাঙ্গার, সাজানোর সরঞ্জাম, ওয়াটারমার্ক বা অপ্রাসঙ্গিক কোনো পোশাক দিয়ে জিনিসটি আড়াল করা যাবে না।
  • অভিজ্ঞতাটি চালু করার আগে ভ্যারিয়েন্ট ম্যাপিং যাচাই করা হয়েছে।

QA এবং লঞ্চ

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

সমস্যা সমাধান

বাটনটি দেখা যাচ্ছে না।

এসডিকে ইনিশিয়ালাইজেশন, ক্লায়েন্ট আইডেন্টিফায়ার, হোস্ট এলিমেন্ট আইডি, প্রোডাক্ট এলিজিবিলিটি, গার্মেন্ট রেডিনেস এবং ভ্যারিয়েন্ট ম্যাপিং নিশ্চিত করুন। তারপর টোকেন শেয়ার না করে ব্রাউজার কনসোল এবং নেটওয়ার্ক ত্রুটি পরীক্ষা করুন।

ভুল পণ্য বা ভ্যারিয়েন্ট দেখা যাচ্ছে

স্টোরফ্রন্টের প্রোডাক্ট এবং ভ্যারিয়েন্ট আইডিগুলোকে SPREEAI-এ পাঠানো রেকর্ডগুলোর সাথে তুলনা করুন। ক্রেতা যখন ভ্যারিয়েন্ট পরিবর্তন করেন, তখন রেন্ডার করা রিকোয়েস্টটিও পরিবর্তিত হয় কিনা তা নিশ্চিত করুন।

অভিজ্ঞতাটি ধীরগতির বা অনুপলব্ধ।

একটি পরিচিত ও প্রস্তুত পণ্য পরীক্ষা করুন, সক্রিয় পরিবেশ যাচাই করুন, অবরুদ্ধ অনুরোধগুলি পরিদর্শন করুন এবং একটি পরিষ্কার ব্রাউজার সেশনের সাথে তুলনা করুন। সহায়তার জন্য একটি টাইমস্ট্যাম্প এবং পুনরাবৃত্তিযোগ্য ক্রম সংগ্রহ করুন।

ডেভেলপার সহায়তা নিন

ইমেল support@spreeai.com পরিবেশ, পণ্য বা পোশাকের আইডি, ব্রাউজার বা ডিভাইস, আনুমানিক টাইমস্ট্যাম্প, প্রত্যাশিত আচরণ এবং পুনরায় ঘটার ধাপসমূহ উল্লেখ করুন। গোপনীয় তথ্য বা গ্রাহকের ছবি অন্তর্ভুক্ত করবেন না।

ডকুমেন্টেশন

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