Flow'u remote config ile özelleştirme

Important

Bu kılavuz, Flow & Paywall Builder için remote config’i kapsar. Builder kullanılmadan oluşturulan klasik paywall’lar için Paywall’u remote config ile tasarlama bölümüne bakın.

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 üzere, builder’daki ekran önizlemesinin üzerindeki simgesine tıklayın.

Flow & Paywall Builder düzenleyicisinde remote config'i açma

JSON görünümünde herhangi bir JSON formatında veri girebilirsiniz. Düzenleyici, eklediğiniz her yerel ayar için bir sütun gösterir:

Warning

Remote config geçersiz JSON içeriyorsa, flow’u ne kaydedebilir ne de yayınlayabilirsiniz. Önizlemeyi ve yayınlamayı engelleyen sorunların tam listesi için Sık karşılaşılan sorunlar bölümüne bakın.

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çin ve flow’unuzu çalışma zamanında özelleştirmek için ayrıştırılmış dictionary veya ham jsonString değerini okuyun. Remote config’i nasıl kullanabileceğinize dair 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 uygulamanızda gösterin: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform veya Capacitor.

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.