Kanonické události
Když mapujete události vaší platformy na kanonická jména casinocrm.io, každá reporting / segmentation / journey cesta funguje automaticky. Použijte prefix custom_* pro platform-specific události, které neodpovídají kanonické taxonomii.
Identita / session
| Událost | Povinné properties |
|---|---|
signup | — |
login | — |
logout | — |
session_start | — |
session_end | — |
page_view | path |
click | target |
KYC
| Událost | Povinné properties |
|---|---|
kyc_submitted | level, documents? |
kyc_approved | level, expires_at? |
kyc_rejected | level, reason |
kyc_expired | level |
kyc_level_upgraded | from_level, to_level |
Responsible gaming
| Událost | Povinné properties |
|---|---|
self_exclusion_set | until?, reason? |
self_exclusion_lifted | reason |
deposit_limit_set | kind (daily/weekly/monthly), amount, currency |
deposit_limit_reached | kind, attempted_amount, currency |
loss_limit_set / loss_limit_reached | stejný shape |
session_limit_warning / session_limit_exceeded | minutes_used |
reality_check | triggered_at, acknowledged? |
cooldown_entered | duration_minutes |
Peníze in/out
| Událost | Povinné properties |
|---|---|
deposit_initiated | amount, currency, transaction_id, payment_method (required) |
deposit_confirmed | amount, currency, transaction_id, payment_method (required) |
deposit_failed | transaction_id, reason |
withdrawal_requested | amount, currency, transaction_id |
withdrawal_confirmed | amount, currency, transaction_id |
withdrawal_failed | transaction_id, reason |
amount je v nejmenší jednotce měny (cents / sat) — viz Multi-currency. casinocrm.io obohatí o amount_base + base_currency + fx_rate_locked při ingestion.
Wagering — casino
| Událost | Povinné properties |
|---|---|
bet_placed | amount, currency, bet_id, game_id, game_category |
bet_settled | amount, payout, currency, bet_id, game_id, game_category, outcome |
bet_won | (volitelné — bet_settled je kanonická settlement událost) |
bet_lost | (volitelné) |
game_category ∈ slots | live | table | crash | dice | sports | other (cokoli jiného sklopíme do other).
outcome ∈ won | lost.
Wagering — sportsbook
Dvoufázový lifecycle: sázka je placed, později settled NEBO voided NEBO cashout (hráč early-settle).
| Událost | Povinné properties |
|---|---|
sport_bet_placed | amount, currency, bet_id, sport, bet_type, odds, event_ref |
sport_bet_settled | amount, payout, currency, bet_id, outcome |
sport_bet_voided | bet_id, reason |
sport_cashout | amount, payout, currency, bet_id |
sport ∈ football | basketball | tennis | hockey | mma | … (operátorem definováno, ale držte se běžných hodnot pro cross-tenant analytiku).
bet_type ∈ single | accumulator | system.
event_ref je identifikátor zápasu (id vaší platformy; nemusí mapovat na nic v casinocrm.io).
Bonusy
casinocrm.io trackuje bonus state přes webhooks (viz Bonus flow), ne tyto události. bonus_* události jsou pro player-side signály (hráč si claimnul / bonus completed viditelný hráči) — odděleno od platform-side state machine.
| Událost | Povinné properties |
|---|---|
bonus_claimed | bonus_id |
bonus_wagered | bonus_id, amount, currency |
bonus_completed | bonus_id |
bonus_expired | bonus_id |
Custom události
Cokoli, co není v kanonickém seznamu, MUSÍ mít prefix custom_:
{
"event": "custom_slot_jackpot_won",
"external_id": "...",
"properties": { "amount": 50000, "game_id": "starburst", "tier": "minor" }
}
casinocrm.io custom události akceptuje, ale nevynucuje schema. Používejte je v segmentech (event aggregation: custom_slot_jackpot_won → count > 0).