Topic Subscription στις push ειδοποιήσεις — τι είναι, πώς λειτουργεί και ρυθμίζεται

Τι είναι το Topic Subscription στο FCM

Topic Subscription — είναι ένας μηχανισμός ομαδικής αποστολής push ειδοποιήσεων, όπου οι συσκευές εγγράφονται σε ονομασμένα κανάλια (θέματα) και λαμβάνουν μηνύματα που αποστέλλονται σε αυτά τα κανάλια. Κάθε θέμα αναγνωρίζεται από ένα όνομα συμβολοσειράς, για παράδειγμα news_sports ή weather_alerts.

Αρχή λειτουργίας θεμάτων

Όταν μια συσκευή εγγράφεται σε ένα θέμα, το FCM προσθέτει το Registration Token της στη λίστα παραληπτών αυτού του θέματος. Κατά την αποστολή μηνύματος σε ένα θέμα, το FCM δρομολογεί αυτόματα ένα αντίγραφο σε κάθε εγγεγραμμένη συσκευή. Το Firebase δεν περιορίζει τον αριθμό συνδρομών ανά συσκευή — η εφαρμογή μπορεί να εγγράψει τον χρήστη σε δεκάδες θέματα ταυτόχρονα.

Θέματα έναντι μεμονωμένης αποστολής

Το κύριο πλεονέκτημα των θεμάτων είναι η επεκτασιμότητα. Για να στείλετε μια ειδοποίηση σε ένα εκατομμύριο χρήστες, αρκεί ένα αίτημα HTTP προς το FCM με το όνομα του θέματος. Στη μεμονωμένη αποστολή θα χρειαζόταν ένα εκατομμύριο αιτήματα ή μαζική αποστολή έως 500 token κάθε φορά. Τα θέματα απλοποιούν επίσης τη λογική του διακομιστή — δεν χρειάζεται να αποθηκεύονται λίστες token για κάθε κατηγορία.

Παραδείγματα χρήσης θεμάτων

Το Topic Subscription χρησιμοποιείται ευρέως σε εφαρμογές ειδήσεων για κατηγοριοποίηση περιεχομένου — η εγγραφή σε θέματα "Αθλητικά", "Πολιτική", "Τεχνολογία" επιτρέπει την παράδοση σχετικών ειδοποιήσεων. Στο ηλεκτρονικό εμπόριο, τα θέματα χρησιμοποιούνται για ειδοποιήσεις σχετικά με εκπτώσεις σε συγκεκριμένες κατηγορίες προϊόντων. Σε εφαρμογές messenger και κοινωνικά δίκτυα, τα θέματα χρησιμοποιούνται για ειδοποιήσεις σχετικά με γεγονότα σε ομάδες.

Περιορισμοί και όρια FCM

Το Firebase επιβάλλει περιορισμούς στην εργασία με θέματα. Μία εφαρμογή μπορεί να έχει έως 2000 θέματα. Κάθε συσκευή μπορεί να εγγραφεί σε όχι περισσότερα από 2000 θέματα. Η συχνότητα εγγραφών/απεγγραφών είναι επίσης περιορισμένη — όχι περισσότερες από 3000 λειτουργίες ανά λεπτό ανά έργο. Η υπέρβαση των ορίων οδηγεί σε προσωρινό αποκλεισμό. Για έργα με μεγάλο αριθμό θεμάτων, συνιστάται η χρήση συνθήκης (condition) αντί για θέμα — το FCM υποστηρίζει λογικές εκφράσεις για στόχευση.

Πώς λειτουργεί η συνδρομή σε θέματα

Η διαδικασία Topic Subscription αποτελείται από τρία στάδια: αρχικοποίηση της συνδρομής στον πελάτη, εγγραφή στην υποδομή FCM και επιβεβαίωση της λειτουργίας. Μετά από επιτυχή εγγραφή, η συσκευή αρχίζει να λαμβάνει μηνύματα που αποστέλλονται σε αυτό το θέμα.

Κύκλος ζωής συνδρομής

Όταν ο πελάτης καλεί τη μέθοδο subscribeToTopic(), το Firebase SDK στέλνει ένα αίτημα στους διακομιστές FCM. Ο διακομιστής ελέγχει το επιτρεπτό της λειτουργίας και προσθέτει το token της συσκευής στη λίστα συνδρομητών του θέματος. Το FCM επιστρέφει στον πελάτη επιβεβαίωση επιτυχούς εγγραφής. Από αυτή τη στιγμή, όλα τα μηνύματα σε αυτό το θέμα θα παραδίδονται στη συσκευή.

Αυτόματη δημιουργία θέματος

Το θέμα δεν χρειάζεται να δημιουργηθεί εκ των προτέρων στην κονσόλα Firebase. Κατά την πρώτη εγγραφή οποιασδήποτε συσκευής σε ένα θέμα με όνομα news_promo, το FCM το δημιουργεί αυτόματα. Αν η τελευταία συσκευή απεγγραφεί, το θέμα παραμένει στο σύστημα αλλά ανενεργό, και συνεχίζει τη λειτουργία του με νέα εγγραφή.

Συνδρομή σε θέματα στο Android

Στο Android, η εγγραφή και απεγγραφή από θέματα πραγματοποιείται μέσω του FirebaseMessaging SDK. Οι μέθοδοι subscribeToTopic() και unsubscribeFromTopic() λαμβάνουν το όνομα του θέματος ως παράμετρο. Οι λειτουργίες είναι ασύγχρονες και απαιτούν επεξεργασία του αποτελέσματος.

Βασική εγγραφή σε θέμα

Για εγγραφή, αρκεί να καλέσετε τη subscribeToTopic() με το όνομα του επιθυμητού θέματος. Το Firebase SDK διαχειρίζεται ανεξάρτητα τα αιτήματα δικτύου και τις επαναπροσπάθειες σε περίπτωση αποτυχίας. Συνιστάται η εγγραφή σε θέματα μετά την επιτυχή λήψη του Registration Token.

class TopicSubscriber(private val context: Context) {

    fun subscribeToNewsTopic() {
        FirebaseMessaging.getInstance()
            .subscribeToTopic("news_latest")
            .addOnCompleteListener { task ->
                val msg = if (task.isSuccessful) {
                    "Subscribed to news topic"
                } else {
                    "Subscription failed"
                }
                Log.d("FCM", msg)
            }
    }

    fun unsubscribeFromNewsTopic() {
        FirebaseMessaging.getInstance()
            .unsubscribeFromTopic("news_latest")
            .addOnCompleteListener { task ->
                Log.d("FCM", "Απεγγραφή: ${task.isSuccessful}")
            }
    }
}

Διαχείριση πολλαπλών συνδρομών

Σε πραγματικές εφαρμογές, ο χρήστης μπορεί να εγγραφεί σε πολλές κατηγορίες. Για εύκολη διαχείριση, δημιουργήστε μια κλάση διαχειριστή που συγχρονίζει την κατάσταση συνδρομών με τον διακομιστή. Κατά τη σύνδεση του χρήστη, επαναφέρετε τις συνδρομές του από το προφίλ.

class SubscriptionManager(private val context: Context) {

    private val fcm = FirebaseMessaging.getInstance()

    suspend fun syncSubscriptions(topics: List<String>) {
        topics.forEach { topic ->
            fcm.subscribeToTopic(topic).await()
        }
    }

    suspend fun removeAllSubscriptions() {
        val savedTopics = getSavedTopics()
        savedTopics.forEach { topic ->
            fcm.unsubscribeFromTopic(topic).await()
        }
    }

    private fun getSavedTopics(): List<String> {
        return listOf("news_latest", "promotions", "updates")
    }
}

Συνδρομή σε θέματα στο iOS

Στο iOS, η διαδικασία εγγραφής σε θέματα είναι λογικά ταυτόσημη με το Android, αλλά χρησιμοποιεί το Swift API του Firebase Messaging. Οι μέθοδοι subscribe και unsubscribe καλούνται στο στιγμιότυπο Messaging και είναι επίσης ασύγχρονες.

Υλοποίηση εγγραφής στο iOS

Για εγγραφή σε ένα θέμα σε εφαρμογή iOS, χρησιμοποιείται η μέθοδος Messaging.subscribe(). Είναι σημαντικό να καλέσετε την εγγραφή μετά την αρχικοποίηση του Firebase και τη λήψη του Registration Token. Η Apple συνιστά να ζητάτε άδεια για ειδοποιήσεις πριν από την εγγραφή σε θέματα.

import FirebaseMessaging

class PushTopicManager {

    func subscribeToTopic(topic: String) {
        Messaging.messaging().subscribe(toTopic: topic) { error in
            if let error = error {
                Log.e("FCM", "Σφάλμα εγγραφής: \(error)")
            } else {
                Log.d("FCM", "Εγγραφή στο \(topic)")
            }
        }
    }

    func unsubscribeFromTopic(topic: String) {
        Messaging.messaging().unsubscribe(fromTopic: topic) { error in
            if let error = error {
                Log.e("FCM", "Σφάλμα απεγγραφής: \(error)")
            }
        }
    }
}

Χαρακτηριστικά συνδρομών iOS

Στο iOS, η εγγραφή σε θέμα συνδέεται επίσης με το Registration Token που λαμβάνει το Firebase από το APNs. Αν το APNs token αλλάξει (π.χ. μετά από επαναφορά συσκευής), το Firebase μεταφέρει αυτόματα τις συνδρομές στο νέο token. Ωστόσο, σε σπάνιες περιπτώσεις, μπορεί να απαιτηθεί εκ νέου εγγραφή μετά την ενημέρωση του Registration Token.

Διαχείριση συνδρομών από τον διακομιστή

Διαχείριση από τον διακομιστή συνδρομών επιτρέπει την εγγραφή και απεγγραφή συσκευών χωρίς τη συμμετοχή της εφαρμογής πελάτη. Αυτό είναι χρήσιμο για διαχείριση, δοκιμές A/B και διαχείριση συνδρομών στην πλευρά του backend.

FCM HTTP API για διαχείριση συνδρομών

Το Firebase παρέχει REST API για μαζική διαχείριση συνδρομών. Η μέθοδος /v1/projects/{project_id}/subscriptions επιτρέπει την εγγραφή έως 1000 συσκευών σε ένα αίτημα. Το API χρησιμοποιεί τα Registration Token των συσκευών για ταυτοποίηση.

const admin = require("firebase-admin")

async function subscribeUsersToTopic(tokens, topic) {
    try {
        const response = await admin
            .messaging()
            .subscribeToTopic(tokens, topic)
        Log.info(`Success: ${response.successCount}`)
        Log.info(`Failures: ${response.failureCount}`)
    } catch (error) {
        Log.error("Σφάλμα εγγραφής", error)
    }
}

Σενάρια χρήσης διαχείρισης από τον διακομιστή

Η διαχείριση συνδρομών από τον διακομιστή χρησιμοποιείται σε διάφορα σενάρια. Κατά την εγγραφή χρήστη, ο διακομιστής τον εγγράφει αυτόματα σε βασικά θέματα. Κατά την αλλαγή προτιμήσεων στην έκδοση web, ο διακομιστής συγχρονίζει τις συνδρομές στην κινητή συσκευή. Διαχειριστές μπορούν να εγγράφουν δοκιμαστικές συσκευές σε εσωτερικά θέματα για εντοπισμό σφαλμάτων. Για μαζικές λειτουργίες, το FCM παρέχει τη μέθοδο Instance Group, που επιτρέπει τη διαχείριση συνδρομών μιας ομάδας συσκευών μέσω ενός μοναδικού αναγνωριστικού ομάδας.

Παρακολούθηση κατάστασης συνδρομών

Το Firebase δεν παρέχει ενσωματωμένο API για έλεγχο των τρεχουσών συνδρομών μιας συσκευής. Συνιστάται στους προγραμματιστές να διατηρούν δική τους βάση δεδομένων συνδρομών στην πλευρά του διακομιστή. Σε κάθε εκκίνηση της εφαρμογής, ο πελάτης συγχρονίζει τις συνδρομές του με τον διακομιστή στέλνοντας μια λίστα ενεργών θεμάτων. Αυτό επιτρέπει τον εντοπισμό αποσυγχρονισμού και την επαναφορά συνδρομών εάν χρειαστεί. Για έλεγχο, χρησιμοποιήστε τα αρχεία καταγραφής Firebase Cloud Functions — κάθε λειτουργία subscribe/unsubscribe μπορεί να καταγραφεί.