ভ্যালু অ্যাডেড সুযোগ

ব্যাকগ্রাউন্ড

আপনি এখন ভ্যালু অ্যাডেড অপরচুনিটি মডিউল অন্তর্ভুক্ত করার জন্য অবজেক্ট ও ক্লাস আপডেট করতে পারবেন। মডিউলগুলি পাসের নিচের অংশে দেখানো হবে এবং ইস্যুকারীর কন্টেন্টের সাথে লিঙ্ক করা যেতে পারে। এই ডকুমেন্টটি Google Wallet API ব্যবহার করে মডিউল চালু ও ব্যবহার করার জন্য প্রয়োজনীয় মূল ধাপগুলি সম্পর্কে বিস্তারিত তথ্য প্রদান করে।

মনে রাখবেন: গিফ্ট কার্ড, লয়ালটি কার্ড ও অফারের ক্ষেত্রে আমরা Shopping Merchant Center-এর সাথে অটোমেটিক ইন্টিগ্রেশনও কাজ করে।

ফিচারের উদাহরণ

সিঙ্গেল ভিউ	তালিকা ভিউ

নিম্নলিখিত নির্দেশিকা ধরে নেয় যে আপনি Google Wallet-এর প্রাথমিক ধারণা সম্পর্কে জানেন এবং আগে থেকেই সাজেস্ট করা পূর্বশর্ত পূরণ করেছেন। আপনার Google Wallet POC-কে কোনও প্রশ্ন বা মতামত পাঠান।

ইন্টিগ্রেশনের ধাপ

নতুন মডিউল যোগ করতে, আপনাকে অবজেক্ট এবং/অথবা ক্লাস আপডেট করতে হবে যাতে ValueAddedModuleData অন্তর্ভুক্ত করা যায়। ValueAddedModuleData-তে নিম্নলিখিত ফিল্ড আছে:

[প্রয়োজনীয়] LocalizedString হেডার

মডিউলে দেখানো হেডার। অক্ষর সীমা ৬০টি এবং এর চেয়ে বড় স্ট্রিং ছোট করে দেওয়া হবে।

LocalizedString body

মডিউলে দেখানো বডি। অক্ষর সীমা ৫০ এবং এর থেকে বড় স্ট্রিং ছোট করে দেওয়া হবে।

Image image

মডিউলে দেখানো ছবি। ১:১ হল সাজেস্ট করা ছবির রেশিও এবং এই রেশিওর সাথে মানানসই করতে ছবিগুলির সাইজ পরিবর্তন করা হবে।

[প্রয়োজনীয়] স্ট্রিং uri

ক্লিক করা হলে মডিউলটি যে URI-তে নিয়ে যায়। এটি কোনও ওয়েব লিঙ্ক বা ডিপ লিঙ্ক হতে পারে।

ModuleViewConstraints viewConstraints

মডিউল দেখানোর জন্য সব বাধ্যবাধকতা পূরণ করতে হবে। ModuleViewConstraints-এ নিম্নলিখিত ফিল্ড আছে:

TimeInterval displayInterval

ব্যবহারকারীদের যত সময়ের জন্য মডিউলটি দেখানো হবে। `startTime` এবং `endTime` উভয়ই নির্ধারণ করতে পারে। `startTime` সেট করা না থাকলে, যোগ করার সাথে সাথেই মডিউলটি দেখানো হয়। `endTime` সেট করা না থাকলে মডিউলটি অনির্দিষ্টকালের জন্য দেখানো হয়।

int32 sortIndex

মডিউল সাজানোর জন্য ইন্ডেক্স। কম সর্ট ইন্ডেক্স সহ মডিউলগুলি বেশি সর্ট ইন্ডেক্স সহ মডিউলগুলির আগে দেখানো হয়। অনির্দিষ্ট থাকলে, সাজানোর ইন্ডেক্স INT_MAX হিসেবে ধরা হয়। দুটি মডিউলের ইন্ডেক্স একই হলে, সর্টিং আচরণ অনির্দিষ্ট হয়।

ValueAddedModuleData-এর উদাহরণ:

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

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

প্রত্যাশিত আচরণ

অবজেক্ট এবং/অথবা ক্লাস সফলভাবে আপডেট করার পরে, আপনি এখন সংশ্লিষ্ট পাসে মডিউল দেখতে পাবেন। আপনি যদি শুধুমাত্র একটি মডিউল যোগ করে থাকেন, তাহলে আপনি এটি পাসের সামনের দিকে দেখতে পাবেন।

ভ্যালু অ্যাডেড সুযোগ মডিউল সংক্রান্ত নির্দেশিকা

মডিউল হল অতিরিক্ত অ্যাকশনের মাধ্যমে আপনার ব্যবহারকারীর পাস অভিজ্ঞতাকে আরও উন্নত করার সুযোগ। মডিউল তৈরি ও ম্যানেজ করার সময় আপনাকে নিম্নলিখিত বিষয়গুলি বিবেচনা করতে হবে:

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

ব্যতিক্রম ম্যানেজ করা

মেসেজ	কারণ
ValueAddedModuleData-তে অবশ্যই হেডার থাকতে হবে।	ValueAddedModuleData-তে কোনও হেডার নেই।
ValueAddedModuleData-তে খালি নয় এমন URI থাকতে হবে।	ValueAddedModuleData-তে খালি নয় এমন URI নেই।
প্রতিটি ক্লাসে সর্বাধিক ১৫টি ভ্যালু অ্যাডেড মডিউল যোগ করা যাবে।	ক্লাসে ভ্যালু অ্যাডেড মডিউল কমাতে হবে।
প্রতিটি অবজেক্টে সর্বাধিক ১৫টি ভ্যালু অ্যাডেড মডিউল ব্যবহার করা যাবে।	অবজেক্টে ভ্যালু অ্যাডেড মডিউলের সংখ্যা কমাতে হবে।