Firebase Remote Config: nedir, parametreler ve uzaktan nasıl yönetilir

Firebase Remote Config nedir ve nasıl çalışır

Firebase Remote Config, Firebase sunucu tarafında anahtar-değer çiftlerini depolayan ve bunları talep üzerine veya bir programa göre istemci cihazlarına ileten bir hizmettir. Her parametrenin bir adı (dize), bir değeri (dize, sayı, boolean veya JSON) vardır ve belirli bir kullanıcının hangi değeri alacağını belirleyen kurallara (koşullar) bağlanabilir. Koşullar, uygulama sürümünü, cihaz dilini, bölgeyi, rastgele yüzdeyi ve diğer birçok özelliği kontrol edebilir.

Remote Config mimarisi, çekme öncelikli bir itme-çekme modeli üzerine kurulmuştur. İstemci periyodik olarak sunucudan güncel değerleri ister (varsayılan olarak her 12 saatte bir). Ancak geliştirici, kod içinde veya Firebase konsolu aracılığıyla (“Publish changes” düğmesi) anlık senkronizasyon başlatabilir. Değişiklikler yayınlandıktan sonra sunucu, Firebase Cloud Messaging aracılığıyla bir push bildirimi gönderir ve uygulama bunu alarak parametreleri yeniden talep edebilir.

Ücretsiz katman Firebase Remote Config'in parametre veya istek sayısında sınırı yoktur, bu da onu diğer Firebase hizmetlerinden ayırır. Tek sınırlama, yanıt boyutunun 800 KB'ı aşmamasıdır (tüm parametreler için toplam). Bu, tipik bir senaryo için fazlasıyla yeterlidir: çoğu proje 10–50 parametre kullanır ve toplam hacimleri nadiren 100 KB'ı aşar.

Remote Config, bir kullanıcıya hangi değeri vereceğini nasıl belirler

Değer seçim mekanizması, koşulların önceliğine dayanır. Her koşul bir kuralı temsil eder (örneğin, “iOS sürümü > 15.0”). Remote Config, koşulları öncelik sırasına göre kontrol eder ve ilk eşleşen koşulun değerini döndürür. Hiçbir koşul eşleşmezse, varsayılan değer kullanılır. Bu mekanizma, en özelden en genele bir kural hiyerarşisi oluşturmanıza olanak tanır.

Önemli: Firebase konsolundaki koşulların sırası önemlidir. İki koşul aynı anda bir kullanıcıyla eşleşebilirse, listede daha yukarıda olan kazanır. Daha spesifik koşulların (örneğin belirli bir uygulama sürümü için) genel koşulların (örneğin “Tüm iOS kullanıcıları”) üzerine yerleştirilmesi önerilir. Yanlış sıralama, hedeflenen bir değişikliğin asla uygulanmamasına neden olabilir.

Önbellekleme ve parametre yaşam süresi

Varsayılan olarak Remote Config, sunucudan alınan değerleri 12 saat boyunca önbelleğe alır. Bu, konsolda değişiklikler yayınlandıktan sonra uygulamanın bunları en erken 12 saat sonra göreceği anlamına gelir (veya bir sonraki açık fetch çağrısından sonra). Minimum önbellek süresi FirebaseRemoteConfigSettings(minimumFetchIntervalInSeconds: 3600) ile ayarlanabilir — üretim için aşırı sunucu isteklerini ve kullanıcı veri trafiğini önlemek için en az 1 saat önerilir.

Geliştirme sırasında değişiklikleri test etmek için 0 saniyelik minimum aralık kullanın: FirebaseRemoteConfigSettings(minimumFetchIntervalInSeconds: 0). Bu modda, her fetch çağrısı sunucudan güncel değerleri yükleyecektir. Yayınlamadan önce üretim aralığına geri dönmeyi unutmayın, aksi takdirde her uygulama başlatışı sunucuyla iletişime geçerek maliyetleri ve pil tüketimini artıracaktır.

Parametreler, koşullar ve kullanıcı grupları

Remote Config parametresi, koşullara bağlı olarak birkaç değerden birini alabilen adlandırılmış bir değişkendir. Değer türleri: dize, sayı (double), boolean, JSON nesnesi (serileştirilmiş dize). JSON parametreleri, birçok ayrı parametre oluşturmadan yapılandırılmış veri iletmek için kullanışlıdır: örneğin, uygulama teması ayarlarını içeren bir nesne (primaryColor, backgroundColor, fontSize).

Koşullar, kullanıcı veya cihaz özniteliklerini kontrol eden mantıksal kurallardır: işletim sistemi sürümü (iOS, Android), uygulama sürümü, ülke, dil, kullanıcı kitlesi (kodda tanımlanan özellik), rastgele yüzde (A/B testleri için). Koşullar mantıksal AND ile birleştirilebilir: örneğin, “uygulama sürümü >= 5.0” AND “ülke = Rusya”. Her parametre sınırsız sayıda koşula sahip olabilir, ancak pratikte 2–5 arası kullanılır.

Kişiselleştirme için, Firebase Analytics aracılığıyla uygulama kodunda ayarlanan öznitelikleri (kullanıcı özellikleri) kullanın. Örneğin: analytics.setUserProperty(“subscription_tier”, “premium”). Remote Config bu özelliği kontrol edebilir ve premium kullanıcılara özel değerler iletebilir. Remote Config aracılığıyla kişiselleştirme, istemci tarafında koşullar oluşturmayı gerektirmez — tüm mantık bulut konsolunda yoğunlaşmıştır.

Kullanıcı grupları ve segmentasyon

Remote Config iki segmentasyon modelini destekler: öznitelik tabanlı (koşullar) ve Firebase Analytics özellikleri tabanlı (kullanıcı özellikleri). İlk model statiktir: bir koşul, bir oturum veya uygulama sürümü içinde değişmeyen sabit bir özniteliği kontrol eder. İkinci model dinamiktir: bir özellik, uygulama çalışması sırasında herhangi bir zamanda ayarlanabilir ve çalışma zamanında esnek kullanıcı segmentasyonuna olanak tanır.

Önemli: Remote Config'te kullanıcı özelliklerini kullanmak için Firebase Analytics'in entegre edilmesi gerekir. Bu gereklilik, Remote Config'in Analytics SDK'sından kullanıcı verileri almasından kaynaklanır. Analytics olmadan Remote Config yalnızca cihaz öznitelikleriyle (işletim sistemi sürümü, uygulama sürümü, IP'den ülke) çalışır. Kullanıcı davranışına dayalı kişiselleştirme (örneğin “5 satın alma yaptı”) yalnızca Analytics aracılığıyla kullanılabilir.

Şablon sürümlemesi

Remote Config şablonu, tüm parametrelerin, koşulların ve değerlerinin tam kümesidir. Firebase, şablon değişiklik geçmişini saklar ve 90 gün içinde önceki herhangi bir sürüme geri dönmeye olanak tanır. Sürümleme çok önemlidir: değişiklikler yayınlandıktan sonra bir hata bulunursa (örneğin yanlış bir parametre değeri kullanıcı arayüzünü bozarsa), Firebase konsolu aracılığıyla şablonu hemen önceki çalışan sürüme geri alabilirsiniz.

Her şablon değişikliği (yayınlama), benzersiz bir numarayla yeni bir sürüm oluşturur. Firebase konsolu, zaman, kullanıcı ve açıklama (doldurulmuşsa) ile bir değişiklik günlüğü sağlar. Yayınlamalara her zaman bir açıklama eklenmesi önerilir: “iOS %10 test grubu için yeni besleme etkinleştirildi”. Açıklama olmadan, bir ay sonra sürüm 42'de tam olarak neyin değiştirildiğini hatırlamak imkansız olacaktır.

Bir uygulamada Remote Config nasıl uygulanır

Remote Config uygulaması üç adımdan oluşur: SDK'yı ayarlarla (önbellek süresi) başlatma, varsayılan parametreleri tanımlama (sunucu kullanılamadığında değerler) ve alınan değerleri uygulama mantığı. Varsayılan parametreler, cihazın Firebase'e bağlanamaması durumunda (internet yok, sunucu kullanılamıyor) bir güvenlik ağıdır. Varsayılan değerler olmadan uygulama null kullanır ve bu da çökmelere neden olabilir.

Varsayılan değerlerin tanımlanması iki şekilde yapılır: programlama yoluyla setDefaultsAsync aracılığıyla veya bir XML dosyası aracılığıyla. Programlama yaklaşımı küçük projeler için kullanışlıdır: tüm değerler uygulama başlangıcında bir kez doğrudan kodda ayarlanır. Dosya yaklaşımı, düzinelerce parametresi olan projeler için tercih edilir: değerler kaynaklarda depolanır ve yeniden derleme olmadan kolayca düzenlenebilir. Birleştirme önerilir: temel ayarlar XML'de ve belirli ayarlar programlama yoluyla.

Eş zamansızlık, Remote Config SDK'sının temel bir özelliğidir. fetchAndActivate() yöntemi, kullanıcı arayüzünü engellemeden bir arka plan iş parçacığında sunucuya bir istek gönderir. Yükleme tamamlandıktan sonra etkinleştirme gerçekleşir — parametre değerleri uygulamanın belleğinde güncellenir. Tamamlanmayı izlemek için dinleyiciler veya coroutine'ler (Android/Kotlin'de) kullanın. Parametreler güncellenirken kullanıcı arayüzde “sıçrama” görmemelidir — tüm değişiklikler sorunsuz bir şekilde uygulanmalıdır.

onComplete ve dinleyicilerle başlatma

İlk başlatışta, Remote Config SDK'sı uygulama başlatmasını engellemez. Senkronizasyon devam ederken uygulama varsayılan deşerleri kullanır. Bu, kullanıcının ilk başlatışta eski arayüz sürümünü ve fetch tamamlandıktan sonra yenisini görebileceği anlamına gelir. Kritik parametreler için (örneğin, çalışabilirliğin bağlı olduğu serverUrl), sonuç beklemeli senkron etkinleştirme kullanın.

Önerilen uygulama: uygulamanın ilk ekranı göstermeden önce güncel parametreleri alması kritikse, minimum gecikmeyle bir yükleme ekranı gösterin. Yükleme ekranında, 5 saniye zaman aşımıyla fetchAndActivate çalıştırın. Parametreler 5 saniye içinde yüklenmezse, uygulama varsayılan deşerlerle başlar. Bu, internet olmadığında sonsuz beklemeyi önler.

JSON parametreleriyle çalışma

JSON parametreleri Remote Config'te yapılandırılmış verileri tek bir değer olarak iletmeye olanak tanır. Örneğin, tema stilleri içeren bir nesne: {“primaryColor”: “#6200EE”, “borderRadius”: 8, “fontFamily”: “Roboto”}. İstemci tarafında JSON ayrıştırılır ve kullanıcı arayüzüne uygulanır. Avantajları: üç yerine bir parametre, atomik güncelleme (üç alan aynı anda güncellenir), temiz konsol. Dezavantajı: Firebase konsolunda okuma zorluğu (JSON bir dize olarak görüntülenir).

Öneri: birlikte güncellenen mantıksal olarak ilişkili değer grupları için JSON parametreleri kullanın (temalar, ekran yapılandırması, ağ ayarları). Bağımsız parametreler için (feature toggle, serverUrl), ayrı dize veya boolean parametreleri kullanın — konsolda okunması daha kolaydır ve şablon sürüm geçmişinde değişiklikleri izlemesi daha kolaydır.

Remote Config ile A/B testleri

A/B testleri, Firebase Remote Config'in yerleşik bir özelliğidir ve kullanıcıları gruplara ayırmanıza, her grup için farklı parametre değerleri ayarlamanıza ve seçilen metrikler üzerindeki değişikliklerin etkisini ölçmenize olanak tanır. random_percent ile koşullar aracılığıyla manuel bölmenin aksine, Firebase Analytics ile entegrasyon, her deney grubu için otomatik olarak istatistik toplar ve farklılıkların istatistiksel anlamlılığını gösterir.

A/B test süreci: geliştirici Firebase konsolunda (A/B Testing bölümü) bir deney oluşturur, bir Remote Config parametresi seçer, kontrol ve test grupları için değerler belirler ve hedef metriği (örneğin dönüşüm oranı veya gelir) tanımlar. Firebase, kullanıcıları otomatik olarak gruplara dağıtır, veri toplar ve 2–4 hafta sonra p-değeriyle sonucu gösterir. Sonuç kesinse deney erken durdurulabilir.

İstatistiksel anlamlılık, bir deneyi durdurmanın ana kriteridir. Firebase A/B Testing, Sıkçı yaklaşımını kullanır ve her metrik için p-değerini gösterir. Standart anlamlılık eşiği 0.05'tir (%95 güven olasılığı). Bu eşiğe gruplardan birinin lehine ulaşıldığında Firebase, deneyi durdurmayı ve değişiklikleri tüm kullanıcılara uygulamayı önerir. 4 hafta sonra anlamlılık sağlanamazsa deney sonuçsuz kabul edilir.

Deney türleri

Firebase A/B Testing iki tür deneyi destekler: klasik A/B (bir parametrenin iki değerinin karşılaştırılması) ve çok değişkenli A/B/n (üç veya daha fazla değerin karşılaştırılması). Çok değişkenli testler, istatistiksel anlamlılığa ulaşmak için daha fazla kullanıcı gerektirir. A/B/n'nin yalnızca her bir varyantın diğerlerinden temelde farklı olduğu 3–5 varyantlı parametreler için kullanılması önerilir.

Deney süresi trafik hacmine bağlıdır: günlük 1000 aktif kullanıcısı olan uygulamalar için minimum süre 2 haftadır; 100.000 kullanıcısı olan uygulamalar için 3–5 gündür. Firebase gerekli süreyi otomatik olarak hesaplar ve mevcut trafiğin anlamlı farklılıkları tespit etmek için yetersiz olması durumunda uyarır. Önemli: sonuç açık görünse bile deneyi tahmini süreden önce durdurmayın — bu klasik “peeking” hatasıdır.

A/B testleri için metrikler

Hedef metrikler Firebase A/B Testing'de Firebase Analytics olaylarına göre belirlenir. Standart metrikler mevcuttur: günlük aktif kullanıcılar, gelir, dönüşüm oranı, kullanıcıyı elde tutma, kullanıcı etkileşimi. Ek parametrelerle herhangi bir Analytics olayına dayalı özel bir metrik de oluşturabilirsiniz. Örneğin, “Ödeme ekranına ulaşan kullanıcıların yüzdesi” metriği, screen_name = “payment” parametresiyle screen_view olayından oluşturulur.

Deney başarısı kararının dayandırılacağı bir birincil metrik ve ek analiz için 2–3 ikincil metrik seçilmesi önerilir. Birden çok birincil metrik seçmek, yanlış pozitif sonuç riskini artırır (çoklu karşılaştırma sorunu). Seçilen birincil metrik istatistiksel olarak anlamlı bir iyileşme göstermezse, ikincil metrikler iyileşmiş olsa bile deney başarısız kabul edilir.

Kotlin'de Remote Config için kod örnekleri

Bir Android uygulamasında Kotlin ile Remote Config entegrasyonunu inceleyelim. Örnekler, özel önbellek süresiyle SDK başlatmayı, farklı türlerde parametreleri almayı, istemci tarafında bir A/B koşulu uygulamayı ve sunucu kullanılamadığında hata yönetimini içerir. Tüm kod ana aktivitede veya Application sınıfında çalışır, böylece parametreler uygulama başlangıcından itibaren kullanılabilir olur.

Kullanmadan önce, Firebase BOM aracılığıyla bağımlılığı ekleyin: implementation(“com.google.firebase:firebase-config”). Firebase Analytics'in de bağlı olduğundan emin olun, çünkü Remote Config, kullanıcı özelliklerini iletmek için Analytics'i kullanır.

Başlatma ve parametreleri alma

İlk örnek, üretim için minimum 1 saat fetch aralığıyla temel Remote Config kurulumudur. SDK, Application sınıfının onCreate yönteminde başlatılır. fetchAndActivate'ten sonra, karşılama ekranı için uzaktan değiştirilebilen welcome_message parametresinin değeri kontrol edilir.

class MainApp : Application() {

    override fun onCreate() {
        super.onCreate()
        val remoteConfig = Firebase.remoteConfig
        val settings = FirebaseRemoteConfigSettings.Builder()
            .setMinimumFetchIntervalInSeconds(3600)
            .build()

        remoteConfig.setConfigSettingsAsync(settings)
        remoteConfig.setDefaultsAsync(
            R.xml.remote_config_defaults
        )

        remoteConfig.fetchAndActivate()
            .addOnCompleteListener { task ->
                if (task.isSuccessful) {
                    val welcomeMsg = remoteConfig
                        .getString("welcome_message")
                    Log.d("RemoteConfig", welcomeMsg)
                }
            }
    }
}

Örnekte, setDefaultsAsync, res/xml/remote_config_defaults.xml XML dosyasından varsayılan deşerleri yükler. Fetch başarısız olursa (ağ yok, sunucu kullanılamıyor), uygulama bu deşerleri kullanır. XML dosyası, Firebase konsolundakiyle aynı parametre adlarını içerir: <entry key=“welcome_message”>Hoş geldiniz!</entry>. Tüm Remote Config parametreleri için her zaman varsayılan deşerlerin olması önerilir.

Remote Config ile özellik değiştirme

İkinci örnek bir özellik değiştirme (feature toggle) örneğidir. new_checkout_enabled parametresi boolean türündedir. true ise uygulama yeni ödeme ekranını, false ise eskisini gösterir. Feature toggle, en popüler Remote Config senaryosudur: değişiklik yalnızca bir parametreyi etkiler, mantık değişikliği gerektirmez ve anında geri alınabilir.

fun isFeatureEnabled(paramName: String): Boolean {
    return Firebase.remoteConfig
        .getBoolean(paramName)
}

// Activity'de kullanım
if (isFeatureEnabled("new_checkout_enabled")) {
    navigateToNewCheckout()
} else {
    navigateToLegacyCheckout()
}

isFeatureEnabled işlevi, Remote Config'e erişimi kapsülar ve mock aracılığıyla kolayca test edilebilir. Feature toggle'lar için bir adlandırma kuralı kullanılması önerilir: feature_, ff_ veya flag_ öneki, Firebase konsolunda parametrenin amacının hemen anlaşılmasını sağlar. Örnek: feature_new_onboarding, ff_dark_mode, flag_v3_api. 3 aydan uzun süre etkinleştirme/devre dışı bırakma için bayrak parametreleri kullanmayın — ölü bayrakların birikmesi bakımı zorlaştırır.

JSON tema yapılandırmasını alma

Üçüncü örnek, uygulama teması ayarlarıyla bir JSON parametresi alma örneğidir. app_theme parametresi, primaryColor, borderRadius ve fontFamily içeren bir JSON nesnesi içerir. İstemci tarafında JSON, Gson veya kotlinx.serialization ile ayrıştırılır ve değerler kullanıcı arayüzüne uygulanır. Bu yaklaşım, tasarımcıların geliştirici katılımı ve yayınlama olmadan uygulama temasını değiştirmesine olanak tanır.

data class AppTheme(
    val primaryColor: String = "#6200EE",
    val borderRadius: Int = 8,
    val fontFamily: String = "Roboto"
)

fun getAppTheme(): AppTheme {
    val json = Firebase.remoteConfig
        .getString("app_theme")
    return Gson().fromJson(json, AppTheme::class.java)
}

JSON ile çalışmak dikkat gerektirir: Firebase konsolundaki JSON hatalıysa (örneğin virgül eksikse), ayrıştırma başarısız olur ve uygulama geçerli tema yerine varsayılan deşerleri alır. JSON dizelerinin bir JSON doğrulayıcı aracılığıyla yayınlamadan önce doğrulanması önerilir. Üretim için, ayrıştırma sırasında try-catch ekleyin ve Firebase Crashlytics aracılığıyla hataları günlükleyin.

En iyi uygulamalar ve sınırlamalar

Firebase Remote Config güçlü bir araçtır, ancak yanlış kullanıldığında performans, davranış öngörülebilirliği ve güvenlik sorunlarına yol açabilir. Hizmetle çalışırken yaygın hatalardan kaçınmanıza yardımcı olacak temel uygulamaları ve uygulama mimarisi tasarlarken dikkate alınması gereken sınırlamaları inceleyelim.

Hassas verilerden kaçının — Remote Config, sırları (API anahtarları, token'lar, şifreler) depolamak için tasarlanmamıştır. Tüm parametre deşerleri istemci kodu için erişilebilirdir ve uygulama belleğinden çıkarılabilir. Gizli veriler için, sunucu tarafı doğrulamasıyla Cloud Functions veya Secret Manager kullanın. Remote Config'te yalnızca genel parametreleri saklayın: metinler, bayraklar, arayüz ayarları, genel uç nokta URL'leri.

Her değişikliği test edin tüm kitleye yayınlamadan önce. Yeni değerin çökme yapmadığını ve görünümü bozmadığını doğrulamak için bir A/B testi veya küçük bir yüzdeye (%1–5 kullanıcı) yayınlama kullanın. Remote Config'in hazırlama ortamı yoktur — tüm değişiklikler hemen üretime yayınlanır. Güvenli bir şekilde yayınlamanın tek yolu kademeli dağıtımdır.

Platform sınırlamaları: maksimum parametre sayısı — 2000 (tüm türler için), bir değerin maksimum boyutu — 256 KB, toplam sunucu yanıt boyutu — 800 KB. Remote Config'te kullanılabilecek kullanıcı özelliklerinin sayısı 25 ile sınırlıdır. Minimum fetch aralığı 0 saniyedir (hata ayıklama için), ancak aşırı kullanım Cloud Functions kotasını (proje başına dakikada 30.000 istek) aşmaya neden olabilir.