# 📋 DMP 잠재고객수 API — BQ 큐브 추가 적재 DevLog

> # 📋 DMP 잠재고객수 API — BQ 큐브 추가 적재 DevLog > 최종 업데이트: 2026-02-23 KST > 관련 채팅: 현재 세션 --- ## 배경 런컴 실시간 타겟팅 기획서 v1.3의 세그먼트 항목을 우리 API로 서비스하기 위해, BQ 원본(tb_tam_f1)에

## 핵심 요약


# 📋 DMP 잠재고객수 API — BQ 큐브 추가 적재 DevLog

> 최종 업데이트: 2026-02-23 KST
> 관련 채팅: 현재 세션

---

## 배경

런컴 실시간 타겟팅 기획서 v1.3의 세그먼트 항목을 우리 API로 서비스하기 위해, BQ 원본(tb_tam_f1)에서 미보유 차원을 큐브 집계하여 Supabase에 적재.

**구조**: 런컴 애드서버 → 우리 API(Edge Function) → Supabase DB (우리가 API 제공자)

## 수행 내용

### BQ 큐브 5개 집계 + Supabase 적재 완료

| # | 큐브 | BQ 테이블 | Supabase 테이블 | 행 수 | 커버 항목 |
|---|------|----------|----------------|------:|----------|
| 1 | 지역 상세 | cube_region_detail | de_dmp_cube_region_detail | 336,843 | 시군구, 읍면동 |
| 2 | 디바이스 | cube_device | de_dmp_cube_device | 396 | 통신사, 모바일브랜드 |
| 3 | 카드 업종 | cube_card_category | de_dmp_cube_card_category | 27,346 | 카드 승인 업종 (KB전용) |
| 4 | 금액 구간 | cube_amount_bucket | de_dmp_cube_amount_bucket | 13,561 | 승인 금액 구간 |
| 5 | 교통 | cube_transit | de_dmp_cube_transit | 24,773 | 지하철역, 승하차 (버스 제외) |

### FDW Foreign Table 추가 (5개)

```
bigquery.cube_region_detail
bigquery.cube_device
bigquery.cube_card_category
bigquery.cube_amount_bucket
bigquery.cube_transit
```

### 주요 발견사항

- **통신사 코드**: T=SKT, K=KT, U=LGU+, Z=기타(208만으로 최대)
- **모바일 브랜드**: SAMSUNG=84만, Apple=66만, 미지정=171만
- **업종 매핑율**: partner_cd → category_code JOIN 84% 매칭 (16% 미매칭 → 보강 필요)
- **교통 큐브**: BUS 64만행(97%) vs 지하철 2.5만행(3%) → 지하철만 적재 (기획서에서 버스 '보류')
- **지역 상세**: 서울 25구 386동, 경기 42시군구 622읍면동 확보
- **금액 분포**: 1만 미만이 33.3억건 (교통 소액 포함), 전형적 롱테일

### BQ 비용

큐브 5개 집계 실행: 추정 ~$3~4

## 기획서 커버리지 최종

```
기획서 '가능' 항목 15개 중 13개 커버 (87%)
보류 2개: 모바일 브랜드(기획서도 보류), 승인 횟수(기획서도 보류)
```

## 산출물

- 구현방안 문서: dmp_segment_api_plan_v2.md
- BQ 큐브 SQL 5개 (문서 §4에 포함)
- Supabase 테이블 5개 + FDW 5개

## 다음 작업: Phase 2 — API 구현

아래 순서로 진행 예정:

1. seg 키 매핑 테이블 생성 (de_dmp_segment_mapping)
2. RPC 함수 구현 (get_segment_preview — 다차원 필터 + 교차 추정)
3. 값 변환 헬퍼 함수 (연령/요일/지역 매핑)
4. Edge Function 배포 (segment-preview — form-urlencoded 파싱)
5. 런컴 연동 테스트

### 의사결정 필요 (찰스 확인)

1. seg 키 스프레드시트 접근 권한 (런컴에 요청)
2. 런컴 → 우리 API 인증 방식 (API Key? IP 제한?)
3. 응답 시간 요구사항 (실시간 타겟팅이면 <1초 필요)


## FAQ


---
출처: https://bizspring.ai/kb/ref/khub/dmp-runcomm-dmp-잠재고객수-api-bq-큐브-추가-적재-devlog · 최종 갱신 2026-08-24T11:53:44.908861+00:00