リモートコンフィグでフローをカスタマイズする

このガイドはフロービルダーのリモートコンフィグについて説明しています。フロービルダーを使わずに作成したクラシックなペイウォールについては、リモートコンフィグでペイウォールをデザインするを参照してください。

リモートコンフィグを使うと、カスタム JSON ペイロードをストアし、SDK がランタイムで読み取れるようになります。新しいアプリリリースなしに、タイトル・画像・フォント・カラー・フィーチャーフラグといった値を設定するために活用できます。

リモートコンフィグの操作

フローのリモートコンフィグを開くには、フローエディターのスクリーンプレビュー上部にあるアイコンをクリックします。

Open remote config in the Flow Builder editor

JSON ビューでは、JSON 形式のデータを自由に入力できます。エディターには、追加したロケールごとに 1 列ずつ表示されます。

リモートコンフィグに無効な JSON が含まれている場合、フローを保存することも公開することもできません。プレビューや公開をブロックする問題の完全なリストについては、フローの保存と公開を参照してください。

このデータには、後から SDK を通じて AdaptyFlow の remoteConfigs 配列としてアクセスできます。Adapty はロケールごとに 1 件の AdaptyRemoteConfig エントリを保存します。ユーザーのロケールに一致するエントリを選択し、パース済みの dictionary または生の jsonString を読み取ることで、実行時にフローを調整できます。リモートコンフィグの使用例をいくつか紹介します。

{
    "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。

ロケールを追加する

フローをローカライズするには、エディター上部の Add locale をクリックしてロケールを選択します。

Adapty はそのロケール用の新しい列をエディターに追加します。各列は独立して編集できます。実行時には、SDK がユーザーの選択に一致する locale を持つ AdaptyRemoteConfig エントリを返します。

JSON のインポートとエクスポート

エディター上部の Import/Export メニューを使うと、すべてのロケールのリモートコンフィグをまとめてバックアップ・共有・一括編集できます。

Export JSON: すべてのロケールを含む JSON ファイルをダウンロードします。
Import JSON: 同じ形式の JSON ファイルをアップロードします。アップロードしたファイルで現在のリモートコンフィグが置き換えられます。

ファイルはロケールコードをトップレベルのキーとし、各ロケールのペイロードを値として使用します：

{
  "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 構造に従っています。