পার্টনার ট্রিগার করা বিজ্ঞপ্তি
বার্তা যোগ করুন এবং বিজ্ঞপ্তি দিন
পটভূমি
একজন ব্যবহারকারী একটি পাস যোগ করার পর, আপনি তাদের পাস সম্পর্কিত একটি বার্তা পাঠাতে পারেন এবং নিশ্চিত করতে পারেন যে তারা এটি সম্পর্কে অবহিত। TEXT_AND_NOTIFY এর সমান message_type সহ Add Message API অনুরোধ ব্যবহার করে নিম্নলিখিতটি ঘটে:
- "পাসের পিছনে" (যাকে " বিস্তারিত টেমপ্লেট "ও বলা হয়) একটি " বার্তা " আইটেম যোগ করা হয় এবং পাসটি সংরক্ষিত থাকা ব্যবহারকারীদের কাছে একটি পুশ বিজ্ঞপ্তি পাঠানো হয়।
- ব্যবহারকারী একবার বিজ্ঞপ্তিতে ট্যাপ করলে এটি পাসের সামনের দিকে (যাকে কার্ড ভিউও বলা হয়) গুগল ওয়ালেট খুলবে এবং ব্যবহারকারী স্ক্রিনের শীর্ষে "বার্তা দেখুন" বোতাম সহ একটি কলআউট দেখতে পাবেন।
- কলআউটে ক্লিক করলে ব্যবহারকারীরা পাসের পিছনে চলে যাবেন, যেখানে নতুন অপঠিত বার্তাগুলি হাইলাইট করা হবে।
ব্যবহারকারীদের বিজ্ঞপ্তি সহ বার্তা পাঠানোর সময় কিছু বিবেচ্য বিষয়
- বার্তা সম্পর্কিত পুশ বিজ্ঞপ্তিগুলি পেতে ব্যবহারকারীদের পাসের জন্য বিজ্ঞপ্তি সক্ষম থাকতে হবে।
- বার্তাগুলিতে আপনার ওয়েবসাইট বা অ্যাপের 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 " ব্যবহার করে সেট করা যেতে পারে।
কাছাকাছি বিজ্ঞপ্তি
এই বৈশিষ্ট্যটি এমন ব্যবহারকারীদের দেখাবে যারা বিজ্ঞপ্তি সক্ষম করেছেন এবং 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
},
]
}প্রত্যাশিত আচরণ
ব্যবহারকারীরা যখন নির্দিষ্ট মার্চেন্টলোকেশনের যেকোনো একটিতে থাকবেন তখন তাদের পাস সম্পর্কে একটি স্টিকি নোটিফিকেশন পাবেন। যদি তারা বিজ্ঞপ্তিতে ক্লিক করেন, তাহলে এটি তাদের পাসটি গুগল ওয়ালেটে খুলবে। ব্যবহারকারীরা সোয়াইপ জেসচারের মাধ্যমে বিজ্ঞপ্তিটি বাতিল করতে পারবেন। যখন কোনও ব্যবহারকারী অবস্থান ছেড়ে চলে যাবেন, তখন বিজ্ঞপ্তিটি অদৃশ্য হয়ে যাবে।