지식센터 / 레퍼런스

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

# 📋 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 적재 완료

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초 필요)

관련 문서

이 문서를 참조하는 문서 (역링크)

• 없음

다른 표현: Markdown · JSON · 최종 갱신 2026-08-24