Remote Config Parametreleri ve Koşulları

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 Android, Apple, Web, Unity dahil olmak üzere Remote Config için istemci SDK'ları Flutter ve C++ uygulamaları. Remote Config parametreleri ve değerleri: sunucuya özgü şablonlar Remote Config uygulamalarına sunulur Firebase Yöneticisi kullanan (Cloud Run ve Cloud Functions dahil) Node.js SDK v12.1.0+.

Firebase konsolunu veya Remote Config arka uç API'leri 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 dizedir ancak parametre değerleri, bu değerleri en iyi şekilde yararlanabilirsiniz.

Firebase konsolunu kullanarak Admin SDK veya Remote Config REST API şunun için yeni varsayılan değerler oluşturabilirsiniz: parametrelerin yanı sıra uygulama gruplarını hedeflemek için kullanılan koşullu değerler sağlar. 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şlemlere Firebase konsolu, ve REST API hakkında daha fazla bilgi edinmek için aşağıdaki makalelerimizi inceleyebilirsiniz: Remote Config şablon sürümlerini yönetin.

Bu kılavuzda parametreler, koşullar, kurallar ve ve çeşitli parametre değerlerinin Search Ads 360'ta nasıl önceliklendirildiğini Remote Config Server ve uygulamanızda. Ayrıca, nasıl uyarlayacağınıza dair kurallarından biridir.

Koşullar, kurallar ve koşullu değerler

Uygulama örnekleri grubunu hedeflemek için koşullar 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, başlangıç sayfasında, basit kural if device_os = Android:

Veya bir zaman koşulu uygulamanızda ne zaman özel reklamların gösterildiğini kontrol etmek için kullanılabilir promosyon öğeleri.

Bir parametrede birden fazla koşul olabilir Parametreler, doğru ve etkili bir şekilde girebilmek için anlatabilmişimdir. Parametreler sekmesi her bir metriğin getirme yüzdesini görüntüleyebilirsiniz. parametresinin koşullu değerlerini içerir. Bu metrik, isteklerin yüzdesini gösterir (son 24 saatte her bir değeri alan)

Parametre değeri önceliği

Bir parametre, kendisiyle ilişkilendirilmiş birkaç koşullu değere sahip olabilir. İlgili içeriği oluşturmak için kullanılan Remote Config'den hangi değerin getirileceğini aşağıdaki kurallar belirler ve belirli bir uygulama örneğinde belirli bir noktada kullanılan değer, zaman:

Parametre değerleri, aşağıdaki önceliğe göre getirilir liste

1. İlk olarak, 2007'den itibaren geçerli olmak üzere belirli bir uygulama örneği için true olarak değişecektir. Birden fazla koşul true olarak değerlendirilirse Firebase konsolu kullanıcı arayüzünde gösterilen ilk (en üstteki) önceliklidir ve Bu koşulla ilişkili koşullu değerler, bir uygulama Arka uçtan değer getirir. Koşulların önceliğini şu şekilde değiştirebilirsiniz: Koşullar sekmesinde sürükleyip bırakma.

2. true olarak değerlendirilen koşullara sahip koşullu değer yoksa Remote Config'in varsayılan değeri, bir uygulama arka uçta olması gerekir. Parametre arka uçta yoksa veya varsayılan değer Uygulama içi varsayılanı kullan değerine ayarlanırsa bu parametre için herhangi bir değer sağlanmaz Bir uygulama değer getirdiğinde.

Uygulamanızda, parametre değerleri şuna göre get yöntemleri tarafından döndürülür: aşağıdaki öncelik listesinde

1. Bir değer arka uçtan getirilip etkinleştirildiyse uygulama getirildiği tarihtir. Etkinleştirilen parametre değerleri kalıcıdır.

2. Arka uçtan herhangi bir değer getirilmediyse veya Remote Config arka ucu etkinleştirilmedi. Uygulama, 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ı indirin.

3. Uygulama içi varsayılan değer ayarlanmadıysa uygulama statik bir tür kullanır değeri (ör. int için 0 ve boolean için false).

Bu grafikte, Remote Config arka ucu ve uygulamanızda:

Parametre değeri veri türleri

Remote Config, her parametre için bir veri türü seçmenize ve Bir şablondan önce bu türe göre tüm Remote Config değerlerini doğrular güncelleyin. Veri türü depolanır ve getRemoteConfig üzerinde döndürülür. isteği gönderin.

Şu anda desteklenen türler şunlardır:

• String
• Boolean
• Number
• JSON

Firebase konsolu kullanıcı arayüzünde, veri türü sonraki açılır listeden seçilebilir. ifadesini ekleyin. REST API türleri, value_type kullanılarak ayarlanabilir. alan, parametre nesnesinin içindeki yer alır.

Parametre grupları

Remote Config, daha düzenli bir çalışma için parametreleri gruplandırmanıza olanak tanır. Kullanıcı arayüzü ve zihinsel model.

Ö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 üç parametreyi kullanın ve bunları istediğiniz gibi etkinleştirin ve ardından bunları "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 şablonunuz. Parametre grupları oluştururken aşağıdakileri göz önünde bulundurun:

• Parametreler, aynı anda yalnızca bir gruba ve bir parametreye dahil edilebilir. anahtarı tüm parametrelerde 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ığı, yayınlama sırasında parametre gruplarını işlemek için güncellendi.

Firebase konsolunu kullanarak parametre grupları oluşturma veya değiştirme

Parametreleri Parametreler sekmesi Firebase konsolu. Bir grup oluşturmak veya değiştirmek için:

1. Grupları yönet'i seçin.
2. Eklemek istediğiniz parametrelerin onay kutularını işaretleyip seçin Gruba taşı'yı tıklayın.
3. Mevcut bir grubu seçin veya bir ad girip Açıklamayı tıklayıp Yeni grup oluştur'u seçin. Bir grup kaydedildikten sonra, Değişiklikleri yayınla düğmesi.

Programatik olarak grup oluşturma

Remote Config REST API, parametre grupları oluşturmanın ve yayınlamanın otomatik bir yoludur. REST hakkında bilgi sahibi olduğunuzu ve API kullanıyorsanız grupları programatik olarak yönetmek için şu adımları uygulayabilirsiniz:

1. Geçerli şablonu alma
2. Parametre gruplarınızı temsil edecek JSON nesneleri ekleme
3. Parametre gruplarını HTTP PUT isteği kullanarak yayınlayın.

parameterGroups nesnesi, iç içe yerleştirilmiş bir açıklamaya ve Gruplandırılmış parametrelerin listesidir. Her grup anahtarının genel olarak benzersiz olması gerektiğini unutmayın.

Örneğin, "yeni menü" grubunu gruplandırma tek parametre ile pumpkin_spice_season:

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

Koşul kuralı türleri

Firebase konsolunda aşağıdaki kural türleri desteklenir. Eşdeğer işlevi, şurada açıklandığı gibi Remote Config REST API'sinde mevcuttur: koşullu ifade referansı.

Kural türü	Operatörler	Değerler	Not
Uygulama	==	Firebase'inizle ilişkili uygulamalar için Uygulama Kimlikleri listesinden seçim yapın belirler.	Firebase'e bir uygulama eklediğinizde paket kimliği veya Android girersiniz App ID (Uygulama Kimliği) olarak sunulan bir özelliği tanımlayan paket adı Remote Config kuralları. Bu özelliği aşağıdaki şekilde kullanın: Apple platformları için: Uygulamanın CFBundleIdentifier. Paket Tanımlayıcı'yı cihazınızın Genel sekmesinde bulabilirsiniz. Xcode'da uygulamanın birincil hedefidir. Android için: Uygulamanın applicationId. applicationId, uygulama düzeyinizde kullanılabilir. build.gradle dosya
Uygulama sürümü	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 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. şununla tam olarak eşleşir:, içerir, içermez veya normal ifade operatörü kullanıyorsanız birden fazla değer seçebilirsiniz. Normal ifade operatörünü kullanırken normal ifade 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ı.
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 Apple veya Firebase projenizle ilişkilendirilmiş Android uygulaması.	Bu operatör yalnızca Apple ve Android uygulamaları için kullanılabilir. Bu, uygulamanın Apple için CFBundleVersion ve Android için versionCode. Bu kural için dize karşılaştırmaları: büyük/küçük harfe duyarlıdır. şununla tam olarak eşleşir: içerir, şunu içermez: veya normal ifade operatörü kullanıyorsanız birden fazla değer seçebilirsiniz. Normal ifade operatörünü kullanırken normal ifade 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ı.	Bu kural, belirli bir Web uygulaması örneği içintrue işletim sistemi ve sürümü, belirtilen listedeki bir hedef değerle eşleşiyor.
Tarayıcı	==	Hedeflenecek tarayıcıları belirtin. Bu kuralı kullanmadan önce bir Uygulama Kimliği kuralı kullanarak Firebase projenizle ilişkilendirilmiş web uygulaması.	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 cihaz mı yoksa mobil cihaz mı olduğunu değerlendirir. mobil olmayan (masaüstü veya konsol). 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çintrue örneği listelenen bölge 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	Dönüşüm gerçekleştiren Google Analytics kitleleri listesinden bir veya daha fazla belirleneceğini konuşacağız.	Bu kural, Firebase projesi. Not: Birçok Analytics kitlesi etkinliklere veya kullanıcı özelliklerine dayalı olabilir. Bu, uygulamadaki Kitledeki kullanıcı kuralının belirli bir uygulama için geçerli hale gelmesi biraz zaman alabilir. kullanır.
Kullanıcı özelliği	Dize değerleri için: içerir, şunları içermez: şununla tam olarak eşleşir: normal ifade Sayısal değerler için: =, ≠, >, ≥, <, ≤ Not: İstemcide, kullanıcı için yalnızca dize değerleri ayarlayabilirsiniz. özellikler. Sayısal operatörler kullanan koşullar için Remote Config, ilgili öğenin değerini kullanıcı özelliğini bir tam sayı/kayan değer hâline getirir.	Mevcut Google Analytics kullanıcıları listesinden seçim yapın özellikler.	Uygulamanızı aşağıdaki amaçlarla özelleştirmek için kullanıcı özelliklerini nasıl kullanabileceğinizi öğrenmek üzere segmentlerine göz atmak isterseniz Remote Config ve kullanıcı özellikleri. Kullanıcı özellikleri hakkında daha fazla bilgi edinmek için aşağıdaki kılavuzlara bakın: Apple'da kullanıcı özelliklerini ayarlama Android'de kullanıcı özelliklerini ayarlama şununla tam olarak eşleşir: içerir, şunu içermez: veya normal ifade operatörü kullanıyorsanız birden fazla değer seçebilirsiniz. Normal ifade operatörünü kullanırken normal ifade 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ı. Not: Otomatik olarak toplanan kullanıcı özellikleri şu anda 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	Uygulama örneklerinin rastgele bir örneğine değişiklik uygulamak için bu alanı kullanın kaydırma çubuğu widget'ı kullanılarak (%0,0001 kadar küçük örnek boyutlarıyla) özelliğini kullanarak rastgele karıştırılan kullanıcıları (uygulama örnekleri) gruplara ayırabilirsiniz. Her uygulama örneği kalıcı olarak rastgele bir bütünle eşlenir ya da kesirli sayı anlamına gelir. Bir kural, varsayılan anahtarı kullanır ( Firebase konsolu) kullanın. Bir kuralı Başlangıç noktası alanını temizleyerek varsayılan anahtarı kullanın. Aynı uygulama örneklerini belirli bir yüzde dahilinde tutarlı bir şekilde ele almak için aralıklarında, koşullar genelinde aynı başlangıç değerini kullanın. Veya yeni bir tane seçin belirli bir yüzde aralığı için rastgele atanmış uygulama örneği grubu yeni bir başlangıç noktası belirtin. Örneğin, her biri belirli bir anahtar kelime için geçerli olan iki %5'inin bir kısmını örtüşmeyen bir şekilde ayarlayarak %0 ile% 5 arasında bir yüzde değeri girin ve başka bir koşulu bir aralıkla eşleşecek şekilde yapılandırın %5 ile %10 arasında. Bazı kullanıcıların her iki grupta da rastgele görünmesine izin vermek için her koşuldaki kurallar için farklı çekirdek değerler kullanın.
İçe aktarılan segment	içinde	İçe aktarılmış bir veya daha fazla segment seçin.	Bu kural için özel ayarlar yapılması gerekir içe aktarılan segmentlerin sayısı.
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 gerekir: Google Analytics için Firebase SDK'sı Apple platformları SDK v9.0.0+ veya Android SDK v21.1.1+ (Firebase BoM 30.3.0 sürümü ve daha yeni sürümler)
Kurulum 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.	Bu koşul kuralını, projeden bağımsız olarak projedeki tüm kullanıcıları eşleştirmek için kullanın. olduğunu unutmayın.

Parametreleri ve koşulları arama

Projenizin parametre anahtarlarını, parametre değerlerini ve koşullarını arayabilirsiniz Firebase konsolundan Remote Config Parametreleri sekmesinin üst kısmındaki arama kutusunu işaretleyin.

Parametre ve koşullarla ilgili sınırlar

Bir Firebase projesinde en fazla 2.000 parametre ve en fazla 500 parametre conditions. Parametre anahtarları en fazla 256 karakter uzunluğunda olabilir. alt çizgi veya İngiliz alfabesi karakteri (A-Z, a-z) içerebilir ve ayrıca numaraları'na dokunun. Bir projedeki parametre değeri dizelerinin toplam uzunluğu, 1.000.000 karakteri aşmalıdır.

Parametreler ve koşullardaki değişiklikleri görüntüleme

Remote Config şablonlarınızda yapılan en son değişiklikleri görüntüleyebilirsiniz Firebase konsolundan kaldırın. Örneğin, 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şmişse dakika sayısını veya değişikliğin etkin reklamveren hesabında yayınlanmasından bu yana geçen saat Remote Config şablonu.

• Değişiklik bir veya daha fazla gün önce gerçekleşmişse değişiklik etkin Remote Config şablonunda yayınlandı.

Parametre güncellemeleri

Remote Config parametreleri hakkında Son yayınlanan sütunu, her sayfada en son değiştiren kullanıcıyı parametresini ve değişikliğin son yayınlanma tarihini belirtin:

• 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.

Durum güncellemeleri

Remote Config hakkında Koşullar sayfasında koşulu değiştiren son kullanıcıyı ve değiştirildiği tarihi görün bu seçeneği her bir koşulun altındaki Son değiştirilme'nin yanında görebilirsiniz.

Sonraki adımlar

Firebase projenizi yapılandırmaya başlamak için Firebase Remote Config projesi oluşturun.