ペイウォールでインタラクティブな体重目標チャートを表示する

レシピに従って、ペイウォールフローでユーザーの予測体重をチャートとして表示しましょう。ユーザーはオンボーディングフローで現在の体重と目標体重を入力します。アプリは両方の値を収集します。チャートには、アプリを使って一方の値からもう一方の値へと期待できる毎週の進捗が表示されます。アプリはチャートをネイティブの Swift Charts ビューとしてカスタム要素にレンダリングします。

Tip

このレシピはiOSアプリのみに対応しています。他のフレームワークで作成されたアプリは、カスタム要素のフォールバックコンテンツのみを表示します。Androidおよびクロスプラットフォームフレームワークへのサポートは近日公開予定です。

始める前に

  • アプリを Adapty iOS SDK 4.4 以降にアップデートしてください。それより古いバージョンの SDK では、すべてのカスタム要素にフォールバックコンテンツが表示されます。
  • アプリでフローを取得・表示できるよう設定してください。
  • オンボーディング用とペイウォール用に、それぞれ別のフローを作成してください。それぞれをプレースメントに追加します。このレシピのコードは、ID が weight_paywall のプレースメントからペイウォールフローを取得します。

1. オンボーディングフローで現在の体重と目標体重を入力してもらう

フロー&ペイウォールビルダーで、オンボーディングフローに2つのNumber 入力を追加します:

  • 現在の体重(キログラム)を入力するもの(Element ID は weight)
  • 目標体重(キログラム)を入力するもの(Element ID は goal_weight)

すべてのロケールでウェイトを同じように読み取るには、両方の入力フィールドの Format ドロップダウンから Integer を選択してください。入力フィールドは、ユーザーが入力したテキストをそのままアプリに送信します。このレシピのコードでは、“70.5” と “70,5” は異なる値として読み取られます。整数には小数点区切り文字がないため、この問題は発生しません。

アプリが両方の値を確実に受け取れるようにするには、入力フィールドのないスクリーンでオンボーディングフローを終了してください。そのスクリーンに、Close flow アクションを設定したボタンを追加します。入力フィールドは、フォーカスが外れたとき、またはユーザーが別のスクリーンに移動したときに値を送信します。

2. ペイウォール画面にカスタム要素を追加する

ペイウォールフローで、画面にカスタム要素を追加し、チャート用に次のように設定します。

  • Type: line_chart
  • ID: weight_goal
  • Height: デフォルトの Fixed 高さのままにします。チャートはカスタム要素全体を埋めます。

カスタム要素は、カルーセルなどのタッチに反応するコンテナの中に配置しないでください。そうしないと、チャート上でドラッグするとカルーセルも動いてしまいます。

カスタム要素の中に、体重チャートのサンプル画像として Image を追加します。アプリのバージョンがチャートを表示できない場合、ユーザーはこれをフォールバックとして見ることになります。

3. アプリに現在の体重と目標体重を保存する

オンボーディングフローの flow_user_input イベントから現在の体重と目標体重を収集します。方法はフローからデータを処理するを参照してください。ユーザーが最後の画面に到達したことを検知するには、is_last_screen が true に設定された flow_screen_showed イベントを監視します。その画面の後にオンボーディングフローが閉じたら、両方の体重を showWeightPaywall(チャートをカスタム要素に対応させるペイウォールフローを開くメソッド)に渡します。

以下のコードはUIKit用です。1つのビューコントローラーが両方のフローのデリゲートとなります。また、AdaptyFlowControllerDelegate プロトコルの購入・リストアメソッドも実装する必要があります。この例ではそれらを省略しています。詳細は UIKitでフローとペイウォールを表示する を参照してください。

SwiftUI では、デリゲートメソッドの代わりに .flow モディファイアの didReceiveAnalyticEvent クロージャと didDisappear クロージャを使用します。ペイウォールフローを表示するには、2つ目の .flow モディファイアを使用します。

4. チャートビューを作成する

体重プランのモデルと、チャートを含む SwiftUI ビューを作成します。プランには現在の体重から目標体重まで、1 週間ごとのエントリが含まれます。ユーザーがチャート上をドラッグすると、タッチポイントの週がマークされ、その週の予測体重が表示されます。

このプランでは、体重が1週間あたり0.5 kgずつ変化すると仮定しています。別のペースを使用するには、weeklyChange を編集してください。

チャート上でのドラッグ操作にはiOS 17以降が必要です。iOS 16では、ユーザーはラインを見ることはできますが、ドラッグはできません。

5. カスタム要素にチャートを対応付ける

line_chart タイプおよび weight_goal IDに対してチャートビューを返すリゾルバーを記述します。ウェイトプランはリゾルバーのプロパティに保存してください。

リゾルバーをペイウォールフローにアタッチするには、その設定を取得する際に行います。現在の体重と目標体重を使って、リゾルバーをウェイトプランとともに作成します。

アプリにアプリ全体のリゾルバーが設定されている場合、このリゾルバーはペイウォールフロー内でそれを置き換えます。WeightChartResolver は他の Type と ID に対して nil を返します。このレシピのペイウォールフローには他のカスタム要素がないためです。ペイウォールフローに他のカスタム要素がある場合は、アプリ全体のリゾルバーをこのリゾルバーに渡してください。そして、1つのフローにリゾルバーをアタッチするの説明に従い、それらの Type と ID に対してアプリ全体のリゾルバーを呼び出してください。

6. デバイスでテストする

Flow & ペイウォールビルダーはアプリのコードを実行できないため、キャンバスにはフォールバックのみが表示されます。チャートをプレビューするには:

  1. 両方のフローを公開する。キャッシュではなく最新の公開バージョンを確認するには、デバイスをテストデバイスとして登録してください。
  2. リゾルバーを含むアプリのビルドを iOS 17 以降で実行します。現在の体重と目標体重を入力してオンボーディングフローを完了します。チャートの線が現在の体重から始まり、目標体重で終わることを確認してください。
  3. チャート上をドラッグして、指の下の週の予測体重が線の上に表示されることを確認してください。

フォールバックをテストするには、getFlowConfiguration の呼び出しから customElementsResolver 引数を削除し、ペイウォールフローを再度開いてください。

フォールバックがチャートの代わりに表示される原因を調べるには、iOSガイドのデバイスでテストするセクションの手順に従ってください。