パッケージ

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

パッケージタイプ

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

パッケージタイプ

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

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

ボーナスタイプ

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

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

組み合わせの例

購入価格と特典

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

たとえば:

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

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

デバイス制限

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

デバイス制限はこのパッケージから作成されるすべてのウォレットクレジットとタイムクレジットに継承されます。

有効期間

有効日数

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

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

有効曜日

有効曜日設定は、特典を消費できる曜日を制限する任意の曜日選択です。「平日のみ」や「週末のみ」のバンドルなどのパッケージが可能です。有効曜日が設定されている場合、システムは該当する曜日のみパッケージのクレジットから差し引きます。

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

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

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

• 0（デフォルト）: 資金は指定されたカテゴリに制限されます。
• 1: 資金は他のカテゴリでも利用可能です。

メンバー割引の累積

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

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

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

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

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

パッケージの作成

既存のキャンペーンにパッケージを追加するには:

1. キャンペーンリストからキャンペーンを開きます。
2. パッケージ追加をクリックします。
3. パッケージタイプ（分数または金額）を設定し、基本量を設定します。
4. ボーナスタイプとボーナス量を設定します（任意）。
5. 購入価格（メンバーが支払う金額）を設定します。
6. デバイス制限を選択します。
7. 期間限定オファーの場合は有効日数と有効曜日を設定します（任意）。
8. カテゴリベースのウォレット分離を使用する場合はウォレットカテゴリとクロスカテゴリ利用を設定します。
9. メンバー割引累積の設定を行います。
10. パッケージを保存します。