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

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

বার্তা যোগ করুন এবং বিজ্ঞপ্তি দিন

পটভূমি

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

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

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

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

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

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

একটি পাসেস ক্লাসে বার্তা যোগ করার এবং বিজ্ঞপ্তি দেওয়ার জন্য 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"
    },
  …

একটি পাসেস অবজেক্টে বার্তা এবং বিজ্ঞপ্তি যোগ করার জন্য 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 এ সেট করলে একটি বিজ্ঞপ্তি আসবে, যদি আপডেট করা ক্ষেত্রটি বর্তমানে সমর্থিত হয়।

সমর্থিত ক্ষেত্রগুলি

ইভেন্ট টিকিটক্লাস
  • ইভেন্টের নাম
  • ইভেন্টভেন্যু.নাম
  • ইভেন্টভেন্যু.ঠিকানা
  • ইভেন্টডেটটাইম.দরজাখোলা
  • ইভেন্টডেটটাইম.স্টার্ট
ইভেন্ট টিকিট অবজেক্ট
  • ইভেন্টসিট.সিট
  • ইভেন্টসিট.রো
  • ইভেন্টসিট.সেকশন
  • ইভেন্টসিট.গেট

কাছাকাছি বিজ্ঞপ্তি

এই বৈশিষ্ট্যটি এমন ব্যবহারকারীদের দেখাবে যারা বিজ্ঞপ্তি সক্ষম করেছেন এবং 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
    },
  ]
}

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

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

Google Wallet দ্বারা ট্রিগার করা স্বয়ংক্রিয় বিজ্ঞপ্তি

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

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

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

ব্যবহারকারী যদি লক স্ক্রিনের জন্য বিজ্ঞপ্তি সক্ষম করে থাকেন, তাহলে বিজ্ঞপ্তিটি বিজ্ঞপ্তি এলাকায় এবং লক স্ক্রিনে প্রদর্শিত হবে।

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

  class.eventName

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

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

বিজ্ঞপ্তিটি পিন করা আছে এবং ব্যবহারকারী এটি খোলার পরে স্বয়ংক্রিয়ভাবে খারিজ হবে না। class.dateTime.start এর 60 মিনিট পরে স্বয়ংক্রিয়ভাবে খারিজ হবে।