Remote Config parametreleri ve koşulları

Firebase Remote Config, kullanıcıların uygulama güncellemesi indirmesini veya arka uç yeniden dağıtımlarını gerektirmeden uygulamalarınızın davranışını ve görünümünü dinamik olarak kontrol etmenize olanak tanır.

Uygulamalarınızı yapılandırmak için Remote Config içinde parametreler (anahtar/değer çiftleri) tanımlar ve bunları uygulamanızda veya arka uç kodunuzda kullanırsınız. Ayrıca, belirli kitleler, ortamlar veya özel ölçütler için varsayılan değerleri geçersiz kılan koşullu değerler atamak üzere koşullar (hedefleme kuralları) da tanımlayabilirsiniz.

Remote Config parametreleri ve koşulları şablonlar halinde düzenler. Mimarinize bağlı olarak istemci şablonlarını, sunucu şablonlarını veya her ikisini de kullanabilirsiniz:

  • İstemci şablonlarındaki parametreler ve koşullar: Apple, Android, Web, Flutter, Unity ve C++ platformlarındaki istemci uygulaması örneklerine yapılandırmalar sunun. Google Analytics kitlelerini, uygulama sürümlerini, platformu, cihaz dilini, ülkeyi, kullanıcı yüzdelik dilimlerini ve istemci tarafı özel sinyallerini kullanarak uygulama örneklerini hedefleyin.

  • Sunucu şablonlarındaki parametreler ve koşullar: Node.js, Python, Go ve Java için Firebase Admin SDK kullanarak Cloud Run, Cloud Functions for Firebase veya kapsayıcılı sunucular gibi arka uç ortamlarına yapılandırmalar sunun. Sunucu özel sinyallerini ve rastgele yüzde dağıtımlarını kullanarak parametreleri sunucu tarafında neredeyse sıfır gecikmeyle değerlendirin.

İstemci ve sunucu şablonlarını karşılaştırma

İstemci ve sunucu şablonları farklı mimarilere hizmet eder ve farklı SDK'ları ve hedefleme kurallarını destekler. Hangi şablon türünün kullanım alanınıza uygun olduğunu anlamak için aşağıdaki tablodan yararlanın:

Özellik Müşteri şablonları Sunucu şablonları
Hedef ortamlar İstemci uygulamaları (Apple, Android, Web, Flutter, Unity, C++) Sunucu ortamları (Cloud Run, Cloud Functions for Firebase, GKE, arka uç hizmetleri)
Desteklenen SDK'lar Firebase istemci SDK'ları Firebase Admin SDK (Node.js, Python, Go, Java)
Değerlendirme modeli İstemci cihazlarda getirilip önbelleğe alınır; uygulama koduyla etkinleştirilir. Sunucu belleğine yüklenir; isteğe göre değerlendirilir ve neredeyse sıfır gecikmeyle sonuçlanır.
Koşul kuralları Uygulama sürümü, işletim sistemi/platform, cihaz dili, ülke/bölge, Analytics kitleler ve kullanıcı özellikleri, rastgele yüzdelik dilimdeki kullanıcı, ilk uygulama açılışı, istemci özel sinyalleri Rastgele yüzdelik dilimdeki kullanıcı, sunucu özel sinyalleri
Yaygın kullanım alanları Kullanıma sunulan özellikler, sezonluk tanıtımlar, kullanıcı arayüzü temaları, A/B Testing, Kişiselleştirme Yapay zeka istemi ve model seçimi, sunucu tarafı özellik işaretleri, arka uçta sıklık sınırlama, dinamik yönlendirme
Ayrıntılı kılavuz Müşteri şablonlarındaki parametreler Sunucu şablonlarındaki parametreler

Temel kavramlar

İster istemci şablonlarıyla ister sunucu şablonlarıyla çalışın, Remote Config temel kavramlar aynıdır:

Parametreler

Parametreler, Firebase konsolunda veya Remote Config arka uç API'leri kullanılarak tanımlanan anahtar/değer çiftleridir.

  • Parametre anahtarları: Parametrelerinizin dize tanımlayıcıları. Anahtarlar en fazla 256 karakter uzunluğunda olabilir, alt çizgi veya İngilizce harf karakteriyle (A-Z, a-z) başlamalı ve sayı içerebilir.
  • Parametre değerleri: Parametrelerinize atanan değerler. Değerler dize olarak depolanır ancak konsolda veri türlerini seçerek değerleri String, Boolean, Number veya JSON gibi biçimlere göre doğrulayabilirsiniz.
  • Varsayılan değerler: Koşul kurallarının uygulanmadığı durumlarda atanan temel değer. Kodunuzda uygulama içi varsayılan değerleri ve Remote Config arka ucunda şablon varsayılan değerlerini tanımlayabilirsiniz.

Koşullar, kurallar ve koşullu değerler

Koşullar, uygulama kullanıcılarının veya sunucu isteklerinin belirli segmentlerini özelleştirilmiş parametre değerleriyle hedeflemenize olanak tanır:

  • Kurallar: İstemci meta verilerine veya istek bağlamlarına (ör. sürüm numarası, ülke ya da özel sinyal) göre değerlendirilen bireysel ölçütler.
  • Koşullar: Bir veya daha fazla kuraldan oluşan adlandırılmış kümelerdir. Bir koşulun true olarak değerlendirilmesi için koşuldaki tüm kurallar true olarak değerlendirilmelidir.
  • Koşullu değerler: Bir koşul true olarak değerlendirildiğinde bir parametreye atanan alternatif değerler. Birden fazla koşul true olarak değerlendirilirse Firebase konsolunda önceliği en yüksek olan koşul öncelikli olur.

Parametre grupları

Düzinelerce veya yüzlerce parametre içeren yapılandırmaları düzenlemek için parametre gruplarını kullanabilirsiniz. Gruplar, Firebase konsolunda görsel düzenleme, REST API'de ise mantıksal gruplandırma sağlar.

  • Bir parametre aynı anda yalnızca bir gruba ait olabilir.
  • Parametre anahtarları, gruplandırmadan bağımsız olarak projenizde genel olarak benzersiz kalır.
  • Gruplandırma, parametre değerlerinin SDK kodunuzda nasıl referans verildiğini değiştirmez.

Grup oluşturma ve yönetmeyle ilgili talimatlar için ayrıntılı istemci veya sunucu parametreleri kılavuzlarına bakın.

Şablon sürümü oluşturma ve geri alma

Remote Config'da parametreleri veya koşulları her güncelleyip yayınladığınızda Firebase, şablonunuzun yeni bir sürümünü oluşturup depolar. Sürüm geçmişini görüntüleyebilir, sürümler arasındaki değişiklikleri karşılaştırabilir ve gerektiğinde önceki bir sürüme geri dönebilirsiniz.

Şablon sürümü yönetimi hakkında daha fazla bilgi edinmek için Remote Config şablon sürümlerini yönetme başlıklı makaleyi inceleyin.

Kotalar ve sınırlar

Bir Firebase projesinde Remote Config aşağıdaki sınırları uygular:

  • Parametreler: Proje başına en fazla 3.000 parametre.
  • Koşullar: Proje başına en fazla 2.000 koşul.
  • Parametre anahtarı uzunluğu: En fazla 256 karakter.
  • Toplam değer dizesi uzunluğu: Bir projedeki tüm parametre değerlerinde en fazla 1.000.000 karakter.

Sınırların tam listesi için Kotalar ve sınırlar başlıklı makaleyi inceleyin.

Sonraki adımlar