HandyCafe Docs
owner

Livelli Fedelta

Il sistema dei livelli fedelta premia i clienti abituali con sconti automatici basati sulla loro attivita accumulata. Man mano che i membri utilizzano il locale (spendendo denaro, effettuando accessi, acquistando pacchetti o effettuando ordini) guadagnano punti fedelta. Quando il loro totale punti supera la soglia di un livello, avanzano a un livello superiore e ricevono uno sconto maggiore sulle tariffe delle sessioni.

Struttura dei Livelli

Ogni livello fedelta e definito da quattro campi:

Campo Descrizione
code Un codice breve univoco per il livello (ad esempio silver, gold, vip). Utilizzato internamente per l'identificazione e nelle risposte API.
name Un nome visualizzato leggibile (ad esempio "Membro Silver", "Membro Gold"). Mostrato nel profilo membro e sulla schermata di blocco del client.
threshold_points Il numero minimo di punti fedelta che un membro deve accumulare per qualificarsi per questo livello.
discount_bps Lo sconto applicato alle tariffe delle sessioni, espresso in punti base. 100 BPS equivale a 1%. Un valore di 500 significa uno sconto del 5%.

I livelli sono ordinati per il valore threshold_points. Un membro appartiene al livello piu alto per il quale soddisfa la soglia di punti.

Sconti in Punti Base (BPS)

Gli sconti sono espressi in punti base (BPS) anziche in percentuali per evitare errori di arrotondamento in virgola mobile nei calcoli finanziari. Un punto base equivale a 0,01%, ovvero un centesimo di percento.

Valori di sconto comuni:

Valore BPS Percentuale Esempio su tariffa 1000 unita/ora
250 2,5% Il membro paga 975 all'ora
500 5% Il membro paga 950 all'ora
1000 10% Il membro paga 900 all'ora
1500 15% Il membro paga 850 all'ora
2000 20% Il membro paga 800 all'ora

Quando un membro con uno sconto di livello avvia una sessione, il motore di tariffazione riduce la tariffa oraria base del discount_bps del livello prima di calcolare i costi dei segmenti.

Eventi Fedelta

I membri guadagnano punti tramite eventi fedelta. Ogni evento registra una variazione di punti e l'attivita che l'ha generata:

Tipo Evento Descrizione Punti Tipici
spend Il membro ha pagato per una sessione (postpagata o detrazione dal portafoglio). I punti sono proporzionali all'importo speso. Varia per importo speso
usage Il membro ha utilizzato un PC o console per una sessione, indipendentemente dal pagamento. I punti sono basati sulla durata di utilizzo. Varia per minuti utilizzati
visit Il membro ha effettuato l'accesso da un PC client. Un bonus fisso per ogni visita, incoraggiando la frequentazione regolare. Fisso per visita
topup Il membro ha aggiunto fondi al portafoglio. I punti riflettono l'importo della ricarica. Varia per importo della ricarica
order Il membro ha effettuato un ordine prodotti (cibo, bevande, ecc.). I punti sono proporzionali al totale dell'ordine. Varia per totale dell'ordine
adjustment Una rettifica manuale dei punti effettuata da un amministratore. Utilizzata per correzioni, promozioni o premi speciali. Qualsiasi valore (positivo o negativo)

Ogni record di evento fedelta include:

  • points_delta: Il numero di punti guadagnati (positivo) o persi (negativo) da questo evento.
  • amount_minor: L'importo monetario associato all'evento (in unita minori di valuta), se applicabile.
  • minutes_delta: Il numero di minuti associati all'evento, se applicabile.
  • source_entity / source_entity_id: Un riferimento alla sessione, ordine o transazione che ha generato l'evento.
  • event_at: Il timestamp di quando l'evento si e verificato.

Avanzamento di Livello

L'avanzamento di livello funziona nel seguente modo:

  1. Un membro esegue un'attivita (sessione, acquisto, accesso, ecc.).
  2. Il sistema crea un evento fedelta con il corrispondente points_delta.
  3. Il totale punti del membro viene ricalcolato come la somma di tutti i valori points_delta dei suoi eventi fedelta.
  4. Il sistema verifica se il nuovo totale soddisfa la soglia per un livello superiore.
  5. Se il membro si qualifica per un nuovo livello, il suo campo tier viene aggiornato e il nuovo sconto ha effetto dalla sessione successiva.

L'assegnazione del livello puo anche essere impostata manualmente da un amministratore, sovrascrivendo il calcolo automatico.

Come gli Sconti di Livello si Applicano alle Tariffe Sessione

Quando il motore di tariffazione calcola il costo di un segmento di sessione per un membro:

  1. Il prezzo orario base e determinato dalla fascia tariffaria attiva.
  2. Se il membro ha un livello con un valore discount_bps, il prezzo base viene ridotto: prezzo_scontato = prezzo_base * (10000 - discount_bps) / 10000.
  3. Inoltre, sconti individuali a livello membro (member_discount_bps nel record del membro) vengono applicati se presenti.
  4. La tariffa scontata finale viene utilizzata per calcolare il costo del segmento.

Gli sconti di livello e gli sconti a livello membro possono cumularsi, dando al membro il beneficio combinato di entrambi.

Creazione e Gestione dei Livelli

Per creare un nuovo livello:

  1. Vai su Impostazioni e apri la sezione Tariffe (o l'area dedicata alla gestione dei livelli).
  2. Clicca Aggiungi Livello.
  3. Inserisci il codice (univoco, minuscolo), il nome (etichetta di visualizzazione), i punti soglia e lo sconto BPS.
  4. Salva il livello.

Per modificare un livello esistente, selezionalo dall'elenco e modifica qualsiasi campo. Le modifiche al discount_bps di un livello hanno effetto su tutti i membri attualmente assegnati a quel livello, a partire dalla sessione successiva.

Per eliminare un livello, rimuovilo dall'elenco. I membri che erano assegnati al livello eliminato ricadranno nel livello immediatamente inferiore per il quale si qualificano in base ai loro punti.

Esempio di Configurazione dei Livelli

Una configurazione tipica a tre livelli potrebbe apparire cosi:

Codice Nome Punti Soglia Sconto BPS
bronze Bronzo 0 0
silver Silver 500 500
gold Gold 2000 1000
vip VIP 5000 1500

In questa configurazione, un nuovo membro inizia al livello Bronzo (nessuno sconto). Dopo aver accumulato 500 punti da visite, spese e ordini, avanza automaticamente a Silver con uno sconto del 5%. A 2000 punti raggiunge Gold (10%) e a 5000 punti ottiene lo status VIP (15%).