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. 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. Mimarisine bağlı olarak istemci şablonlarını, sunucu şablonlarını veya her ikisini birden 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 kitleleri, uygulama sürümleri, platform, cihaz dili, ülke, kullanıcı yüzdelik dilimleri ve istemci tarafı özel sinyalleri kullanarak uygulama örneklerini hedefleyin.

  • Sunucu şablonlarındaki parametreler ve koşullar: Node.js, Python, Go ve Java için Firebase Admin SDK kullanarak yapılandırmaları Cloud Run, Cloud Functions for Firebase veya container mimarisine alınmış sunucular gibi arka uç ortamlarına sunun. Sunucu özel sinyallerini ve rastgele yüzde sunumları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. Kullanım alanınıza uygun şablon türünü belirlemek için aşağıdaki tablodan yararlanabilirsiniz:

Ö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 kodu tarafından etkinleştirilir. Sunucu belleğine yüklenir; neredeyse sıfır gecikmeyle istek başına değerlendirilir.
Koşul kuralları Uygulama sürümü, OS/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üzdedeki kullanıcı, sunucu özel sinyalleri
Yaygın kullanım alanları Kullanıma sunulan özellikler, sezonluk promosyonlar, kullanıcı arayüzü temaları, A/B Testing, Kişiselleştirme Yapay zeka istemi ve model seçimi, sunucu tarafı özellik bayrakları, arka uç sıklık sınırlaması, dinamik yönlendirme
Ayrıntılı kılavuz İstemci şablonlarındaki parametreler Sunucu şablonlarındaki parametreler

Temel kavramlar

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

Parametreler

Parametreler, Firebase konsolunda veya Remote Config arka uç API'lerini kullanarak tanımladığınız anahtar/değer çiftleridir.

  • Parametre anahtarları: Parametreleriniz için 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ıdır ve sayı içerebilir.
  • Parametre değerleri: Parametrelerinize atanan değerler. Değerler dize olarak depolanır ancak değerleri String, Boolean, Number veya JSON gibi biçimlere göre doğrulamak için konsolda veri türlerini seçebilirsiniz.
  • Varsayılan değerler: Hiçbir koşul kuralı geçerli olmadığında atanan referans 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, özelleştirilmiş parametre değerleriyle uygulama kullanıcılarının veya sunucu isteklerinin belirli segmentlerini hedeflemenize olanak tanır:

  • Kurallar: İstemci meta verilerine veya istek bağlamlarına (ör. sürüm numarası, ülke veya özel sinyal) göre değerlendirilen ayrı ayrı ö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şul içindeki tüm kuralların true olarak değerlendirilmesi gerekir.
  • Koşullu değerler: Bir koşul true olarak değerlendirildiğinde parametreye atanan alternatif değerler. Birden fazla koşul true olarak değerlendirilirse Firebase konsolunda en yüksek önceliğe sahip koşul öncelikli olur.

Parametre grupları

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

  • Bir parametre aynı anda yalnızca bir gruba ait olabilir.
  • Parametre anahtarları, gruplandırmadan bağımsız olarak projeniz genelinde benzersiz kalır.
  • Gruplandırma, parametre değerlerinin SDK kodunuzda referans alınma şeklini değiştirmez.

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

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

Remote Config uygulamasında parametreleri veya koşulları her güncelleyip yayınladığınızda Firebase, şablonunuzun yeni bir sürümünü oluşturur ve 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

Firebase projelerinde 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ğerleri genelinde 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