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 Remote Config için istemci SDK'ları (Android, Apple, Web, Unity dahil), Flutter ve C++ uygulamaları. Şuradan Remote Config parametre ve değer: Remote Config uygulamaları için sunucuya özel şablonlar 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'si, 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, Firebase Admin SDK ve REST API hakkında daha fazla bilgi verilmiştir. Bu konular Remote Config şablon sürümünü 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 Sunucuda 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 birinin getirme yüzdesini Firebase konsolu üzerinden 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 Aşağıdaki kurallar, Remote Config öğesinden getirilecek değeri 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
İlk olarak, 2007'den itibaren geçerli olmak üzere belirli bir uygulama örneği için
true
olarak değişecektir. Birden fazla koşultrue
olarak değerlendirilirse Firebase konsolunun kullanıcı arayüzünde gösterilen ilk (en üstte) ö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.true
olarak değerlendirilen koşullara sahip koşullu değer yoksa Bir uygulamaRemote Config 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
- Bir değer arka uçtan getirilip etkinleştirildiyse uygulama getirildiği tarihtir. Etkinleştirilen parametre değerleri kalıcıdır.
Arka uçtan herhangi bir değer getirilmediyse veya Remote Config arka ucu etkinleştirilmedi. Uygulama, uygulama içi varsayılan değere sahiptir.
Varsayılan değerleri alma ve ayarlama hakkında daha fazla bilgi için Remote Config varsayılan şablonu indirin.
Uygulama içi varsayılan değer ayarlanmadıysa uygulama statik bir tür kullanır değeri (ör.
int
için0
veboolean
içinfalse
).
Bu grafikte, Remote Config arka ucunda ve uygulamanızda:
Parametre değeri veri türleri
Remote Config, her parametre için veri türü seçmenize olanak tanır.
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ğinde bulunabilirsiniz.
Şu anda desteklenen türler şunlardır:
String
Boolean
Number
JSON
Firebase konsolunun 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 birlikte 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 şunları oluşturabilirsiniz: üç 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 konsolunda gösterilir. Bir grup oluşturmak veya değiştirmek için:
- Grupları yönet'i seçin.
- Eklemek istediğiniz parametrelerin onay kutularını işaretleyip seçin Gruba taşı'yı tıklayın.
- 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:
- Geçerli şablonu alma
- Parametre gruplarınızı temsil edecek JSON nesneleri ekleme
- 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 Bu işlev, Remote Config REST API'de aşağıdaki sayfada açıklandığı şekilde 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 kural.
Bu özelliği aşağıdaki şekilde kullanın:
|
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 Uygulama Kimliği kuralı kullanarak 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çin true
ö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 | Google Analytics kitle listesinden bir veya daha fazla kitle seçin 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, karşılık gelen 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: ş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 çekirdeke göre tanımlanmış kesirli sayı. Bir kural varsayılan anahtarı kullanır (Başlangıç noktası için Firebase konsolu). 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:
|
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 Parametreler sekmesinin üst kısmındaki arama kutusunu tıklayın.
Parametre ve koşullarla ilgili sınırlar
Bir Firebase projesinde en fazla 2.000 parametre ve en fazla 500 parametre koşullar. Parametre anahtarları en fazla 256 karakter uzunluğunda olabilir. alt çizgi veya İngiliz alfabesi karakteri (A-Z, a-z) içerebilir ve 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 son değişiklikleri görüntüleyebilirsiniz Firebase konsolundan yapabilirsiniz. Ö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 Parametresinde Son yayınlanan sütununda, her birini değiştiren son kullanıcı gösterilir 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 üzerinde 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.