Flow'u remote config ile özelleştirin

Bu kılavuz, Flow Builder için remote config’i kapsar. Flow Builder olmadan oluşturulan klasik paywall’lar için bkz. Paywall’u remote config ile tasarlama.

Remote Config, SDK’nın çalışma zamanında okuduğu özel bir JSON yükü saklamanıza olanak tanır. Bunu kullanarak yeni bir uygulama sürümü yayınlamadan başlıklar, görseller, fontlar, renkler veya özellik bayrakları gibi değerleri ayarlayabilirsiniz.

Remote config ile çalışma

Bir flow için remote config’i açmak istiyorsanız, flow editöründeki ekran önizlemesinin üzerindeki simgesine tıklayın.

Flow Builder editöründe remote config'i açma

JSON görünümünde istediğiniz JSON formatındaki verileri girebilirsiniz. Editör, eklediğiniz her yerel ayar için ayrı bir sütun gösterir:

Remote config geçersiz bir JSON içeriyorsa, flow’u ne kaydedebilir ne de yayınlayabilirsiniz. Önizleme ve yayınlamayı engelleyen sorunların tam listesi için bkz. Flow’ları kaydet ve yayınla.

Bu verilere daha sonra SDK üzerinden AdaptyFlow nesnesindeki remoteConfigs dizisi aracılığıyla erişebilirsiniz. Adapty, her locale için bir AdaptyRemoteConfig girişi saklar; kullanıcınızın locale’iyle eşleşen girişi seçip çözümlenmiş dictionary’i veya ham jsonString’i okuyarak flow’unuzu çalışma zamanında özelleştirebilirsiniz. Remote config kullanımına ilişkin bazı örnekler aşağıda verilmiştir.

{
    "screen_title": "Today only: Subscribe, and get 7 days for free!"
}

# Test titles or other texts

{
    "background_image": "https://adapty.io/media/paywalls/bg1.webp"
}

# Test images on your flow

{
    "font_family": "San Francisco",
    "font_size": 16
}

# Test fonts

{
    "subscribe_button_color": "purple"
}

# Test colors of buttons, texts etc.

{
    "photo_gallery": "https://adapty.io/media/paywalls/link-to-html-snippet.html"
}

# Any HTML code that can be displayed in the flow

{
    "hard_paywall": true
}

# By setting it to true, you disallow skipping the paywall without subscribing
# You have to handle this logic in your app

{
    "title": {
        "en": "Try for free!",
        "es": "¡Prueba gratis!",
        "ru": "Попробуй бесплатно!"
    }
}

Bu kalıpların herhangi birini birleştirebilir ya da alternatif metinleri, düzenleri veya davranışları test etmek için kendi anahtarlarınızı tanımlayabilirsiniz.

Ardından bir placement oluşturun ve flow’u buna ekleyin. Sonra flow’u iOS uygulamanızda gösterin.

Yerel ayar ekleme

Flow’unuzu yerelleştirmek için editörün üzerindeki Add locale seçeneğine tıklayın ve yerel ayarları seçin.

Adapty, o yerel ayar için editöre yeni bir sütun ekler. Her sütunu bağımsız olarak düzenleyin — çalışma zamanında SDK, locale’i kullanıcının seçimiyle eşleşen AdaptyRemoteConfig girişini döndürür.

Add locale dialog with Code and Name fields

JSON İçe ve Dışa Aktarma

Tüm locale’lerdeki remote config’inizi yedeklemek, paylaşmak veya toplu düzenlemek için editörün üzerindeki Import/Export menüsünü kullanın.

Export JSON: Her locale’i içeren tek bir JSON dosyası indirir.
Import JSON: Aynı formatta bir JSON dosyası yükler. Yüklenen dosya mevcut remote config’in yerini alır.

Dosya, üst düzey anahtar olarak locale kodlarını, değer olarak ise her locale’in içeriğini kullanır:

{
  "en": {
    "title": "Get Premium",
    "cta": "Continue",
    "trial_days": 7,
    "features": ["sync", "export", "ai"]
  },
  "fr": {
    "title": "Passez à Premium",
    "cta": "Continuer",
    "trial_days": 7,
    "features": ["synchronisation", "exportation", "IA"]
  }
}

Her yerel ayar bloğu, doğrudan bir yerel ayar sütununa gireceğiniz JSON yapısının aynısını izler.