Remote Config Parametreleri ve Koşulları


Hem istemci hem de sunucu kullanım alanları için şablonlar yapılandırabilirsiniz. Müşteri şablonların, Firebase'i uygulayan tüm uygulama örneklerine Remote Config için istemci SDK'ları (Android, Apple, Web, Unity dahil), Flutter ve C++ uygulamaları. Sunucuya özgü şablonlardaki Remote Config parametreleri ve değerleri, Firebase Admin Node.js SDK v12.1.0 veya sonraki sürümleri kullanan Remote Config uygulamalarına (Cloud Run ve Cloud Functions dahil) yayınlanır.

Firebase konsolunu veya Remote Config arka uç API'si, veya daha fazla parametre (anahtar/değer çifti) çiftler) ve bu parametreler için uygulama içi varsayılan değerler sağlar. Bu uygulama içi varsayılan değerleri tanımlar. Parametre anahtarları ve parametre değerleri dizelerdir ancak bu değerleri uygulamanızda kullandığınızda parametre değerleri diğer veri türleri olarak yayınlanabilir.

Firebase Konsolu, Admin SDK veya Remote Config REST API'yi kullanarak parametreleriniz için yeni varsayılan değerler ve uygulama örneği gruplarını hedeflemek için kullanılan koşullu değerler oluşturabilirsiniz. Firebase konsolunda yapılandırmanızı her güncellediğinizde, Firebase, Remote Config şablonunuzun yeni bir sürümünü oluşturur ve yayınlar. Önceki sürüm saklanarak gerektiğinde eski sürüme döndürebilir veya geri alabilirsiniz. Bu işlemleri Firebase konsolunda, Firebase Admin SDK ve REST API hakkında daha fazla bilgi verilmiştir. Bu konular Remote Config şablon sürümünü yönetin.

Bu kılavuzda parametreler, koşullar, kurallar, koşullu değerler ve çeşitli parametre değerlerinin Remote Config arka ucunda ve uygulamanızda nasıl önceliklendirildiği açıklanmaktadır. Ayrıca, koşul oluşturmak için kullanılan kural türleri hakkında ayrıntılı bilgi verilmektedir.

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

Koşul, bir uygulama örneği grubunu hedeflemek için kullanılır. Koşulların sağlanması koşulun çalışması için tümünün true olarak değerlendirilmesi gereken bir veya daha fazla kuraldan belirli bir uygulama örneği için true olarak değerlendirilsin. Bir kuralın değeri (örneğin, kullanılabilir bir değer olmadığında) bu kural, false

Örneğin, büyük bir dili tanımlayan bir parametre oluşturabilirsiniz modeli (LLM) model adı ve sürüm dizesini kullanarak farklı özel sinyale dayalı modeller kuralları hakkında daha fazla bilgi edinin. Bu kullanım alanında, çoğu isteği yayınlamak için varsayılan değer olarak kararlı bir model sürümü kullanabilir ve istemci isteklerine yanıt vermek üzere deneysel bir model kullanmak için özel sinyali kullanabilirsiniz.

Bir parametrede birden fazla koşul olabilir Parametreler, doğru ve etkili bir şekilde girebilmek için anlatabilmişimdir. Firebase konsolunun Parametreler sekmesinde, her parametrenin koşullu değerleri için getirme yüzdesini görüntüleyebilirsiniz. Bu metrik, son 24 saat içinde her bir değeri alan isteklerin yüzdesini gösterir.

Parametre değeri önceliği

Sunucu uygulamalarında Firebase Admin SDK kullanarak Remote Config'ü kullandığınızda, her istemci isteği için uygun parametre değerlerini isteğe bağlı olarak ayıklamak amacıyla şablonun tamamını getirip yüklersiniz. Bir parametrenin ilişkili birkaç koşullu değeri olabilir.

Aşağıdaki kurallar, şablon değerlendirmesi sırasında hangi değerin atanacağını belirler belirli bir zamanda:

  1. Öncelikle, belirli bir istemci isteği için true olarak değerlendirilen tüm koşullara koşullu değerler uygulanır. Birden fazla koşul true olarak değerlendirilirse Firebase konsol kullanıcı arayüzünde gösterilen ilk (üstteki) koşul öncelik alır ve şablon değerlendirilirken bu koşulla ilişkili koşullu değerler sağlanır. Şunları yapabilirsiniz: koşulları sürükleyip bırakarak koşulların önceliğini Koşullar sekmesi.

  2. true olarak değerlendirilen koşullara sahip koşullu değer yoksa şablon değerlendirmesi sırasında Remote Config'un varsayılan değeri sağlanır. Şablonda bir parametre yoksa veya varsayılan değer ayarlanmışsa Uygulama içi varsayılanı kullan seçeneğine ayarlanırsa bu parametre için herhangi bir değer sağlanmaz şablon değerlendirilir.

Sunucu uygulamalarında Remote Config şablonlarını yükleme ve değerlendirme hakkında daha fazla bilgi için Remote Config'ü sunucu ortamlarında kullanma başlıklı makaleyi inceleyin.

Parametre değeri veri türleri

Remote Config, her parametre için bir veri türü seçmenize olanak tanır ve şablon güncellemesinden önce tüm Remote Config değerlerini ilgili veri türüne göre doğrular. Veri türü depolanır ve getRemoteConfig isteğinde döndürülür.

Desteklenen veri türleri şunlardır:

  • String
  • Boolean
  • Number
  • JSON

Firebase konsol kullanıcı arayüzünde, veri türü parametre anahtarının yanındaki açılır listeden seçilebilir. REST API'de türler şu komutla ayarlanabilir: parametre nesnesindeki value_type alanına.

Parametre grupları

Remote Config, daha düzenli bir kullanıcı arayüzü ve daha iyi kullanılabilirlik için parametreleri gruplandırmanıza olanak tanır.

Örneğin, üç farklı kimlik doğrulama türünü etkinleştirmeniz veya devre dışı bırakmanız gerektiğini varsayalım. yeni bir giriş özelliğini kullanıma sunuyor. Remote Config ile şunları oluşturabilirsiniz: üç parametreyi seçin ve ardından bunları tek tek "Yeni giriş bilgileri" adlı grup, hiçbir önek veya özel sıralama gerekmez.

Firebase konsolunu veya Remote Config REST API. Oluşturduğunuz her parametre grubunun Remote Config şablonunuzda benzersiz bir adı vardır. Parametre grupları oluştururken şunları göz önünde bulundurun:

  • Parametreler herhangi bir zamanda yalnızca bir gruba dahil edilebilir ve parametre anahtarı tüm parametreler için benzersiz olmalıdır.
  • Parametre grubu adları 256 karakterle sınırlıdır.
  • Hem REST API'yi hem de Firebase konsolunu kullanıyorsanız REST API mantığının, yayınlama sırasında parametre gruplarını işleyecek şekilde güncellendiğinden emin olun.

Firebase konsolunu kullanarak parametre grupları oluşturma veya değiştirme

Parametreleri Parametreler Firebase konsolunun sekmesindedir. Grup oluşturmak veya mevcut bir grubu değiştirmek için:

  1. Grupları yönet'i seçin.
  2. Eklemek istediğiniz parametrelerin onay kutularını işaretleyin ve Gruba taşı'yı seçin.
  3. Mevcut bir grubu seçin veya ad ve açıklama girip Yeni grup oluştur'u seçerek yeni bir grup oluşturun. Bir grup kaydedildikten sonra, Değişiklikleri yayınla düğmesi.

Koşul kuralı türleri

Sunucu uygulamaları için Remote Config şablonları aşağıdaki koşul türlerini destekler:

Rastgele yüzdelik dilimde kullanıcı

Rastgele karıştırılan kullanıcıları (uygulama örnekleri) gruplara ayırmak için kaydırma çubuğu widget'ını kullanarak rastgele bir uygulama örneği (örnek boyutu %0,0001 kadar küçük olabilir) üzerinde değişiklik uygulamak için bu alanı kullanın.

Her uygulama örneği, ilgili projede tanımlanan bir tohum değerine göre rastgele bir tam veya kesirli sayı ile sürekli olarak eşlenir.

Bir kural aşağıdaki işlemleri yapmazsanız varsayılan anahtarı (Firebase konsolunda Başlangıç noktasını düzenle olarak gösterilir) kullanır. çekirdek değeri değiştirin. Tohum alanını temizleyerek bir kuralı varsayılan anahtarı kullanmaya döndürebilirsiniz.

Belirli yüzde aralıkları içindeki aynı uygulama örneklerini tutarlı bir şekilde ele almak için koşullarda aynı başlangıç değerini kullanın. Alternatif olarak, yeni bir başlangıç değeri belirterek belirli bir yüzde aralığı için rastgele atanan yeni bir uygulama örneği grubu seçebilirsiniz.

Örneğin, her biri bir uygulamanın %5'inin örtüşmeyen %5'i için geçerli olacak şekilde bir koşulu% 0 ile% 5 arasında bir yüzdeyle eşleşecek şekilde yapılandırabilir ve %5 ile %10 arasında bir aralıkla eşleşecek başka bir koşul daha gönderin. Bazı kullanıcıların her iki grupta da her koşuldaki kurallar için farklı çekirdek değerler kullanın.

Uygulamanıza rastgele yüzde koşulları eklemeyi öğrenmek için Sunucunuzu yapılandırma dönüştürmenizi sağlar.

Özel sinyaller

Firebase Admin Node.js SDK 12.5.0 ve sonraki sürümlerde, uygulamanızda tanımladığınız rastgele koşulları eşleştirmek için Özel sinyal koşul türünü kullanabilirsiniz. Bu sayede sunucu yanıtını her istemci isteği için özelleştirebilirsiniz.

Örneğin, belirli platformlara göre ayarlanmış farklı modellerle yanıtlar oluşturmaya yardımcı olmak için üretken yapay zeka kullanan bir sunucu uygulaması üzerinde çalışıyorsanız şunları yapabilirsiniz:

  1. prompt ve model_name parametrelerini Remote Config dosyanıza ekleyin sunucu şablonu.
  2. Oluşturduğunuz her platform için platform değerine sahip özel sinyaller ekleyin oluşturmanız gerekir.
  3. Sunucuya özel Remote Config şablonunuza varsayılan değerler ekleyin ve koşullu değerleri (tanımladığınız her platform koşulu için) belirleyin.
  4. platform özel sinyalini ayarlayıp kullanmak için uygulama kodunuzu güncelleyin.

Artık uygulamanız şablon sırasında uygun istemi ve modeli çıkarabiliyor ve bunları kullanarak her bir müşteriye özelleştirilmiş yanıtlar vermek için kullanabilirsiniz.

Şurada özel sinyaller oluşturmak için aşağıdaki kural türlerini kullanabilirsiniz: Firebase konsolu.

Operatör kategorisi Operatörler Değer Not
Metin tam olarak eşleşir, içerir, içermez, normal ifade içerir

Bu kural için dize karşılaştırmaları büyük/küçük harfe duyarlıdır. şununla tam olarak eşleşir:, içerir, içermez veya şunu içerir: normal ifade operatörünü kullandığınızda birden fazla değer seçebilirsiniz.

normal ifade içeriyor operatörünü kullanırken RE2 biçiminde normal ifadeler oluşturabilirsiniz. Normal ifadeniz, hedef sürüm dizenin tamamını veya bir kısmını eşleştirebilir. Bir hedef dizenin başlangıcını, sonunu veya tamamını eşleştirmek için ^ ve $ çapalarını da kullanabilirsiniz.

Numbers <, <=, =, !=, >, >= Ondalık işaretinin her iki yanında en fazla on basamak bulunan sayı.
Sürümler <, <=, =, !=, >, >= Eşleştirilecek sürüm numaralarını temsil eden sayı (örneğin, 2.1.0).

Uygulamanıza özel sinyalleri nasıl ekleyeceğinizi öğrenmek için sunucu uygulamasına gidin.

Parametreleri ve koşulları arayın

Projenizin parametre anahtarlarını, parametre değerlerini ve koşullarını arayabilirsiniz Firebase konsolundan Remote Config Parametreler sekmesinin üst kısmındaki arama kutusunu tıklayın.

Parametre ve koşullarla ilgili sınırlar

Bir Firebase projesinde en fazla 2.000 parametre ve 500 koşul olabilir. Parametre anahtarları en fazla 256 karakter uzunluğunda olabilir, alt çizgiyle veya İngiliz alfabesinden bir karakterle (A-Z, a-z) başlamalıdır ve sayı da içerebilir. Bir projedeki parametre değeri dizelerinin toplam uzunluğu 1.000.000 karakteri aşamaz.

Parametreler ve koşullardaki değişiklikleri görüntüleme

Remote Config şablonlarınızdaki en son değişiklikleri Firebase konsolundan görüntüleyebilirsiniz. Her parametre ve koşul için şunları yapabilirsiniz:

  • Parametreyi veya koşulu en son değiştiren kullanıcının adını görüntüleyin.

  • Değişiklik aynı gün içinde gerçekleştiyse değişikliğin etkin Remote Config şablonunda yayınlanmasından bu yana geçen dakika veya saat sayısını görüntüleyin.

  • Değişiklik bir veya daha fazla gün önce gerçekleştiyse değişikliğin etkin Remote Config şablonunda yayınlandığı tarihi görüntüleyin.

Parametreler için değişiklik geçmişi

Remote Config Parametreler sayfasındaki Son yayınlanma tarihi sütununda, her parametreyi değiştiren son kullanıcı ve değişikliğin son yayınlanma tarihi gösterilir:

  • Gruplandırılmış parametrelerle ilgili değişiklik meta verilerini görüntülemek için parametre grubunu genişletin.

  • Yayınlanma tarihine göre artan veya azalan düzende sıralamak için Son yayınlanan sütun etiketi.

Koşullar için değişiklik geçmişi

Remote Config Koşullar sayfasında, her koşulun altındaki Son değiştirilme ifadesinin yanında koşulu değiştiren son kullanıcıyı ve koşulu değiştirdiği tarihi görebilirsiniz.

Sonraki adımlar

Firebase projenizi ve sunucu uygulamanızı Remote Config kullanacak şekilde yapılandırmak için Remote Config'ü sunucu ortamlarında kullanma başlıklı makaleyi inceleyin.