Ana içeriğe atla
Google Play Store üzerinden Android cihazlara push bildirimleri göndermek için OneSignal, Firebase Cloud Messaging (FCM) kimlik bilgilerine ihtiyaç duyar. Bu kılavuz, gerekli Hizmet Hesabı JSON dosyasını oluşturma ve OneSignal uygulama ayarlarınıza yükleme konusunda size yol gösterir. Teknik arka plan için Google’ın Hizmet Hesabı belgelerine bakın.
Bu kılavuz, Google Play Store üzerinden dağıtılan bir Android mobil uygulamasıyla OneSignal’ı entegre eden geliştiriciler içindir.

​
Gereksinimler

​
Kurulum

​
1. Firebase Projenizi oluşturun veya açın

Firebase konsoluna gidin.
  • Henüz bir projeniz yoksa, Proje ekle’ye tıklayın ve kurulumu tamamlayın.
  • Zaten bir projeniz varsa, onu seçin.

Firebase içindeki Projeler Sayfası

​
2. Firebase Cloud Messaging API v1’i etkinleştirin

1

Proje Ayarlarına gidin

Firebase’de, Projeye Genel Bakış > Proje ayarları’nın yanındaki dişli simgesine tıklayın.

Proje Ayarlarını gösteren Firebase dişli simgesi alt menüsü

2

Cloud Messaging'e gidin

Cloud Messaging sekmesine gidin.Firebase Cloud Messaging API (V1) devre dışıysa, 3 nokta menüsü > Cloud Console’da Aç’a tıklayın.

Bu görüntüde Firebase Cloud Messaging API (V1) devre dışı. Projeniz için etkinleştirildiğinden emin olun.

Google Cloud Console’da Etkinleştir’e tıklayın. Değişikliğin Firebase’e yansıması için birkaç dakika bekleyin.

Firebase Cloud Messaging API v1'i etkinleştirin.

​
3. Bir Hizmet Hesabı JSON dosyası oluşturun

1

Proje Ayarları > Hizmet Hesapları'na dönün

En altta, Yeni özel anahtar oluştur’a tıklayın.

Firebase içindeki Hizmet Hesapları bölümü

2

Onaylayın ve anahtar oluşturun

Açılır pencerede Anahtar oluştur’a tıklayarak onaylayın.

🔒 Bu dosya hassas kimlik bilgileri içerir. Paylaşmayın veya sürüm kontrolüne eklemeyin.

3

Dosyayı kaydedin

.json dosyasını güvenli bir konuma kaydedin. Kısa süre sonra ihtiyacınız olacak.
Gerekli Hizmet Hesabı izinleri:
  • cloudmessaging.messages.create
  • firebase.projects.get
Bunlar varsayılan olarak dahildir. Özel bir Hizmet Hesabı kullanıyorsanız, aşağıdakilere sahip olduğundan emin olun:
  • roles/firebasemessaging.admin
  • roles/firebase.viewer

​
4. Kimlik bilgilerinizi OneSignal’a yükleyin

1

Android platform ayarlarına gidin

OneSignal kontrol panelinizde şuraya gidin: Ayarlar > Push & In-App > Push Platformları > Google Android (FCM).Etkinleştir’e tıklayın.

OneSignal uygulama ayarları içindeki Platformlar ekranı

2

Kimlik bilgilerinizi yükleyin

Hizmet Hesabı JSON altında .json dosyasını Dosya seç’e tıklayarak yükleyin.

FCM yapılandırma ekranı

İstenirse, açılır menüden Firebase Cloud Messaging API (V1) seçeneğini seçin.Doğru Firebase projesini kullandığınızı doğrulamak için, Firebase’deki Gönderen Kimliği’ni (Cloud Messaging > Gönderen Kimliği) OneSignal ayarlarınızda gösterilenle eşleştirin.
3

Kaydedin ve devam edin

4

SDK'nızı seçin

Kullandığınız SDK’yı seçin ve Kaydet ve Devam Et’e tıklayın.

SDK seçim ekranı

5

OneSignal Uygulama Kimliğini kodunuza ekleyin

Mobil SDK kurulumu’nu takip etmeye devam edin ve bu OneSignal Uygulama Kimliğini kodunuza ekleyin.

Android yapılandırma kurulum ve test ekranı

OneSignal uygulamanızı Firebase Cloud Messaging (V1)‘e başarıyla bağladınız.Ardından, Mobil SDK kurulumu’nu tamamlayın veya platforma özgü talimatlar için Mobil push kurulumu’na gidin.

​
SSS

​
Hata: “Bu yapılandırma farklı bir Firebase Projesi için…”

Bu hata, yüklenen JSON dosyası farklı bir Firebase projesine ait olduğunda (yani farklı Gönderen Kimliği) oluşur. Çözüm: Orijinal Firebase projesinin JSON dosyasını kullanın. Mevcut değilse, Uygulama Kimliğinizle birlikte support@onesignal.com ile iletişime geçin. Proje değiştirmek push token’larını sıfırlar—kullanıcılarınızın tekrar push alabilmesi için uygulamayı yeniden açması gerekir.

​
Gönderen Kimliğimi değiştirebilir miyim?

Hayır. Push token’larının yanlışlıkla geçersiz kılınmasını önlemek için uygulamanız 100 Android kullanıcısını aştıktan sonra Gönderen Kimliği kilitlenir. Gerekirse, yardım için Uygulama Kimliğinizle birlikte support@onesignal.com ile iletişime geçin.

​
FCM V1’e geçerken kodumu güncellemem gerekiyor mu?

Hayır, uygulama veya SDK değişikliği gerekmez—bu yalnızca kontrol paneli güncellemesidir.

​
FCM v1’e geçiş için son tarih nedir?

Google, eski FCM API’lerini Temmuz 2024’te kullanımdan kaldırmaya başladı. Geçiş şiddetle tavsiye edilir. Google’ın duyurusuna bakın.

​
OneSignal’da neden Gönderen Kimliği göremiyorum?

Firebase sunucu anahtarınız AIz... gibi görünüyorsa, muhtemelen eski bir Google Cloud Messaging (GCM) kurulumu kullanıyorsunuz. Yeni bir Firebase projesi oluşturun ve bir Hizmet Hesabı JSON dosyası yükleyin.

​
Hangi uygulamaların hala Eski API’yi kullandığını nasıl kontrol edebilirim?

Uygulamaları görüntüle API’sini kullanın ve şunları kontrol edin:
  • "gcm_key" → Eski kullanıyor, güncelleme gerekiyor
  • "fcm_v1_service_account_json" → V1 kullanıyor ✅
  • İkisi de değil → uygulama Android push kullanmıyor