আপনি যদি প্রোগ্রামগতভাবে অনুরোধ পাঠানোর জন্য FCM API ব্যবহার করেন, তাহলে আপনি দেখতে পাবেন যে, সময়ের সাথে সাথে, আপনি পুরানো রেজিস্ট্রেশন টোকেন সহ নিষ্ক্রিয় ডিভাইসগুলিতে বার্তা পাঠিয়ে সম্পদ নষ্ট করছেন। এই পরিস্থিতি Firebase কনসোলে রিপোর্ট করা মেসেজ ডেলিভারি ডেটা বা BigQuery-এ রপ্তানি করা ডেটাকে প্রভাবিত করতে পারে, যা ডেলিভারির হারে নাটকীয় (কিন্তু আসলে বৈধ নয়) হিসাবে দেখা যাচ্ছে। দক্ষ বার্তা টার্গেটিং এবং বৈধ ডেলিভারি রিপোর্টিং নিশ্চিত করতে সাহায্য করার জন্য আপনি নিতে পারেন এমন কিছু ব্যবস্থা নিয়ে এই গাইডটি আলোচনা করে।
মৌলিক সেরা অনুশীলন
এমন কিছু মৌলিক অনুশীলন রয়েছে যা আপনাকে যে কোনো অ্যাপে অনুসরণ করা উচিত যা প্রোগ্রামগতভাবে অনুরোধ পাঠানোর জন্য FCM API ব্যবহার করে। প্রধান সেরা অনুশীলন হল:
- আপনার সার্ভারে রেজিস্ট্রেশন টোকেন সংরক্ষণ করুন। সার্ভারের জন্য একটি গুরুত্বপূর্ণ ভূমিকা হল প্রতিটি ক্লায়েন্টের টোকেনের ট্র্যাক রাখা এবং সক্রিয় টোকেনের একটি আপডেট তালিকা রাখা। আমরা দৃঢ়ভাবে আপনার কোড এবং আপনার সার্ভারে একটি টোকেন টাইমস্ট্যাম্প প্রয়োগ করার এবং নিয়মিত বিরতিতে এই টাইমস্ট্যাম্প আপডেট করার সুপারিশ করি৷
- সঞ্চিত টোকেনগুলি সরান যা বাসি হয়ে গেছে । অবৈধ টোকেন প্রতিক্রিয়াগুলির সুস্পষ্ট ক্ষেত্রে টোকেনগুলি সরানোর পাশাপাশি, আপনাকে সম্ভবত অন্যান্য লক্ষণগুলি পর্যবেক্ষণ করতে হবে যে টোকেনটি পুরানো। এই নির্দেশিকাটি এটি অর্জনের জন্য আপনার কিছু বিকল্প নিয়ে আলোচনা করে।
রেজিস্ট্রেশন টোকেন পুনরুদ্ধার করুন এবং সংরক্ষণ করুন
আপনার অ্যাপের প্রাথমিক স্টার্টআপে, FCM SDK ক্লায়েন্ট অ্যাপের উদাহরণের জন্য একটি নিবন্ধন টোকেন তৈরি করে। এটি এমন একটি টোকেন যা আপনাকে API থেকে টার্গেটেড সেন্ড রিকোয়েস্টে অন্তর্ভুক্ত করতে হবে, অথবা টপিক টার্গেট করার জন্য টপিক সাবস্ক্রিপশনে যোগ করতে হবে।
আমাদের ক্লায়েন্ট সেটআপ নির্দেশিকাগুলিতে যেমন উল্লেখ করা হয়েছে, আপনার অ্যাপকে প্রাথমিক স্টার্টআপে এই টোকেনটি পুনরুদ্ধার করা উচিত এবং একটি টাইমস্ট্যাম্পের সাথে আপনার অ্যাপ সার্ভারে সংরক্ষণ করা উচিত । এই টাইমস্ট্যাম্পটি আপনার কোড এবং আপনার সার্ভার দ্বারা প্রয়োগ করা আবশ্যক, কারণ এটি আপনার জন্য FCM SDK দ্বারা সরবরাহ করা হয় না।
এছাড়াও, সার্ভারে টোকেন সংরক্ষণ করা এবং টাইমস্ট্যাম্প আপডেট করা গুরুত্বপূর্ণ, যখনই এটি পরিবর্তন হয়, যেমন যখন:
- অ্যাপটি একটি নতুন ডিভাইসে পুনরুদ্ধার করা হয়েছে
- ব্যবহারকারী অ্যাপটি আনইনস্টল/পুনরায় ইনস্টল করে
- ব্যবহারকারী অ্যাপ ডেটা সাফ করে।
উদাহরণ: ক্লাউড ফায়ারস্টোরে টোকেন এবং টাইমস্ট্যাম্প সংরক্ষণ করুন
উদাহরণস্বরূপ, আপনি fcmTokens নামে একটি সংগ্রহে টোকেন সংরক্ষণ করতে ক্লাউড ফায়ারস্টোর ব্যবহার করতে পারেন। সংগ্রহে থাকা প্রতিটি ডকুমেন্ট আইডি একটি ইউজার আইডির সাথে মিলে যায় এবং ডকুমেন্টটি বর্তমান রেজিস্ট্রেশন টোকেন এবং এর সর্বশেষ আপডেট করা টাইমস্ট্যাম্প সংরক্ষণ করে। এই Kotlin উদাহরণে দেখানো হিসাবে set ফাংশন ব্যবহার করুন:
/**
* Persist token to third-party servers.
*
* Modify this method to associate the user's FCM registration token with any server-side account
* maintained by your application.
*
* @param token The new token.
*/
private fun sendTokenToServer(token: String?) {
// If you're running your own server, call API to send token and today's date for the user
// Example shown below with Firestore
// Add token and timestamp to Firestore for this user
val deviceToken = hashMapOf(
"token" to token,
"timestamp" to FieldValue.serverTimestamp(),
)
// Get user ID from Firebase Auth or your own server
Firebase.firestore.collection("fcmTokens").document("myuserid")
.set(deviceToken)
}
যখনই একটি টোকেন পুনরুদ্ধার করা হয়, এটি sendTokenToServer কল করে ক্লাউড ফায়ারস্টোরে সংরক্ষণ করা হয়:
/**
* Called if the FCM registration token is updated. This may occur if the security of
* the previous token had been compromised. Note that this is called when the
* FCM registration token is initially generated so this is where you would retrieve the token.
*/
override fun onNewToken(token: String) {
Log.d(TAG, "Refreshed token: $token")
// If you want to send messages to this application instance or
// manage this apps subscriptions on the server side, send the
// FCM registration token to your app server.
sendTokenToServer(token)
}
var token = Firebase.messaging.token.await()
// Check whether the retrieved token matches the one on your server for this user's device
val preferences = this.getPreferences(Context.MODE_PRIVATE)
val tokenStored = preferences.getString("deviceToken", "")
lifecycleScope.launch {
if (tokenStored == "" || tokenStored != token)
{
// If you have your own server, call API to send the above token and Date() for this user's device
// Example shown below with Firestore
// Add token and timestamp to Firestore for this user
val deviceToken = hashMapOf(
"token" to token,
"timestamp" to FieldValue.serverTimestamp(),
)
// Get user ID from Firebase Auth or your own server
Firebase.firestore.collection("fcmTokens").document("myuserid")
.set(deviceToken).await()
}
}
FCM ব্যাকএন্ড থেকে অবৈধ টোকেন প্রতিক্রিয়া সনাক্ত করুন৷
FCM থেকে অবৈধ টোকেন প্রতিক্রিয়া শনাক্ত করা নিশ্চিত করুন এবং আপনার সিস্টেম থেকে অবৈধ বলে পরিচিত যেকোন রেজিস্ট্রেশন টোকেন মুছে দিয়ে প্রতিক্রিয়া জানান৷ HTTP v1 API এর সাথে, এই ত্রুটি বার্তাগুলি নির্দেশ করতে পারে যে আপনার প্রেরণের অনুরোধটি লক্ষ্যবস্তু বা অকার্যকর টোকেন:
-
UNREGISTERED(HTTP 404) -
INVALID_ARGUMENT(HTTP 400)
মনে রাখবেন, যেহেতু বার্তা পেলোডের সমস্যাগুলির ক্ষেত্রেও INVALID_ARGUMENT নিক্ষেপ করা হয়, তাই পেলোড সম্পূর্ণ বৈধ হলেই এটি একটি অবৈধ টোকেনকে সংকেত দেয়৷ আরো তথ্যের জন্য ErrorCodes দেখুন।
আপনি যদি নিশ্চিত হন যে মেসেজ পেলোডটি বৈধ এবং আপনি একটি টার্গেটেড টোকেনের জন্য এই প্রতিক্রিয়াগুলির মধ্যে একটি গ্রহণ করেন, তাহলে এই টোকেনের আপনার রেকর্ড মুছে ফেলা নিরাপদ, কারণ এটি আর কখনও বৈধ হবে না। উদাহরণস্বরূপ, ক্লাউড ফায়ারস্টোর থেকে অবৈধ টোকেনগুলি মুছতে, আপনি নিম্নলিখিতগুলির মতো একটি ফাংশন স্থাপন এবং চালাতে পারেন:
// Registration token comes from the client FCM SDKs
const registrationToken = 'YOUR_REGISTRATION_TOKEN';
const message = {
data: {
// Information you want to send inside of notification
},
token: registrationToken
};
// Send message to device with provided registration token
getMessaging().send(message)
.then((response) => {
// Response is a message ID string.
})
.catch((error) => {
// Delete token for user if error code is UNREGISTERED or INVALID_ARGUMENT.
if (errorCode == "messaging/registration-token-not-registered") {
// If you're running your own server, call API to delete the token for the user
// Example shown below with Firestore
// Get user ID from Firebase Auth or your own server
Firebase.firestore.collection("fcmTokens").document(user.uid).delete()
}
});
নিবন্ধন টোকেন সতেজতা নিশ্চিত করা
একটি টোকেন তাজা বা বাসি কিনা তা নির্ধারণ করা সর্বদা সোজা নয়। সমস্ত ক্ষেত্রে কভার করার জন্য, আপনি যখন টোকেনগুলিকে পুরানো মনে করেন তার জন্য একটি থ্রেশহোল্ড গ্রহণ করা উচিত; আমাদের সুপারিশ দুই মাস। দুই মাসের বেশি পুরানো কোনো টোকেন একটি নিষ্ক্রিয় ডিভাইস হতে পারে; একটি সক্রিয় ডিভাইস অন্যথায় তার টোকেন রিফ্রেশ হবে.
নিয়মিত টোকেন আপডেট করুন
আমরা সুপারিশ করি যে আপনি পর্যায়ক্রমে আপনার সার্ভারে সমস্ত নিবন্ধন টোকেন পুনরুদ্ধার এবং আপডেট করুন৷ এর জন্য আপনার প্রয়োজন:
- উপযুক্ত API কল ব্যবহার করে বর্তমান টোকেন পুনরুদ্ধার করতে আপনার ক্লায়েন্ট অ্যাপে অ্যাপ লজিক যোগ করুন (যেমন
token(completion):Apple প্ল্যাটফর্মের জন্য বা Android এর জন্যgetToken()) এবং তারপর বর্তমান টোকেনটি স্টোরেজের জন্য আপনার অ্যাপ সার্ভারে পাঠান (টাইমস্ট্যাম্প সহ) ) এটি সমস্ত ক্লায়েন্ট/টোকেন কভার করার জন্য কনফিগার করা একটি মাসিক কাজ হতে পারে। - টোকেন পরিবর্তিত হয়েছে কিনা তা নির্বিশেষে নিয়মিত বিরতিতে টোকেনের টাইমস্ট্যাম্প আপডেট করতে সার্ভার লজিক যোগ করুন।
WorkManager ব্যবহার করে টোকেন আপডেট করার জন্য Android লজিকের উদাহরণের জন্য, Firebase ব্লগে ক্লাউড মেসেজিং টোকেন পরিচালনা করা দেখুন।
আপনি যে টাইমিং প্যাটার্ন অনুসরণ করুন না কেন, পর্যায়ক্রমে টোকেন আপডেট করতে ভুলবেন না। প্রতি দুই মাসে একবার আপডেট ফ্রিকোয়েন্সি সম্ভবত ব্যাটারি প্রভাব বনাম নিষ্ক্রিয় নিবন্ধন টোকেন সনাক্তকরণের মধ্যে একটি ভাল ভারসাম্য সৃষ্টি করে। এই রিফ্রেশ করার মাধ্যমে, আপনি এটাও নিশ্চিত করেন যে নিষ্ক্রিয় হয়ে যাওয়া যেকোন ডিভাইস আবার সক্রিয় হয়ে গেলে তার রেজিস্ট্রেশন রিফ্রেশ করবে। সাপ্তাহিক থেকে বেশি ঘন ঘন রিফ্রেশ করার কোন সুবিধা নেই।
পুরানো নিবন্ধন টোকেন সরান
একটি ডিভাইসে বার্তা পাঠানোর আগে, নিশ্চিত করুন যে ডিভাইসের রেজিস্ট্রেশন টোকেনের টাইমস্ট্যাম্প আপনার স্থবিরতা উইন্ডো সময়ের মধ্যে রয়েছে। উদাহরণ স্বরূপ, টাইমস্ট্যাম্পটি একটি সংজ্ঞায়িত স্ট্যালেনেস উইন্ডো পিরিয়ড যেমন const EXPIRATION_TIME = 1000 * 60 * 60 * 24 * 60; এবং তারপরে বাসি টোকেনগুলি সরান:
exports.pruneTokens = functions.pubsub.schedule('every 24 hours').onRun(async (context) => {
// Get all documents where the timestamp exceeds is not within the past month
const staleTokensResult = await admin.firestore().collection('fcmTokens')
.where("timestamp", "<", Date.now() - EXPIRATION_TIME)
.get();
// Delete devices with stale tokens
staleTokensResult.forEach(function(doc) { doc.ref.delete(); });
});
বিষয় থেকে বাসি টোকেন সদস্যতা ত্যাগ করুন
পুরানো রেজিস্ট্রেশন টোকেনগুলি সরাতে বিষয়ের সদস্যতাগুলি পরিচালনা করা আরেকটি বিবেচ্য বিষয়। এটি দুটি পদক্ষেপ জড়িত:
- আপনার অ্যাপটি প্রতি মাসে একবার এবং/অথবা যখনই নিবন্ধন টোকেন পরিবর্তন হয় তখন বিষয়গুলিতে পুনরায় সদস্যতা নেওয়া উচিত। এটি একটি স্ব-নিরাময় সমাধান গঠন করে, যেখানে একটি অ্যাপ আবার সক্রিয় হলে সদস্যতাগুলি স্বয়ংক্রিয়ভাবে পুনরায় উপস্থিত হয়।
- যদি একটি অ্যাপ ইন্সট্যান্স 2 মাস ধরে নিষ্ক্রিয় থাকে (অথবা আপনার নিজের অচলতা উইন্ডো) তাহলে আপনাকে FCM ব্যাকএন্ড থেকে টোকেন/টপিক ম্যাপিং মুছে ফেলার জন্য Firebase অ্যাডমিন SDK ব্যবহার করে বিষয়গুলি থেকে সদস্যতা ত্যাগ করতে হবে।
এই দুটি পদক্ষেপের সুবিধা হল যে আপনার ফ্যানআউটগুলি দ্রুত ঘটবে কারণ ফ্যান আউট করার জন্য কম বাসি টোকেন রয়েছে এবং আপনার পুরানো অ্যাপের দৃষ্টান্তগুলি আবার সক্রিয় হয়ে গেলে স্বয়ংক্রিয়ভাবে পুনরায় সদস্যতা পাবে৷
বিতরণ সাফল্য পরিমাপ
সাধারণত, আমরা সক্রিয়ভাবে ব্যবহৃত অ্যাপ ইন্সট্যান্স থেকে দেখা বা ক্যাপচার করা ক্রিয়াগুলির উপর ভিত্তি করে বার্তাগুলিকে লক্ষ্য করার পরামর্শ দিই। এটি বিশেষভাবে গুরুত্বপূর্ণ যদি আপনি নিয়মিতভাবে বিপুল সংখ্যক গ্রাহক সহ বিষয়গুলিতে বার্তা পাঠান; যদি এই গ্রাহকদের একটি অংশ প্রকৃতপক্ষে নিষ্ক্রিয় থাকে, তবে আপনার বিতরণ পরিসংখ্যানের প্রভাব সময়ের সাথে উল্লেখযোগ্য হতে পারে।
একটি টোকেন বার্তা লক্ষ্য করার আগে, বিবেচনা করুন:
- Google Analytics, BigQuery-এ ক্যাপচার করা ডেটা বা অন্যান্য ট্র্যাকিং সিগন্যাল কি ইঙ্গিত দেয় যে টোকেন সক্রিয় আছে?
- পূর্ববর্তী ডেলিভারি প্রচেষ্টা একটি নির্দিষ্ট সময়ের মধ্যে ধারাবাহিকভাবে ব্যর্থ হয়েছে?
- গত দুই মাসে আপনার সার্ভারে নিবন্ধন টোকেন আপডেট করা হয়েছে?
- অ্যান্ড্রয়েড ডিভাইসের জন্য, FCM ডেটা এপিআই কি
droppedDeviceInactiveকারণে বার্তা বিতরণ ব্যর্থতার একটি উচ্চ শতাংশ রিপোর্ট করে?
ডেলিভারি সম্পর্কে আরও তথ্যের জন্য, বার্তা বিতরণ বোঝা দেখুন।