Topic Subscription sa mga push notification — ano ito, paano ito gumagana at naka-set up

Ano ang Topic Subscription sa FCM

Topic Subscription — ay isang mekanismo ng group push notification kung saan nag-subscribe ang mga device sa mga pinangalanang channel (paksa) at tumatanggap ng mga mensaheng ipinadala sa mga channel na ito. Ang bawat paksa ay kinikilala ng isang string na pangalan, halimbawa news_sports o weather_alerts.

Prinsipyo ng paggana ng mga paksa

Kapag nag-subscribe ang isang device sa isang paksa, idinaragdag ng FCM ang Registration Token nito sa listahan ng mga tatanggap ng paksang iyon. Kapag nagpapadala ng mensahe sa isang paksa, awtomatikong iruruta ng FCM ang kopya sa bawat naka-subscribe na device. Firebase ay hindi naglilimita sa bilang ng subscription bawat device — ang app ay maaaring mag-subscribe sa user sa dose-dosenang paksa nang sabay-sabay.

Mga paksa kumpara sa indibidwal na pagpapadala

Ang pangunahing bentahe ng mga paksa ay scalability. Para magpadala ng notification sa isang milyong user, sapat na ang isang HTTP request sa FCM na may pangalan ng paksa. Sa indibidwal na pagpapadala, kakailanganin ang isang milyong request o batch sending ng hanggang 500 token sa isang pagkakataon. Pinapasimple rin ng mga paksa ang server-side logic — hindi kailangang mag-imbak ng mga listahan ng token para sa bawat kategorya.

Mga halimbawa ng paggamit ng paksa

Ang Topic Subscription ay malawakang ginagamit sa mga news app para sa pagkakategorya ng nilalaman — ang pag-subscribe sa mga paksang "Sports", "Politika", "Teknolohiya" ay nagbibigay-daan sa paghahatid ng mga kaugnay na notification. Sa e-commerce, ang mga paksa ay ginagamit para sa mga notification tungkol sa mga diskwento sa mga partikular na kategorya ng produkto. Sa mga messenger at social network, ang mga paksa ay ginagamit para sa mga notification tungkol sa mga kaganapan sa mga grupo.

Mga limitasyon at hangganan ng FCM

Ang Firebase ay nagpapataw ng mga limitasyon sa pagtatrabaho sa mga paksa. Ang isang app ay maaaring magkaroon ng hanggang 2000 paksa. Bawat device ay maaaring mag-subscribe sa hindi hihigit sa 2000 paksa. Ang dalas ng pag-subscribe/pag-unsubscribe ay limitado rin — hindi hihigit sa 3000 operasyon bawat minuto bawat proyekto. Ang paglampas sa mga limitasyon ay humahantong sa pansamantalang pag-block. Para sa mga proyektong may malaking bilang ng paksa, inirerekomenda ang paggamit ng condition sa halip na paksa — sinusuportahan ng FCM ang mga lohikal na expression para sa pag-target.

Paano gumagana ang subscription sa paksa

Ang proseso ng Topic Subscription ay binubuo ng tatlong yugto: pagsisimula ng subscription sa client, pagpaparehistro sa imprastraktura ng FCM, at kumpirmasyon ng operasyon. Pagkatapos ng matagumpay na subscription, magsisimulang makatanggap ang device ng mga mensaheng ipinadala sa paksang iyon.

Siklo ng buhay ng subscription

Kapag tinawag ng client ang subscribeToTopic() method, ang Firebase SDK ay nagpapadala ng request sa FCM servers. Sinusuri ng server ang pagiging pinapayagan ng operasyon at idinaragdag ang token ng device sa listahan ng mga subscriber ng paksa. FCM ay nagbabalik ng kumpirmasyon ng matagumpay na subscription sa client. Mula sa sandaling iyon, lahat ng mensahe sa paksang ito ay ihahatid sa device.

Awtomatikong paglikha ng paksa

Ang paksa ay hindi kailangang likhain nang maaga sa Firebase console. Sa unang subscription ng anumang device sa isang paksang pinangalanang news_promo, awtomatiko itong nililikha ng FCM. Kung ang huling device ay mag-unsubscribe, ang paksa ay mananatili sa system ngunit hindi aktibo, at magpapatuloy sa bagong subscription.

Subscription sa paksa sa Android

Sa Android, ang pag-subscribe at pag-unsubscribe sa mga paksa ay ginagawa sa pamamagitan ng FirebaseMessaging SDK. Ang mga method na subscribeToTopic() at unsubscribeFromTopic() ay tumatanggap ng pangalan ng paksa bilang parameter. Ang mga operasyon ay asynchronous at nangangailangan ng pagproseso ng resulta.

Pangunahing subscription sa paksa

Para mag-subscribe, sapat na ang tumawag ng subscribeToTopic() na may pangalan ng target na paksa. Ang Firebase SDK ay independiyenteng namamahala ng mga network request at pagsubok muli sa mga pagkabigo. Inirerekomenda na mag-subscribe sa mga paksa pagkatapos matanggap ang 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", "Nag-unsubscribe: ${task.isSuccessful}")
            }
    }
}

Pamamahala ng maramihang subscription

Sa mga tunay na app, ang user ay maaaring mag-subscribe sa maraming kategorya. Para sa maginhawang pamamahala, gumawa ng manager class na nag-si-sync ng status ng subscription sa server side. Sa pag-login ng user, ibalik ang kanilang mga subscription mula sa profile.

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")
    }
}

Subscription sa paksa sa iOS

Sa iOS, ang proseso ng pag-subscribe sa paksa ay lohikal na kapareho ng Android, ngunit gumagamit ng Swift API ng Firebase Messaging. Ang mga method na subscribe at unsubscribe ay tinatawag sa Messaging instance at asynchronous din.

Pagpapatupad ng subscription sa iOS

Para mag-subscribe sa isang paksa sa iOS app, ginagamit ang Messaging.subscribe() method. Mahalagang tawagan ang subscription pagkatapos ng initialization ng Firebase at pagtanggap ng Registration Token. Inirerekomenda ng Apple na humingi ng pahintulot para sa notification bago mag-subscribe sa mga paksa.

import FirebaseMessaging

class PushTopicManager {

    func subscribeToTopic(topic: String) {
        Messaging.messaging().subscribe(toTopic: topic) { error in
            if let error = error {
                Log.e("FCM", "Error sa subscription: \(error)")
            } else {
                Log.d("FCM", "Naka-subscribe sa \(topic)")
            }
        }
    }

    func unsubscribeFromTopic(topic: String) {
        Messaging.messaging().unsubscribe(fromTopic: topic) { error in
            if let error = error {
                Log.e("FCM", "Error sa pag-unsubscribe: \(error)")
            }
        }
    }
}

Mga katangian ng iOS subscription

Sa iOS, ang subscription sa paksa ay nakatali rin sa Registration Token na natatanggap ng Firebase mula sa APNs. Kung magbago ang APNs token (halimbawa, pagkatapos ng pag-restore ng device), awtomatikong ililipat ng Firebase ang mga subscription sa bagong token. Gayunpaman, sa mga bihirang kaso, maaaring kailanganin ang muling pag-subscribe pagkatapos ng pag-update ng Registration Token.

Pamamahala ng subscription mula sa server

Pamamahala ng server ng mga subscription ay nagbibigay-daan sa pag-subscribe at pag-unsubscribe ng mga device nang walang partisipasyon ng client app. Ito ay kapaki-pakinabang para sa administrasyon, A/B testing, at pamamahala ng subscription sa backend side.

FCM HTTP API para sa pamamahala ng subscription

Ang Firebase ay nagbibigay ng REST API para sa malawakang pamamahala ng subscription. Ang method na /v1/projects/{project_id}/subscriptions ay nagbibigay-daan sa pag-subscribe ng hanggang 1000 device sa isang request. Ginagamit ng API ang Registration Token ng mga device para sa identipikasyon.

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 sa subscription", error)
    }
}

Mga senaryo ng paggamit ng pamamahala ng server

Ang pamamahala ng server ng mga subscription ay ginagamit sa ilang senaryo. Sa pagrehistro ng user, awtomatikong ini-subscribe siya ng server sa mga pangunahing paksa. Sa pagbabago ng kagustuhan sa web version, sinasabay ng server ang mga subscription sa mobile device. Mga administrator ay maaaring mag-subscribe ng test device sa mga internal na paksa para sa debugging. Para sa malawakang operasyon, ang FCM ay nagbibigay ng Instance Group method, na nagbibigay-daan sa pamamahala ng subscription ng group ng mga device sa pamamagitan ng isang group identifier.

Pagmonitor ng status ng subscription

Ang Firebase ay hindi nagbibigay ng built-in na API para sa pagsusuri ng kasalukuyang subscription ng device. Inirerekomenda sa mga developer na magpanatili ng sariling database ng subscription sa server side. Sa bawat pag-start ng app, isi-sync ng client ang mga subscription nito sa server sa pamamagitan ng pagpapadala ng listahan ng aktibong paksa. Ito ay nagbibigay-daan sa pagtuklas ng desync at pagpapanumbalik ng mga subscription kung kinakailangan. Para sa audit, gamitin ang mga log ng Firebase Cloud Functions — bawat subscribe/unsubscribe operation ay maaaring ma-log.