HandyCafe Docs
owner

Sadakat Katmanları

Sadakat katman sistemi düzenli müşterileri biriken aktivitelerine göre otomatik indirimlerle ödüllendirir. Üyeler kafeyi kullandıkça (para harcama, giriş yapma, paket satın alma veya sipariş verme) sadakat puanı kazanır. Toplam puanları bir katman eşiğini aştığında daha yüksek bir katmana yükselir ve oturum fiyatlandırmasında daha büyük indirim alır.

Katman Yapısı

Her sadakat katmanı dört alanla tanımlanır:

Alan Açıklama
code Katman için benzersiz kısa kod (örneğin silver, gold, vip). Dahili tanımlama ve API yanıtlarında kullanılır.
name Okunabilir görünen ad (örneğin "Gümüş Üye", "Altın Üye"). Üye profilinde ve istemci kilit ekranında gösterilir.
threshold_points Bir üyenin bu katmana hak kazanması için biriktirmesi gereken minimum sadakat puanı sayısı.
discount_bps Oturum fiyatlandırmasına uygulanan indirim (baz puan cinsinden). 100 BPS %1'e eşittir. 500 değeri %5 indirim anlamına gelir.

Katmanlar threshold_points değerine göre sıralanır. Bir üye puan eşiğini karşıladığı en yüksek katmana aittir.

Baz Puan (BPS) İndirimleri

İndirimler mali hesaplamalarda kayan nokta yuvarlama hatalarından kaçınmak için yüzde yerine baz puan (BPS) olarak ifade edilir. Bir baz puan %0,01'e yani yüzdede birin yüzde birine eşittir.

Yaygın indirim değerleri:

BPS Değeri Yüzde Saat başına 1000 birimlik ücret örneği
250 %2,5 Üye saat başına 975 öder
500 %5 Üye saat başına 950 öder
1000 %10 Üye saat başına 900 öder
1500 %15 Üye saat başına 850 öder
2000 %20 Üye saat başına 800 öder

Katman indirimli bir üye oturum başlattığında fiyatlandırma motoru segment maliyetlerini hesaplamadan önce temel saatlik ücreti katmanın discount_bps değeri kadar düşürür.

Sadakat Olayları

Üyeler sadakat olayları aracılığıyla puan kazanır. Her olay bir puan değişikliğini ve bunu tetikleyen aktiviteyi kaydeder:

Olay Türü Açıklama Tipik Puan
spend Üye bir oturum için ödeme yaptı (son ödemeli veya cüzdan düşümü). Puanlar harcanan tutarla orantılıdır. Harcama tutarına göre değişir
usage Üye ödemeden bağımsız olarak bir bilgisayar veya konsol oturumu kullandı. Puanlar kullanım süresine dayanır. Kullanılan dakikaya göre değişir
visit Üye bir istemci bilgisayardan giriş yaptı. Düzenli katılımı teşvik eden her ziyaret için sabit bonus. Ziyaret başına sabit
topup Üye cüzdanına bakiye yükledi. Puanlar yükleme tutarını yansıtır. Yükleme tutarına göre değişir
order Üye bir ürün siparişi verdi (yiyecek, içecek vb.). Puanlar sipariş toplamıyla orantılıdır. Sipariş toplamına göre değişir
adjustment Bir yönetici tarafından yapılan elle puan ayarlaması. Düzeltmeler, promosyonlar veya özel ödüller için kullanılır. Herhangi bir değer (pozitif veya negatif)

Her sadakat olayı kaydı şu bilgileri içerir:

  • points_delta: Bu olaydan kazanılan (pozitif) veya kaybedilen (negatif) puan sayısı.
  • amount_minor: Varsa olayla ilişkili parasal tutar (küçük para birimi cinsinden).
  • minutes_delta: Varsa olayla ilişkili dakika sayısı.
  • source_entity / source_entity_id: Olayı oluşturan oturum, sipariş veya işleme geri başvuru.
  • event_at: Olayın gerçekleştiği zaman damgası.

Katman İlerlemesi

Katman ilerlemesi şu şekilde çalışır:

  1. Üye bir aktivite gerçekleştirir (oturum, alış, giriş vb.).
  2. Sistem ilgili points_delta ile bir sadakat olayı oluşturur.
  3. Üyenin toplam puanları tüm sadakat olayı points_delta değerlerinin toplamı olarak yeniden hesaplanır.
  4. Sistem yeni toplamın daha yüksek bir katman eşiğini karşılayıp karşılamadığını kontrol eder.
  5. Üye yeni bir katmana hak kazanırsa tier alanı güncellenir ve yeni indirim sonraki oturumda geçerli olur.

Katman ataması otomatik hesaplamayı geçersiz kılarak bir yönetici tarafından elle de ayarlanabilir.

Katman İndirimlerinin Oturum Fiyatlandırmasına Uygulanışı

Fiyatlandırma motoru bir üye için oturum segmenti maliyetini hesaplarken:

  1. Temel saatlik fiyat aktif fiyatlandırma dilimi tarafından belirlenir.
  2. Üyenin discount_bps değerine sahip bir katmanı varsa temel fiyat düşürülür: indirimli_fiyat = temel_fiyat * (10000 - discount_bps) / 10000.
  3. Ayrıca varsa bireysel üye düzeyinde indirimler (üye kaydındaki member_discount_bps) uygulanır.
  4. Nihai indirimli ücret segment maliyetini hesaplamak için kullanılır.

Katman indirimleri ve üye düzeyinde indirimler üst üste gelebilir. Üyeye her ikisinin birleşik avantajını sağlar.

Katman Oluşturma ve Yönetme

Yeni bir katman oluşturmak için:

  1. Ayarlar'a gidin ve Fiyatlandırma bölümünü açın (veya katman yönetimi alanını).
  2. Katman Ekle'ye tıklayın.
  3. Kod (benzersiz, küçük harf), ad (görünen etiket), eşik puanları ve indirim BPS değerini girin.
  4. Katmanı kaydedin.

Mevcut bir katmanı düzenlemek için listeden seçin ve alanlardan herhangi birini değiştirin. Bir katmanın discount_bps değerindeki değişiklikler o anda o katmana atanmış tüm üyeler için sonraki oturumlarıyla birlikte geçerli olur.

Bir katmanı silmek için listeden kaldırın. Silinen katmana atanmış üyeler puanlarına göre hak kazandıkları bir sonraki düşük katmana geri döner.

Örnek Katman Kurulumu

Tipik bir üç katmanlı yapılandırma şu şekilde görünebilir:

Kod Ad Eşik Puanı İndirim BPS
bronze Bronz 0 0
silver Gümüş 500 500
gold Altın 2000 1000
vip VIP 5000 1500

Bu kurulumda yeni bir üye Bronz'dan (indirim yok) başlar. Ziyaretler, harcamalar ve siparişlerden 500 puan biriktirdikten sonra otomatik olarak %5 indirimle Gümüş'e yükselir. 2000 puanda Altın'a (%10) ve 5000 puanda VIP statüsüne (%15) ulaşır.