এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

প্রোমো কোড এবং ডিসকাউন্টের সংক্ষিপ্ত বিবরণ

এই নির্দেশিকাটি ইউনিভার্সাল কমার্স প্রোটোকল (UCP) চেকআউট প্রক্রিয়ার মধ্যে প্রচারমূলক কোড এবং ডিসকাউন্ট কীভাবে পরিচালনা করতে হয় তা ব্যাখ্যা করে।

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

প্রচারের উৎস

গুগল দুটি প্রধান উৎস থেকে প্রচারমূলক তথ্য সরবরাহ করে:

স্বয়ংক্রিয়ভাবে প্রয়োগকৃত প্রোমোশন: আপনার গুগল মার্চেন্ট সেন্টার ফিড থেকে সরাসরি নেওয়া অফার। গুগল স্বয়ংক্রিয়ভাবে এই অফারগুলো কার্টে প্রয়োগ করে।
ব্যবহারকারী-প্রয়োগকৃত প্রচার: প্রচারমূলক কোড যা ব্যবহারকারীরা চেকআউটের সময় ম্যানুয়ালি প্রবেশ করান, যেমন সর্বজনীন ডিসকাউন্ট কোড বা ব্যক্তিগতকৃত ইমেল অফার। চেকআউট UI প্রতি সেশনে সর্বোচ্চ ১০টি প্রয়োগকৃত প্রোমো কোড সমর্থন করে।

এপিআই বাস্তবায়ন দেখুন

যখন কোনো ব্যবহারকারী একটি চেকআউট সেশন তৈরি করেন বা কোনো প্রচারমূলক কোড পরিবর্তন করেন, তখন গুগল আপনার POST /checkout-sessions অথবা PUT /checkout-sessions/{id} এন্ডপয়েন্টগুলিতে একটি অনুরোধ পাঠায়।

আপনার ইন্টিগ্রেশন ডিসকাউন্ট পরিচালনা করার জন্য তিনটি প্রধান অ্যারের উপর নির্ভর করে:

অনুরোধকৃত কোডসমূহ ( discounts.codes ): গুগল ব্যবহারকারীর প্রোমো কোডগুলো এই অ্যারেতে জমা দেয়। স্টেট বজায় রাখার জন্য আপনাকে অবশ্যই আপনার রেসপন্সে এই অ্যারেটি ফেরত পাঠাতে হবে। রেসপন্স অ্যারের ইনডেক্স ভ্যালিডেশন ওয়ার্নিংগুলোকে নির্দিষ্ট কোডের সাথে সংযুক্ত করে।
- প্রতিস্থাপন নীতি: এই অ্যারেটি জমা দিলে পূর্বে জমা দেওয়া যেকোনো কোড প্রতিস্থাপিত হবে।
- কোড মুছে ফেলা: একটি খালি অ্যারে ( [] ) পাঠালে সমস্ত ডিসকাউন্ট কোড মুছে যায়।
- কেস-ইনসেনসিটিভ: আপনার বিজনেস লজিক অবশ্যই কোডগুলোকে কেস-ইনসেনসিটিভভাবে মেলাতে হবে।
প্রয়োগকৃত ডিসকাউন্ট ( discounts.applied ): যদি কোনো কোড বৈধ হয়, তবে সেটিকে একটি পাঠযোগ্য title , ডিসকাউন্টের ধনাত্মক amount এবং গণনা method এই অ্যারেতে অন্তর্ভুক্ত করুন।
প্রত্যাখ্যান ( messages ): যদি কোনো কোড অবৈধ হয়, তবে সেটিকে applied ' অ্যারে থেকে বাদ দিন এবং messages ' অ্যারেতে একটি প্রমিত সতর্কবার্তা ব্যবহার করে ব্যর্থতার কারণটি জানান।

গাণিতিক অপরিবর্তনীয়তা

ডেটার অখণ্ডতা এবং রসিদের সঠিক উপস্থাপন নিশ্চিত করতে, আপনার ইন্টিগ্রেশনকে অবশ্যই সমস্ত UCP সংস্করণ জুড়ে নিম্নলিখিত গাণিতিক নিয়মগুলি মেনে চলতে হবে:

বরাদ্দের যোগফল: allocations[].amount এর যোগফল অবশ্যই applied_discount.amount এর সমান হতে হবে।
লাইন-আইটেমের মোট যোগফল: totals[type=items_discount].amount অবশ্যই line_items[].totals[type=items_discount].amount এর যোগফলের সমান হতে হবে।

ত্রুটি পরিচালনা এবং ব্যবহারকারীর প্রতিক্রিয়া

যদি কোনো প্রোমো কোড বা গিফট কার্ড অফার প্রযোজ্য না হয়, অথবা পূর্বে প্রয়োগ করা কোনো অফার সরিয়ে নেওয়া হয়, তাহলে আপনার API-কে অবশ্যই সুস্পষ্ট কারণ কোড ফেরত দিতে হবে। এটি নিশ্চিত করে যে Google ব্যবহারকারীকে যথাযথ প্রতিক্রিয়া প্রদর্শন করে।

যেসব অপারেশন অর্ডারের মোট মূল্যকে প্রভাবিত করে, অথবা মোট মূল্য সম্পর্কে ব্যবহারকারীর প্রত্যাশাকে প্রভাবিত করে, সেগুলোর জন্য অবশ্যই type: "warning" ব্যবহার করতে হবে। এটি নিশ্চিত করে যে ত্রুটিগুলো প্ল্যাটফর্মের দ্বারা নীরবে সমাধান না হয়ে ব্যবহারকারীর কাছে দৃশ্যমান হয়। উদাহরণস্বরূপ, যদি কোনো ব্যবহারকারী ছাড় আশা করেন কিন্তু কোডের মেয়াদ শেষ হয়ে যাওয়ার কারণে তা না পান, তবে আপনাকে অবশ্যই তাকে জানাতে হবে।

ত্রুটি কোড রেফারেন্স

আপনার প্রতিক্রিয়ার ' messages ' অ্যারের মধ্যে নিম্নলিখিত প্রমিত ত্রুটি কোডগুলি ফেরত দিন। পদোন্নতির যোগ্যতা জানাতে "type": "warning" ব্যবহার করুন:

ত্রুটি কোড	বর্ণনা
`discount_code_expired`	কোডটির মেয়াদ শেষ হয়ে গেছে।
`discount_code_invalid`	কোডটি খুঁজে পাওয়া যায়নি অথবা এটি ত্রুটিপূর্ণ।
`discount_code_already_applied`	কোডটি ইতিমধ্যে প্রয়োগ করা হয়েছে।
`discount_code_combination_disallowed`	কোডটি অন্য কোনো সক্রিয় ডিসকাউন্টের সাথে একত্রিত করা যাবে না, অথবা স্টোর-নির্দিষ্ট সীমা পূরণ হয়ে গেছে।
`discount_code_user_not_logged_in`	কোডটির জন্য একজন প্রমাণীকৃত ব্যবহারকারী প্রয়োজন।
`discount_code_user_ineligible`	ব্যবহারকারী যোগ্যতার মানদণ্ড পূরণ করেন না।

পরবর্তী পদক্ষেপ

আপনার UCP সংস্করণের জন্য API পেলোড এবং প্রযুক্তিগত বাস্তবায়নের বিবরণ দেখুন: