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

カスタムエレメントを使ったペイウォールフローで、各ユーザーの予測体重をチャートとして表示するには、次の手順に従います。ユーザーはオンボーディングフローで現在の体重と目標体重を入力します。アプリは両方の値を収集します。チャートは、アプリを使って一方の値からもう一方の値へと毎週どれだけ進捗するかを示します。アプリはチャートをネイティブビューとしてカスタムエレメントでレンダリングします。このビューはチャートライブラリを使わずにチャートを描画します。

始める前に

2つの別々のフローを作成します。1つはオンボーディング用、もう1つはペイウォール用です。それぞれをプレースメントに追加してください。このレシピのコードは、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(ペイウォールフローをカスタム要素に合わせて開く関数)に渡してください。

最後の画面でユーザーが Close flow アクション付きのボタンをタップすると、リスナーはオンボーディングフローの代わりにペイウォールフローを開きます。

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

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

このプランでは、体重が1週間に0.5 kgずつ変化することを前提としています。別の変化率を使用するには、weeklyChange を編集してください。

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

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

ペイウォールフローのビューを作成する際に、リゾルバーをアタッチします。現在の体重と目標体重からウェイトプランを使って、リゾルバーを作成します。

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

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

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

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

フォールバックをテストするには、WeightChartResolver が null を返すようにして、ペイウォールフローを再度開いてください。

フォールバックが表示される理由を調べるには、Androidガイドのデバイスでテストするセクションの手順に従ってください。