Настройка флоу с помощью Remote Config

Important

Этот гайд посвящён Remote Config для Flow & Paywall Builder. Для классических пейволов, созданных без него, см. Дизайн пейвола с Remote Config.

Remote Config позволяет хранить произвольный JSON, который SDK читает во время выполнения. Используйте его, чтобы менять заголовки, изображения, шрифты, цвета или флаги фич без выпуска новой версии приложения.

Работа с Remote Config

Чтобы открыть Remote Config для флоу, нажмите иконку над предпросмотром экрана в редакторе.

Open remote config in the Flow & Paywall Builder editor

В режиме JSON можно ввести любые данные в формате JSON. Редактор показывает по одной колонке на каждую добавленную локаль:

Warning

Если Remote Config содержит невалидный JSON, вы не сможете ни сохранить, ни опубликовать флоу. Смотрите раздел Частые проблемы с полным списком проблем, блокирующих предпросмотр и публикацию.

Позднее вы можете получить эти данные из SDK через массив remoteConfigs объекта AdaptyFlow. Adapty хранит по одной записи AdaptyRemoteConfig на каждую локаль — выберите ту, которая соответствует локали пользователя, и читайте либо разобранный dictionary, либо сырой jsonString, чтобы настраивать флоу во время выполнения. Ниже приведены примеры использования Remote Config.

{
    "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": "Попробуй бесплатно!"
    }
}

Вы можете комбинировать любые из этих паттернов или задавать собственные ключи для тестирования альтернативных текстов, макетов или поведения.

Далее создайте плейсмент и добавьте в него флоу. Затем отрендерите флоу в своём приложении: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform или Capacitor.

Добавление локали

Чтобы локализовать флоу, нажмите Add locale над редактором и выберите локали.

Adapty добавит в редактор новый столбец для этой локали. Редактируйте каждый столбец независимо — во время выполнения SDK возвращает запись AdaptyRemoteConfig, у которой locale совпадает с выбором пользователя.

Add locale dialog with Code and Name fields

Импорт и экспорт JSON

Используйте меню Import/Export над редактором, чтобы создать резервную копию, поделиться или массово отредактировать Remote Config сразу для всех локалей.

Export JSON: скачивает один JSON-файл со всеми локалями.
Import JSON: загружает JSON-файл в том же формате. Загруженный файл заменяет текущий Remote Config.

В файле локали используются как ключи верхнего уровня, а содержимое каждой локали — как значение:

{
  "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"]
  }
}

Каждый блок локали следует той же структуре JSON, которую вы вводите непосредственно в столбец локали.