HandyCafe Docs
owner

Tahap Kesetiaan

Sistem tahap kesetiaan memberi ganjaran kepada pelanggan tetap dengan diskaun automatik berdasarkan aktiviti terkumpul mereka. Apabila ahli menggunakan kafe (membelanjakan wang, log masuk, membeli pakej atau membuat pesanan), mereka memperoleh mata kesetiaan. Apabila jumlah mata mereka melebihi ambang tahap, mereka maju ke tahap yang lebih tinggi dan menerima diskaun yang lebih besar pada penetapan harga sesi.

Struktur Tahap

Setiap tahap kesetiaan ditakrifkan oleh empat medan:

Medan Penerangan
code Kod pendek unik untuk tahap (contoh: silver, gold, vip). Digunakan secara dalaman untuk pengenalan dan dalam respons API.
name Nama paparan yang boleh dibaca manusia (contoh: "Ahli Perak", "Ahli Emas"). Ditunjukkan dalam profil ahli dan pada skrin kunci klien.
threshold_points Bilangan minimum mata kesetiaan yang ahli mesti kumpulkan untuk layak untuk tahap ini.
discount_bps Diskaun yang dikenakan pada penetapan harga sesi, dinyatakan dalam mata asas. 100 BPS bersamaan 1%. Nilai 500 bermakna diskaun 5%.

Tahap disusun mengikut nilai threshold_points mereka. Ahli tergolong dalam tahap tertinggi yang mana mereka memenuhi ambang mata.

Diskaun Mata Asas (BPS)

Diskaun dinyatakan dalam mata asas (BPS) dan bukannya peratusan untuk mengelakkan ralat pembundaran titik terapung dalam pengiraan kewangan. Satu mata asas bersamaan 0.01%, atau satu perseratus peratus.

Nilai diskaun biasa:

Nilai BPS Peratusan Contoh pada kadar 1000 unit/jam
250 2.5% Ahli membayar 975 sejam
500 5% Ahli membayar 950 sejam
1000 10% Ahli membayar 900 sejam
1500 15% Ahli membayar 850 sejam
2000 20% Ahli membayar 800 sejam

Apabila ahli dengan diskaun tahap memulakan sesi, enjin penetapan harga mengurangkan kadar sejam asas mengikut discount_bps tahap sebelum mengira kos segmen.

Peristiwa Kesetiaan

Ahli memperoleh mata melalui peristiwa kesetiaan. Setiap peristiwa merekodkan perubahan mata dan aktiviti yang mencetuskannya:

Jenis Peristiwa Penerangan Mata Biasa
spend Ahli membayar untuk sesi (pascabayar atau potongan dompet). Mata berkadar dengan jumlah yang dibelanjakan. Berbeza mengikut jumlah belanja
usage Ahli menggunakan PC atau konsol untuk sesi, tanpa mengira pembayaran. Mata berdasarkan tempoh penggunaan. Berbeza mengikut minit digunakan
visit Ahli log masuk dari PC klien. Bonus tetap untuk setiap lawatan, menggalakkan kehadiran tetap. Tetap setiap lawatan
topup Ahli menambah dana ke dompet mereka. Mata mencerminkan jumlah isian semula. Berbeza mengikut jumlah isian semula
order Ahli membuat pesanan produk (makanan, minuman dan sebagainya). Mata berkadar dengan jumlah pesanan. Berbeza mengikut jumlah pesanan
adjustment Pelarasan mata manual oleh pentadbir. Digunakan untuk pembetulan, promosi atau ganjaran khas. Sebarang nilai (positif atau negatif)

Kemajuan Tahap

Kemajuan tahap berfungsi seperti berikut:

  1. Ahli melaksanakan aktiviti (sesi, pembelian, log masuk dan sebagainya).
  2. Sistem mencipta peristiwa kesetiaan dengan points_delta yang sepadan.
  3. Jumlah mata ahli dikira semula sebagai hasil tambah semua nilai points_delta peristiwa kesetiaan mereka.
  4. Sistem menyemak sama ada jumlah baharu memenuhi ambang untuk tahap yang lebih tinggi.
  5. Jika ahli layak untuk tahap baharu, medan tier mereka dikemas kini dan diskaun baharu berkuat kuasa pada sesi seterusnya.

Penetapan tahap juga boleh ditetapkan secara manual oleh pentadbir, mengatasi pengiraan automatik.

Cara Diskaun Tahap Dikenakan pada Penetapan Harga Sesi

Apabila enjin penetapan harga mengira kos segmen sesi untuk ahli:

  1. Harga sejam asas ditentukan oleh slot harga yang aktif.
  2. Jika ahli mempunyai tahap dengan nilai discount_bps, harga asas dikurangkan: discounted_price = base_price * (10000 - discount_bps) / 10000.
  3. Selain itu, diskaun peringkat ahli individu (member_discount_bps pada rekod ahli) dikenakan jika ada.
  4. Kadar akhir yang didiskaunkan digunakan untuk mengira kos segmen.

Diskaun tahap dan diskaun peringkat ahli boleh bertindih, memberi ahli manfaat gabungan kedua-duanya.

Mencipta dan Mengurus Tahap

Untuk mencipta tahap baharu:

  1. Navigasi ke Tetapan dan buka bahagian Penetapan Harga (atau kawasan pengurusan tahap yang khusus).
  2. Klik Tambah Tahap.
  3. Masukkan kod (unik, huruf kecil), nama (label paparan), ambang mata dan diskaun BPS.
  4. Simpan tahap.

Untuk menyunting tahap sedia ada, pilihnya dari senarai dan ubah suai mana-mana medannya. Perubahan pada discount_bps tahap berkuat kuasa pada semua ahli yang ditetapkan kepada tahap itu, bermula dengan sesi seterusnya.

Untuk memadamkan tahap, buangnya dari senarai. Ahli yang ditetapkan kepada tahap yang dipadamkan akan kembali ke tahap seterusnya yang lebih rendah yang mana mereka layak berdasarkan mata mereka.

Contoh Persediaan Tahap

Konfigurasi tiga tahap yang biasa mungkin kelihatan seperti ini:

Kod Nama Ambang Mata Diskaun BPS
bronze Gangsa 0 0
silver Perak 500 500
gold Emas 2000 1000
vip VIP 5000 1500

Dalam persediaan ini, ahli baharu bermula di Gangsa (tiada diskaun). Selepas mengumpulkan 500 mata daripada lawatan, perbelanjaan dan pesanan, mereka secara automatik naik taraf ke Perak dengan diskaun 5%. Pada 2000 mata mereka mencapai Emas (10%) dan pada 5000 mata mereka mencapai status VIP (15%).