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
Bir parametrenin ilişkili birkaç koşullu değeri olabilir. İlgili içeriği oluşturmak için kullanılan Aşağıdaki kurallar, Remote Config öğesinden getirilecek değeri belirler şablonu ve belli bir zamandaki belirli bir uygulama örneğinde hangi değerin belirli bir nokta:
İlk olarak, koşullu değerler
true
olarak değerlendirilen koşullar için geçerlidir. Eğer birden fazla koşul,true
olarak değerlendirilir. Bu koşulun sağlandığı ilk (en iyi) koşul, Firebase Console kullanıcı arayüzü önceliklidir ve koşullu değerler Bir uygulama değer getirdiğinde, bu koşulla ilişkilendirilen veriler sağlanır görebilirsiniz. Koşulları Koşullar sekmesine sürükleyip bırakarak önceliklerini değiştirebilirsiniz.true
olarak değerlendirilen koşullara sahip koşullu değer yoksa Bir uygulama veri getirdiğinde Remote Config öğesinin varsayılan değeri sağlanır değerlerini arka uçtan alabilirsiniz. Arka uçta parametre yoksa veya varsayılan değer Uygulama içi varsayılan kullan değerine ayarlanırsa başka bir değer Değer, bir uygulama tarafından getirildiğinde bu parametre için sağlanır.
Uygulamanızda, parametre değerleri şuna göre get
yöntemleri tarafından döndürülür:
aşağıdaki öncelik listesinde
- Bir değer arka uçtan getirilip etkinleştirildiyse uygulama, getirilen değeri kullanır. Etkinleştirilen parametre değerleri kalıcı olur.
Arka uçtan herhangi bir değer getirilmediyse veya Remote Config arka ucu etkinleştirilmedi. Uygulama, uygulama içi varsayılan değere sahiptir.
Varsayılan değerleri alma ve ayarlama hakkında daha fazla bilgi için Remote Config şablonu varsayılanlarını indirme başlıklı makaleyi inceleyin.
Uygulama içi varsayılan değer ayarlanmadıysa uygulama statik bir tür kullanır değeri (ör.
int
için0
veboolean
içinfalse
).
Bu grafikte, parametre değerlerinin Remote Config arka ucunda ve uygulamanızda nasıl önceliklendirildiği özetlenmiştir:
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:
- Grupları yönet'i seçin.
- Eklemek istediğiniz parametrelerin onay kutularını işaretleyin ve Gruba taşı'yı seçin.
- 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
Firebase konsolunda aşağıdaki kural türleri desteklenir. Koşullu ifade referansında açıklandığı gibi, Remote Config REST API'sinde eşdeğer özellikler mevcuttur.
Kural türü | Operatörler | Değerler | Not |
Uygulama | == | Firebase projenizle ilişkili uygulamaların uygulama kimlikleri listesinden seçim yapın. | Firebase'e bir uygulama eklediğinizde paket kimliği veya Android girersiniz
Uygulama Kimliği olarak kullanıma sunulan bir özelliği tanımlayan paket adı
Remote Config kural.
Bu özelliği aşağıdaki şekilde kullanın:
|
Uygulama sürümü |
Dize değerleri için: tam olarak eşleşir, içerir, şunu içermez, normal ifade içerir Sayısal değerler için: <, <=, =, !=, >, >= |
Hedeflenecek uygulamanızın sürümlerini belirtin. Bu kuralı kullanmadan önce bir Uygulama Kimliği kuralı kullanarak Firebase projenizle ilişkilendirilmiş Android/Apple uygulaması. |
Apple platformları için: Uygulamanın CFBundleShortVersionString değerini kullanın. Not: Apple uygulamanızın, Firebase Apple platformlar SDK'sını kullandığından emin olun CFBundleShortVersionString ile gönderilmediği için sürüm 6.24.0 veya üzeri (sürüm notlarına bakın). Android için: Uygulamanın versionName değerini kullanın. Bu kural için dize karşılaştırmaları büyük/küçük harfe duyarlıdır. Tam olarak eşleşir, içerir, içermez veya normal ifade içerir operatörünü kullanırken birden fazla değer seçebilirsiniz. Şu normal ifadeyi içerir operatörünü kullanırken normal ifade oluşturabilirsiniz: RE2'deki ifadeler biçimindedir. Normal ifadeniz, hedef sürüm dizenin tamamını veya bir kısmını eşleştirebilir. Başlangıcı, sonu veya tamamı. |
Derleme numarası |
Dize değerleri için: tam olarak eşleşir, içerir, içermez, normal ifade Sayısal değerler için: =, ≠, >, ≥, <, ≤ |
Hedeflenecek uygulamanızın derlemelerini belirtin. Bu kuralı kullanmadan önce bir Uygulama Kimliği kuralı kullanarak Apple veya Firebase projenizle ilişkilendirilmiş Android uygulaması. |
Bu operatör yalnızca Apple ve Android uygulamaları için kullanılabilir. Bu değer, Apple için uygulamanın CFBundleVersion, Android için ise versionCode değerine karşılık gelir. Bu kural için dize karşılaştırmaları: büyük/küçük harfe duyarlıdır. Tam olarak eşleşir, içerir, içermez veya normal ifade içerir operatörünü kullanırken birden fazla değer seçebilirsiniz. Şu normal ifadeyi içerir operatörünü kullanırken normal ifade oluşturabilirsiniz: RE2'deki ifadeler biçimindedir. Normal ifadeniz hedef sürümün tamamıyla veya bir kısmıyla eşleşebilir dize. Başlangıcı, sonu veya tamamı. |
Platform | == | iOS Android Web |
|
İşletim sistemi | == |
Hedeflenecek işletim sistemlerini belirtin. Bu kuralı kullanmadan önce bir Uygulama Kimliği kuralı kullanarak Firebase projenizle ilişkilendirilmiş web uygulaması. |
İşletim sistemi ve sürümü, belirtilen listedeki bir hedef değerle eşleşirse bu kural, belirli bir web uygulaması örneği için true olarak değerlendirilir.
|
Tarayıcı | == |
Hedeflenecek tarayıcıları belirtin. Bu kuralı kullanmadan önce, Firebase projenizle ilişkili bir web uygulaması seçmek için bir uygulama kimliği kuralı kullanmanız gerekir. |
Bu kural, belirli bir Web uygulaması örneği içintrue
tarayıcının ve sürümünün belirtilen listedeki bir hedef değerle eşleştiğinden emin olun.
|
Cihaz kategorisi | eşit değildir | mobil | Bu kural, web uygulamanıza erişen cihazın mobil mi yoksa mobil olmayan (masaüstü veya konsol) bir cihaz mı olduğunu değerlendirir. Bu kural türü yalnızca web'de kullanılabilir |
Diller | içinde | Bir veya daha fazla dil seçin. | Bu kural, belirli bir uygulama örneği için şu şekilde değerlendirilir: true
listelenen dillerden birini kullanan bir cihaza yüklenmiş olmalıdır.
|
Ülke/Bölge | içinde | Bir veya daha fazla bölge ya da ülke seçin. | Bu kural belirli bir uygulama örneği için true
örneği listelenen bölgeler veya ülkelerden herhangi birinde bulunuyorsa. Cihazın ülke kodu
istekte cihazın IP adresi veya ülke kodu kullanılarak belirlenir
Firebase Analytics tarafından belirlenir (Analytics verileri Firebase ile paylaşılıyorsa).
|
Kullanıcı kitleleri | En az birini içerir | Projeniz için oluşturduğunuz Google Analytics kitle listesinden bir veya daha fazlasını seçin. | Bu kural, Firebase projesi. Not: Birçok Analytics kitlesi, uygulama kullanıcılarının işlemlerine dayalı olabilecek etkinlikler veya kullanıcı özellikleriyle tanımlandığından, belirli bir uygulama örneğinde Kitlede kullanıcı kuralının geçerlilik kazanması biraz zaman alabilir. |
Kullanıcı özelliği |
Dize değerleri için:
içerir, şunları içermez: şununla tam olarak eşleşir: normal ifade içerir Sayısal değerler için: =, ≠, >, ≥, <, ≤ Not: İstemcide, kullanıcı için yalnızca dize değerleri ayarlayabilirsiniz. özellikler. Sayısal operatör kullanan koşullarda Remote Config, ilgili kullanıcı özelliğinin değerini tam sayıya/kayan noktalı sayıya dönüştürür. |
Mevcut Google Analytics kullanıcı mülkleri listesinden seçim yapın. | Uygulamanızı, kullanıcı tabanınızın belirli segmentleri için özelleştirmek amacıyla kullanıcı özelliklerini nasıl kullanabileceğinizi öğrenmek için
Remote Config ve kullanıcı özellikleri başlıklı makaleyi inceleyin.
Kullanıcı özellikleri hakkında daha fazla bilgi edinmek için aşağıdaki kılavuzları inceleyin: Tam olarak eşleşir, içerir, içermez veya normal ifade içerir operatörünü kullanırken 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ün tamamıyla veya bir kısmıyla eşleşebilir dize. Başlangıcı, sonu veya tamamı. Not: Otomatik olarak toplanan kullanıcı özellikleri Remote Config koşulları oluşturulurken kullanılamaz. |
Rastgele yüzdedeki kullanıcı | Kaydırma çubuğu (Firebase konsolunda İlgili içeriği oluşturmak için kullanılan
REST API,
<= , > ve between operatörleri).
|
0-100 |
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, bir uygulamanın kullanıcılarının her biri çakışmayan %5'i için geçerli olacak iki ilgili koşul oluşturmak amacıyla bir koşulu %0 ile %5 arasındaki bir yüzdeyle eşleşecek şekilde, başka bir koşulu ise %5 ile %10 arasındaki bir aralıkla eşleşecek şekilde yapılandırabilirsiniz. Bazı kullanıcıların her iki grupta da rastgele görünmesine izin vermek için her koşuldaki kurallar için farklı başlangıç değerleri kullanın. |
İçe aktarılan segment | içinde | İçe aktarılmış bir veya daha fazla segment seçin. | Bu kural için özel içe aktarılan segmentler oluşturmanız gerekir. |
Tarih/Saat | Önce, Sonra | Cihazın saat diliminde veya belirli bir tarihte belirtilen tarih ve saat "(GMT+11) Sidney saati" gibi bir saat dilimi belirtmem gerekir. | Geçerli saati cihazın getirme zamanıyla karşılaştırır. |
İlk açılış | Önce, Sonra | Belirtilen saat diliminde belirtilen tarih ve saat. | Hedeflenen uygulamayı belirtilen zaman aralığı. Aşağıdaki SDK'ları gerektirir:
|
Yükleme kimliği | içinde | Hedeflenecek bir veya daha fazla Kurulum Kimliği (en fazla 50) belirtin. | Bu kural belirli bir yükleme için true olarak değerlendirilir.
kurulumunun kimliği, virgülle ayrılmış değerler listesindedir.
Kurulum kimliklerini nasıl alacağınızı öğrenmek için İstemci tanımlayıcılarını alma. |
Kullanıcı mevcut | (operatör yok) | Geçerli projedeki tüm uygulamaların tüm kullanıcılarını hedefler. |
Uygulama veya platformdan bağımsız olarak projedeki tüm kullanıcıları eşleştirmek için bu koşul kuralını kullanın. |
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.