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'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 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 öğelerin mantıksal "ve"sini 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 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şlattığı zamana 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ği'nin 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. Kurulum kimliği belirtilen kurulum 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 cihazın bulunduğu bölgeye/ülkeye göre belirlenen bir öğe (ör. 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 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 dayalı bir öğe. Dil, IETF dil etiketi (ör. es-ES, pt-BR veya en-US) kullanılarak 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 olarak değerlendirilir.
percent Rastgele atanmış kesirli bir yüzdeye (örnek boyutları %0,000001 kadar küçük olabilir) kullanıcının 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. Yukarıda 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

Örneğin, gerçek uygulama derlemesi 123 veya 492 ise app.build.notContains([123, 456]), 999 ise FALSE değerini döndürür.TRUE Örneğin, app.version.notContains([123, 456]), gerçek uygulama sürümü 123 veya 492 ise TRUE değerini, gerçek uygulama sürümü 999 ise FALSE değerini döndürür.
Öğe Desteklenen operatörler Açıklama
app.audiences .inAtLeastOne([...]) Gerçek kitle, listedeki kitle adlarından en az biriyle 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 herhangi birinin ü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 "^" karakterini, sonuna ise "$" karakterini 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.
app.build .exactlyMatches([...]) Uygulamanın gerçek 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, alt dizeyle veya gerçek değerin tamamıyla eşleşirse TRUE döndürür. Dizenin tamamının eşleşmesini zorunlu kılmak için normal ifadenin başına "^" karakterini, sonuna ise "$" karakterini 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.
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.
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 bir hedef normal ifade, alt dizeyle veya gerçek değerin tamamıyla eşleşirse TRUE döndürür. Dizenin tamamının eşleşmesini zorunlu kılmak için normal ifadenin başına "^" karakterini, sonuna ise "$" karakterini 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 zorunlu kılmak için normal ifadenin başına "^" karakterini, sonuna ise "$" karakterini ekleyin. RE2 söz dizimi kullanılır.
version(app.customSignal) <, <=, ==, !=, >=, > Özel 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 <=, > Geçerli 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 sonucunu 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ıç 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