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 sorun giderme yardımı ve sık sorulan soruların yanıtları yer alı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 üzerine inşa edilmiş hafif, sunucusuz bir mesajlaşma çözümüdür. Kullanıcı dostu bir grafik konsolu ve daha az kodlama gereksinimi sunan Bildirim Oluşturucu, kullanıcıların yeniden etkileşim kurmak ve kullanıcıları elde tutmak, Uygulama Kullanıcı Kitlesini Büyütme'yi teşvik etmek ve pazarlama kampanyalarını desteklemek için mesaj göndermesine olanak tanır.

Özellikler		Bildirim Oluşturucu	Cloud Messaging
Target	Tek cihaz
	Konulara (ör. hava durumu) abone olan istemciler
	Önceden tanımlanmış kullanıcı segmentindeki (uygulama, sürüm, dil) istemciler
	Belirtilen Analytics kitlelerindeki istemciler
	Cihaz gruplarındaki istemciler
	İstemciden sunucuya yukarı 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 Notifications analiz koleksiyonu 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.

Hedeflediğim cihazlar neden mesajları almıyor?

Cihazların mesajları başarıyla almadığı durumlarda öncelikle şu iki olası nedeni kontrol edin:

Bildirim mesajları için ön planda mesaj işleme. İstemci uygulamalarının, uygulama cihazda ön plandayken bildirim mesajlarını işlemek için mesaj 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ı şunlardır:

5228
5229
5230

FCM genellikle 5228'i kullanır ancak bazen 5229 ve 5230'u da kullanır. FCM belirli IP'ler sağlamaz. Bu nedenle, güvenlik duvarınızın Google'ın 15169 ASN'sinde 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 intent'ten 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 depoladığından hem orijinal uygulama örneği hem de geri yüklenen uygulama örneği kullanılıyorsa bir uygulama örneği FCM'e kaydolduğunda 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:

Yedeklemedeki Firebase kurulum verilerini hariç tutun. Firebase kurulum verileri PersistedInstallation....json dosyasında saklanır. Dosya adı, bir uygulama için sabit bir değerdir. Örneğin, <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Apple, APN'ler için eski ikili protokolün kullanımdan kaldırılacağı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 iş modelimi desteklemek için bu mesajların hemen teslim edilmesi gerekiyor. Daha fazla kota alabilir miyim?

Maalesef bu nedenle kota artışı yapamıyoruz. Trafikte ani artışları ö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 haline getirme ve izleme ile ilgili Google Cloud kılavuzuna göz atın.

429 hatalarını yönetmek benim işletmem için zor. 429 hatası almamak için muafiyet veya daha fazla kota alabilir miyim?

Kota sınırlarının zorlayıcı olabileceğinin farkındayız ancak kotalar, hizmetin güvenilirliğini korumak için hayati önem taşır ve muafiyet tanınamaz. 429 hatalarını düzgün şekilde işlemek için yeniden denemeleri kullanın.

Kota artışı isteğimin yerine getirilmesi 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 alırsınız. 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, etkinliğin ne zaman başlayıp ne zaman biteceğine dair net ayrıntılarla birlikte gönderin. FCM, isteği yerine getirmek için her türlü makul ç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şiklikleri önceden size bildirir. Hizmet duyurularını alma olasılığını artırmak için Cloud MSA kişilerinizi güncel tutun.

FCM eski API'nin desteği sonlandırıldı

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

Hangi API'lerin ve özelliklerin desteği sonlandırıldı 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 kullanımdan kaldırılacak. Aşağıdaki tabloda, desteği sonlandırılan API'ler/özellikler ve yapılması gereken işlemler 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 alma	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 gönderme API'sini 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 konu aboneliği API'si	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'ye gönderilen 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 sunucu API'sine geçiş yapın.
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 gönderilen istekler 29 Eylül 2027'den sonra başarısız olmaya başlayacak. Sunucu tarafında APN jetonlarından FCM kayıt 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 işlem, 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 gönderilen istekler 29 Eylül 2027'den sonra başarısız olmaya başlayacak.	Özelliği kullanmayı bırakmayla ilgili rehberimizi inceleyin. Mesajlar, grup jetonları yerine tek tek FCM kayıtlarına gönderilmeye devam edebilir.
Cihaz grubu 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'yı 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 önceki sürümlerini kullanıyorsanız bu değişiklikten etkileneceksiniz. 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	>=9.11.0
Go	<=4.21.0	>=4.22.0
.NET	<=3.6.0	>=3.7.0

29 Eylül 2027'den önce hizmet düzeyinde düşüş olacak mı?

Hayır. Desteği sonlandırılan API'lerden alternatiflere geçiş yapmak için 12 ay süreniz vardır. Bu süre zarfında hizmetinizde herhangi bir kesinti olmaz. 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ılan API'leri/özellikleri kullanımdan kaldırılmadan önce kullanmaya başlayabilir mi?

Yeni kullanıcılar, desteği sonlandı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. Desteği sonlandırılan API'leri kullanan kullanıcılar, bu API'leri 29 Eylül 2027'ye kadar 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.