Remote Config Parametreleri ve Koşulları

Hem istemci hem de sunucu kullanım alanları için şablonlar yapılandırabilirsiniz. İstemci şablonları; Android, Apple, Web, Unity, Flutter ve C++ uygulamaları dahil olmak üzere Remote Config için Firebase istemci SDK'larını uygulayan tüm uygulama örneklerine sunulur. Ş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 Konsolu, Admin SDK veya Remote Config REST API'yi kullanarak parametreleriniz için yeni varsayılan değerler ve uygulama örneği gruplarını hedeflemek için kullanılan koşullu değerler oluşturabilirsiniz. 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şlemleri Firebase konsolunda, 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 tanımlanmamışsa (örneğin, hiçbir değer mevcut değilse) bu kural false olarak değerlendirilir.

Örneğin, başlangıç sayfasında, if device_os = Android. kural:

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. Firebase konsolunun Parametreler sekmesinde, her parametrenin koşullu değerleri için getirme yüzdesini görüntüleyebilirsiniz. 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

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

2. true olarak değerlendirilen koşullara sahip koşullu değer yoksa bir uygulama arka uçtan değer getirdiğinde Remote Config'un varsayılan değeri sağlanır. Arka uçta parametre yoksa veya varsayılan değer Uygulama içi varsayılan kullan değerine ayarlanırsa başka bir değer Değer, bir uygulama tarafından getirildiğinde bu parametre için sağlanır.

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

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 ucunda ve uygulamanızda:

Parametre değeri veri türleri

Remote Config, her parametre için veri türü seçmenize olanak sağlar. 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 isteğinde döndürülür.

Desteklenen veri türleri şunlardır:

• String
• Boolean
• Number
• JSON

Firebase konsolunun kullanıcı arayüzünde, veri türü açılır menüsünü tıklayın. REST API'de türler, parametre nesnesinde value_type alanı kullanılarak ayarlanabilir.

Parametre grupları

Remote Config, daha düzenli bir çalışma için parametreleri birlikte gruplandırmanıza olanak tanır. Kullanıcı arayüzünü ve kullanılabilirliği artırın.

Ö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 seçin ve ardından bunları tek tek "Yeni giriş bilgileri" adlı grup, hiçbir önek veya özel sıralama gerekmez.

Firebase konsolunu veya Remote Config REST API'yi kullanarak parametre grupları oluşturabilirsiniz. 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. Grup oluşturmak veya mevcut bir grubu 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 etmek için JSON nesneleri ekleme
3. Parametre gruplarını HTTP PUT isteği kullanarak yayınlayın.

parameterGroups nesnesi, gruplandırılmış parametrelerin listesini ve iç içe yerleştirilmiş bir açıklamayı içeren grup anahtarları içerir. 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 pumpkin spice season."
        }
      }
    }
  }
}

Koşul kuralı türleri

Firebase konsolunda aşağıdaki kural türleri desteklenir. Eşdeğer özellikleri Remote Config REST API'de aşağıdaki sayfada açıklandığı şekilde mevcuttur: koşullu ifade referansı.

Arama parametreleri ve koşulları

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 ayrıca numaraları'na dokunun. Bir projedeki parametre değeri dizelerinin toplam uzunluğu 1.000.000 karakteri aşamaz.

Parametrelerde ve koşullarda yapılan 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ınlanma tarihi sütun etiketini tıklayın.

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.