Канонічні події
Translator note: machine-translated baseline. Needs human review by a native UK speaker. EN source is canonical.
Коли ви мапите події вашої платформи на канонічні імена casinocrm.io, кожен reporting / segmentation / journey шлях працює автоматично. Використовуйте префікс custom_* для platform-specific подій, які не відповідають канонічній таксономії.
Identity / session
| Подія | Обов'язкові properties |
|---|---|
signup | — |
login | — |
logout | — |
session_start | — |
session_end | — |
page_view | path |
click | target |
KYC
| Подія | Обов'язкові 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
| Подія | Обов'язкові 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 | той самий shape |
session_limit_warning / session_limit_exceeded | minutes_used |
reality_check | triggered_at, acknowledged? |
cooldown_entered | duration_minutes |
Гроші in/out
| Подія | Обов'язкові 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 — у найменшій одиниці валюти (cents / sat) — див. Multi-currency. casinocrm.io збагатить про amount_base + base_currency + fx_rate_locked під час ingestion.
Wagering — casino
| Подія | Обов'язкові 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 | (опційно — bet_settled є канонічною settlement подією) |
bet_lost | (опційно) |
game_category ∈ slots | live | table | crash | dice | sports | other (все інше колапсуємо до other).
outcome ∈ won | lost.
Wagering — sportsbook
Двофазовий lifecycle: ставку placed, потім settled АБО voided АБО cashout (гравець early-settle).
| Подія | Обов'язкові 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 | … (operator-defined, але тримайтесь поширених значень для cross-tenant аналітики).
bet_type ∈ single | accumulator | system.
event_ref — ідентифікатор матчу (id вашої платформи; не потрібно мапити на щось у casinocrm.io).
Бонуси
casinocrm.io трекає bonus state через webhooks (див. Bonus flow), не ці події. bonus_* події призначені для player-side сигналів (гравець claim-нув / bonus completed видимий гравцю) — окремо від platform-side state machine.
| Подія | Обов'язкові properties |
|---|---|
bonus_claimed | bonus_id |
bonus_wagered | bonus_id, amount, currency |
bonus_completed | bonus_id |
bonus_expired | bonus_id |
Custom події
Все, що не в канонічному списку, МАЄ мати префікс custom_:
{
"event": "custom_slot_jackpot_won",
"external_id": "...",
"properties": { "amount": 50000, "game_id": "starburst", "tier": "minor" }
}
casinocrm.io приймає custom події, але не вимагає схему. Використовуйте їх у сегментах (event aggregation: custom_slot_jackpot_won → count > 0).