パッケージ

パッケージは、メンバーがキャンペーンから購入した際に受け取る具体的な特典を定義します。各パッケージはメンバーが支払う金額、見返りに受け取る内容（分数、ウォレットクレジット、またはその両方）、特典が適用されるデバイス、特典の有効期間を指定します。

パッケージタイプ

すべてのパッケージには特典の性質を決定する2つのタイプフィールドがあります。

パッケージタイプ

パッケージタイプは主要な特典を定義します。

• 分数: メンバーはプリペイド分数のブロックを受け取ります。基本量は含まれる分数を表します。購入時にこの分数のタイムクレジットが作成されます。
• 金額: メンバーはウォレットクレジットを受け取ります。基本量は最小通貨単位での金額を表します。購入時にこの残高のウォレットクレジットが作成されます。

ボーナスタイプ

ボーナスタイプは基本に加えて付与される任意の二次的特典を定義します。

• 分数: メンバーはボーナス分数を受け取ります。ボーナス量は付与される追加分数を指定します。「ボーナス」クレジットタイプの別のタイムクレジットが作成されます。
• 金額: メンバーはボーナスウォレットクレジットを受け取ります。ボーナス量は最小単位でのボーナス金額を指定します。「ボーナス」クレジットタイプの別のウォレットクレジットが作成されます。
• なし: このパッケージにはボーナスが含まれません。メンバーは基本特典のみを受け取ります。

組み合わせの例

購入価格と特典

購入価格はメンバーがレジで支払う金額（最小通貨単位）です。これは基本量とは独立しています。2つの値は一致する必要はありません。

たとえば:

• パッケージの購入価格が2000最小単位で、3000最小単位のウォレットクレジット（基本量）を付与する場合があります。メンバーは実質的に50%のボーナスが基本価格に組み込まれています。
• 分数パッケージの購入価格が1500最小単位で120分を付与する場合があります。「分単位コスト」は暗黙的であり、標準時間単価と一致する必要はありません。

この分離により、カフェオーナーは特典が支払い額を超えるお得なパッケージを作成でき、都度払いの料金設定よりも魅力的なパッケージを提供できます。

デバイス範囲

デバイス範囲は特典が使用できるデバイスタイプを制御します。

デバイス範囲はこのパッケージから作成されるすべてのウォレットクレジットとタイムクレジットに継承されます。メンバーはメンバーパネルの購入履歴でこの範囲を確認できます。

有効期間

有効日数

valid_daysフィールドは購入後に特典が使用可能な日数を設定します。メンバーがパッケージを購入すると、システムは購入日 + valid_daysとして有効期限を計算します。有効期限後、関連するロットの残高（分数またはウォレットクレジット）は使用できなくなります。

valid_daysが設定されていない場合、特典は期限切れになりません。

有効曜日

有効曜日設定は、特典を消費できる曜日を制限する任意の曜日選択です。「平日のみ」や「週末のみ」のバンドルなどのパッケージが可能です。曜日セレクターは月曜日から日曜日までです。すべての曜日を選択したままにすると制限なしを意味します。少なくとも1つの曜日は選択されている必要があります。

ウォレットカテゴリとクロスカテゴリ利用

パッケージは作成されるウォレットクレジットにウォレットカテゴリを割り当てることができます。これにより資金にカテゴリラベル（例: 「ゲーミング」「一般」「飲食」）がタグ付けされ、残高の使用先が制限されます。

パッケージのクロスカテゴリ利用を許可オプションは、作成されるクレジットがカテゴリ外での利用を許可するかどうかを制御します。

• オフ（デフォルト）: 資金は指定されたカテゴリに制限されます。
• オン: このパッケージのボーナス残高は、自身のカテゴリだけでなく任意のウォレットカテゴリで利用できます。

メンバー割引の累積

メンバー割引と併用オプションは、パッケージの分数やウォレットクレジットが消費される際に、メンバーのティア割引がこのパッケージの料金に追加適用されるかどうかを制御します。

• オフ（デフォルト）: メンバーのティア割引は累積されません。パッケージは固定値の特典として扱われます。
• オン: メンバーのティア割引がパッケージ条件に加えて適用されます。上位ティアのメンバーはプリペイドパッケージ使用時にも追加の割引を受けられます。

パッケージの購入と付与の仕組み

パッケージが購入されると:

1. 支払いの回収: 購入価格がメンバーに請求されます（現金、カード、またはウォレットからの引き落とし）。
2. 購入レコード: メンバー、パッケージ、支払い金額、タイムスタンプを記録する購入エントリが作成されます。
3. クレジットの作成: パッケージの設定に基づいて:
   • パッケージタイプが金額の場合: 基本量と「有料」クレジットタイプのウォレットクレジットが作成されます。
   • パッケージタイプが分数の場合: 基本量を分数とする「有料」クレジットタイプのタイムクレジットが作成されます。
   • ボーナスタイプが金額の場合: ボーナス量と「ボーナス」クレジットタイプの追加ウォレットクレジットが作成されます。
   • ボーナスタイプが分数の場合: ボーナス量を分数とする「ボーナス」クレジットタイプの追加タイムクレジットが作成されます。
4. 制限と有効期限: すべての作成されたクレジットはパッケージのデバイス範囲とウォレットカテゴリを継承します。有効期間が設定されている場合、有効期限が計算されます。
5. 追跡: 購入レコードは有料分とボーナス分の両方について、付与量と消費量のランニングトータルを維持し、必要に応じて正確な返金計算を可能にします。

パッケージの作成

パッケージを追加するには:

1. サイドバーからキャンペーンページを開き、パッケージタブに切り替えます。
2. パッケージ追加をクリックします。
3. 定義セクションで、パッケージに名前を付け、所属するキャンペーンを選択します。
4. 内容セクションで、パッケージタイプ（分数または金額）、基本量、任意のボーナスタイプとそのボーナス量、購入価格（メンバーが支払う金額）を設定します。
5. 制約セクションで、デバイス範囲を選択し、カテゴリベースのウォレット分離を使用する場合はウォレットカテゴリとクロスカテゴリ利用を設定し、メンバー割引の設定を行います。
6. 有効性セクションで、期間限定オファーの場合は有効日数と有効曜日を設定します（任意）。
7. ダイアログ下部にある平易な文章の要約を確認します。ボーナス、有効期間、制限を含めて、顧客が支払う内容と受け取る内容が言い換えられています。
8. パッケージを保存します。

パッケージの管理

パッケージタブには、すべてのパッケージがキャンペーン、内容、価格、単位あたりの価値、有効期間、デバイス範囲とともに一覧表示されます。件数の行には、登録されているパッケージ数と公開中の数が表示されます。パッケージは一時停止と再開ができます。パッケージを削除すると無効になり、顧客は購入できなくなりますが、既存の購入と履歴は保持されます。パッケージが完全に削除されることはありません。