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" operatörünü oluşturmak için kullanılır. Bir öğe REST söz diziminde && ise bu öğe bir koşul olarak kabul edilir.

Not: "Ve" işaretinden önce ve sonra boşluk bırakılmalıdır. Ö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 TRUE veya FALSE olarak değerlendirilen bir öğe bir veya daha fazla yerde olup olmadığı Firebase Analytics kitleleri.
app.firstOpenTimestamp Kullanıcının bir uygulamayı ilk kez başlatmasına dayalı bir öğedir. Google Analytics first_open etkinliğinden elde edilir. Sabit bir saat dilimi belirtme seçeneğiyle ISO tarih biçimini kullanır (ör. app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles')). Saat dilimi belirtilmezse GMT kullanılır.
app.userProperty Firebase Analytics Kullanıcı Özelliği'nin sayısal veya dize değerine göre TRUE veya FALSE değerini döndüren bir öğe.
app.operatingSystemAndVersion

Uygulamanın çalıştığı işletim sistemine dayalı bir öğe. İşletim sistemi ve işletim sistemi sürümü belirtilen sürümle eşleştiğinde TRUE olarak değerlendirilir hedefi belirleyebilirsiniz.

Not: Yalnızca web uygulamaları için kullanılabilir.

app.browserAndVersion

Bir 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 değerini döndürür.

Not: Yalnızca web uygulamaları için kullanılabilir.

app.firebaseInstallationId Belirli cihaz kurulumlarının kimliklerini temel alan bir öğe. Kurulum kimliği şu olduğunda TRUE olarak değerlendirilir: belirtilen yükleme kimliklerinden biriyle eşleşir.
device.country Cihazın bulunduğu bölgeyi/ülkeyi temel alan bir öğe: ISO 3166-1 alfa-2 standardı (örneğin, ABD veya Birleşik Krallık). Şu şekilde değerlendirilir: Bir ülke beklenen ülke koduyla eşleştiğinde TRUE.
device.dateTime Cihazın gerçekleştirdiği son getirme zamanına dayalı bir öğe. Sabit bir saat dilimi belirtmek için ISO tarih biçimini dateTime('2017-03-22T13:39:44', 'America/Los_Angeles') seçeneğiyle kullanır.
device.language Cihazda seçilen dile dayalı bir öğe. Dil es-ES, pt-BR veya en-US gibi bir IETF Dil etiketi kullanılarak gösterilir. Bir dil beklenen dil koduyla eşleştiğinde TRUE değerini döndürür.
device.os Bir cihazda kullanılan işletim sistemine (Apple veya Android) dayalı bir öğe. Cihazın işletim sistemi beklenen tür olduğunda TRUE olarak değerlendirilir.
percent Kullanıcının rastgele atanan kesirli yüzdeye dahil edilmesine göre TRUE değerini alır (örnek boyutları %0,000001 kadar küçüktür).

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

  1. İsteğe bağlı olarak tanımlanan name (en fazla 100 karakter)
  2. TRUE veya FALSE olarak değerlendirilen bir koşullu ifade, yukarıda gösterilen öğelerden oluşur.
  3. (İsteğe bağlı) Aşağıdaki işlemleri yapabilecek tagColor "BLUE", "BROWN", "CYAN", "DEEP_ORANGE", "GREEN", "INDIGO", "LIME", "ORANGE", "PINK", "PURPLE" veya "TEAL". Renk büyük/küçük harfe duyarlı değildir ve yalnızca Firebase konsolunuza gidin.

Desteklenen operatörler

Örneğin, app.build.notContains([123, 456]), şu durumda TRUE değerini döndürür: asıl uygulama derlemesi 123 veya 492'dir, ancakFALSE gerçek uygulama derlemesi 999'dur. Örneğin, app.version.notContains([123, 456]), şu durumda TRUE değerini döndürür: asıl uygulama sürümü 123 veya 492'dir, ancakFALSE gerçek uygulama sürümü 999'dur.
Öğe Desteklenen operatörler Açıklama
app.audiences .inAtLeastOne([...]) Gerçek kitle en az bir kitleyle eşleşirse TRUE değerini döndürür kitle adını tıklayın.
Ö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 döndürülü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 aşağıdakilerden herhangi birinin üyesi değilse TRUE değerini döndürür kitle listesidir.
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 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, operatörle eşleşen bir şekilde belirtilen değerle sayısal olarak karşılaştırılırsa TRUE döndürülü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 döndürülür.
app.userProperty .exactlyMatches([...]) Gerçek kullanıcı özelliği tam olarak eşleşirse TRUE değerini döndürür (büyük/küçük harfe duyarlı) listedeki hedef değerlerden herhangi biri.
app.userProperty .matches([...]) Listede bulunan herhangi bir hedef normal ifade, gerçek değerin bir alt dizesi veya tamamıyla eşleşirse TRUE döndürülür. Tüm dizenin eşleşmesini zorunlu kılmak için normal ifadenin önüne "^" ifadesini ekleyin ve "$" sonekini ekleyin. Kullanım RE2 söz dizimi.
app.id == Belirtilen değer uygulamanın uygulama kimliğiyle eşleşirse TRUE döndürür.
app.build <, <=, ==, !=, >=, > Gerçek uygulama derlemesi, operatörle eşleşen bir şekilde belirtilen değerle sayısal olarak karşılaştırılırsa TRUE döndürülür.
app.build .contains([...]) Hedef değerlerden herhangi biriTRUE gerçek uygulama derlemesi (örneğin, "a") ve "bc" şunun alt dizeleridir: "abc" olabilir.
app.build .notContains([...]) Hedef değerlerin hiçbiriTRUE en iyi uygulamadır.
app.build .exactlyMatches([...]) Gerçek uygulama derlemesi tam olarak eşleşirse TRUE değerini döndürür listedeki hedef değerlerden herhangi biri.
app.build .matches([...]) Listede bulunan herhangi bir hedef normal ifade, gerçek değerin bir alt dizesi veya tamamıyla eşleşirse TRUE döndürülür. Eşleşmeyi zorunlu kılmak için normal ifadenin önüne "^" ekleyin ve sonek olarak "$" ile değiştirin. kullanır RE2 söz dizimi.
app.version <, <=, ==, !=, >= > Gerçek uygulama sürümü, operatörle eşleşen bir şekilde belirtilen değerle sayısal olarak karşılaştırılırsa TRUE döndürülür.
app.version .contains([...]) Hedef değerlerden herhangi biriTRUE gerçek uygulama sürümü (örneğin, "a") ve "bc" şunun alt dizeleridir: "abc" olabilir.
app.version .notContains([...]) Hedef değerlerin hiçbiriTRUE gerçek uygulama sürümünü gösterir.
app.version .exactlyMatches([...]) Gerçek uygulama sürümü listedeki hedef değerlerden herhangi biriyle tam olarak eşleşirse TRUE döndürülür.
app.version .matches([...]) Listede bulunan herhangi bir hedef normal ifade, gerçek değerin bir alt dizesi veya tamamıyla eşleşirse TRUE döndürülür. Eşleşmeyi zorunlu kılmak için normal ifadenin önüne "^" ekleyin ve sonek olarak "$" ile değiştirin. kullanır RE2 söz dizimi.
app.operatingSystemAndVersion .inOne([...]) OS ve sürüm,TRUE hedef değerlerinin yerini alı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 döndürülür.
Örneğin:

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

app.firebaseInstallationId in [...] Kurulum kimliği listedeki bir kimlikle eşleşirse TRUE döndürülür. Örnek kullanım: app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']
device.country in [...] Cihazın ülkesi listedeki bir ülkeyle eşleşirse TRUE döndürür. Örnek kullanım: device.country in ['gb', 'us']. Cihazın ülke kodu istekte cihazın IP adresi veya Firebase tarafından belirlenen ülke kodu Analytics (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 bağlı olarak TRUE veya FALSE olarak değerlendirilir. Ö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 döndürür. Örnek kullanım: device.language in ['en-UK', 'en-US'].
device.os ==, != Cihazın işletim sistemi, varsayılan olarak TRUE değerini döndürürse bu alanda operatörle eşleşen değeri değiştirin.
percent <=, >, between percent alanındaki değerse TRUE değerini döndürür operatörle eşleşen rastgele atanmış değerle karşılaştırır.

Rastgele atanan yeni bir çekirdek seçmek için aşağıda açıklandığı gibi belirli bir yüzde aralığı için uygulama örneği grubu Koşul kuralı türler olarak tanımlar.

Bunu yapmak için aşağıdaki örnekte olduğu gibi operatörden önce tohumun adını sağlayın:

percent('keyName') <= 10

Belirli bir aralığı yapılandırmak için between öğesini kullanabilirsiniz. operatörümüzü kullanabilirsiniz. Varsayılan başlangıç değeri'ni kullanarak 20 ila 60 arasında bir kullanıcı aralığını yapılandırmak için:

percent between 20 and 60

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

percent('seedName') between 60 and 80