ট্রিগার পুশ বিজ্ঞপ্তি

অংশীদার দ্বারা প্রেরিত বিজ্ঞপ্তি

বার্তা যোগ করুন এবং অবহিত করুন

পটভূমি

কোনো ব্যবহারকারী পাস যোগ করার পর, আপনি হয়তো পাসটি সম্পর্কিত একটি বার্তা পাঠাতে এবং তাকে এ বিষয়ে অবহিত করতে চাইতে পারেন। `add Message` API অনুরোধের ক্ষেত্রে message_type হিসেবে ` TEXT_AND_NOTIFY ব্যবহার করলে নিম্নলিখিত ঘটনাটি ঘটে:

  1. "পাসের পিছনে" (যা ডিটেইলস টেমপ্লেট নামেও পরিচিত) একটি " মেসেজ " আইটেম যোগ করা হয় এবং যে ব্যবহারকারীদের পাস সেভ করা আছে, তাদের কাছে একটি পুশ নোটিফিকেশন পাঠানো হয়।
  2. ব্যবহারকারী নোটিফিকেশনটিতে ট্যাপ করলে, গুগল ওয়ালেটটি পাসের সামনে (অর্থাৎ কার্ড ভিউতে) খুলে যাবে এবং স্ক্রিনের উপরে "ভিউ মেসেজ" বাটনসহ একটি কলআউট দেখতে পাবেন।
  3. কলআউটটিতে ক্লিক করলে ব্যবহারকারীরা পাসের একেবারে শেষে চলে যাবেন, যেখানে নতুন অপঠিত বার্তাগুলো হাইলাইট করা থাকবে।

ব্যবহারকারীদের কাছে নোটিফিকেশন সহ বার্তা পাঠানোর সময় কিছু বিবেচ্য বিষয়

  • বার্তা সম্পর্কিত পুশ নোটিফিকেশন পেতে হলে ব্যবহারকারীদের তাদের পাসের জন্য নোটিফিকেশন চালু রাখতে হবে।
  • মেসেজে আপনার ওয়েবসাইট বা অ্যাপের ইউআরআই (URI) থাকতে পারে। হাইপারলিঙ্ক অবশ্যই পাসের সাথে সম্পর্কিত কোনো ওয়েবসাইট বা অ্যাপের হতে হবে। পাসের সাথে সম্পর্কিত নয় এমন লিঙ্কে ব্যবহারকারীদের পাঠানো গ্রহণযোগ্য ব্যবহার নীতির লঙ্ঘন।
  • আপনি ২৪ ঘণ্টার মধ্যে সর্বাধিক ৩টি বার্তা পাঠাতে পারবেন যা পুশ নোটিফিকেশন চালু করবে। আপনি যদি আপনার ব্যবহারকারীদের স্প্যাম করছেন বলে মনে করা হয়, তবে গুগল আপনার পুশ নোটিফিকেশন পাঠানোর কোটা কমিয়ে দিতে পারে।
  • ব্যবহারকারীরা তাদের লক স্ক্রিনে যে পুশ নোটিফিকেশন দেখেন, তা গুগল ওয়ালেট দ্বারা নিয়ন্ত্রিত হয়।
  • আপনি সাধারণ ক্লাস বা অবজেক্ট এন্ডপয়েন্ট ব্যবহার করে মেসেজ ডেটা সম্পাদনা বা অপসারণ করতে UPDATE অথবা PATCH মেথড ব্যবহার করতে পারেন।

একীকরণ পদক্ষেপ

AddMessage API ব্যবহার করে যোগ করা একটি নতুন ইস্যুকারী বার্তা সম্পর্কে ব্যবহারকারীদের অবহিত করতে চাইলে, আপনাকে AddMessageRequest- টি আপডেট করতে হবে, যাতে আপনার নতুন টেক্সট সম্বলিত Message-টির MessageType, TEXT- এর পরিবর্তে TEXT_AND_NOTIFY হয়।

একটি Passes ক্লাসে বার্তা যোগ করতে এবং অবহিত করার জন্য JSON অনুরোধের উদাহরণ 

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

একটি Passes Object-এ বার্তা যোগ করতে এবং অবহিত করার জন্য JSON অনুরোধের উদাহরণ। 

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

একটি পাস ক্লাসের জন্য বার্তা যোগ করা এবং অবহিত করার প্রতিক্রিয়ার উদাহরণ 

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

ব্যতিক্রম পরিচালনা

তিনবারের বেশি নোটিফাই করার যেকোনো প্রচেষ্টার ফলে একটি QuotaExceededException রেসপন্স পাওয়া যাবে। ইন্টিগ্রেশন স্টেপস -এ যেমন আলোচনা করা হয়েছে, সেই অনুযায়ী " TEXT_AND_NOTIFY "-এর পরিবর্তে " TEXT " ব্যবহার করে পাসের যেকোনো পরবর্তী আপডেট সেট করা যেতে পারে।

ক্ষেত্রটি আপডেট করুন এবং অবহিত করুন

পটভূমি

কোনো ব্যবহারকারী পাস যোগ করার পর, আপনি নির্দিষ্ট কিছু ফিল্ড আপডেট করলে একটি পুশ নোটিফিকেশন চালু করতে চাইতে পারেন। নোটিফিকেশনটি ব্যবহারকারীর লক স্ক্রিনে প্রদর্শিত হবে এবং তাদের জানাবে যে তাদের পাসে একটি আপডেট এসেছে। এই নোটিফিকেশনটি শুধুমাত্র UPDATE এবং PATCH API মেথড ব্যবহার করে নিচে সংজ্ঞায়িত করা ফিল্ডগুলোর একটি নির্দিষ্ট উপসেটের জন্য চালু হবে। পাস আপডেট করার জন্য একবার API কল করা হলে নিম্নলিখিত ঘটনাগুলো ঘটে:

  1. ব্যবহারকারীর লক স্ক্রিনে একটি পুশ নোটিফিকেশন পাঠানো হয় ও প্রদর্শিত হয়, যা তাকে পাস আপডেটের বিষয়ে অবহিত করে।
  2. ব্যবহারকারী নোটিফিকেশনটিতে ট্যাপ করলে, গুগল ওয়ালেটটি পাসের সামনের অংশে (অর্থাৎ কার্ড ভিউতে) খুলে যাবে এবং স্ক্রিনের উপরে 'রিভিউ আপডেট' বাটনসহ একটি কলআউট দেখতে পাবেন।
  3. বাটনটিতে ক্লিক করলে ব্যবহারকারী এমন একটি স্ক্রিনে চলে যান যেখানে তিনি আপডেটের ফলে পরিবর্তিত ফিল্ডগুলো দেখতে পারেন।

ফিল্ড আপডেট নোটিফিকেশন পাঠানোর সময় কিছু বিবেচ্য বিষয়

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

একীকরণ পদক্ষেপ

এই নোটিফিকেশনগুলো চালু করার জন্য, আপনাকে বিদ্যমান UPDATE বা PATCH কলগুলো ব্যবহার করতে হবে এবং notifyPreference নির্দিষ্ট করে দিতে হবে। কোনো ক্লাস বা অবজেক্টের ফিল্ড আপডেট করার সময়, নোটিফিকেশনটি চালু করার জন্য আপনি ক্লাস বা অবজেক্ট রিকোয়েস্টে notifyPreference নামে একটি নতুন ফিল্ড যোগ করতে পারেন।

একটি ক্লাসে আপডেট এবং নোটিফাই করার জন্য JSON রিকোয়েস্টের উদাহরণ 

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …

notifyPreference কে notifyOnUpdate এ সেট করলে একটি নোটিফিকেশন ট্রিগার হবে, যদি আপডেট করা ফিল্ডটি বর্তমানে সমর্থিত থাকে।

সমর্থিত ক্ষেত্র

ইভেন্ট টিকেট ক্লাস
  • ইভেন্টের নাম
  • ইভেন্টের স্থান.নাম
  • অনুষ্ঠানের স্থান ঠিকানা
  • ইভেন্টের তারিখ ও সময়। দরজা খোলা
  • ইভেন্টের তারিখ ও সময় শুরু
ইভেন্ট টিকেট অবজেক্ট
  • ইভেন্টসিট.সিট
  • ইভেন্টসিট.সারি
  • ইভেন্টসিট.বিভাগ
  • ইভেন্টসিট.গেট

নিকটবর্তী বিজ্ঞপ্তি

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

একীকরণ পদক্ষেপ

কীভাবে ব্যবহার করবেন

এই ফিচারটি ব্যবহার করার জন্য, আপনাকে আপনার ক্লাস এবং অবজেক্টে লোকেশন যোগ করতে হবে। আপনি প্রতি ক্লাসে সর্বোচ্চ ১০টি এবং প্রতি অবজেক্টে সর্বোচ্চ ১০টি লোকেশন যোগ করতে পারেন। আপনার ক্লাস বা অবজেক্ট ডেফিনিশনে MerchantLocations ব্যবহার করুন। insert , patch , বা update মেথডগুলো ব্যবহার করার সময় আপনি এই লোকেশনগুলো যোগ করতে পারেন।

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

MerchantLocations সেট করা একটি LoyaltyClass-এর উদাহরণ: 
{
  "kind": "walletobjects#loyaltyClass",
  "programLogo": {
  "kind": "walletobjects#image",
  "sourceUri": {
    "uri":
    ...
  }
  },
  "localizedProgramName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Program Name",
    }
  },
  "id": Id1234,
  "version": "1",
  "allowMultipleUsersPerObject": true,
  "reviewStatus": "underReview",
  "enableSmartTap": false,
  "localizedIssuerName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Issuer Name"
    }
  },
  "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
  "merchantLocations": [
    {
      "latitude": 37.79020867928078,
      "longitude": -122.39004
    },
    {
      "latitude": 37.42587,
      "longitude": -122.08620
    },
  ]
}

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

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

গুগল ওয়ালেট দ্বারা সক্রিয় স্বয়ংক্রিয় বিজ্ঞপ্তি

আসন্ন বিজ্ঞপ্তি

গুগল ওয়ালেট কোনো ইভেন্টের তিন ঘণ্টা আগে ব্যবহারকারীকে একটি নোটিফিকেশন পাঠায়। ইভেন্টের সময়টি class.dateTime.start দ্বারা নির্ধারিত হয়।

এই বিজ্ঞপ্তিটি পেতে হলে, ব্যবহারকারীকে অবশ্যই বিজ্ঞপ্তি চালু রাখতে হবে। এটি পরীক্ষা করার জন্য, তারা সেটিংস > বিজ্ঞপ্তি- তে গিয়ে দেখতে পারেন যে ‘আপনার পাস সম্পর্কিত আপডেট’ চালু আছে কিনা।

নোটিফিকেশনটি নোটিফিকেশন এরিয়াতে এবং লক স্ক্রিনেও দেখা যায়, যদি ব্যবহারকারী লক স্ক্রিনের জন্য নোটিফিকেশন চালু করে রাখেন।

বিজ্ঞপ্তিটির নিম্নলিখিত অপরিবর্তনীয় বিন্যাস রয়েছে:

  class.eventName

যদি তারা নোটিফিকেশনটিতে ট্যাপ করে তাদের ডিভাইসটি আনলক করেন, তাহলে তাদের পাসওয়ার্ডটি গুগল ওয়ালেট অ্যাপে দেখা যাবে।

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

নোটিফিকেশনটি পিন করা থাকে এবং ব্যবহারকারী এটি খোলার পর স্বয়ংক্রিয়ভাবে অদৃশ্য হবে না। class.dateTime.start ৬০ মিনিট পর এটি স্বয়ংক্রিয়ভাবে অদৃশ্য হয়ে যায়।