Remote Config koşullu ifade referansı

Bu sayfada, Remote Config arka uç API'lerini veya Firebase konsolunu kullanarak koşullu ifadeler oluşturmayla ilgili referans bilgileri yer alır. Arka uç API'lerinin kurulumu ve kullanımı hakkında daha fazla bilgi için Remote Config'i programatik olarak değiştirme başlıklı makaleyi inceleyin.

Koşulları oluşturmak için kullanılan öğeler

Remote Config REST API, Firebase Console'u kullanarak Remote Config yapılandırırken koşullar oluşturmak için kullanabileceğiniz öğeleri destekler:

Öğe Açıklama
&&

Bir koşul için birden fazla öğe kullanılıyorsa öğeler arasında mantıksal bir "ve" işlemi oluşturmak için kullanılır. Bir öğe REST söz diziminde && olmadan kullanılırsa bu öğe koşul olarak değerlendirilir.

Not: Ve işaretlerinden önce ve sonra boşluk bırakılması gerekir. Örneğin: element1 && element2.
app.build

Bir uygulamanın derleme numarasının değerine göre TRUE veya FALSE olarak değerlendirilir.

Not: Yalnızca Apple ve Android cihazlarda kullanılabilir. Apple için CFBundleVersion değerini, Android için ise versionCode değerini kullanın.
app.version

Bir uygulamanın sürüm numarasının değerine göre TRUE veya FALSE olarak değerlendirilir.

Not: Android cihazlar için versionName değerini, Apple cihazlar için ise CFBundleShortVersionString değerini kullanın.
app.id Uygulamanın Firebase uygulama kimliğine dayalı bir öğe
app.audiences Kullanıcının bir veya daha fazla Firebase Analytics kitlesinde bulunup bulunmamasına göre TRUE veya FALSE olarak değerlendirilen bir öğe.
app.firstOpenTimestamp Kullanıcının bir uygulamayı ilk kez başlatmasına dayalı bir öğe. Bu öğe, Google Analytics first_open etkinliğinden elde edilir. Sabit bir saat dilimi belirtme seçeneğiyle ISO tarih biçimini kullanır. Örneğin, app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles'). Saat dilimi belirtilmezse GMT kullanılır.
app.userProperty Bir Google Analytics kullanıcı özelliğinin sayısal veya dize değerine göre TRUE ya da FALSE olarak değerlendirilen bir öğe.
app.operatingSystemAndVersion

Bir uygulamanın üzerinde çalıştığı işletim sistemine dayalı bir öğe. İşletim sistemi ve işletim sistemi sürümü belirtilen hedefle eşleştiğinde TRUE olarak değerlendirilir.

Not: Yalnızca web uygulamalarında kullanılabilir.
app.browserAndVersion

Bir uygulamanın üzerinde çalıştığı tarayıcıya dayalı bir öğe. Tarayıcı ve tarayıcı sürümü belirtilen hedefle eşleştiğinde TRUE olarak değerlendirilir.

Not: Yalnızca web uygulamalarında kullanılabilir.
app.firebaseInstallationId Belirli cihaz kurulumlarının kimliklerine dayalı bir öğe. Yükleme kimliği belirtilen yükleme kimliklerinden biriyle eşleştiğinde TRUE olarak değerlendirilir.
app.customSignal Özel sinyal koşullarının sayısal, anlamsal veya dize değerine göre TRUE ya da FALSE olarak değerlendirilen bir öğe.
device.country ISO 3166-1 alfa-2 standardı kullanılarak bir cihazın bulunduğu bölgeye/ülkeye göre belirlenen bir öğe (örneğin, ABD veya Birleşik Krallık). Bir ülke beklenen ülke koduyla eşleştiğinde TRUE değerini döndürür.
device.dateTime Cihazın gerçekleştirdiği son getirme işlemine göre belirlenen bir öğe. Sabit bir saat dilimi belirtme seçeneğiyle ISO tarih biçimini kullanır. Örneğin, dateTime('2017-03-22T13:39:44', 'America/Los_Angeles').
device.language Cihazda seçilen dile göre belirlenen bir öğe. Dil, es-ES, pt-BR veya en-US gibi bir IETF dil etiketiyle gösterilir. Bir dil, beklenen bir dil koduyla eşleştiğinde TRUE olarak değerlendirilir.
device.os Bir cihazda kullanılan işletim sistemine (Apple veya Android) dayalı bir öğe. Cihazın işletim sistemi beklenen türdeyse TRUE değerini döndürür.
percent Rastgele atanan kesirli bir yüzdeye (örnek boyutları %0,000001 kadar küçük olabilir) dahil edilmesine göre TRUE olarak değerlendirilir.

Tek öğeli bir koşul üç alan içerir:

  1. Rastgele tanımlanmış bir name (en fazla 100 karakter)
  2. Önceki tabloda gösterilen öğelerden oluşan ve TRUE veya FALSE olarak değerlendirilen koşullu ifade.
  3. (İsteğe bağlı) tagColor. Bu değer "BLUE", "BROWN", "CYAN", "DEEP_ORANGE", "GREEN", "INDIGO", "LIME", "ORANGE", "PINK", "PURPLE" veya "TEAL" olabilir. Renk büyük/küçük harfe duyarlı değildir ve yalnızca koşulların Firebase konsolunda nasıl görüntülendiğini etkiler.

Desteklenen operatörler

Öğe Desteklenen operatörler Açıklama
app.audiences .inAtLeastOne([...])

Gerçek kitle, listedeki en az bir kitle adıyla eşleşiyorsa TRUE değerini döndürür.
Örneğin:

app.audiences.inAtLeastOne(['Audience 1', 'Audience 2'])
app.audiences .notInAtLeastOne([...])

Gerçek kitle, listedeki kitle adlarından en az biriyle eşleşmiyorsa TRUE değerini döndürür.
app.audiences .inAll([...])

Gerçek kitle, listedeki her kitle adının üyesiyse TRUE değerini döndürür.
app.audiences .notInAll([...])

Gerçek kitle, listedeki herhangi bir kitlenin üyesi değilse TRUE değerini döndürür.
app.firstOpenTimestamp <=, >

first_open etkinliğinin zamanını koşuldaki belirtilen zamanla karşılaştırır ve operatöre bağlı olarak TRUE veya FALSE değerini döndürür.
Örnek kullanım:
app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles').
Bir aralık belirtmek için:
app.firstOpenTimestamp >= ('2022-11-01T00:00:00') && app.firstOpenTimestamp < ('2022-12-01T00:00:00') Saat dilimi belirtilmezse GMT kullanılır.

app.userProperty <, <=, ==, !=, >=, >

Gerçek kullanıcı özelliği, operatörle eşleşecek şekilde belirtilen değerle sayısal olarak karşılaştırıldığında TRUE değerini döndürür.
app.userProperty .contains([...])

Hedef değerlerden herhangi biri gerçek kullanıcı özelliğinin alt dizesiyse TRUE değerini döndürür.
app.userProperty .notContains([...])

Hedef değerlerden hiçbiri gerçek kullanıcı özelliğinin alt dizesi değilse TRUE değerini döndürür.
app.userProperty .exactlyMatches([...])

Gerçek kullanıcı özelliği, listedeki hedef değerlerden herhangi biriyle tam olarak eşleşirse (büyük/küçük harfe duyarlı) TRUE değerini döndürür.
app.userProperty .matches([...])

Listedeki herhangi bir hedef normal ifade, alt dizeyle veya gerçek değerin tamamıyla eşleşirse TRUE değerini döndürür. Dizenin tamamının eşleşmesini zorunlu kılmak için normal ifadenin başına "^" ve sonuna "$" ekleyin. RE2 söz dizimi kullanılır.
app.id ==

Belirtilen değer, uygulamanın uygulama kimliğiyle eşleşirse TRUE değerini döndürür.
app.build <, <=, ==, !=, >=, >

Gerçek uygulama derlemesi, operatörle eşleşecek şekilde belirtilen değerle sayısal olarak karşılaştırıldığında TRUE değerini döndürür.
app.build .contains([...])

Hedef değerlerden herhangi biri gerçek uygulama derlemesinin alt dizesiyse TRUE değerini döndürür. Örneğin, "a" ve "bc", "abc"nin alt dizeleridir.
app.build .notContains([...])

Hedef değerlerden hiçbiri gerçek uygulama derlemesinin alt dizesi değilse TRUE değerini döndürür. Örneğin, app.build.notContains([123, 456]) gerçek uygulama derlemesi 123 veya 492 ise TRUE değerini, 999 ise FALSE değerini döndürür.

app.build .exactlyMatches([...])

Gerçek uygulama derlemesi, listedeki hedef değerlerden herhangi biriyle tam olarak eşleşiyorsa TRUE değerini döndürür.
app.build .matches([...])

Listedeki herhangi hedef normal ifade, alt dizeyle veya gerçek değerin tamamıyla eşleşirse TRUE değerini döndürür. Dizenin tamamının eşleşmesini zorunlu kılmak için normal ifadenin başına "^" ve sonuna "$" ekleyin. RE2 söz dizimi kullanılır.
app.version <, <=, ==, !=, >=, >

Gerçek uygulama sürümü, operatörle eşleşecek şekilde belirtilen değerle sayısal olarak karşılaştırıldığında TRUE değerini döndürür.

Not: Sayısal karşılaştırma operatörleri yalnızca sayısal anlamsal sürümleri (ör. 1.2.3) destekler ve yayın öncesi ekleri veya tireleri (ör. -beta veya -rc) desteklemez. Sayısal olmayan ekler veya tireler içeren sürüm dizeleri için bunun yerine dize operatörlerini (ör. .matches veya .contains) kullanın.
app.version .contains([...])

Hedef değerlerden herhangi biri gerçek uygulama sürümünün alt dizesiyse TRUE değerini döndürür. Örneğin, "a" ve "bc", "abc"nin alt dizeleridir.
app.version .notContains([...])

Hedef değerlerden hiçbiri gerçek uygulama sürümünün alt dizesi değilse TRUE değerini döndürür. Örneğin, gerçek uygulama sürümü 123 veya 492 ise app.version.notContains([123, 456]) TRUE değerini, gerçek uygulama sürümü 999 ise FALSE değerini döndürür.

app.version .exactlyMatches([...])

Gerçek uygulama sürümü, listedeki hedef değerlerden herhangi biriyle tam olarak eşleşiyorsa TRUE değerini döndürür.
app.version .matches([...])

Listedeki herhangi hedef normal ifade, alt dizeyle veya gerçek değerin tamamıyla eşleşirse TRUE değerini döndürür. Dizenin tamamının eşleşmesini zorunlu kılmak için normal ifadenin başına "^" ve sonuna "$" ekleyin. RE2 söz dizimi kullanılır.
app.operatingSystemAndVersion .inOne([...])

OS ve sürüm listedeki hedef değerlerden herhangi biriyle eşleşirse TRUE değerini döndürür.
Örneğin:

app.operatingSystemAndVersion.inOne([operatingSystemName('Macintosh')
    .version.==('10.15')])
app.browserAndVersion .inOne([...])

Tarayıcı ve sürüm, listedeki hedef değerlerden herhangi biriyle eşleşirse TRUE değerini döndürür.
Örneğin:

app.browserAndVersion.inOne([browserName('Chrome').anyVersion])
app.firebaseInstallationId in [...]

Yükleme kimliği listede belirtilenlerden biriyle eşleşirse TRUE değerini döndürür. Örnek kullanım: app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']
app.customSignal <, <=, ==, !=, >=, >

Özel sinyal koşulu, operatörle eşleşecek şekilde belirtilen değerle sayısal olarak karşılaştırıldığında TRUE değerini döndürür.
app.customSignal .contains([...])

Hedef değerlerden herhangi biri gerçek özel sinyal koşulunun alt dizesiyse TRUE değerini döndürür.

app.customSignal .notContains([...])

Hedef değerlerden herhangi biri gerçek özel sinyal koşulunun alt dizesiyse TRUE değerini döndürür.

app.customSignal .exactlyMatches([...])

Gerçek özel sinyal koşulu listedeki hedef değerlerden herhangi biriyle tam olarak (büyük/küçük harfe duyarlı) eşleşirse TRUE değerini döndürür.
app.customSignal .matches([...])

Listedeki herhangi bir hedef normal ifade, gerçek özel sinyal koşulunun bir alt dizesiyle veya tamamıyla eşleşirse TRUE değerini döndürür. Dizenin tamamının eşleşmesini zorlamak için normal ifadenin başına "^" karakterini, sonuna ise "$" karakterini ekleyin. RE2 söz dizimi kullanılır.
version(app.customSignal) <, <=, ==, !=, >=, >

Özelleştirilebilen sinyal koşulu, operatörle eşleşecek şekilde belirtilen değerle anlamsal olarak karşılaştırılıyorsa TRUE değerini döndürür.
device.country in [...]

Cihazın ülkesi listede belirtilenlerden herhangi biriyle eşleşiyorsa TRUE değerini döndürür. Örnek kullanım: device.country in ['gb', 'us']. Cihazın ülke kodu, istekteki cihazın IP adresi veya Firebase Analytics tarafından belirlenen ülke kodu (Analytics verileri Firebase ile paylaşılıyorsa) kullanılarak belirlenir.
device.dateTime <=, >

Mevcut saati koşulun hedef saatiyle karşılaştırır ve operatöre bağlı olarak TRUE veya FALSE olarak değerlendirir. Örnek kullanım: dateTime < dateTime('2017-03-22T13:39:44').
device.language in [...]

Uygulamanın dillerinden herhangi biri listedeki bir dille eşleşirse TRUE değerini döndürür. Örnek kullanım: device.language in ['en-UK', 'en-US'].
device.os ==, != Cihazın işletim sistemi, operatörle eşleşen alandaki değerle karşılaştırıldığında TRUE değerini döndürür.
percent <=, >, between

percent alanındaki değer, operatörle eşleşen rastgele atanmış değerle karşılaştırıldığında TRUE değerini döndürür.

Koşul kuralı türleri bölümünde açıklandığı gibi, belirli bir yüzde aralığı için rastgele atanmış yeni bir uygulama örneği grubu seçmek üzere bir başlangıç değeri belirleyebilirsiniz.

Bunu yapmak için aşağıdaki örnekte olduğu gibi operatörden önce başlangıç değerinin adını girin:

percent('keyName') <= 10

Belirli bir aralığı yapılandırmak için between operatörünü kullanabilirsiniz. Varsayılan başlangıç değeri kullanılarak 20 ile 60 arasında bir kullanıcı aralığı yapılandırmak için:

percent between 20 and 60

Özel bir başlangıç kullanarak 60 ila 80 arasında bir kullanıcı aralığı yapılandırmak için:

percent('seedName') between 60 and 80