HandyCafe Docs
owner

キャンペーン

キャンペーンは、1つ以上のパッケージを単一のテーマや期間限定のプロモーションとしてまとめたプロモーションオファーです。インターネットカフェやゲーミングセンターのオーナーは、構造化されたお得なプラン(「サマースペシャル」や「週末ゲーミングバンドル」など)を作成し、メンバーがクライアント側のメンバーパネルまたはキャッシャーカウンターで閲覧・購入できるようにします。

キャンペーンの構成

各キャンペーンは以下のフィールドで定義されます。

フィールド 説明
name キャンペーンの表示名。メンバーとスタッフに表示されます。
description キャンペーンの目的、条件、特典を説明するテキストです。
active キャンペーンが現在購入可能かどうかを制御するトグルです。
expires_at オプションの有効期限。この日付以降、キャンペーンは新規購入できなくなりますが、既存の購入はそれぞれの条件に従って有効です。
deleted 論理削除フラグ。削除されたキャンペーンはアクティブリストから非表示になりますが、データはレポート用に保持されます。

キャンペーンの状態

キャンペーンは以下のいずれかの状態になります。

  • アクティブ: キャンペーンが表示され、購入可能です。activeフラグが1に設定されており、論理削除されていません。
  • 非アクティブ: キャンペーンは存在しますが、一時的に無効化されています。activeフラグが0に設定されています。いつでも再有効化できます。
  • 期限切れ: 現在の日付がキャンペーンのexpires_atを過ぎています。新規購入はできません。
  • 削除済み: キャンペーンが論理削除されています。アクティブリストに表示されず、購入もできませんが、関連するすべてのデータ(購入、ロット、消費記録)は保持されます。

パッケージとキャンペーンの紐付け

キャンペーン単体では、メンバーが受け取る内容を定義しません。それはパッケージの役割です。各キャンペーンには、具体的な特典(分数、ウォレットクレジット、またはその両方)と購入価格を定義する1つ以上のパッケージが含まれます。

たとえば、「新学期キャンペーン」には3つのパッケージを含めることができます。

  • ベーシック: 固定価格で60分。
  • スタンダード: 高めの価格で120分 + ボーナス30分。
  • プレミアム: 最高価格で500ウォレットクレジット + ボーナス60分。

パッケージの設定方法の詳細はパッケージページをご覧ください。

メンバーの購入フロー

メンバーがキャンペーンパッケージを購入すると、以下の順序で処理が行われます。

  1. 閲覧: メンバーはクライアントPCのメンバーパネル(キャンペーンタブ)で利用可能なキャンペーンを閲覧するか、キャッシャーがサーバーUIでキャンペーンを検索します。
  2. 選択: メンバーがキャンペーン内の特定のパッケージを選択します。
  3. 支払い: 購入価格が回収されます。レジでの現金、カード支払い、またはメンバーの既存ウォレット残高からの引き落としが可能です。
  4. 付与: パッケージの定義に基づいて、適切なウォレットクレジットや時間クレジットがシステムによって作成されます。
    • 金額パッケージの場合: 金銭的特典のウォレットクレジットが作成されます。
    • 分数パッケージの場合: 分数特典の時間クレジットが作成されます。
    • ボーナス特典は「ボーナス」としてタグ付けされた追加クレジットを作成します。
  5. 記録: メンバー、キャンペーン、パッケージ、および関連するすべてのクレジットを紐付ける購入記録が作成されます。この記録は購入レベルでの特典と消費を追跡します。

キャンペーンの有効化と無効化

オーナーはキャンペーンのアクティブ状態をいつでも切り替えることができます。

  • キャンペーンを有効化すると、メンバーとキャッシャーがすぐに購入できるようになります。
  • キャンペーンを無効化すると、購入リストから削除されますが、既存の購入には影響しません。すでにキャンペーンからパッケージを購入したメンバーは、ウォレットクレジットと時間クレジットを保持します。

これは季節限定プロモーションに便利です。事前にキャンペーンを作成し、プロモーション開始時に有効化し、終了時に無効化できます。データは一切失われません。

キャンペーンの作成

新しいキャンペーンを作成するには:

  1. サイドバーのキャンペーンセクション(または専用のキャンペーン管理エリア)に移動します。
  2. キャンペーン追加をクリックします。
  3. キャンペーンの名前説明を入力します。
  4. 特定の日付以降に新規購入の受付を自動的に停止する場合は、有効期限を設定します(任意)。
  5. キャンペーンを保存します。
  6. キャンペーンに1つ以上のパッケージを追加します(詳細はパッケージを参照)。

キャンペーンの管理

キャンペーンリストから以下の操作が可能です。

  • キャンペーンの名前、説明、有効期限の編集
  • アクティブ状態の切替によるキャンペーンの有効化または無効化。
  • キャンペーンの削除(論理削除)。データを保持しながらアクティブリストから永久に非表示にします。
  • 購入履歴の表示。このキャンペーンからパッケージを購入したメンバーと特典のステータスを確認できます。