Ανάλυση και μέτρηση API

1) Γιατί ένα ξεχωριστό στρώμα API

Ενιαία αλήθεια για τον KPI: εξαιρούνται οι «ζωολογικοί κήποι SQL».
Ταχύτητα προϊόντος: μέτωπα, πίνακες εταίρων, πελάτες κινητής τηλεφωνίας αποκτούν συγκεντρωτικά στοιχεία χωρίς άμεση πρόσβαση σε DWH.
Ασφάλεια και συμμόρφωση: Μαρκινοποίηση, μάσκες, γεωγραφικοί περιορισμοί, φίλτρα RG/AML.
Κλιμάκωση: κρύπτη, προνόμια, CDN, σταθερές συμβάσεις.

2) Ταξινόμηση: μετρήσεις, διαστάσεις, γεγονότα

Γεγονότα: στοιχήματα, κέρδη, καταθέσεις, εκδηλώσεις KYC, παρεμβάσεις της RG.
Διαστάσεις: ημερομηνία/ώρα (ημερολόγια), παιχνίδι/πάροχος, εμπορικό σήμα/χώρα, κανάλι/συσκευή, παίκτης (σύμβολο).
Μετρήσεις: GGR, NGR/NET, ARPPU, διατήρηση D1/D7/D30, συχνότητα καταθέσεων, FPR κατά της απάτης, κίνδυνος RG.
Μονάδες: νόμισμα (FX), χρόνος (TZ), όγκος/μετρητές (idempotent!).
Σημασιολογία KPI: ορισμοί στις συμβάσεις BI, οι εκδόσεις KPI είναι σταθερές.

3) Συμβάσεις δεδομένων & ΔΙ

Σχήμα: πεδία, τύποι, εκμηδενίσιμα, enum, μονάδες, νομίσματα.
Σημασιολογία των μετρήσεων: φόρμουλα, πηγές, παράθυρα συγκέντρωσης, φίλτρα.
Συμβατότητα (SEMVER): MAJOR διαλείμματα, MINOR προσθέτει πεδία, PATCH διορθώσεις.
DQ/SLA: φρεσκάδα, πληρότητα, συνέπεια, ανοχές απόκλισης.
Privacy: 'pii: false', 'mokenized: true', απαγόρευση της αποτοξίνωσης.

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 (επιγραμμική συγκέντρωση πάνω από «χρυσό «/κύβους/fichestore).
Precompute API (προγραμματισμένοι prerenders, υλοποιημένες απόψεις).
Συμβάντα API (μετρητές ροής/σήματα).
Εξαγωγές API (υπογεγραμμένα uploads, WORM για έλεγχο).
Cache: in-memory → Redis → CDN, key = query hash + version.
Συνέπεια: διαβάζει-σας-γράφει για τις τελικές ηχογραφήσεις, SLA φρεσκάδα για τα συγκεντρωτικά στοιχεία.

5) Διεπαφή και αιτήματα

5. 1 Φίλτρα/συγκεντρώσεις/παράθυρα

'filter': κλίμακες ημερομηνιών ('από/προς' UTC, γνωρίζοντας χρονική ζώνη), χώρες, εμπορικά σήματα, παιχνίδια, κανάλια, συσκευές.
'group _ by': διαστάσεις.
'metrics': κατάλογος των KPI.
'window': 'DAY' WEEK 'MONTH' ROLLING _ 7 ROLLING _ 28D '.
'currency': 'reporting' native ', FX strategy:' eo intaday 'txn'.
«δειγματοληψία»: για σοβαρά ερωτήματα (μόνο εφόσον επιτρέπεται).

5. Παράδειγμα αίτησης

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) Σελιδοποίηση, όρια, διαλογή

Pagination: 'όριο' (≤10k), 'δρομέας' (αδιαφανές), διαλογή κατά διαστάσεις/ημερομηνία.
Χρονοδιάγραμμα/μερική: μερικές απαντήσεις μόνο για μη χρηματοοικονομικούς ΚΔΕ. χρηματοδότηση - είτε P200 είτε P504.
Όρια επιτοκίου: παγκόσμιο/κατά κλειδί/ανά ενοικιαστή· Η απάντηση περιέχει 'X- Limit-'.

7) Ιδιαιτερότητα και μνήμη

Idempotent GET/POST-read (με το σώμα) με 'Idempotency-Key'.
Κλειδί κρύπτης = hash (παράμετροι + έκδοση σχήματος + ρόλος/ενοικιαστής/geo).
TTL: εξαρτώμενος από τον KPI (π.χ. «PT15M» για έσοδα, «PT5M» για εκδηλώσεις), επαναφορά με νέο στιγμιότυπο.

8) Συνέπεια και νόμισμα του χρόνου

Σημαία χρονοδιαδρόμου για αναδρομικές εκθέσεις (εκδόσεις δεδομένων).
Κανόνες διακοπής (λήξη ημέρας/εβδομάδας).
FX: καθορίζουμε τη στρατηγική, την ημερομηνία μαθημάτων στην απάντηση.
Ρολόι: όλες οι χρονοσφραγίδες είναι ISO-8601, απαιτείται TZ.

9) Ασφάλεια και ιδιωτικότητα

. 3, υπογραφή HMAC του φορέα αίτησης/απάντησης (MITM/προστασία αναπαραγωγής).
RBAC/ABAC/ReBAC: ρόλος + χώρα + εμπορικό σήμα + σκοπός· προεπιλεγμένες μάσκες.
Πολυπληθής - απομονωμένα σχήματα/κλειδιά/ποσοστώσεις.
Προσδιορισμός σημείων αναγνώρισης. Απαγόρευση PII στις απαντήσεις.
Έλεγχος: αμετάβλητα αρχεία καταγραφής αιτήσεων (WORM), «trace _ id »/« actor »/« σκοπός».
Συναίνεση/DSAR: φίλτρα για χαρακτηριστικά εμπορίας. σημαία που έχει διαγραφεί από το υποκείμενο.

10) RG/AML/Αντιφρακτικά περιορισμού

πολιτικές RG: απαγόρευση έκδοσης «επιθετικών» δεικτών για τμήματα υψηλού κινδύνου· οι μονάδες είναι ασφαλείς.
AML/Antifraud: περιορισμένη πρόσβαση σε ευαίσθητους KPI, ανά περιοχή, χωριστά τελικά σημεία για τις έρευνες.
Επεξήγηση: λεξικό επεξηγήσεων του KPI/σήματα υποστήριξης.

11) Παρατηρησιμότητα και SLO API

SLO: p95 καθυστέρηση (για παράδειγμα, ≤ 300 ms για επιτυχίες στην κρύπτη, ≤ 2 s για βαριά), ποσοστό επιτυχίας ≥ 99. 5%.
DQ: φρεσκάδα/πληρότητα/ακεραιότητα· ετικέτες στην απάντηση.
Χρήση: QPS, cache hit-rate, hot keys, σφάλματα επικύρωσης.
Συναγερμοί: υποβάθμιση της φρεσκάδας, ανάπτυξη 4xx/5xx, ανωμαλίες σύμφωνα με τον KPI (απροσδόκητα μηδενικά/κορυφές).
Εντοπισμός: 'trace _ id' end-to-end to DWH/fichestore.

12) Έκδοση και συμβατότητα

Διαδρομές: '/v1 ', '/v2', απορρίπτονται με παράθυρο μετανάστευσης.
Σχήμα: 'schema _ version' σε απάντηση. MAJOR Οδηγοί μετανάστευσης διπλής ανάγνωσης.
Εκδόσεις KPI: στην απάντηση 'kpi _ ορισμούς' με σύνδεσμο στον κατάλογο. Αποτροπή κρυμμένων αλλαγών φόρμουλας.

13) Σφάλματα και καταστάσεις

'400' επικύρωση (ανύπαρκτος συνδυασμός μέτρησης/μέτρησης/φίλτρου).
'401/403' authentication/εξουσιοδότηση.
'409' μετάφραση/ασυμβίβαστο πολιτικής.
'422' παραβίαση του δικαιώματος προαίρεσης/συγκατάθεσης.
'429' ποσοστώσεις.
'5xx' platform failures (trace_id και retrip seq.).

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

14) Ολοκλήρωση και διεπαφές

BI: Προκαθορισμένα σημασιολογικά μοντέλα, συνδετήρες (Looker/Power BI/Tableau) → API ως πηγή.
ML: ελαφρά τελικά σημεία για μονάδες χαρακτηριστικών (σημείο σε χρόνο, χωρίς PII).
Εταίροι: περιορισμένα κλειδιά/ποσοστώσεις, γεωγραφικά φίλτρα, εκθέσεις μόνο σε συγκεντρωτικά τμήματα.
Webhook/Push: ειδοποιήσεις «στιγμιότυπο έτοιμο», «σπασμένο εύρος SLO/KPI».

15) Παραδείγματα τελικών σημείων των πόρων

15. 1 Έσοδα/Απόδοση

'POST/v2/μετρήσεις/έσοδα' → GGR/NGR, στοιχήματα/νίκες, μετρούμενα με 'ημερομηνία, μάρκα, χώρα, πάροχος, παιχνίδι'.

15. 2 Κατακράτηση και χοάνες

'POST/v2/μετρήσεις/κατακράτηση' → когорты D1/D7/D30, 'group _ by = [cohort _ week, brand, country]'.

15. 3 Πληρωμές

'POST/v2/μετρήσεις/πληρωμές' → καταθέσεις/αναλήψεις, μέσος έλεγχος, επιτόκιο χρέωσης.

15. 4 Υπεύθυνο παιχνίδι

'POST/v2/metrics/rg' → αριθμός παρεμβάσεων, αναλογία υψηλού κινδύνου, μέσος χρόνος αντίδρασης.

15. ΑντιράδιοCity name (optional, probabl

'POST/v2/metrics/antifrau FPR/TPR, περιπτώσεις, αποφυγή ζημιών.

16) Έλεγχος και ποιότητα

Δοκιμές σύμβασης: enum/nullable/type, νόμισμα/ζώνη ώρας.
Δοκιμές DQ: έλεγχος των εύρους τιμών, μονοτονία και ακεραιότητα.
v1/v2 σύγκριση των ανοχών.
Φορτίο: προφίλ αιχμής (τουρνουά/εκδηλώσεις παρόχου).
Ασφάλεια: υπογραφές, αντι-αναπαραγωγή, ασαφή αιτήματα, Zero-PII σε αρχεία καταγραφής.

17) Προστασία της ιδιωτικής ζωής εξ ορισμού

Συγκεντρωτικά μεγέθη με κατώτατα όρια «ελάχιστων N εγγραφών» (k-ανωνυμία).
Δεν υπάρχουν ακατέργαστοι αναγνωριστικοί κωδικοί. μόνο μάρκες/κατηγορίες.
DSAR: API για εκφόρτωση/διαγραφή μέσω συμβολοσειράς μέσω προνομιακού βρόχου.

18) Μετρήσεις επιτυχίας (API KPI)

Έγκριση: Αναλογία εκθέσεων/γραφικών συστατικών που χρησιμοποιούν API και όχι απευθείας SQL.
Συνέπεια - απόκλιση μεταξύ της ΔΙ και της ανοχής ≤ API.
SLO: συμμόρφωση με την καθυστέρηση/επιτυχία/φρεσκάδα.
Ασφάλεια: μηδενικές περιπτώσεις PII σε απαντήσεις/αρχεία καταγραφής.
Κόστος: ποσοστό επιτυχίας της μνήμης, κόστος της αίτησης,% των προνομιούχων.

19) RACI (παράδειγμα)

Προϊόν/Ανάλυση (A) - Ορισμοί, απαιτήσεις του KPI.
Πλατφόρμα δεδομένων (R) - εφαρμογή, κρύπτη, SLA, παρατηρησιμότητα.
Ιδιοκτήτες τομέα (R) - Πηγές/συμβάσεις.
Ασφάλεια/ΥΠΔ (A/R) - προστασία της ιδιωτικής ζωής, πρόσβαση, έλεγχοι.
SRE (R) - ποσοστώσεις, αυτοκλίμακα, περιστατικά.
Χρηματοδότηση (Γ) είναι η χρηματοοικονομική σημασιολογία της GGR/NGR/NET.

20) Χάρτης πορείας για την εφαρμογή

0- 30 ηµέρες (MVP)

1. Επιλογή 3-5 KPI (GGR, καταθέσεις, διατήρηση D7).
2. Περιγράψτε τις συμβάσεις και τη σημασιολογία του KPI. Ενεργοποίηση DQ/SLA.
3. Εφαρμογή '/v1 'API + cache + mTLS/HMAC.
4. Ταμπλό SLO (καθυστέρηση/επιτυχία/φρεσκάδα), έλεγχος/ίχνος _ id.

30- 90 ηµέρες

1. Precompute popular storefronts, CDN cache.
2. Έκδοση '/v2 ', οδηγός μετανάστευσης διπλής ανάγνωσης.
3. Εξαγωγή API με υπογεγραμμένα uploads και WORM.
4. Ενσωμάτωση με ΔΙ/ML. ποσοστώσεις/ενοικιαστές/γεωαπομονωτές.

3-6 μήνες

1. Ολοκλήρωση της ταξινομίας KPI και της βιβλιοθήκης γραφικών συστατικών.
2. Έξυπνες άκρες/φίλτρα αυτόματης συμπλήρωσης, χιτώνιο ερωτήσεων.
3. Αυτόματες σημειώσεις απελευθέρωσης KPI, έλεγχος ανοχών v1/v2.
4. Εξωτερικός βρόχος εταίρων με περιορισμένα κλειδιά και πολιτικές RG.

21) Αντι-μοτίβα

Κρυμμένη αλλαγή τύπου KPI χωρίς νέα έκδοση και σημειώσεις έκδοσης.
Επιστροφή PII/πρώτων υλών αντί για συγκεντρωτικά στοιχεία/μάρκες.
Η έλλειψη κρύπτης/προλήψεων → δαπανηρή και αργή.
Σκληρή σύνδεση σε μια συγκεκριμένη βάση δεδομένων (χωρίς αφαίρεση στρώματος).
Ασυνεπείς αριθμοί TZ/FX → διαφορετικοί.
Δεν υπάρχουν όρια δασμού/ποσοστώσεις → «DDOS».

22) Υποδείγματα (έτοιμα προς χρήση)

22. 1 Πολιτική SLO API (snippet)

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 (snippet)

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 Κατάλογος αποδέσμευσης

• Επικαιροποιημένη σημασιολογία KPI και αναβάθμιση έκδοσης
• Σύμβαση/σχήμα στον κατάλογο? Δοκιμές παλινδρόμησης/παλινδρόμησης πράσινες
• Πλήκτρα κρύπτης/TTL, προνόμια ρυθμισμένα
• Τεκμηρίωση και δειγματοληπτικές αιτήσεις/απαντήσεις
• Περιλαμβανόμενες καταχωρίσεις SLO και ποσοστώσεων
• Περιορισμοί RG/AML που ελέγχθηκαν

23) Συναφή τμήματα

Πρακτικές DataOps, έλεγχος και έκδοση, ασφάλεια και κρυπτογράφηση, έλεγχος πρόσβασης, τοκετός δεδομένων, πολιτικές διατήρησης, προέλευση δεδομένων και διαδρομή, MLOp: εκμετάλλευση μοντέλων, δεοντολογία δεδομένων.

Σύνολο

Τα API ανάλυσης και μέτρησης είναι ένα συμβατικό, ασφαλές και γρήγορο στρώμα πρόσβασης σε δεδομένα χρυσού και KPI. Εγγυάται ομοιόμορφη σημασιολογία, σταθερές εκδόσεις, προεπιλεγμένη προστασία της ιδιωτικής ζωής και επιδόσεις σε επίπεδο προϊόντος - από εσωτερικά ταμπλό έως πίνακες εταίρων και ML.