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

পার্টনার ট্রিগার করা বিজ্ঞপ্তি

মেসেজ যোগ করুন এবং বিজ্ঞপ্তি পাঠান

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

কোনও ব্যবহারকারী পাস যোগ করার পরে, আপনি তাকে পাস সম্পর্কিত কোনও মেসেজ পাঠাতে এবং তিনি যাতে সেই সম্পর্কে বিজ্ঞপ্তি পান তা নিশ্চিত করতে চাইতে পারেন। Add Message API অনুরোধ ব্যবহার করে message_type-এর মান TEXT_AND_NOTIFY-এর সমান হলে নিম্নলিখিত ঘটনা ঘটে:

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

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

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

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

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

Passes Class-এ মেসেজ যোগ করা এবং বিজ্ঞপ্তি পাঠানোর জন্য 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 অবজেক্টে মেসেজ যোগ করা এবং বিজ্ঞপ্তি পাঠানোর জন্য 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"
    },
  …

পাস ক্লাসের জন্য মেসেজ যোগ করতে এবং বিজ্ঞপ্তি দিতে Response-এর উদাহরণ

  // 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. ব্যবহারকারী বিজ্ঞপ্তিতে ট্যাপ করলে, Google Wallet-এ পাসের সামনের দিক (অর্থাৎ কার্ড ভিউ) খুলে যায় এবং ব্যবহারকারী স্ক্রিনের সবচেয়ে উপরে "আপডেট পর্যালোচনা করুন" বোতাম সহ একটি কলআউট দেখতে পাবেন।
  3. বোতামে ক্লিক করলে ব্যবহারকারী এমন একটি স্ক্রিনে পৌঁছান যেখানে তিনি আপডেটের মাধ্যমে পরিবর্তিত ফিল্ডগুলি দেখতে পান।

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

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

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

এইসব বিজ্ঞপ্তি ট্রিগার করতে, আপনাকে আগে থেকে থাকা UPDATE বা PATCH কল ব্যবহার করতে হবে এবং notifyPreference উল্লেখ করতে হবে। কোনও ক্লাস বা অবজেক্টের ফিল্ড আপডেট করার সময়, আপনি ক্লাস বা অবজেক্টের অনুরোধে নতুন ফিল্ড, notifyPreference, যোগ করতে পারেন যাতে বিজ্ঞপ্তি ট্রিগার করা যায়।

কোনও ক্লাসে আপডেট ও বিজ্ঞপ্তি পাঠানোর জন্য JSON অনুরোধের উদাহরণ

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

notifyPreference-কে notifyOnUpdate-এ সেট করলে একটি বিজ্ঞপ্তি ট্রিগার হবে, তবে আপডেট করা ফিল্ডটি বর্তমানে কাজ করতে হবে।

কাজ করে এমন ফিল্ড

EventTicketClass
  • eventName
  • eventVenue.name
  • eventvenue.address
  • eventDateTime.doorsOpen
  • eventDateTime.start
EventTicketObject
  • eventSeat.seat
  • eventSeat.row
  • eventSeat.section
  • eventSeat.gate

আশেপাশের বিজ্ঞপ্তি

এই ফিচারটি সেইসব ব্যবহারকারীকে পুশ বিজ্ঞপ্তি দেখাবে যারা বিজ্ঞপ্তি চালু করেছেন এবং Google Wallet অ্যাপকে সুনির্দিষ্ট, সবসময় চালু লোকেশন অ্যাক্সেস দিয়েছেন। এই বিজ্ঞপ্তি তাদের মনে করিয়ে দেবে যে তারা তাদের বর্তমান লোকেশনের সাথে প্রাসঙ্গিক একটি পাস সেভ করেছেন।

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

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

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

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

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
    },
  ]
}

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

ব্যবহারকারী নির্দিষ্ট MerchantLocations-এর কোনও একটিতে থাকলে, তার পাসের ব্যাপারে স্টিকি বিজ্ঞপ্তি পাওয়া উচিত। তিনি বিজ্ঞপ্তিতে ক্লিক করলে, Google Wallet-এ তার পাস খুলে যাবে। ব্যবহারকারীরা সোয়াইপ জেসচারের মাধ্যমে বিজ্ঞপ্তি বাতিল করতে পারবেন। ব্যবহারকারী লোকেশন থেকে বেরিয়ে গেলে, বিজ্ঞপ্তিটি আর দেখা যাবে না।

Google Wallet-এর মাধ্যমে ট্রিগার করা অটোমেটিক বিজ্ঞপ্তি

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

ইভেন্ট শুরু হওয়ার তিন ঘণ্টা আগে Google Wallet ব্যবহারকারীকে বিজ্ঞপ্তি পাঠায়। ইভেন্টের সময় class.dateTime.start দ্বারা সংজ্ঞায়িত।

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

বিজ্ঞপ্তিটি বিজ্ঞপ্তি দেখানোর জায়গায় এবং লক স্ক্রিনে দেখা যায়, যদি ব্যবহারকারী লক স্ক্রিনের জন্য বিজ্ঞপ্তি চালু করে থাকেন।

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

  class.eventName

তিনি বিজ্ঞপ্তিতে ট্যাপ করে ডিভাইস আনলক করলে, Google Wallet অ্যাপে তার পাস দেখতে পাবেন।

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

বিজ্ঞপ্তিটি পিন করা আছে এবং ব্যবহারকারী এটি খোলার পরে অটোমেটিক বন্ধ হবে না। class.dateTime.start-এর ৬০ মিনিট পরে অটোমেটিক বাতিল হয়ে যায়।