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

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

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

Работа с Remote Config

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

Open remote config in the Flow Builder editor

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

Если 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-приложении.

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

Чтобы локализовать флоу, нажмите 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, которую вы вводите непосредственно в столбец локали.