एनालिटिक्स और मेट्रिक्स एपीआई

1) एक अलग एपीआई परत क्यों

केपीआई के लिए एकल सत्य: "चिड़ियाघर एसक्यूएल" को बाहर करना।

उत्पाद गति: मोर्चे, साझेदार पैनल, मोबाइल ग्राहकों को DWH तक सीधे पहुंच के बिना समुच्चय मिलता है।

सुरक्षा और अनुपालन: टोकन, मुखौटे, भू-प्रतिबंध, आरजी/एएमएल फिल्टर।

स्केलिंग: कैश, प्रदाता, सीडीएन, स्थिर अनुबंध।

2) वर्गीकरण: मैट्रिक्स, आयाम, तथ्य

तथ्य: दांव, जीत, जमा, केवाईसी घटनाएं, आरजी हस्तक्षेप।

आयाम: तिथि/समय (पंचांग), खेल/प्रदाता, ब्रांड/देश, चैनल/उपकरण, खिलाड़ी (टोकन)।

मेट्रिक्स: GGR, NGR/NET, ARPPU, D1/D7/D30 प्रतिधारण, जमा आवृत्ति, धोखाधड़ी विरोधी FPR, RG जोखिम।

इकाइयाँ: मुद्रा (एफएक्स), समय (टीजेड), वॉल्यूम/काउंटर (पहचान!)।

KPI शब्दार्थ: BI अनुबंधों में परिभाषाएँ, KPI संस्करण तय हैं।

3) डेटा और द्वि अनुबंध

स्कीमा: क्षेत्र, प्रकार, शून्य, एनम, इकाइयाँ, मुद्राएं।

मैट्रिक्स के शब्दार्थ: सूत्र, स्रोत, एकत्रीकरण खिड़कियां, फिल्टर।

संगतता (SEMVER): मेजर ब्रेक, MINTER जोड़ ता है क्षेत्र, PATCH सुधार।

DQ/SLA: ताजगी, पूर्णता, स्थिरता, विसंगति सहिष्णुता।

गोपनीयता: 'पिई: गलत', 'टोकन: सच', डिटोकेनाइजेशन का निषेध।

yaml api: analytics. v2 resource: /metrics/revenue kpi: GGR schema_version: 2. 1. 0 dimensions: [date, brand, country, provider, game]
metrics: [ggr, stakes, wins, bets_count]
sla: {freshness: PT15M, completeness: ">=99. 9%"}
privacy: {pii: false, tokenized: true}

4) वास्तुकला

क्वेरी एपीआई ("गोल्ड "/क्यूब्स/फिचेस्टोर पर ऑनलाइन एकत्रीकरण)।

प्रीकॉम्प्यूट एपीआई (अनुसूचित प्रदाता, भौतिक विचार)।

इवेंट एपीआई (स्ट्रीम काउंटर/सिग्नल)।

निर्यात API (हस्ताक्षरित अपलोड, ऑडिट के लिए WORM)।

कैश: इन-मेमोरी → Redis → CDN, कुंजी = क्वेरी हैश + संस्करण।

स्थिरता: अंतिम रिकॉर्डिंग के लिए रीड-योर-राइट्स, समुच्चय के लिए एसएलए ताजगी।

5) इंटरफ़ेस और अनुरोध

5. 1 फ़िल्टर/एकत्रीकरण/विंडो

'फिल्टर': डेट रेंज ('से/' UTC, टाइमज़ोन जागरूक), देश, ब्रांड, गेम, चैनल, डिवाइस।

'ग्रुप _ बाय': आयाम।

'मेट्रिक्स': केपीआई की सूची।

'Window': 'DAY' WEEK 'MONTH' ROLING _ 7D 'ROLLING _ 28D'।

'क्यूरेंसी': 'रिपोर्टिंग' नेटिव ', FX रणनीति:' eod 'intraday' txn '।

'sampling': भारी प्रश्नों के लिए (केवल जहां अनुमति दी गई)।

5. 2 निवेदन उदाहरण

json
POST /v2/metrics/revenue
{
"range": {"from":"2025-10-01","to":"2025-10-31","tz":"Europe/Kyiv"},
"group_by": ["date","brand","country"],
"metrics": ["ggr","bets_count","net_revenue"],
"filters": {"country":["EE","LT","LV"],"brand":["alpha","beta"]},
"currency": "reporting",
"window": "DAY"
}

5. 3 प्रतिक्रिया का उदाहरण

json
{
"schema_version":"2. 1. 0",
"kpi_definitions":["ggr@1. 7. 0","net_revenue@1. 3. 2"],
"range":{"from":"2025-10-01","to":"2025-10-31","tz":"Europe/Kyiv"},
"data":[
{"date":"2025-10-01","brand":"alpha","country":"EE","ggr":12450. 72,"bets_count":182342,"net_revenue":10732. 11},
{"date":"2025-10-01","brand":"beta","country":"EE","ggr":...}
],
"fx":{"strategy":"eod","rate_date":"2025-10-31"},
"dq":{"freshness_sec":420,"completeness":0. 9992},
"trace_id":"3d1a-...-c79"
}

6) पृष्ठभूमि, सीमा, छंटाई

पृष्ठभूमि: 'सीमा' (≤10k), 'कर्सर' (अपारदर्शी), आयाम/तिथि द्वारा छंटाई।

टाइमआउट/आंशिक: केवल गैर-वित्तीय केपीआई के लिए आंशिक प्रतिक्रियाएं; वित्त - या तो P200 या P504।

दर सीमा: वैश्विक/कुंजी/किरायेदार द्वारा; प्रतिक्रिया में 'एक्स-रेटलिमिट-' शामिल है।

7) आइडेम्पोटेंस और कैश

Idempotency-Key के साथ Idempotency GET/POST-read (बॉडी के साथ)।

कैश कुंजी = हैश (पैरामीटर + स्कीमा संस्करण + भूमिका/किरायेदार/भू)।

टीटीएल: केपीआई-निर्भर (उदा। राजस्व के लिए 'PT15M', घटनाओं के लिए 'PT5M'), नए स्नैपशॉट के साथ रीसेट करें।

8) समय की स्थिरता और मुद्रा

पूर्वव्यापी रिपोर्ट (डेटा संस्करण) के लिए समय-यात्रा ध्वज।

कट-ऑफ नियम (दिन/सप्ताह बंद)।

FX: हम रणनीति को ठीक करते हैं, उत्तर में पाठ्यक्रम की तारीख।

घड़ी: सभी टाइमस्टैम्प हैं ISO-8601, TZ की आवश्यकता है।

9) सुरक्षा और गोपनीयता

mTLS/TLS1। 3, अनुरोध/प्रतिक्रिया निकाय के एचएमएसी हस्ताक्षर (एमआईटीएम/रीप्ले संरक्षण)।

RBAC/ABAC/ReBAC: भूमिका + देश + ब्रांड + उद्देश्य; डिफ़ॉल्ट मास्क।

मल्टी-किरायेदार - आइसोलेट स्कीमा/कुंजी/कोटा।

पहचानकर्ताओं का टोकन; प्रतिक्रियाओं में पीआईआई निषेध।

लेखा परीक्षा: अपरिवर्तनीय अनुरोध लॉग (WORM), 'ट्रेस _ id '/' कर्ता '/' उद्देश्य'.

सहमति/डीएसएआर: विपणन विशेषताओं पर फिल्टर; "विषय मिटा" ध्वज।

10) आरजी/एएमएल/प्रतिबंध एंटीफ्रोड

आरजी-नीतियां: उच्च जोखिम वाले खंडों के लिए "आक्रामक" संकेतक जारी करने का निषेध; इकाइयाँ सुरक्षित हैं।

एएमएल/एंटीफ्राड: संवेदनशील केपीआई तक सीमित पहुंच, भूमिका द्वारा ज़ोनिंग; जांच के लिए अलग अंत बिंदु।

व्याख्यात्मकता: समर्थन के लिए केपीआई/संकेतों के स्पष्टीकरण का शब्दकोश।

11) अवलोकन और एसएलओ एपीआई

SLO: p95 विलंबता (उदाहरण के लिए, कैश हिट के लिए ≤ 300 ms; भारी के लिए ≤ 2 s), सफलता-दर ≥ 99। 5%.

डीक्यू: ताजगी/पूर्णता/अखंडता; प्रतिक्रिया में लेबल।

उपयोग: QPS, कैश हिट-रेट, हॉट कुंजी, सत्यापन त्रुटियां।

अलर्ट: ताजगी का क्षरण, विकास 4xx/5xx, KPI (अप्रत्याशित शून्य/चोटियों) के अनुसार विसंगतियाँ।

ट्रेसिंग: DWH/fichestore पर 'trace _ id' एंड-टू-एंड।

12) वर्शनिंग और संगतता

पथ: '/v1 ', '/v2'; माइग्रेशन विंडो के साथ पदावनत करें।

स्कीमास: 'schema _ version' जवाब में; मेजर → डुअल-रीड, माइग्रेशन गाइड।

केपीआई संस्करण: निर्देशिका में लिंक के साथ प्रतिक्रिया 'केपीआई _ परिभाषाओं' में; छिपे हुए सूत्र परिवर्तनों को रो

13) त्रुटियां और स्टेटस

'400' validation (गैर-मौजूद मीट्रिक/माप/फ़िल्टर संयोजन)।

'401/403' authentication/प्राधिकरण।

'409' version/पॉलिसी असंगति।

'422' की सहमति/सहमति उल्लंघन।

'429' कोटा।

'5xx' platform विफलताएं (trace_id और पुन: प्रयास seq।)।

json
{
"error":"VALIDATION_FAILED",
"message":"Unknown metric: ngrx",
"hint":"metrics allowed: ggr, net_revenue,...",
"trace_id":"..."
}

14) एकीकरण और इंटरफेस

द्वि: पूर्व-वर्णित शब्दार्थ मॉडल, कनेक्टर (लुकर/पावर बीआई/झांकी) → एपीआई एक स्रोत के रूप में।

एमएल: फीचर इकाइयों के लिए हल्के एंडपॉइंट (PII के बिना पॉइंट-इन-टाइम)।

भागीदार: सीमित कुंजी/कोटा, भू-फिल्टर, केवल कुल ब्लॉकों में रिपोर्ट करते हैं।

वेबहुक/पुश: सूचनाएं "स्नैपशॉट रेडी", "टूटी हुई एसएलओ/केपीआई रेंज"।

15) संसाधन समापन बिंदुओं के उदाहरण

15. 1 राजस्व/वापसी

'POST/v2/metrics/revenue' → GGR/NGR, दांव/जीत, 'तिथि, ब्रांड, देश, प्रदाता, गेम' द्वारा मापा जाता है।

15. 2 प्रतिधारण और फ़नल

'POST/v2/metrics/retention' → когорты D1/D7/D30, 'group _ by = [cohort _ week, brand, cand]'।

15. 3 भुगतान

'POST/v2/metrics/paments' → जमा/निकासी, औसत जाँच, चार्जबैक दर।

15. 4 ज़िम्मेदार गेमिंग

'POST/v2/metrics/rg' हस्तक्षेप की संख्या, उच्च जोखिम का अनुपात, औसत प्रतिक्रिया समय।

15. 5 एंटीफ्राड

'POST/v2/metrics/antifraud' → FPR/TPR, मामले, नुकसान को रोका गया।

16) परीक्षण और गुणवत्ता

अनुबंध परीक्षण: enum/nullable/type, मुद्रा/समय क्षेत्र स्थिरता।

डीक्यू परीक्षण: पर्वतमाला, एकरसता और अखंडता का नियंत्रण।

प्रतिगमन: सहिष्णुता पर v1/v2 की तुलना।

लोड: पीक प्रोफाइल (टूर्नामेंट/प्रदाता घटना)।

सुरक्षा: लॉग में हस्ताक्षर, एंटी-रीप्ले, फजिंग अनुरोध, जीरो-पीआईआई।

17) डिफ़ॉल्ट रूप से गोपनीयता

"न्यूनतम एन रिकॉर्ड" (के-गुमनामी) के थ्रेसहोल्ड के साथ एकत्र होता है।

कोई कच्चे पहचानकर्ता नहीं; टोकन/श्रेणियां केवल।

DSAR: एक विशेषाधिकार प्राप्त लूप के माध्यम से टोकन द्वारा उतारने/हटाने के लिए API।

18) सफलता मेट्रिक्स (एपीआई केपीआई)

गोद लेना: प्रत्यक्ष SQL के बजाय API का उपयोग करके रिपोर्ट/विजेट का अनुपात।

संगति - द्वि और सहिष्णुता के बीच विसंगति ≤ एपीआई।

एसएलओ: विलंबता/सफलता/ताजगी का अनुपालन।

सुरक्षा: प्रतिक्रियाओं/लॉग में शून्य पीआईआई मामले।

लागत: कैश की हिट-दर, अनुरोध की लागत, प्रदाताओं का%।

19) RACI (उदाहरण)

उत्पाद/एनालिटिक्स (ए) - केपीआई परिभाषाएं, आवश्यकताएं।

डेटा प्लेटफ़ॉर्म (आर) - कार्यान्वयन, कैश, एसएलए, अवलोकन।

डोमेन मालिक (आर) - स्रोत/अनुबंध।

सुरक्षा/डीपीओ (ए/आर) - गोपनीयता, पहुंच, ऑडिट।

एसआरई (आर) - कोटा, ऑटोस्केल, घटनाएं।

वित्त (C) GGR/NGR/NET का वित्तीय शब्दार्थ है।

20) कार्यान्वयन रोडमैप

0-30 दिन (एमवीपी)

1. 3-5 केपीआई (जीजीआर, जमा, प्रतिधारण डी 7) चुनें।

2. अनुबंध और केपीआई शब्दार्थ का वर्णन करें; DQ/SLA सक्षम करें।

3. '/v1 'क्वेरी एपीआई + कैश + एमटीएलएस/एचएमएसी लागू करें।

4. एसएलओ डैशबोर्ड (विलंबता/सफलता/ताजगी), ऑडिट/ट्रेस _ आईडी।

30-90 दिन

1. लोकप्रिय स्टोरफ्रंट, सीडीएन कैश।

2. वर्शनिंग '/v2 ', डुअल-रीड, माइग्रेशन गाइड।

3. हस्ताक्षरित अपलोड और WORM के साथ API निर्यात करें।

4. बीआई/एमएल के साथ एकीकरण; कोटा/किरायेदार/भू-आइसोलेटर।

3-6 महीने

1. केपीआई टैक्सोनॉमी और विजेट लाइब्रेरी को पूरा करें।

2. स्मार्ट टिप्स/स्वतः पूर्ण फिल्टर, क्वेरी लिंटर।

3. स्वचालित रिलीज नोट्स केपीआई, सहिष्णुता v1/v2 का नियंत्रण।

4. प्रतिबंधित कुंजी और आरजी नीतियों के साथ बाहरी साझेदार लूप।

21) एंटी-पैटर्न

नए संस्करण और रिलीज नोट्स के बिना छिपा केपीआई सूत्र बदलता है।

समुच्चय/टोकन के बजाय पीआईआई/कच्चे माल की वापसी करें।

कैश/प्रदाताओं की कमी - महंगी और धीमी।

किसी विशिष्ट डेटाबेस में हार्ड बाइंडिंग (कोई परत अमूर्त नहीं)।

असंगत TZ/FX → असमान संख्या।

कोई दर सीमा/कोटा नहीं → "डीडीओएस खुद।"

22) साँचा (उपयोग करने के लिए तैयार)

22. 1 एसएलओ एपीआई नीति (स्निपेट)

yaml api: analytics. v2 slo:
p95_latency_ms: 300 success_rate: 0. 995 freshness_sec_max: 900 quotas:
per_key_qps: 50 burst: 200 privacy:
min_group_size: 25 pii_in_response: false

22. 2 OpenAPI (स्निपेट)

yaml paths:
/v2/metrics/revenue:
post:
requestBody:
content:
application/json:
schema: {$ref: '#/components/schemas/RevenueQuery'}
responses:
'200': {description: 'OK', content: {application/json: {schema: {$ref:'#/components/schemas/RevenueResponse'}}}}
'422': {description:'Privacy/Consent violation'}

22. 3 रिलीज़ चेकलिस्ट

• केपीआई शब्दार्थ अद्यतन और संस्करण उन्नत
• कैटलॉग में संविदा/स्कीमा; डीक्यू/प्रतिगमन परीक्षण हरा
• कैश कुंजी/टीटीएल, प्रदाताओं को कॉन्फ़िगर किया गया
• प्रलेखन और नमूना अनुरोध/प्रतिक्रियाएँ
• एसएलओ और कोटा अलर्ट शामिल
• आरजी/एएमएल बाधाओं का परीक्षण किया

23) संबंधित अनुभाग

डेटाऑप्स प्रैक्टिस, ऑडिट और वर्शनिंग, सिक्योरिटी एंड एन्क्रिप्शन, एक्सेस कंट्रोल, डेटा टोकन, रिटेंशन पॉलिसी, डेटा ओरिजिन एंड पाथ, एमएलओपी: मॉडल एक्सप्लोरेशन, डेटा एथिक्स।

कुल

एनालिटिक्स और मैट्रिक्स एपीआई सोने के डेटा और केपीआई तक पहुंच की एक अनुबंधित, सुरक्षित और तेज परत है। यह आंतरिक डैशबोर्ड से लेकर पार्टनर पैनल और एमएल तक एक समान शब्दार्थ, स्थिर संस्करण, डिफ़ॉल्ट गोपनीयता और उत्पाद-स्तर के प्रदर्शन की गारंटी देता है।