Firebase Cloud Messaging ileti türleri

FCM ile istemci uygulamalarınıza iki tür mesaj gönderebilirsiniz:

  • "Görüntüleme mesajları"na benzer olan bildirim mesajları, FCM SDK tarafından otomatik olarak işlenir.
  • İstemci uygulaması tarafından işlenen veri mesajları

Bildirim mesajları, kullanıcı tarafından görülebilen önceden tanımlanmış bir dizi anahtar içerir ve isteğe bağlı bir veri yükü içerebilir. Buna karşılık, veri mesajları yalnızca kullanıcı tanımlı özel anahtar/değer çiftlerinizi içerir. Firebase konsolundan gönderilen iletiler hariç, her iki ileti türü için maksimum yük 4.096 bayttır. Firebase konsolunda 1.000 karakter sınırı uygulanır.

Senaryoyu kullanma Nasıl gönderilir?
Bildirim mesajı FCM SDK, arka planda çalışırken istemci uygulaması adına mesajı son kullanıcı cihazlarında gösterir. Aksi takdirde, bildirim alındığında uygulama ön planda çalışıyorsa davranış, uygulamanın kodu tarafından belirlenir.

  1. Cloud Functions gibi güvenilir bir ortamda veya uygulama sunucunuzda Firebase Admin SDK ya da HTTP v1 API'yi kullanın. notification anahtarını ayarlayın. İsteğe bağlı veri yükü olabilir. Her zaman daraltılabilir.

    Görüntüleme bildirimleri ve istek yükü gönderme ile ilgili bazı örneklere göz atın.

  2. Bildirim oluşturucu: Mesaj Metni, Başlık vb. bilgileri girip gönderin. Özel veriler sağlayarak isteğe bağlı veri yükü ekleyin.
Veri mesajı İstemci uygulaması, veri mesajlarını işlemekle sorumludur. Veri mesajları yalnızca özel anahtar/değer çiftlerine sahiptir ve ayrılmış anahtar adları içermez (aşağıya bakın). Cloud Functions veya uygulama sunucunuz gibi güvenilir bir ortamda Firebase Admin SDK ya da HTTP v1 API'yi kullanın. Gönderme isteğinde data anahtarını ayarlayın.

Uygulamanız arka planda çalışırken FCM SDK'sının bildirimi otomatik olarak göstermesini istediğinizde bildirim mesajlarını kullanabilirsiniz. FCM, isteğe bağlı bir veri yükü içeren bir bildirim mesajı gönderebilir. Bu gibi durumlarda FCM, bildirim yükünü görüntüler ve istemci uygulaması veri yükünü işler.

Mesajları kendi istemci uygulaması kodunuzla işlemek istediğinizde veri mesajlarını kullanabilirsiniz.

Bildirim mesajları

Firebase konsolunu, Firebase Admin SDK veya FCM HTTP v1 API'yi kullanarak bildirim mesajları gönderebilirsiniz. Firebase konsolu, bildirim mesajlarınızı iyileştirmenize ve geliştirmenize yardımcı olmak için analize dayalı A/B testi sunar.

Firebase Admin SDK veya FCM HTTP v1 API'yi kullanarak bildirim mesajları göndermek için notification anahtarını, bildirim mesajının önceden tanımlanmış anahtar-değer seçenekleriyle ayarlayın. Anlık mesajlaşma uygulamasında bildirim mesajını biçimlendirmek için aşağıdaki örneği kullanabilirsiniz.

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
  }
}

Bildirim iletileri, uygulama arka plandayken bildirim tepsisine teslim edilir. Ön plandaki uygulamalarda mesajlar bir geri çağırma işlevi tarafından işlenir.

Bildirim mesajları oluşturmak için kullanılabilecek önceden tanımlanmış anahtarların tam listesi için FCM HTTP v1 API bildirimi nesnesi referans belgelerini kullanabilirsiniz.

Veri mesajları

Seçtiğiniz şifreleme şemasını uygulamak için FCM yükünü data nasıl kullanacağınız size bağlıdır. Özel anahtar/değer çiftlerinizde ayrılmış kelimeler kullanmadığınızdan emin olun. Ayrılmış kelimeler arasında from, message_type veya google., gcm. ya da gcm.notification. ile başlayan kelimeler yer alır.

Aşağıdaki örnekte, mesajı alan tüm platformlardaki istemciler tarafından yorumlanan üst düzey veya ortak veri alanının kullanımı gösterilmektedir. İstemci uygulaması, her platformda geri çağırma işlevinde veri yükünü alır.

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "data":{
      "Nick" : "Mario",
      "body" : "great match!",
      "Room" : "PortugalVSDenmark"
    }
  }
}