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

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

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

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

কোনও ব্যবহারকারী পাস যোগ করার পরে, আপনি তাকে পাস সম্পর্কিত কোনও মেসেজ পাঠাতে এবং তিনি যাতে সেই সম্পর্কে বিজ্ঞপ্তি পান তা নিশ্চিত করতে চাইতে পারেন। 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" ব্যবহার করে সেট করা যেতে পারে।

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

এই ফিচারটি সেইসব ব্যবহারকারীকে পুশ বিজ্ঞপ্তি দেখাবে যারা বিজ্ঞপ্তি চালু করেছেন এবং 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-এ তার পাস খুলে যাবে। ব্যবহারকারীরা সোয়াইপ জেসচারের মাধ্যমে বিজ্ঞপ্তি বাতিল করতে পারবেন। ব্যবহারকারী লোকেশন থেকে বেরিয়ে গেলে, বিজ্ঞপ্তিটি আর দেখা যাবে না।