HandyCafe Docs
owner

Tahap Kesetiaan

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

Struktur Tahap

Setiap tahap kesetiaan ditentukan 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 mudah dibaca (contoh: "Ahli Silver", "Ahli Gold"). Dipaparkan dalam profil ahli dan pada skrin kunci klien.
threshold_points Jumlah minimum mata kesetiaan yang mesti dikumpul oleh ahli untuk layak ke tahap ini.
discount_bps Diskaun yang dikenakan pada harga sesi, dinyatakan dalam mata asas. 100 BPS bersamaan 1%. Nilai 500 bermaksud diskaun 5%.

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

Diskaun Mata Asas (BPS)

Diskaun dinyatakan dalam mata asas (BPS) dan bukan peratusan untuk mengelakkan kesilapan pembundaran titik terapung dalam pengiraan kewangan. Satu mata asas bersamaan 0.01%, atau satu per seratus peratus.

Nilai diskaun biasa:

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

Apabila ahli dengan diskaun tahap memulakan sesi, enjin harga mengurangkan kadar asas per jam dengan discount_bps tahap sebelum mengira kos segmen.

Acara Kesetiaan

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

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

Setiap rekod acara kesetiaan termasuk:

  • points_delta: Jumlah mata yang diperoleh (positif) atau hilang (negatif) dari acara ini.
  • amount_minor: Jumlah wang yang berkaitan dengan acara (dalam unit mata wang kecil), jika berkenaan.
  • minutes_delta: Jumlah minit yang berkaitan dengan acara, jika berkenaan.
  • source_entity / source_entity_id: Rujukan kembali kepada sesi, pesanan, atau transaksi yang menjana acara.
  • event_at: Cap masa apabila acara berlaku.

Kenaikan Tahap

Kenaikan tahap berfungsi seperti berikut:

  1. Seorang ahli melakukan aktiviti (sesi, pembelian, log masuk, dll.).
  2. Sistem mencipta acara kesetiaan dengan points_delta yang sepadan.
  3. Jumlah mata ahli dikira semula sebagai jumlah semua nilai points_delta acara kesetiaan mereka.
  4. Sistem memeriksa jika jumlah baru memenuhi ambang untuk tahap yang lebih tinggi.
  5. Jika ahli layak untuk tahap baru, medan tier mereka dikemas kini dan diskaun baru berkuat kuasa pada sesi seterusnya.

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

Bagaimana Diskaun Tahap Dikenakan pada Harga Sesi

Apabila enjin harga mengira kos segmen sesi untuk ahli:

  1. Harga asas per jam ditentukan oleh slot harga 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 diskaun akhir digunakan untuk mengira kos segmen.

Diskaun tahap dan diskaun peringkat ahli boleh digabungkan, memberikan ahli manfaat gabungan kedua-duanya.

Mencipta dan Mengurus Tahap

Untuk mencipta tahap baru:

  1. Pergi ke Tetapan dan buka bahagian Harga (atau kawasan pengurusan tahap khusus).
  2. Klik Tambah Tahap.
  3. Masukkan code (unik, huruf kecil), name (label paparan), threshold points, dan discount BPS.
  4. Simpan tahap.

Untuk mengedit tahap sedia ada, pilih dari senarai dan ubah mana-mana medannya. Perubahan pada discount_bps tahap berkuat kuasa pada semua ahli yang kini ditugaskan ke tahap itu, bermula dengan sesi seterusnya mereka.

Untuk memadam tahap, keluarkan dari senarai. Ahli yang ditugaskan ke tahap yang dipadam akan kembali ke tahap seterusnya yang lebih rendah yang mana mereka layak berdasarkan mata mereka.

Contoh Penetapan Tahap

Konfigurasi tiga tahap biasa mungkin kelihatan seperti ini:

Kod Nama Mata Ambang Diskaun BPS
bronze Bronze 0 0
silver Silver 500 500
gold Gold 2000 1000
vip VIP 5000 1500

Dalam penetapan ini, ahli baru bermula di Bronze (tiada diskaun). Selepas mengumpul 500 mata dari lawatan, perbelanjaan, dan pesanan, mereka secara automatik dinaik taraf ke Silver dengan diskaun 5%. Pada 2000 mata mereka mencapai Gold (10%) dan pada 5000 mata mereka mencapai status VIP (15%).