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 bilgiler yer alır. Arka uç API'lerini ayarlama ve kullanma hakkında daha fazla bilgi için Remote Config'i programatik olarak değiştirme başlıklı makaleyi inceleyin.

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

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

Öğe Açıklama
&&

Bir koşul için birden fazla öğe kullanılıyorsa öğelerin mantıksal "ve"sini oluşturmak için kullanılır. Bir öğe, REST söz diziminde && olmadan kullanılıyorsa 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 versionCode değerini kullanın.

app.version

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ği'ne 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. 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 AnalyticsKullanıcı Özelliği'nin sayısal veya dize değerine göre TRUE ya da FALSE olarak değerlendirilen bir öğe.
app.operatingSystemAndVersion

Bir uygulamanın ç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

Uygulamanın ç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 yüklemelerinin kimliklerini temel alan bir öğe. Yükleme kimliği, belirtilen yükleme kimliklerinden biriyle eşleştiğinde TRUE değerini alır.
app.customSignal Özel sinyal koşullarının sayısal, semantik veya dize değerine göre TRUE ya da FALSE olarak değerlendirilen bir öğe.
device.country ISO 3166-1 alfa-2 standardını kullanarak cihazın bulunduğu bölgeye/ülkeye göre belirlenen bir öğe (ör. US veya UK). Bir ülke, beklenen ülke koduyla eşleştiğinde TRUE değerini alır.
device.dateTime Cihazın gerçekleştirdiği son getirme işleminin zamanına dayalı bir öğe. Sabit bir saat dilimi belirtme seçeneğiyle ISO tarih biçimini kullanır (ör. dateTime('2017-03-22T13:39:44', 'America/Los_Angeles')).
device.language Cihazda seçilen dile dayalı bir öğe. Dil, es-ES, pt-BR veya en-US gibi bir IETF dil etiketi kullanılarak temsil edilir. Bir dil, beklenen dil koduyla eşleştiğinde TRUE olarak değerlendirilir.
device.os Cihazda kullanılan işletim sistemine (Apple veya Android) dayalı bir öğe. Cihaz işletim sistemi beklenen türdeyse TRUE olarak değerlendirilir.
percent Kullanıcının rastgele atanmış bir kesirli 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. İsteğe bağlı olarak tanımlanmış bir name (en fazla 100 karakter)
  2. Önceki tabloda gösterilen öğelerden oluşan, TRUE veya FALSE olarak değerlendirilen koşullu ifade.
  3. (İsteğe bağlı) tagColor. "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österildiğ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 en az bir kitle adıyla 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 kitlelerden hiçbirinin üyesi değilse TRUE değerini döndürür.

app.firstOpenTimestamp <=, >

first_open etkinliğinin zamanını koşulda belirtilen zamanla karşılaştırır ve operatöre göre TRUE veya FALSE değerini döndürür.
Örnek kullanım:
app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles').
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, belirtilen değerle operatöre uygun şekilde sayısal olarak karşılaştırılıyorsa TRUE değerini döndürür.

app.userProperty .contains([...])

Hedef değerlerden herhangi biri gerçek kullanıcı özelliğinin bir 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 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, gerçek değerin bir alt dizesiyle veya tamamıyla eşleşirse TRUE değerini döndürür. Tüm dizenin eşleşmesini zorunlu kılmak için normal ifadenin başına "^" ve sonuna "$" ekleyin. RE2 söz dizimini kullanır.

app.id ==

Belirtilen değer uygulamanın uygulama kimliğiyle eşleşiyorsa TRUE değerini döndürür.

app.build <, <=, ==, !=, >=, >

Gerçek uygulama derlemesi, belirtilen değerle operatöre uygun şekilde sayısal olarak karşılaştırılırsa TRUE değerini döndürür.

app.build .contains([...])

Hedef değerlerden herhangi biri gerçek uygulama derlemesinin bir 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, gerçek uygulama derlemesi 123 veya 492 ise app.build.notContains([123, 456]), TRUE değerini döndürür ancak gerçek uygulama derlemesi 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 bir hedef normal ifade, gerçek değerin bir alt dizesiyle veya 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 dizimini kullanır.

app.version <, <=, ==, !=, >=, >

Gerçek uygulama sürümü, belirtilen değerle operatöre uygun şekilde sayısal olarak karşılaştırılırsa 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 son ekleri veya kısa çizgileri (ör. -beta ya da -rc) desteklemez. Sayısal olmayan son ekler veya kısa çizgiler içeren sürüm dizeleri için 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 bir 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 bir 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 döndürür ancak 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 eşleşirse TRUE değerini döndürür.

app.version .matches([...])

Listedeki herhangi bir hedef normal ifade, gerçek değerin bir alt dizesiyle veya tamamıyla eşleşirse TRUE değerini döndürür. Tüm dizenin eşleşmesini zorunlu kılmak için normal ifadenin başına "^" ve sonuna "$" ekleyin. RE2 söz dizimini kullanır.

app.operatingSystemAndVersion .inOne([...])

İşletim sistemi 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 herhangi 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, belirtilen değerle operatöre uygun şekilde sayısal olarak karşılaştırılırsa 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 eşleşirse (büyük/küçük harfe duyarlı) TRUE değerini döndürür.

app.customSignal .matches([...])

Listedeki hedef normal ifadelerden herhangi biri, gerçek özel sinyal koşulunun bir alt dizesiyle veya tamamıyla eşleşirse TRUE değerini döndürür. Tüm dizenin eşleşmesini zorunlu kılmak için normal ifadenin başına "^" ve sonuna "$" ekleyin. RE2 söz dizimini kullanır.

version(app.customSignal) <, <=, ==, !=, >=, >

Özel sinyal koşulu, belirtilen değerle operatöre uygun şekilde semantik 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 ülke kodu, istekte cihazın IP adresi kullanılarak veya Firebase Analytics tarafından belirlenen ülke kodu kullanılarak belirlenir (Analytics verileri Firebase ile paylaşılıyorsa).

device.dateTime <=, >

Geçerli zamanı koşulun hedef zamanıyla karşılaştırır ve operatöre göre 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ılırsa 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ılırsa 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 çekirdek belirtebilirsiniz.

Bunun için, aşağıdaki örnekte gösterildiği gibi, operatörden önce çekirdeğin adını girin:

percent('keyName') <= 10

Belirli bir aralığı yapılandırmak için between operatörünü kullanabilirsiniz. Varsayılan çekirdeği kullanarak 20 ile 60 arasında bir kullanıcı aralığı yapılandırmak için:

percent between 20 and 60

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

percent('seedName') between 60 and 80