Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Firebase Cloud Messaging ile ilgili sorun giderme ve SSS

Bu sayfada, Cloud Messaging ile ilgili sık sorulan soruların yanıtları ve sorun giderme yardımı sağlanmaktadır.

Bildirim oluşturucu ile FCM arasındaki fark nedir?

Firebase Cloud Messaging, istemci SDK'ları ve HTTP sunucu protokolü aracılığıyla eksiksiz bir mesajlaşma özellikleri seti sunar. Daha karmaşık mesajlaşma gereksinimleri olan dağıtımlar için FCM doğru seçimdir.

Bildirim oluşturucu, Firebase Cloud Messaging üzerinde oluşturulmuş hafif ve sunucusuz bir mesajlaşma çözümüdür. Kullanıcı dostu bir grafik konsol ve daha az kodlama gereksinimi sunan Bildirim Oluşturucu, kullanıcıların yeniden etkileşim kurmak ve kullanıcıları elde tutmak, uygulama büyümesini desteklemek ve pazarlama kampanyalarını desteklemek için mesaj göndermesine olanak tanır.

Özellikler		Bildirim oluşturucu	Cloud Messaging
Hedef	Tek cihaz
	Konulara abone olan müşteriler (ör. hava durumu)
	Önceden tanımlanmış kullanıcı segmentindeki (uygulama, sürüm, dil) istemciler
	Belirtilen analiz kitlelerindeki müşteriler
	Cihaz gruplarındaki istemciler
	İstemciden sunucuya giden akış
Mesaj Türü	2 KB'a kadar olan bildirimler
	4 KB'a kadar veri mesajları
Yayınlama	Anında
	Gelecekteki istemci cihazının yerel saati
Analytics	Yerleşik bildirimler analizi toplama ve dönüşüm hunisi analizi

FCM hizmetini kullanmak için başka Firebase hizmetlerini kullanmam gerekir mi?

Diğer Firebase hizmetlerini kullanmadan Firebase Cloud Messaging'ı bağımsız bir bileşen olarak kullanabilirsiniz.

Hedeflenen cihazlarım neden mesaj alamıyor?

Cihazlar mesajları başarıyla almamış gibi görünüyorsa önce şu iki olası nedeni kontrol edin:

Bildirim mesajları için ön planda mesaj işleme. İstemci uygulamalarının, uygulama cihazda ön plandayken bildirim iletilerini işlemek için ileti işleme mantığı eklemesi gerekir. iOS ve Android ile ilgili ayrıntıları inceleyin.

Ağ güvenlik duvarı kısıtlamaları. Kuruluşunuzda internete giden veya internetten gelen trafiği kısıtlayan bir güvenlik duvarı varsa Firebase Cloud Messaging istemci uygulamalarınızın mesaj alabilmesi için güvenlik duvarını FCM ile bağlantıya izin verecek şekilde yapılandırmanız gerekir. Açılacak bağlantı noktaları:

5228
5229
5230

FCM genellikle 5228'i kullanır ancak bazen 5229 ve 5230'u da kullanır. FCM belirli IP'ler sağlamadığından güvenlik duvarınızın, Google'ın ASN 15169'da listelenen IP bloklarında bulunan tüm IP adreslerine giden bağlantıları kabul etmesine izin vermeniz gerekir.

Android uygulamamda neden `onMessageReceived` çağrılmıyor?

Uygulamanız arka plandayken bildirim mesajları sistem tepsisinde gösterilir ve onMessageReceived çağrılmaz. Veri yükü içeren bildirim mesajları için bildirim mesajı sistem tepsisinde gösterilir ve bildirim mesajına dahil edilen veriler, kullanıcı bildirime dokunduğunda başlatılan amaçtan alınabilir.

Daha fazla bilgi için İletileri alma ve işleme başlıklı makaleyi inceleyin.

Yedekten geri yüklenen etkin bir uygulama örneğine mesaj gönderdiğimde neden 404 hatası alıyorum?

FID (Firebase yükleme kimliği), bir uygulama örneğinin tanımlayıcısıdır. Varsayılan olarak, Firebase yükleme verileri yedeklenir ve geri yüklenir. Bu nedenle, geri yükleme durumunda geri yüklenen uygulama örneği ve orijinal uygulama örneği aynı FID'yi paylaşır. FCM, FID başına yalnızca bir jeton sakladığından hem orijinal uygulama örneği hem de geri yüklenen uygulama örneği kullanılıyorsa bir uygulama örneği FCM'ya kaydedildiğinde diğer uygulama örneğinin jetonu kaldırılır ve bu durum 404 hatalarına neden olur.

Geliştiricilerin uygulamalarında aşağıdakileri yapmasını öneririz:

Yedeklemeye Firebase yükleme verilerini dahil etmeyin. Firebase yükleme verileri PersistedInstallation....json dosyasında saklanır. Dosya adı, bir uygulama için sabittir. Örneğin, <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Apple, APNS için eski ikili protokolün desteğini sonlandıracağını duyurdu. Herhangi bir işlem yapmam gerekiyor mu?

Hayır. Firebase Cloud Messaging, 2017'de HTTP/2 tabanlı APNs protokolüne geçti. iOS cihazlara bildirim göndermek için FCM kullanıyorsanız herhangi bir işlem yapmanız gerekmez.

FCM kotaları ve sınırları

Geniş bir müşteri tabanını 2 dakika içinde nasıl bilgilendirebilirim?

Bu kullanım alanı desteklenemez. Trafiğinizi 5 dakikaya yaymanız gerekir.

Uygulamam, kullanıcıları etkinlikler hakkında bilgilendiriyor ve benim işletmemi desteklemek için bu mesajların hemen teslim edilmesi gerekiyor. Daha fazla kota alabilir miyim?

Maalesef bu nedenle kota artışı yapamıyoruz. Ani trafik artışlarını önlemek için trafiğinizi 5 dakikaya yaymanız gerekir.

Mesajlarım planlanmış etkinliklerle ilgili. Trafiğin tamamını saat başında nasıl gönderebilirim?

Bildirimleri, etkinlikten en az 5 dakika önce göndermeye başlamanızı öneririz. Alternatif olarak, veri mesajları gönderin ve yerel bildirimleri önceden planlamak için platformunuzun onMessageReceived işleyicisinin benzerini uygulayın.

Kota kullanımımı nasıl izleyebilirim?

Kota metriklerini grafik oluşturma ve izleme hakkında Google Cloud'un yönergelerine bakın.

429 hatalarını benim ve işletmemin ele alması zor. 429 hatası almamak için muafiyet veya daha fazla kota alabilir miyim?

Kota sınırlarının zorlayıcı olabileceğini anlıyoruz ancak kotalar, hizmetin güvenilirliğini korumak için hayati önem taşır ve bu konuda istisna yapamayız. 429 hatalarını düzgün şekilde işlemek için yeniden denemeleri kullanın.

Kota artışı isteğimin karşılanması ne kadar sürer?

Kota artırma isteğiniz, FCM kullanımınıza bağlıdır. Her durumda, birkaç iş günü içinde yanıt alabilirsiniz. Bazı durumlarda, FCM kullanımınız ve çeşitli durumlarla ilgili olarak karşılıklı yazışmalar olabilir. Bu durum, süreci uzatabilir. Tüm şartlar karşılanırsa çoğu istek 2 hafta içinde işleme alınır.

Geçici bir etkinlik için daha fazla kota alabilir miyim?

En fazla 1 ay süren bir etkinliği desteklemek için ek kota isteğinde bulunabilirsiniz. İsteği etkinlikten en az 1 ay önce ve etkinliğin başlangıç ve bitiş zamanıyla ilgili net ayrıntılarla birlikte gönderin. FCM, isteği karşılamak için her türlü pratik çabayı gösterecektir. Onaylanması durumunda bu kota artışları, etkinliğin bitiş tarihinden sonra geri alınır.

Mevcut kotam değişebilir mi?

Google bu işlemi kolay kolay yapmaz ancak sistemin bütünlüğünü korumak için gerektiğinde kotalar değiştirilebilir. Google, mümkün olduğunda bu tür değişikliklerden önce sizi bilgilendirir. Hizmet duyurularını alma olasılığını artırmak için Cloud MSA kişilerinizi güncel tutun.

FCM Eski API'lerin desteğinin sonlandırılması

Sunucu tarafı API'lerinin desteği Eylül 2026'da sonlandırılacak

Hangi API'lerin ve özelliklerin desteği sonlandırılacak ve kullanımdan kaldırılacak? Bu API'leri kullanıyorsam ne yapmalıyım?

Tüm InstanceId sunucu API'leri ve cihaz grubu özelliği kullanımdan kaldırıldı ve 29 Eylül 2027'de devre dışı bırakılacak. Aşağıdaki tabloda, desteği sonlandırılan API'ler/özellikler ve yapılması gereken işlem hakkında daha fazla bilgi verilmektedir.

API adı	API Uç Noktası	Kullanım Amacı	Müşteri Etkisi	İşlem Gerekli
InstanceId info API	https://iid.googleapis.com/iid/info	InstanceId / FCM jetonuyla ilgili bilgi edinme	Bu API'ye yapılan istekler 29 Eylül 2027'den sonra başarısız olmaya başlayacak.	Jeton doğrulama için API'yi kullanan müşteriler FCM V1 send API'yi kullanmalı ve `validate_only` değerini true olarak ayarlamalıdır. Konu aboneliği bilgilerini almak için API'yi kullanan müşteriler yeni konu aboneliği API'sine geçmelidir.
InstanceId topic subscription API	https://iid.googleapis.com/iid/v1/…/rel/topics https://iid.googleapis.com/iid/v1:batchAdd https://iid.googleapis.com/iid/v1:batchRemove	Eski konu aboneliği API'si aracılığıyla bir konuya abone olma.	Bu API'lere yapılan istekler 29 Eylül 2027'den sonra başarısız olmaya başlayacak.	Konu aboneliği ve abonelikten çıkma için yeni FCM konu aboneliği sunucusu API'sine geçin.
InstanceId toplu içe aktarma API'si	https://iid.googleapis.com/iid/v1:batchImport	Sunucu tarafında toplu olarak iOS için FCM jetonları oluşturma.	Bu API'ye yapılan istekler 29 Eylül 2027'den sonra başarısız olmaya başlayacak. Sunucu tarafında APNs jetonlarından FCM kaydı oluşturma desteklenmeyecek.	APNs jetonlarını kullanarak bildirim göndermek için Apple'ın APNs hizmetini kullanabilirsiniz. FCM tarafından sağlanan ek avantajlardan yararlanmak için uygulamanızı FCM iOS SDK ile entegre edin. Bu SDK, istemcide FCM kayıtları oluşturur.
Cihaz grubu yönetimi API'si	https://fcm.googleapis.com/fcm/notification https://fcm.googleapis.com/gcm/notification https://fcm.googleapis.com/iid/notification https://fcm.googleapis.com/notification	Cihaz grubu üyelerini ekleme, kaldırma ve alma	Bu API'ye yapılan istekler 29 Eylül 2027'den sonra başarısız olmaya başlayacak.	Özelliği devre dışı bırakma rehberine bakın. Mesajlar, grup jetonları yerine tek tek FCM kayıtlarına gönderilmeye devam edebilir.
Cihaz grubuna gönderme	https://fcm.googleapis.com/v1/projects/…/messages:send	group notification_key kullanarak cihaz gruplarına mesaj gönderme.	Bu API çalışmaya devam edecek ancak 29 Eylül 2027'den sonra cihaz grubu jetonlarını desteklemeyecek.

Konu aboneliklerini yönetmek için Firebase Admin SDK'sını kullanıyorsam bu kullanımdan kaldırma işleminden etkilenir miyim? Ne yapmalıyım?

Konu aboneliklerini yönetmek için Firebase Admin SDK'nın eski sürümlerini kullanıyorsanız bu desteğin sonlandırılmasından etkilenirsiniz. Firebase Admin SDK'nızı aşağıdaki sürümlere yükseltmeniz gerekir:

Platform	Etkilenen Admin SDK sürümü	Yükseltilecek Admin SDK sürümü
Node.js	<=14.4.0	>=14.5.0
Python	<=7.6.0	>=7.7.0
Java	<=9.10.0	Çok yakında
Go	<=4.21.0	>=4.22.0
.NET	<=3.6.0	Çok yakında

29 Eylül 2027'den önce hizmetimin sürümü düşürülür mü?

Hayır. Kullanımdan kaldırılan API'lerden alternatiflere 12 ay içinde hizmet kalitesinde düşüş yaşamadan geçiş yapabilirsiniz. Devre dışı bırakma işleminden etkilenmemek için taşıma işlemini mümkün olduğunca erken planlamanızı önemle tavsiye ederiz.

29 Eylül 2027'den sonra kullanımdan kaldırılan API'leri çağırdığınızda hata almanız beklenir.

Yeni kullanıcılar, kullanımdan kaldırılmadan önce kullanımdan kaldırılan API'leri/özellikleri kullanmaya başlayabilir mi?

Yeni kullanıcılar, kullanımdan kaldırılan API'leri/özellikleri 1 Ocak 2027'den önce kullanmaya başlayabilir. 1 Ocak 2027'den sonra yeni kullanıcılar, desteği sonlandırılan API'leri kullanamayacak. Kullanımdan kaldırılan API'leri kullanan kullanıcılar, 29 Eylül 2027'ye kadar bu API'leri kullanmaya devam edebilir.

Firebase Cloud Messaging ile ilgili sorun giderme ve SSS Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.