הילוך טורנט

נתונים סטטיסטיים וניתוחים: אירועים, אגרגטים, שימור

מאמר מלא

💡 18+. ניתוח הנדסי לפלטפורמות/אופרטורים, אולפנים (RGS/Live) וצוותי BI/CRM. לא שיחה לשחק.

1) מדוע API ניתוח חיצוני

שותפים/ספקים: SLA ניטור תוכן, RTP, מעורבות.

שיווק/CRM: קמפיין הדק המבוסס על מדדים (DAU, משפך הפקדה).

Operations/Finance: כמעט בזמן אמת GGR/NGR, הצלחה בתשלום, webhook lags.

מוצר: וידג 'טים סטטיסטיים באפליקציות, לוחות A/B.

המטרה היא להחזיר בבטחה וצפוי אירועים ומצטברים עם סמנטיקה מובנת וסלאח.

2) ארכיטקטורה על האצבעות


יצרנים (PAM/Wallet/RGS/Piples/Kafka/CDC)
│
בליעה API ──Stream (קפקא/פולסר) ──Lakehouse (דלתא/קרחון)
│ └─OLAP (ClickHouse/BigQuery/Trino)
API של └────────────────────────────────────Aggregation/Query
(מטמון, RBAC/RLS, מגבלות קצב)

אירועים: לפחות פעם אחת, סבא של ”event _ id/idempotency _ key”.

אגרגטים: רולופס מחושב מראש (1m/5m/1h/1d) + על-לטוס.

מנוע קוהורטה על גולד מארט.

CDN/edge + ETag/Cache-Control, TTL בצד השרת.

3) מודל אירוע: סטנדרט מינימלי

3. 1 שדות משותפים

ג 'סון
{
event_id":"uuid, ”event_type":"bet”. התיישבו, "occurred_at":"2025-10-23T16:21:05Z," ingested_at":"2025-10-23T16:21:06Z, "tenant_id":"brand-7," אזור ":" האיחוד האירופי "," player_id":"p_19f3, "//
trace_id":"tr_a1b2c3, ”schema_version":"1”. 3. 0, ”מטען”:
}

חוקים: UTC timestamps, "player _ id' - כינוי, כסף ביחידות שוליות.

3. 2 סוגי מפתחות

'Session. התחיל	סוף &fost
'bet. ממוקמים	( , , , )
"וואלט. חיוב	קרדיט (סיבה, reference_id)
"פאיימנט. כוונה	מורשה
"בונוס. הונפקה	נצרך
'rg. הגבלה. פגיעה	reality_check'
ורסיונינג - סמבר; מוסיף אופציונלי בלבד.

4) בליעה API (עבור מקורות צד שלישי)

שולח קבוצה של אירועים


פוסט/v1/אירועים:
כותרות: X-Idempotency-Key: ev_20251023_001
[
"event _ id':"..., "event _ type": "הימור. מיקם, ”...,” event _ id': ”...,” event _ type ”:” הימור. התיישב," -
]
▪ 202 ”מקובל”: 2, ”כפולים”: 0, ”trace_id":"tr_a1b2”

אחריות: לפחות פעם אחת; כפילויות מסוננות בכסף על ידי "אירוע _ id'.

5) צבירה API: סדרת זמן ופרוסות

5. 1 סידורי זמן (מדדי זמן)


GET/V1/Analytics/timeseries
מטרית = gr//ggr, ngr, dau, deposits_success, rtp
& גרנולריות = 5m//1m/5m/1h/1d
= = = 2025-10-22T00: 00: 00Z = = 2025-10-23T00: 00: 00Z
& מסננים = אזור: EU, מותג _ id: מותג-7, ספק _ id: studio _ x
& group _ by = brand _ id
→ 200 {
”מטרי”:” ggr”, ”גרנולריות”:” 5m”, ”סדרה”: [
"2025-10-22: 00-00Z", "brand _ id':" bund-7 "," value _ minor ": 120030," ts': "2025-10-22T00: 05: 00Z", "brand _ id':" bung-7 "," value _ minor ": 98020
], "next_cursor":null
}

5. 2 פרוסות/צמרות (קבוצה על ידי)


קבל/V1/אנליטיקה/פרוסה
metral = rtp & dim = game _ id = 2025-10-22 = 2025-10-23
& הגבלה = 50 הזמנה = - value
* 200 פריטים: [ * "game _ id':" g _ 01 "," ערך ": 0. 956},...] }

5. 3 משפכים


פוסט/V1/אנליטיקה/משפך
{
”צעדים ”: [
"אירוע ":" תשלום. כוונה "", "אירוע": "תשלום. מורשה "", "אירוע": "תשלום. נתפס "", "אירוע": "ארנק. אשראי, ”סיבה”: ”הפקדה”
], "window_sec": 3600 ", "פילטרים ": "אזור ":" EU"," brand _ id':" מותג-7 "
}
→ 200 {
”סך הכל”: 12450, ”צעדים”: [
”שם ”:” כוונה”, ”ספירה ”: 12450, ”קצב”: 1. 0. ”שם ”: ”מורשה”, ”ספירה ”: 11020, ”קצב”: 0. 885, ”שם ”: ”נתפס”, ”ספירה ”: 10110, ”קצב”: 0. 811, ”שם ”: ”קרדיט”, ”ספירה ”: 10050, ”קצב”: 0. 807}
]
}

5. 4 גבולות ומטמון

הגבלת קצב לסמל/מותג/אזור.

'Etag' לתגובות; ”אם-אף אחד לא תואם” תמיכה.

מטמון ה-TTL תלוי בגרנולריות (לדוגמה, 5m = TTL 60-120 S).

6) שימור וקוהורטות: כללים ו ־ API

6. 1 הגדרות (מוסכמות)

DAU/WAU/MAU: פעיל אם היה 'bet. במקום או בארנק. קרדיט (הפקדה) 'מושב'. התחיל ב-N דקות.

קוהורט על ידי הפקדה ראשונה (לרוב עבור LTV) או על ידי רישום (לצורך מעורבות).

שימור D1/D7/D30: הפרופורציה מהקוהורטה חזרה לחלון היום +/סובלנות על ידי אזור זמן מותג.

אנו בוחנים ביקורים חוזרים של "שחקן _ id' הייחודי בחלון.

6. 2 קוהורטות של API


פוסט/V1/אנליטיקה/שימור
{
”קוהורט”: ”פיקדון ראשון _”, ”start_date":"2025-09-01,” ”end_date":"2025-09-30,” ”return_event":"bet”. הונח, "ימים": [ 1,7,14,30 ], "מסננים": "אזור": "EU", "מותג _ id':" מותג-7 "
}
→ 200 {
”קוהורט ”: ”פיקדון ראשון _”, ”שורות ”: [
”cohort _ date”:” 2025-09-01 ”, ”גודל ”: 1820,” d1”: 0. 36, ”ד7”: 0. 22, ”d14”: 0. 18, ”d30”: 0. 12, ”cohort _ date”:” 2025-09-02 ”, ”גודל ”: 1714,” d1”: 0. 35, ”ד7”: 0. 23, ”d14”: 0. 19, ”d30”: 0. 13}
]
}

6. 3 LTV/מצטבר


לקבל V1/אנליטיקה/ltv? cohort = ראשית _ הפקדה & מטבע = EUR & אופק = 90d
* 200 "קוהורטס: " תאריך ":" 2025-09-01 "," ltv _ minor ":  0,150,230,280,...

7) סמנטיקה מטרית (לא להתווכח)

מדדים	הגדרה (תקציר)
GGR	סכום (יתד) - סכום (ניצחון) הימור ". התיישב בתקופה/מטבע
NGR	GGR - בונוס הוצאות תרומות לקופה
RTP	סכום (ניצחון )/סכום (יתד)
הפקדת הצלחה	נתפס/כוונה (גורם)
ליישב פיגור	T (מיושב) lt (ממוקם), אחוזון p95
Webhook lag	t (בלע) - (התרחש), p95
DAU/WAU/MAU	שחקנים פעילים ייחודיים על פי כללי פעילות

כל - ב UTC עם מטבע ויחידות משניות; רב-צורניות נפתרת על ידי המרת FX קבוע לאגם דאטה.

8) גרסה, מסננים ותאימות

נתיב: '/v1/... '; מדדים/שדות חדשים - אופציונליים.

”מותג _ id, אזור, provider_id, game_id, שיטה, מטבע, התקן, גיאו”.

Pagination: מבוסס על הסמן ("next _ corress').

שבירה של # רק '/v2 '+ דחייה/כותרות שקיעה וצ' אנגלוג.

9) ביטחון וגישה

OAuth2 Creadentials (אסימונים קצרי ימים), MTLS עבור B2B.

RBAC/ABAC: הרשאות מטריות/פרוסות; מסנן RLS על ידי ”מותג/אזור”.

API לא נותן PII, רק אגרגטים/פסאודו-זיהוי במקרה הצורך.

תושבות: ניתוב בקשות לאזור; מידע חוצה-אזור - אסור.

מגבלות קצב ומכסות, נגד ניצול; ביקורת תולעת של גישה.

10) SLO ויכולת תצפית

ספסל SLO:

GET/timesteries gran = 5M-95 ms 500-800, GET/פרוסה 95 (לכל היותר 50-100 עמדות), POST/Reservation (חודש של קוהורטות) P95 P3-5 S, רעננות: p95 more 2-5 mining from 'case _ at.
מטריות: latency p50/p95/p99, שגיאה-קצב (4xx/5xx), מטמון-להיט, בקשות/סריקה bytes (OLAP), פיגור רעננות לכל רולופ.
יומנים: "trace _ id', מסנני שאילתה (ללא PII), ספירת סריקה.

11) מזומן, חישובים ראשוניים, עלות

גלגול טבלאות: 1m/5m/1h/1d על ידי מדדי מפתח * fast 'timeseries ".

נופים ממומשים עבור חלקים כבדים/קוהורטות.

ETag + max-age; נכות באירועים מאוחרים מתרחשת באופן הדרגתי.

אסטרטגיה ”חם/קר”: שאילתות חמות - OLAP-מחסן; ארכיון - באגם.

הגבלה של ”סרוק בייטים” לכל בקשה; רמזים ללוח הזמנים.

12) מוטבע וייצוא

וידג 'טים מובנים באמצעות URL/iFrame חתומים עם אסימוני RLS.

ייצוא CSV/Parquet על ידי משימה (עבודה API) עם אילוצים בגודל והפניות זמניות.

הודעת Webhook על המוכנות של העלאת.

13) רשימות בדיקה

ארכיטקטורה

[ סכימת האירועים המאוחדים ], סמבר, רישום; סבא של "אירוע _ id'.

[ ] של רולופ ומומש צפיות למקרים עליונים.

[ ] RLS/RBAC/ABAC, תושבות, אסימונים קצרי ימים.

[ ] מטמון (ETag/TTL), מגבלות דירוג, מכסות.

סמנטיקה

[ ] הגדרות GGR/NGR/RTP/DAU/reservation מתועדות.

[ ] מטבעות - יחידות שוליות; FX קבוע בזמן האירוע.

[ ] שימור על ידי UTC, לוקח בחשבון את זמן המותג בתצוגה.

פעולות

[ ] SLO/רעננות ולוחות מחוונים.

[ ] ביקורת תולעת של גישה/יצוא.

[ ] תרגילי DR/xaoc:

14) אנטי דפוסים (דגלים אדומים)

שולחנות OLTP ”גולמיים” ניתנים ישירות ל-API.

הגדרות מטריות לא עקביות בין פקודות.

אין כפילות וסימני מים = אירועים כפולים/אבודים.

ללא הגבלה על מעוף צבירה ללא מטמון/מכסות = בקשות יקרות ואיטיות.

צבירה של אזור ללא מדיניות תושבות.

החזר פרטי PII/שחקן לתגובות הציבור.

שוברים-שינויים שקטים ללא '/v2 'ו-Deprection.

15) מפרט מיני (TL; DR)

אירועים: '/v1/אירועים: אצווה '(לפחות-פעם אחת, dedup by' event _ id').

Timeseries: '/v1/analytics/timeseries? (rollup + cloud).

פרוסות: '/v1/אנליטיקה/פרוסה? מטרי = & dim = "...

משפכים: '/v1/אנליטיקה/משפך '(חלון, שלבים, מסננים).

שימור/קוהורטות: '/v1/אנליטיקה/שימור '(+ LTV).

אבטחה: OAuth2 + mTLS, RLS, אסימונים לכל מותג/אזור, ביקורת תולעת.

פ-95 פלוס 0. 5-2 אס; רעננות בריבית של 2-5 דקות.

סטטיסטיקה ואנליטיקה API אינם ”SELECT FROM, big_table” אלא חוזה של מדדים: אירועים יציבים, קראה מראש ואגרגטים מטופחים, שמירה מוגדרת לחלוטין, אבטחה (RLS/RBAC) ותושבות מובנת על ידי SLO. אז אתם נותנים נתונים במהירות, בזול ובצפוי - לשותפים, מוצר ודו-מיני - ללא פרשנויות שנויות במחלוקת וללא סיכון לדליפה או עומס אחסון.