Yggdrasil - огляд та інтеграція

2) Портфель, механіки та серії

2. 1 Контент

Слоти (core): класика/фентезі/міфологія, «книжкові» теми, сіткові та каскадні механіки.
Варіативність RTP: зазвичай кілька профілів (напр., 96. x/95. x/94. x/92. x) під юрисдикції.
Волатильність: від low до very high; в картці гри вказані'volatility','hit _ rate','max _ win'.

2. 2 Фірмові механіки

Gigablox - великі «склеєні» символи (від 2 × 2 до 6 × 6 +) в кожному спині.
MultiMax/DoubleMax - мультиплікатори, що накопичуються по барабанах/комбінаціях (DoubleMax подвоює серію).
Splitz - один символ «розколюється» на кілька, збільшуючи лінії/ways.
GigaRise - динамічне зростання висоти барабанів в раунді/сесії.

2. 3 Топ-титули (приклади)

Vikings Go Berzerk/To Hell - серія з прогресом люті і боями з вайлдами.
Valley of the Gods (1/2) - респіни, видалення блокерів, множники і екстра-життя.
Raptor DoubleMax - каскади + подвоєння множника після кожного виграшу.
Hades Gigablox, Cazino Zeppelin/Cosmos, Golden Fish Tank, Easter Island - «вічнозелені» хіти.

3) Промо-платформа і кампанії

BOOST: турнірні таблиці (за win-multiplier/sum of wins), Prize Drops (випадкові дропи призів), Missions (виконати N умов в K іграх), Cash Race.
Free Spins/бонус-пакети: видача по конкретних іграх/номіналах (якщо включено в конфіг).
Віджети/банери: готові UI-елементи для вітрини і сторінки гри (локалізовані).

4) YG Masters і GATI (для екосистеми)

YG Masters - програма публікації ігор партнерських студій під зонтичним дистрибуційним стеком.
GATI (Game Adaptation Tools & Interface): уніфіковані шаблони та адаптери для білінгу/локалізацій/регуляторних пакетів → одна інтеграція у оператора - безліч студій/тайтлів.

5) Юрисдикції та обмеження

Вимоги розрізняються за: RTP, лімітам ставок/виграшів, Buy Feature/Autoplay/Quick Spin, обов'язковим Responsible Gaming текстам, іконкам вікових обмежень.
Не всі кампанії/призи і валюти доступні в кожному регіоні.
Регулятори вимагають cut-off звітності та зберігання round-level логів (див. § 9).

• `region → rtp_profile, features_allowed, bet_limits, promo_availability, texts_required`.

6) Архітектура інтеграції

6. 1 Гаманці

Seamless (transfer-less): баланс у оператора; ендпоінти '/authorize', '/bet', '/win', '/rollback'; потрібна сувора ідемпотентність.
Transfer Wallet: пред-трансфер коштів на RGS; розрахунки і синхронізація при закритті сесії.

6. 2 Інтерфейси та події

6. 3 Таймаути/ретраї

Клієнтські таймаути 2-3 с; експоненційний backoff; replay-черга і дедуплікація; «at-least once» вебхукі на вашому боці → ідемпотентні обробники.

6. 4 Локалізація/пристрої

Багатомовний UI, правильні валютні формати, легкі асети (особливо для сіткових і Gigablox), mobile-first.

7) Подієва схема та аналітика

7. 1 Міні-схема події (JSON)

json
{
"event_id": "01J...YGG",
"event_time": "2025-11-02T12:31:05Z",
"type": "bet    win    bonus    promo    session_start    session_end    disconnect    reconnect",
"user": {"id":"u123","tenant":"op1","country":"DE"},
"game": {"id":"ygg_raptor_doublemax","rgs":"yggdrasil","category":"slot"},
"session": {"id":"s456","device":"android"},
"wager": {"amount":1.00,"currency":"EUR","round_id":"r789"},
"payout": {"amount":18.40,"jackpot":false},
"promo": {"type":"mission","id":"msn_2025w44","progress":0.6},
"meta": {"rtp_profile":"96","jurisdiction":"MGA","mechanics":["DoubleMax","Cascade"]}
}

7. 2 Ключові метрики

GGR/NGR, Hit Rate, Spin Frequency, Bonus Entry/Completion Rate, Mission Completion, Prize Drop Participation.
Якість RGS: p95/p99 API, error-rate, webhook lag, розмір retry-черги.
Гравець/сесія: ARPPU/ARPU, avg session length, churn-сигнали, скарги/1k раундів.

7. 3 Антифрод/антиарбітраж

Каруселі місій/бонусів, аномальні win-профілі, multi-account/device, гео-аномалії.
Реакції: пауза промо/ігри по сегменту, ліміти ставок, ручна перевірка.

8) RTP, волатильність та експозиція

Зберігайте'rtp _ profile'per ринок; блокуйте Autoplay/Feature Buy там, де заборонено.
Контролюйте'max _ potential _ payout'на раунд/гру; для високоволатильних механік (DoubleMax/MultiMax) ставте VIP-гвардrails на ліміти.
Для Gigablox/Splitz відстежуйте піки експозиції на «довгих серіях» фриспінів.

9) Звітність і звірка

Round-level logs (ставки/виплати/бонуси/промо/статуси);

Daily Game Report з ігор/валют/ринків; cut-off за серверним часом провайдера (зберігайте TZ/офсет).
Звірка: сума операторських подій vs зведені звіти провайдера; дельта допускається тільки на незакритих раундах.

10) Спостережуваність і SLO інтеграції

API: `/authorize`, `/bet`, `/win` — p95/p99 и error-rate; частка дублікатів транзакцій.
Івенти: webhook-lag, розмір retry-черги, частка'rollback/void'.
Promo: delivery-rate місій/дропів, лаг нарахування призів.
Білінг: розбіжність звітів <порогу, частка закритих до cut-off.

SLO (ескіз)

yaml slo:
api:
bet_p95_ms: 250 win_p95_ms: 250 error_rate_pct: <=0.3 events:
webhook_lag_p95_s: <=3 duplicate_txn_pct: <=0.1 promo:
reward_grant_p95_s: <=5 mission_state_lag_s: <=10 billing:
report_delta_pct: <=0.2 closed_by_cutoff_pct: >=99.7

11) Безпека та комплаєнс

mTLS + HMAC-підписи, allowlist IP, короткоживучі токени; захист конфігів промо.
PII-мінімізація в івентах, токенізація'user _ id'; RLS/CLS по регіону/тенанту.
Responsible Gaming: Reality Check, ліміти/самовиключення; коректні тексти/шрифти.
Юрисдикційні прапори при запуску: autoplay/quick spin/feature buy, ліміти ставок/сесії, розкриття RTP.

12) Маркетинг і вітрина

Полиці: «Хіти Yggdrasil», «Gigablox», «DoubleMax/MultiMax», «Splitz», «Висока волатильність», «Класика».
Теги: `Gigablox`, `DoubleMax`, `Splitz`, `Cascade`, `Book`, `High Volatility`.
Кампанії: турніри/дропи через BOOST, місії з прогресом, фріспіни на онбординг.
Асети: іконки 1:1, постери 16:9/4:3 (webp), короткі прев'ю-відео; локалізовані назви/описи.

13) Тест-план і QA

13. 1 Стейджинг-чек-лист

• '/authorize '/закриття сесії; мови/валюти/формати коректні.
• '/bet '/'/win'ідемпотентні; повтор з тим же'transaction _ id'→ колишню відповідь.
• Free Spins/Bonus/Missions/Prize Drops: нарахування → витрата → звіт.
• Юрисдикції: заборона Autoplay/Feature Buy, правильний RTP-профіль, ліміти ставок/сесій.
• Звіти: збіг з івентами, cut-off, багатовалютність.

13. 2 Негативні сценарії

Дублікат'transaction _ id'→ 200 зі збереженим результатом.
Таймаут на '/win'→ безпечний retry без подвійної виплати.
Регіон без промо/валюти → детермінована відмова і коректна локалізація.
Disconnect/Resume → цілісність стейту і раунду; вірний прогрес місій.

14) Часті помилки і анти-патерни

Єдиний RTP і показ заборонених фіч → ризики комплаєнсу.

15) Шаблони конфігурацій

15. 1 Гра/ринок

yaml game_config:
game_id: "ygg_hades_gigablox"
markets:
- region: "MGA"
rtp: "96.0"
features: {autoplay: true, feature_buy: true}
bet_limits: {min: 0.20, max: 100}
- region: "UKGC"
rtp: "94.0"
features: {autoplay: false, feature_buy: false}
bet_limits: {min: 0.10, max: 10}

15. 2 Політика ідемпотентності

yaml idempotency:
key: "transaction_id"
storage: "redis+db"
ttl: "30d"
behavior: "return_last_result"

15. 3 Схема подій (мінімум)

yaml events:
keys: [event_id, event_time, type, user.id, game.id, session.id, wager.round_id]
bet:  [amount, currency, ext_ref]
win:  [amount, jackpot, ext_ref]
promo: [type, id, value]
tech: [client, device, latency_ms]

15. 4 BOOST/місії (ескіз)

yaml promo_campaign:
id: "boost_q4_2025"
type: ["tournament","prize_drop","mission"]
games: ["ygg_raptor_doublemax","ygg_valley_of_the_gods_2"]
rules:
tournament: {scoring: "win_multiplier", min_bet: 0.2}
prize_drop: {budget_eur: 20000, prizes: 1500, min_bet: 0.2}
mission:
steps:
- {game:"ygg_raptor_doublemax", goal:"win_x>=25", count:1}
- {game:"ygg_valley_of_the_gods_2", goal:"free_spins_trigger", count:1}

16) Дорожня карта впровадження

1. Inventory & Markets: список ігор Yggdrasil/YG Masters, RTP-профілі, фіч-прапори/ліміти; карта доступності промо/валют.
2. API & Wallet: вибір гаманця, ідемпотентність, ретраї, вебхуки; конфіг промо BOOST.
3. Events & Reports: схема подій, round-level логи, cut-off і TZ.
4. Compliance: юрисдикційні конфіги, RG-вимоги, тексти/банери.
5. Promo: турніри/місії/дропи, інтеграція у вітрину і CRM.
6. Observability: панелі SLO (API/івенти/промо/білінг), алерти, реплеї.
7. Go-Live: канарний трафік, порівняння KPI (GGR, hit rate, mission completion, complaints), пост-мортем 1-го тижня.

17) Підсумок

Yggdrasil поєднує сильні власні механіки і масштабовану екосистему YG Masters на базі GATI, а платформа BOOST спрощує промо на рівні мережі. Успішна інтеграція спирається на ідемпотентний білінг, коректні RTP/фічі по юрисдикціях, прозору звітність з cut-off і спостережуваність SLO. При продуманій вітрині і промо портфель Yggdrasil забезпечує стійкий внесок в GGR/LTV при керованих ризиках і вартості обслуговування.