---
title: "ナンバーピッカー"
description: "フロー画面に数字のホイールを追加して、ユーザーが年齢・体重・身長を選択できるようにします。選択した数値はアプリが受け取ります。"
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

フローおよびペイウォールビルダーで**Number picker**を追加すると、ユーザーに年齢・体重・身長などの範囲内の数値を選択させることができます。ホイールの最小値と最大値を設定し、ユーザーはその範囲内の数値を選びます。ホイールを回さなかった場合は、デフォルトの数値がユーザーの回答になります。任意の数値を入力できるようにしたい場合や、質問をスキップできるようにしたい場合は、[Number input](builder-inputs-and-forms)を使用してください。

ユーザーが選択した数値を使って、次のことができます：

- [アプリコードで数値を読み取る](#read-the-number-in-your-app-code)（バックエンドに保存するなど）。
- 「体重は70kgです」のように、文中に数値を表示する。
- 数値に応じて異なる画面にユーザーを誘導する。

:::tip
生年月日などの日付には、[日付入力](builder-inputs-and-forms)を使用してください。3つのNumber pickerで日付を組み立てないでください。ユーザーが2月31日を選べてしまい、アプリコードは3つの別々の数値を受け取ることになります。生まれた年だけを尋ねる場合は、1940〜2010のようなNumber pickerを1つ追加してください。
:::

## 数値ピッカーを追加する \{#add-a-number-picker\}

1. **Add element** パネルを開きます。
2. **Forms & Quiz** カテゴリで、**Input** > **Number picker** をクリックします。

3. キャンバス上で、**Weight** テキストを質問に置き換えます。
4. ホイールを選択します。
5. **Element ID** フィールドで、生成されたIDを `weight` などの回答の名前に置き換えます。条件やテキスト要素では、その数値が変数 `weight.value` となり、アプリのコードでは `weight` というIDで受け取ります。IDはピッカーを追加するときに設定してください。後から変更はしないようにしましょう。IDを変更した場合、ビルダーは条件やテキスト要素を更新しますが、アプリのコードは古いIDを参照し続けます。
6. **Min**、**Max**、**Step** フィールドで範囲を設定します（たとえば体重をキログラムで入力する場合は40〜150）。整数の場合は **Min** と **Step** に整数を使用してください。小数を含む数値の場合は、**Step** に0.5などを使用してください。

   ビルダーは各数値を0.25の倍数に丸めます。そのため、身長にはメートルではなくセンチメートルを使用してください。範囲が1000行を超える場合、ビルダーは **Max** の値を下げます。
7. **Default** フィールドに、70などの一般的な回答を設定します。ユーザーがホイールを回さない場合、デフォルトの数値が回答になります。
8. **Unit** フィールドに、各数値の後に表示する単位（例：`kg`）を設定します。単位が不要な場合は、フィールドを空にしてください。
9. ユーザーが数値を確定するときにタップするボタン（例：**Continue**）を選択し、その数値をアプリのコードに送信します。ボタンの[アクション](onboarding-actions)を **Navigate to Screen**、**Navigate Next**、または **Navigate back** に設定してください。条件付きアクションの中でアクションを実行することも可能です。フローを閉じる、購入を開始する、またはカスタムアクションを実行するボタンは、数値を送信しません。

## 重量をメートル法またはヤード・ポンド法の単位で尋ねる \{#offer-metric-and-imperial-units\}

体重をキログラムまたはポンドで尋ねるには:

1. **kg** と **lb** のオプションを持つ[単一選択クイズ](onboarding-quizzes#change-quiz-type)を追加します。
2. クイズ画面の後に、キログラム用の画面とポンド用の画面を追加します。各画面に、[Number pickerを追加する](#add-a-number-picker)の手順に従って、Element ID が `weight_kg` または `weight_lb` の Number picker を追加します。
3. クイズ画面で、ユーザーが単位を確定するためにタップするボタン（**Continue** など）に[条件付きアクション](onboarding-quizzes#set-up-conditional-navigation)を追加します。ユーザーが **kg** を選択した場合はキログラム用の画面に遷移し、それ以外の場合はポンド用の画面に遷移するように設定します。
4. キログラムとポンドの各画面で、ナビゲーションアクションを **Navigate to Screen** に設定し、両方で同じ次の画面を選択します。

両方のピッカーが同じ画面にある場合、一方を非表示にしていても、アプリコードは両方の数値を受け取ります。別々の画面にする場合も、ユーザーが戻って単位を切り替えると、両方の数値が送信されます。アプリコードでは、ユーザーが最後に **kg** を選択した場合は `weight_kg` を、それ以外の場合は `weight_lb` を読み取ります。

後続の画面では、スキップされたピッカーの変数はデフォルト値と等しくなります。体重を表示したり体重で分岐したりするには、クイズの回答を評価する条件を追加してください。

Number pickerには1つの単位があります。単位を別の言語に[翻訳](add-paywall-locale-in-adapty-paywall-builder#text-content)しても、各数字の後のラベルが変わるだけです。アプリのコードはどの言語でも同じ数値を受け取ります。

フィートとインチで身長を表示するには、インチ単位で1つのNumber pickerを追加します（例：48〜96）。

## テキスト要素に数値を表示する \{#show-the-number-in-a-text-element\}

「あなたの体重は70kgです」のように文中に数値を表示するには、テキスト要素に変数 `<Element ID>.value` を[挿入](onboarding-variables#use-variables-in-text)してください。この変数には単位が含まれないため、変数の後に単位を直接入力してください。デバイス上でホイールが数値で止まると、同じ画面内のテキスト要素がリアルタイムで更新されます。

BMIや他の数値に基づく計算結果を表示するには、アプリのコード内で計算を行い、その結果を後続のフローで[カスタムタグ](flow-custom-tags)に渡してください。フロー内で値を計算することはできません。

## 数値によってフローを分岐させる \{#branch-the-flow-by-the-number\}

数値に応じてユーザーを別のスクリーンに誘導するには、ユーザーが数値を確定する際にタップするボタン（**Continue** など）に[条件付きアクション](onboarding-actions#conditional-actions)を追加します。たとえば、エレメント ID が `age` のピッカーで、`age.value` `<` `18` の場合は別のスクリーンに遷移し、それ以外の場合は次のスクリーンに遷移するといった設定が可能です。

番号によってテキストを変更したり要素を表示したりするには、番号を評価する[条件付きテキスト](onboarding-text#add-conditional-text)または[条件付き表示](onboarding-element-visibility)を追加します。たとえば、`age.value` `<` `18` の場合にヒントを表示するといった使い方ができます。デバイス上では、ホイールが数字の上で止まるとピッカーの画面が更新されます。

## デバイスでホイールをプレビューする \{#preview-the-wheel-on-a-device\}

ホイールを回転させて画面の更新を確認するには、[デバイスでフローをテストする](paywall-device-compatibility-preview#preview-on-devices)を参照してください。iOS では、ホイールはシステム標準のウィールです。Android では、Adapty SDK が独自のホイールを描画します。両プラットフォームとも、各行のフォントと色は **Typography** セクションの設定が適用されます。**Size** セクションでは、ホイールの幅のみ設定できます。高さは各プラットフォームが決定します。

キャンバス上ではホイールを回転させることはできないため、テキスト要素にはデフォルトの数値が表示され、条件はその値で評価されます。

## アプリコードで数値を読み取る \{#read-the-number-in-your-app-code\}

アプリコードは、<InlineTooltip tooltip="Adapty SDK">[iOS](ios-flow-input)、[Android](android-flow-input)、[React Native](react-native-flow-input)、[Flutter](flutter-flow-input)、[Unity](unity-flow-input)、[Kotlin Multiplatform](kmp-flow-input)、[Capacitor](capacitor-flow-input)</InlineTooltip> を通じて、以下のパラメータを含む `flow_user_input` イベントで数値を受け取ります：

- `element_type`: `wheel_range_picker`。
- `element_id`: `weight` などの要素ID。
- `value`: 数値。**Min** または **Step** に小数がある場合、`70.5` のように小数を含むことがあります。

アプリのコードでは、Number inputからの `value` は文字列として、Number pickerからの `value` は数値型として受け取ります。Number inputをNumber pickerに置き換えた場合は、`value` を読み取るアプリのコードも更新してください。

ユーザーがボタンをタップして別の画面を開くと、アプリコードはそのイベントを受け取ります。その前に、同じ画面でクイズの選択肢をタップしたり、トグルを切り替えたりしてもイベントが送信されます。ユーザーが選んだ数値を読み取るには、各 Element ID ごとに最新のイベントのみを保持してください。ユーザーがホイールを回転させなかった場合、`value` はデフォルトの数値になります。非表示のピッカーでもアプリコードにイベントが送信されます。

フローはその数値を Adapty に送信しません。その数値を使って後でユーザーに異なるフローやペイウォールを表示するには：

1. アプリコードから数値をカスタムユーザー属性として Adapty に送信します（<InlineTooltip tooltip="カスタムユーザー属性">[iOS](setting-user-attributes#custom-user-attributes)、[Android](android-setting-user-attributes#custom-user-attributes)、[React Native](react-native-setting-user-attributes#custom-user-attributes)、[Flutter](flutter-setting-user-attributes#custom-user-attributes)、[Unity](unity-setting-user-attributes#custom-user-attributes)、[Kotlin Multiplatform](kmp-setting-user-attributes#custom-user-attributes)、[Capacitor](capacitor-setting-user-attributes#custom-user-attributes)</InlineTooltip>）。テキストではなく、数値そのものを渡してください。
2. Adapty ダッシュボードで、[**Number** カスタム属性を作成します](segments#custom-attributes)。**Key** フィールドには、アプリコードで使用したキーを入力してください。
3. その属性を使って[セグメント](segments)を作成し、[オーディエンス](audience)に追加します。