গিফট কার্ড (ভাউচার নামেও পরিচিত)

দ্রষ্টব্য: এটি একটি পরীক্ষামূলক প্রকল্প।

সতর্কীকরণ: এই নথিটি একটি নির্মাণাধীন নথি। তথ্য প্রায়শই পরিবর্তিত হতে পারে।

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

অফার মোড এবং শ্রেণিবিন্যাস

গিফট কার্ড ইনভেন্টরি জমা দেওয়ার সময়, নিম্নলিখিত মূল বৈশিষ্ট্যগুলি সঠিকভাবে কনফিগার করা হয়েছে কিনা তা নিশ্চিত করুন:

• অফার মোড : offer_modes অবশ্যই সর্বদা "OFFER_MODE_GIFT_CARD_PURCHASE" ধারণকারী একটি একক অ্যারে হিসাবে সেট করতে হবে :

  "offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]
  

• স্টোরড-ভ্যালু ভাউচার বনাম সরাসরি দোকানে গিয়ে তাৎক্ষণিক ছাড় :

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

• মূল্যমান নির্ধারণ : গিফট কার্ডের মূল্যমানটি ভাউচারটির প্রকৃত মূল্য (যা দিয়ে এটি ভাঙানো যাবে) প্রকাশ করবে, ব্যবহারকারী যা পরিশোধ করে (ব্যবহারকারী ছাড়কৃত মূল্য পরিশোধ করে) তা নয় ।

• একাধিক মূল্যমানের একত্রীকরণ : একই ছাড়ের শতাংশ এবং শর্তাবলী থাকা সত্ত্বেও, ভিন্ন অভিহিত মূল্যের একাধিক ভাউচারকে একটি একক অফার এন্ট্রিতে একত্রিত করতে হবে। যেহেতু denomination_type একটি oneof হিসেবে কাজ করে, তাই পার্টনারদের অবশ্যই fixed_denominations অথবা একটি custom_range সেট করার মধ্যে থেকে বেছে নিতে হবে।

  • নির্দিষ্ট মূল্যমান : যখন আলাদা, পূর্বনির্ধারিত গিফট কার্ডের পরিমাণ দেওয়া হয় (যেমন, ₹৫০০, ₹১,০০০, এবং ₹২,০০০, সবগুলোতে ফ্ল্যাট ১০% ছাড় সহ), তখন এটি ব্যবহার করুন। নিশ্চিত করুন যে ল্যান্ডিং পেজে বিক্রি হয়ে যাওয়া বা অনুপলব্ধ কোনো নির্দিষ্ট মূল্যমান যেন ফিড সাবমিশন থেকে স্পষ্টভাবে বাদ দেওয়া হয়।
  • কাস্টম রেঞ্জ : এটি কঠোরভাবে তখনই ব্যবহার করুন যখন ব্যবহারকারীরা ক্রয় পৃষ্ঠায় সংজ্ঞায়িত সীমার মধ্যে অবাধে যেকোনো যথেচ্ছ অভিহিত মূল্য প্রবেশ করতে পারে (যেমন, ৫% ছাড় সহ ₹১০০ থেকে ₹৫,০০০ এর মধ্যে যেকোনো মূল্য)। যদি গন্তব্য ল্যান্ডিং পৃষ্ঠাটি নির্দিষ্ট, পূর্বনির্ধারিত পরিমাণ অফার করে, তবে ইনভেন্টরি কঠোরভাবে fixed_denominations অধীনে মডেল করুন। উপরন্তু, যদি কোনো অফারের জন্য নির্দিষ্ট মূল্য এবং কাস্টম মূল্য উভয়ই উপলব্ধ থাকে, তবে অংশীদারদের ফ্লেক্সিবল কাস্টম রেঞ্জ সেট করা উচিত।

একাধিক অবস্থান শৃঙ্খল পরিচালনা

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

দ্রষ্টব্য: যদি প্রতিটি স্টোর আউটলেটের জন্য গন্তব্য ল্যান্ডিং পেজের URL ( offer_url ) অনন্য হয়, তবে একটি ব্যতিক্রম প্রযোজ্য হবে। সেক্ষেত্রে, পার্টনারদের অবশ্যই প্রতিটি আউটলেটের জন্য একটি পৃথক অফার অবজেক্ট জমা দিতে হবে।

পোর্টাল ব্র্যান্ডিং ( brand_id )

কিছু ভাউচার মূল মার্চেন্ট সাইটের পরিবর্তে নির্দিষ্ট ব্যাংক বা লয়ালটি পোর্টালের (যেমন, ব্যাংক লয়ালটি প্রোগ্রাম বা পার্টনার প্ল্যাটফর্ম) মাধ্যমে অফার করা হয়। এই পোর্টালগুলির জন্য সঠিক ব্র্যান্ডিং নিশ্চিত করতে, পার্টনারদের অবশ্যই টপ-লেভেল অফার অবজেক্টের brand_id ফিল্ডটি পূরণ করতে হবে।

brand_id বাদ দিলে তা অ্যাকাউন্টের প্রাথমিক ব্র্যান্ডকে ডিফল্ট হিসেবে ব্যবহার করে (এবং অ্যাকাউন্টের ডিফল্ট ব্র্যান্ড ব্যবহার করার সময় brand_id প্রয়োজন হয় না), কিন্তু স্পষ্টভাবে brand_id পূরণ করলে তা ইনভেন্টরিকে তার সংশ্লিষ্ট ব্র্যান্ডেড পোর্টালের সাথে সঠিকভাবে সংযুক্ত করে, যা ব্যবহারকারীদের কাছে সঠিক পার্টনার-নির্দিষ্ট লোগো এবং নাম প্রদর্শন নিশ্চিত করে। ব্র্যান্ড কনফিগার করার বিষয়ে আরও নির্দেশাবলী ' ব্র্যান্ড কনফিগারেশন' (Brands Configuration ) অংশে পাওয়া যাবে।

বৈধতার কাঠামো ( ValidityScope )

গিফট কার্ডের একটি স্বতন্ত্র বৈধতার কাঠামো রয়েছে, যা ডিলটি কেনার সময়সীমা এবং কার্ডটি রিডিম করার সময়কালকে আলাদা করে। পার্টনারদের অবশ্যই সর্বদা প্রাসঙ্গিক ValidityScope enum ভ্যালুগুলো ব্যবহার করতে হবে:

• VALIDITY_SCOPE_CLAIM : এটি সেই সময়সীমা নির্ধারণ করে, যার মধ্যে পার্টনার প্ল্যাটফর্মে গিফট কার্ড অফারটি কেনার জন্য উপলব্ধ থাকবে। এই এন্ট্রিটি অবশ্যই সর্বদা উপস্থিত থাকতে হবে। ফিড জমা দেওয়ার সময়, ক্লেইমের বৈধতার সময়কালটি ফিড জমা দেওয়ার সঠিক তারিখ থেকে পূরণ করুন। এছাড়াও, যদি ল্যান্ডিং পেজে স্পষ্টভাবে ক্যাম্পেইন শেষ হওয়ার তারিখ বিজ্ঞাপন করা থাকে, তাহলে ক্লেইমের সময়কাল কখনই অনির্দিষ্ট রাখবেন না; valid_through_time কে বিজ্ঞাপিত মেয়াদ শেষ হওয়ার তারিখের সাথে মেলান।
• VALIDITY_SCOPE_REDEEM : ক্রয়ের পরবর্তী রিডেম্পশনের সময়কাল নির্ধারণ করে (যে সময়সীমার মধ্যে ব্যবহারকারীরা ভাউচারটি কেনার পর স্টোর থেকে রিডিম করতে পারেন, যা একটি সময়কাল বা সময়সীমা হিসাবে নির্দিষ্ট করা যেতে পারে)।

অ্যাকশন টাইপ ম্যাপিং

অংশীদাররা প্রায়শই ভাউচারগুলিকে "অনলাইন/অফলাইনে ব্যবহারযোগ্য", "অনলাইন/আউটলেট", বা "ইন-স্টোর"-এর মতো ধারণা ব্যবহার করে শ্রেণীবদ্ধ করে। ফিড সাবমিশনের ক্ষেত্রে, পণ্যটি কীভাবে ব্যবহার করা হচ্ছে তা সঠিকভাবে সংজ্ঞায়িত করার জন্য এটিকে অবশ্যই ActionType enum-এর সাথে ম্যাপ করতে হবে:

• ডাইনিং / ফুড ভার্টিকাল : "ডাইন-ইন" গিফট কার্ডগুলিকে ACTION_TYPE_DINING এর সাথে ম্যাপ করুন। "ডেলিভারি" গিফট কার্ডগুলিকে ACTION_TYPE_FOOD_DELIVERY এর সাথে ম্যাপ করুন। "টেকআউট" গিফট কার্ডগুলিকে ACTION_TYPE_FOOD_TAKEOUT এর সাথে ম্যাপ করুন।
• শপিং রিটেইল ভার্টিকাল : "ইন-স্টোর" গিফট কার্ডগুলোকে ACTION_TYPE_SHOPPING_IN_STORE এর সাথে ম্যাপ করুন। (দ্রষ্টব্য: শুধুমাত্র অনলাইন রিটেইল ভাউচার সমর্থিত নয়)।
• একক চ্যানেল ম্যাপিং : প্রতিটি offer_id কঠোরভাবে একটি ActionType অন্তর্ভুক্ত হতে পারে। যদি কোনো ইনভেন্টরি আইটেম একাধিক ফুলফিলমেন্ট চ্যানেল সমর্থন করে (যেমন, ফুড ডেলিভারি এবং টেকআউট উভয়ই), তাহলে প্রতিটি মোডের জন্য অনন্য আইডি সহ স্বতন্ত্র Offer অবজেক্ট তৈরি করুন।

স্তরভিত্তিক ছাড় এবং অতিরিক্ত অফার

• পেমেন্ট পদ্ধতি অনুযায়ী স্তরভিত্তিক ছাড় : যদি ব্যবহৃত নির্দিষ্ট পেমেন্ট পদ্ধতির উপর ভিত্তি করে বিভিন্ন শতাংশে ছাড় দেওয়া হয় (যেমন, ক্রেডিট কার্ডের তুলনায় ই-ওয়ালেটের জন্য বেশি ছাড়), তবে সেগুলোকে অবশ্যই আলাদা অফার অবজেক্ট হিসেবে মডেল করতে হবে। একটি নির্ভরযোগ্য সঞ্চয়ের অভিজ্ঞতা নিশ্চিত করার জন্য পার্টনারদের উচিত সমস্ত সমর্থিত পেমেন্ট পদ্ধতির (যেমন, ই-ওয়ালেট, ক্রেডিট কার্ড, ডেবিট কার্ড, নেট ব্যাঙ্কিং) জন্য ব্যাপক প্রচারমূলক কভারেজ প্রদান করা। যদি কোনো অফার প্ল্যাটফর্মে গৃহীত সমস্ত পেমেন্ট পদ্ধতির জন্য সার্বজনীনভাবে প্রযোজ্য হয়, তবে পেমেন্ট ইন্সট্রুমেন্ট ফিল্ডটি সেট করা উচিত নয়।
• অ্যাড-অন অফার গঠন : একাধিক সুবিধা, যেমন ব্যাংক-নির্দিষ্ট রিওয়ার্ড পয়েন্ট বা গিফট কার্ড কেনার ক্ষেত্রে প্রযোজ্য অতিরিক্ত ক্যাশব্যাক, উপস্থাপন করার জন্য উপযুক্ত OfferCategory enum - OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER ব্যবহার করে সেগুলোকে সম্পূর্ণ আলাদা অ্যাড-অন অফার হিসেবে জমা দিন। OfferDetails.other_offer_details_text এর মধ্যে পুরস্কারটির বর্ণনা দিন (যেমন, "৫ গুণ পর্যন্ত রিওয়ার্ড পয়েন্ট" ), এবং OfferRestrictions.combinable_offer_ids এ মূল গিফট কার্ডের offer_id পূরণ করে এটিকে মূল গিফট কার্ড ডিলের সাথে লিঙ্ক করুন।

শর্তাবলী এবং বিশেষ শর্তাবলী

গিফট কার্ড বা ভাউচারের সম্পূর্ণ আইনি শর্তাবলী প্রদানের জন্য অংশীদারদের terms.terms_and_conditions এর উপর নির্ভর করা উচিত। ব্যবহারকারী-কেন্দ্রিক সমস্ত নির্দেশাবলী এবং ব্যবহারের নির্দেশিকা এই ফিল্ডে একত্রিত করুন।

যদি গুরুত্বপূর্ণ বিধিনিষেধের জন্য UI-তে বিশেষ গুরুত্বের প্রয়োজন হয় (যেমন একবার ব্যবহারযোগ্য ব্যালেন্সের মেয়াদ শেষ হওয়া, অর্থ ফেরত না পাওয়া, বা লেনদেন একত্রিত করার সর্বোচ্চ সীমা, যেমন "প্রতি বিলে সর্বোচ্চ ২টি ভাউচার একত্রিত করা যাবে" ), তাহলে সেগুলিকে offer_restrictions.special_conditions এ হাইলাইট করুন।

গুরুত্বপূর্ণ: special_conditions এ উল্লেখিত যেকোনো গুরুতর শর্ত অবশ্যই মূল terms.terms_and_conditions স্ট্রিং-এর মধ্যেও বিস্তারিতভাবে অন্তর্ভুক্ত করতে হবে।

শিরোনামের সুপারিশ প্রস্তাব করুন

অফারের শিরোনামের দৈর্ঘ্য অবশ্যই ৪০ অক্ষরের কম হতে হবে। offer_display_text থেকে মার্চেন্টের ব্র্যান্ডের নাম বাদ দিন, কারণ অফারগুলো সরাসরি মার্চেন্টের নিজস্ব প্লেস শিটে প্রদর্শিত হয়। আমরা নিম্নলিখিত শিরোনামের ফরম্যাটগুলো সুপারিশ করি:

ব্যবহারের ক্ষেত্র	প্রস্তাবিত শিরোনাম
ভাউচারে ফ্ল্যাট ডিসকাউন্ট	X% off on Gift Cards
পরিশোধ পদ্ধতির উপর ভিত্তি করে ছাড়ের পরিমাণ পরিবর্তনশীল।	X% off on Gift Cards using {e-wallet}
বিভিন্ন মূল্যমানের নোটের উপর ছাড়ের তারতম্য	X% off on Gift Cards (বিভিন্ন ছাড় আলাদা অফার হিসেবে পাঠান)
B2B2C উপহার কার্ড	X% off on Gift Cards ( ব্র্যান্ড_আইডি ব্যবহার করে থাম্বনেইলের মাধ্যমে ব্র্যান্ডিং দেখানো হয়)
অতিরিক্ত অফার	Flat/Up to 5X reward points/ <Platform> coins

ল্যান্ডিং পেজের প্রয়োজনীয়তা

প্রতিটি বিজ্ঞাপিত offer_url অবশ্যই কোনো মধ্যবর্তী রিডাইরেক্ট ছাড়াই সরাসরি HTTP 200 OK রিটার্ন করতে হবে এবং অফারটির সত্যতা প্রমাণকারী একটি সক্রিয় গন্তব্য পৃষ্ঠায় নিয়ে যেতে হবে।

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

গন্তব্য ল্যান্ডিং পেজে স্পষ্টভাবে উল্লেখ করা উচিত যে অফারটি শুধুমাত্র গিফট কার্ড বা ভাউচারের জন্য প্রযোজ্য।

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

কুপন কোড সহ অফার

কিছু অফারের জন্য ব্যবহারকারীকে একটি কুপন কোড প্রবেশ করাতে হয়, যেমন "মোট বিলের উপর ২০% ছাড় পেতে SAVE20 কোডটি প্রয়োগ করুন"। এটি মনে রাখা গুরুত্বপূর্ণ যে গুগল কুপন ডেফিনিশন থেকে কুপন কোড প্রদর্শন করে না। পার্টনাররা ব্যবহারকারীদের দেখানোর জন্য এই তথ্যটি OfferDetails.offer_display_text- এর মধ্যে অন্তর্ভুক্ত করতে পারে। কুপন-ভিত্তিক অফারগুলো সাধারণত দুটি শ্রেণীতে বিভক্ত:

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

গিফট কার্ড অফারের উদাহরণ JSON

{
  "data": [
    {
      "offer_id": "example-dining-gift-card-10off",
      "entity_ids": [
        "dining-1",
        "dining-2"
      ],
      "offer_modes": [
        "OFFER_MODE_GIFT_CARD_PURCHASE"
      ],
      "action_type": "ACTION_TYPE_DINING",
      "offer_source": "OFFER_SOURCE_AGGREGATOR",
      "offer_category": "OFFER_CATEGORY_BASE_OFFER",
      "offer_details": {
        "offer_display_text": "10% off on Gift Cards",
        "discount_percent": 10.0,
        "gift_card_info": {
          "fixed_denominations": {
            "amounts": [
              {
                "units": 500,
                "currency_code": "INR"
              },
              {
                "units": 1000,
                "currency_code": "INR"
              },
              {
                "units": 2000,
                "currency_code": "INR"
              }
            ]
          }
        }
      },
      "offer_restrictions": {
        "combinable_with_other_offers": false,
        "special_conditions": [
          "Single-use balance expiration applies",
          "Maximum 2 gift card vouchers can be combined per bill",
          "No cash refund will be provided against this voucher"
        ]
      },
      "terms": {
        "restricted_to_certain_users": false,
        "terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
      },
      "validity_periods": [
        {
          "valid_period": {
            "valid_from_time": {
              "seconds": "1774934350"
            },
            "valid_through_time": {
              "seconds": "1806470350"
            }
          },
          "validity_scope": "VALIDITY_SCOPE_CLAIM"
        },
        {
          "validity_duration_in_days": 365,
          "validity_scope": "VALIDITY_SCOPE_REDEEM"
        }
      ],
      "offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
    }
  ]
}