분석 및 메트릭 API
1) 별도의 API 계층
KPI의 단일 진실: "zoo SQL" 을 제외하십시오.
제품 속도: 전면, 파트너 패널, 모바일 고객은 DWH에 직접 액세스하지 않고 집계를받습니다.
보안 및 준수: 토큰 화, 마스크, 지리 제한, RG/AML 필터.
스케일링: 캐시, 프레이더, CNC, 안정적인 계약.
2) 분류: 지표, 치수, 사실
사실: 베팅, 상금, 예금, KYC 이벤트, RG 중재.
차원: 날짜/시간 (달력), 게임/제공자, 브랜드/국가, 채널/장치, 플레이어 (토큰).
측정 항목: GGR, NGR/NET, ARPPU, D1/D7/D30 보유, 예금 빈도, 사기 방지 FPR, RG 위험.
단위: 통화 (FX), 시간 (TZ), 볼륨/카운터 (demempotent!).
KPI 시맨틱: BI 계약의 정의, KPI 버전이 수정되었습니다.
3) 데이터 및 BI 계약
스키마: 필드, 유형, nullable, enum, 단위, 통화.
메트릭의 의미론: 공식, 소스, 집계 창, 필터.
호환성 (SEMVER): MAJOR 중단, MINOR 추가 필드 추가, PATCH 수정.
DQ/SLA: 신선도, 완전성, 일관성, 불일치 공차.
개인 정보 보호: 'pii: 잘못된', '토큰 화: 참', 해독 금지.
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 ("골드 "/큐브/피체 스토어에 대한 온라인 집계).
Preccompute API (예약 된 프리 엔더, 구체화 된보기).
이벤트 API (스트림 카운터/신호).
API를 내보냅니다 (서명 업로드, 감사를위한 WORM).
캐시: 메모리 내 → Redis → CDN에서 키 = 쿼리 해시 + 버전.
일관성: 최종 녹음을위한 읽기, 집계를위한 SLA 신선도.
5) 인터페이스 및 요청
5. 필터/집계/창 1 개
'필터': 날짜 범위 ('/UTC, 시간대 인식), 국가, 브랜드, 게임, 채널, 장치.
'group _ by': 치수.
'메트릭': KPI 목록.
'창': 'DAY' WEEK 'MONTH' ROLLING _ 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) Pagination, 한계, 정렬
페이지 분석: 치수/날짜별로 정렬 된 '한계' (방향 10k), '커서' (불투명).
타임 아웃/부분: 비재무 KPI에 대한 부분 응답 만; 금융-P200 또는 P504.
요율 제한: 글로벌/키/세입자 별; 응답에는 'X-RateLimit-' 가 포함되어 있습니다.
7) 이데올로기 및 캐시
'Idempotency-Key' 를 사용하여 이념적 GET/POST-read를 (본체와 함께) 읽습니다.
캐시 키 = 해시 (매개 변수 + 스키마 버전 + 역할/테넌트/지오).
TTL: KPI에 따라 다릅니다 (예: 수익을위한 'PT15M', 이벤트를위한 'PT5M'), 새로운 스냅 샷으로 재설정됩니다.
8) 일관성과 시간 통화
소급 보고서 (데이터 버전) 를위한 시간 여행 플래그.
컷오프 규칙 (주간/주간 마감).
FX: 우리는 전략을 수정합니다. 코스 날짜는 답입니다.
시계: 모든 타임 스탬프는 ISO-8601이며 TZ가 필요합니다.
9) 보안 및 개인 정보 보호
mSL/TLS1. 3, 요청/응답 기관의 HMAC 서명 (MITM/재생 보호).
RBAC/ABAC/ReBAC: 역할 + 국가 + 브랜드 + 목적; 기본 마스크.
멀티 테넌트-스키마/키/할당량을 분리하십시오.
식별자의 토큰 화; 응답의 PII 금지.
감사: 불변의 요청 로그 (WORM), 'trace _ id '/' actor '/' porture'.
동의/DSAR: 마케팅 속성에 대한 필터; "대상 지워짐" 플래그.
10) RG/AML/제한 방지
RG 정책: 고위험 부문에 대한 "공격적인" 지표 발행 금지; 단위는 안전합니다.
AML/사기 방지: 민감한 KPI에 대한 제한된 액세스, 역할 별 구역 지정; 조사를위한 별도의 평가 변수.
설명 가능성: 지원을위한 KPI/신호 설명 사전.
11) 관찰 가능성 및 SLO API
SLO: p95 대기 시간 (예: 캐시 적중의 경우 자동 300ms, 무거운 경우 자동 2 초), 성공률 이하 99. 5%.
DQ: 신선도/완전성/무결성; 응답의 레이블.
사용예: QPS, 캐시 적중률, 핫 키, 검증 오류.
경고: 신선도 저하, 성장 4xx/5xx, KPI에 따른 이상 (예기치 않은 0/피크).
추적: DWH/fichestore에 대한 'trace _ id' 엔드 투 엔드.
12) 수정 및 호환성
경로: '/v1 ', '/v2'; 마이그레이션 창으로 제거
스키마: 응답으로 '스키마 _ 버전'; MAJOR → 이중 읽기 마이그레이션 가이드.
KPI 버전: 디렉토리에 링크가있는 응답 'kpi _ definitions' 에서; 숨겨진 공식 변경을 방지하십시오.
13) 오류 및 상태
'400' 검증 (존재하지 않는 메트릭/측정/필터 조합).
'401/403' 인증/인증.
'409' 버전/정책 비 호환성.
'422' 개인 정보 보호/동의 위반.
'429' 할당량.
'5xx' 플랫폼 오류 (추적 _ id 및 재 시도 seq.)
오류 형식:json
{
"error":"VALIDATION_FAILED",
"message":"Unknown metric: ngrx",
"hint":"metrics allowed: ggr, net_revenue,...",
"trace_id":"..."
}14) 통합 및 인터페이스
BI: 사전 설명 된 시맨틱 모델, 커넥터 (Looker/Power BI/Tableu) → API를 소스로 사용합니다.
ML: 기능 단위에 대한 경량 엔드 포인트 (PII가없는 시점).
파트너: 제한된 키/할당량, 지오 필터는 집계 블록으로만보고됩니다.
Webhook/Push: 알림 "스냅 샷 준비", "깨진 SLO/KPI 범위".
15) 리소스 엔드 포인트의 예
15. 1 수익/반환
'POST/v2/메트릭/수익' → GGR/NGR, 베팅/승리, '날짜, 브랜드, 국가, 공급자, 게임' 으로 측정.
15. 2 개의 유지 및 깔때기
'POST/v2/metrics/retension' → ко
15. 3 지불
'POST/v2/metrics/payment' → 예금/인출, 평균 수표, 요금 환급 율.
15. 책임있는 게임 4
'POST/v2/metrics/rg' → 중재 수, 고위험, 평균 반응 시간의 비율.
15. 5 사기 방지
'POST/v2/metrics/antifraw' → FPR/TPR, 사례, 손실 방지.
16) 테스트 및 품질
계약 테스트: enum/nullable/유형, 통화/시간대 일관성.
DQ 테스트: 범위 제어, 단조 및 무결성.
회귀: 공차에 대한 v1/v2 비교.
로드: 피크 프로필 (토너먼트/제공자 이벤트).
보안: 서명, 재생 방지, 퍼지 요청, 로그의 Zero-PII.
17) 기본적으로 개인 정보 보
"최소 N 레코드" (k 익명 성) 의 임계 값으로 집계됩니다.
원시 식별자가 없습니다. 토큰/카테고리 만.
DSAR: 권한있는 루프를 통해 토큰으로 언로드/삭제하기위한 API.
18) 성공 지표 (API KPI)
채택: 직접 SQL이 아닌 API를 사용하는 보고서/위젯의 비율.
일관성-BI와 허용 오차가 일치하지 않습니다.
SLO: 대기 시간/성공/신선도 준수.
보안: 응답/로그에서 제로 PII 사례.
비용: 캐시의 적중률, 요청 비용, 프리 엔더의%.
19) RACI (예)
제품/분석 (A) -KPI 정의, 요구 사항.
데이터 플랫폼 (R) - 구현, 캐시, SLA, 관찰 가능성.
도메인 소유자 (R) -소스/계약.
보안/DPO (A/R) -개인 정보 보호, 액세스, 감사.
SRE (R) -할당량, 오토 스케일, 사건.
금융 (C) 은 GGR/NGR/NET의 재무 의미입니다.
20) 구현 로드맵
0-30 일 (MVP)
1. 3-5 KPI (GGR, 예금, 보존 D7) 를 선택하십시오.
2. 계약 및 KPI 의미론을 설명하십시오. DQ/SLA 사용하기
3. 구현 '/v1 '쿼리 API + 캐시 + mSL/HMAC.
4. SLO 대시 보드 (대기 시간/성공/신선도), 감사/추적 _ id.
30-90 일
1. 인기있는 상점 인 CDN을 다시 계산하십시오.
2. Versioning '/v2 ', 이중 읽기, 마이그레이션 가이드.
3. 서명 된 업로드 및 WORM을 사용하여 API를 내보냅니다
4. BI/ML과의 통합; 할당량/테넌트/지리 분리기.
3-6 개월
1. KPI 분류 및 위젯 라이브러리를 완료하십시오.
2. 스마트 팁/자동 완성 필터, 쿼리 린터.
3. 자동 릴리스 노트 KPI, 공차 제어 v1/v2.
4. 제한된 키 및 RG 정책이있는 외부 파트너 루프.
21) 반 패턴
숨겨진 KPI 공식은 새 버전과 릴리스 메모없이 변경됩니다.
골재/토큰 대신 PII/원료를 반환합니다.
캐시/프리 엔더의 부족 → 비싸고 느립니다.
특정 데이터베이스에 대한 하드 바인딩 (계층 추상화 없음).
일관성이없는 TZ/FX → 이질적인 숫자.
요율 제한/할당량 → "DDOS 자체" 가 없습니다.
22) 템플릿 (사용할 준비)
22. SLO API 정책 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: false22. 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 릴리스 체크리스트
- KPI 의미론 업데이트 및 버전 업그레이드
- 카탈로그의 계약/스키마; DQ/회귀 테스트 녹색
- 캐시 키/TTL, 프리엔더 구성
- 문서 및 샘플 요청/응답
- SLO 및 쿼터 경고 포함
- RG/AML 제약 조건 테스트
23) 관련 섹션
DataOps 관행, 감사 및 검증, 보안 및 암호화, 액세스 제어, 데이터 토큰 화, 보존 정책, 데이터 원점 및 경로, MLops: 모델 탐색, 데이터 윤리.
합계
분석 및 지표 API는 금 데이터 및 KPI에 대한 계약적이고 안전하며 빠른 액세스 계층입니다. 내부 대시 보드에서 파트너 패널 및 ML에 이르기까지 균일 한 의미론, 안정적인 버전, 기본 개인 정보 보호 및 제품 수준 성능을 보장합니다.