OmarketLab_finalv1

Tables (5)

ad_performance

  • search_keyword — VARCHAR(255) — 검색어
  • date — DATE — 일별
  • campaign — VARCHAR(255) — 캠페인
  • campaign_type — VARCHAR(100) — 캠페인유형
  • ad_group — VARCHAR(255) — 광고그룹
  • ad_group_type — VARCHAR(100) — 광고그룹유형
  • impressions — INTEGER — 노출수
  • clicks — INTEGER — 클릭수
  • ctr — NUMERIC(5,2) — 클릭률(%)
  • avg_cpc — NUMERIC(12,2) — 평균 CPC
  • total_cost — NUMERIC(14,2) — 총비용
  • total_conversions — INTEGER — 총 전환수
  • total_conv_sales — NUMERIC(14,2) — 총 전환매출
  • total_conv_rate — NUMERIC(5,2) — 총 전환율(%)
  • total_ad_count — INTEGER — 총 광고수
  • total_conv_amount — NUMERIC(14,2) — 총 전환율액
  • direct_conversions — INTEGER — 직접전환수
  • indirect_conversions — INTEGER — 간접전환수
  • direct_conv_sales — NUMERIC(14,2) — 직접전환매출액(원)
  • indirect_conv_sales — NUMERIC(14,2) — 간접전환매출액(원)
  • collected_at — TIMESTAMPTZ — 수집 시각

ad_performance_metrics

  • id — BIGSERIAL — Primary key — NOT NULL
  • performance_type_code — VARCHAR(30) — Foreign key → performance_type.code — 유형 코드 (performance_type.code 참조, 서버가 판정 규칙·임계값으로 분류)
  • search_keyword — VARCHAR(255) — 검색어 (논리 키, 합산 단위)
  • impressions — INTEGER — 노출 합계 = SUM(impressions)
  • clicks — INTEGER — 클릭 합계 = SUM(clicks)
  • ctr — NUMERIC(5,2) — CTR(%) = SUM(clicks) / SUM(impressions) * 100
  • cost — NUMERIC(14,2) — 광고비 합계 = SUM(total_cost)
  • cpc — NUMERIC(12,2) — CPC(원) = SUM(cost) / SUM(clicks)
  • cvr — NUMERIC(5,2) — CVR(%) = SUM(conversions) / SUM(clicks) * 100
  • conversions — INTEGER — 전환 합계 = SUM(total_conversions)
  • cpa — NUMERIC(14,2) — CPA(원) = SUM(cost) / SUM(conversions)
  • roas — NUMERIC(10,2) — ROAS(%) = SUM(total_conv_sales) / SUM(cost) * 100
  • calculated_at — TIMESTAMPTZ — 집계 계산 시각

classification_reason

  • id — BIGSERIAL — Primary key — NOT NULL
  • metrics_id — BIGINT — Foreign key → ad_performance_metrics.id — NOT NULL — 집계 행 참조 (ad_performance_metrics.id)
  • performance_type_code — VARCHAR(30) — Foreign key → performance_type.code — NOT NULL — 이 근거가 설명하는 분류 유형 (performance_type.code 참조)
  • reason — TEXT — NOT NULL — LLM이 생성한 분류 근거 텍스트
  • kpi_snapshot — JSONB — 분류 당시 KPI 값 (예: {"clicks":2,"roas":3708,...}) — 집계 갱신 후에도 근거의 기준값 보존
  • applied_thresholds — JSONB — 판정에 적용된 임계값 (예: {"roas_base":300,"roas_high":500,"min_clicks":10,"cost_threshold":10000,"min_impressions":100}) — 임계값 변…
  • generated_at — TIMESTAMPTZ — 생성 시각

performance_type

  • code — VARCHAR(30) — Primary key — NOT NULL — 유형 코드 (집계·추천 액션·분류 근거 테이블이 FK로 참조)
  • name_ko — VARCHAR(50) — NOT NULL — 한글명
  • description — TEXT — 유형 설명 (판정 규칙 요약)
  • sort_order — INTEGER — 표시 정렬 순서
  • is_active — BOOLEAN — NOT NULL — 사용 여부 (FK 참조 중인 유형은 삭제 대신 false 처리)
  • created_at — TIMESTAMPTZ — 등록 시각

recommended_action

  • id — BIGSERIAL — Primary key — NOT NULL
  • performance_type_code — VARCHAR(30) — Foreign key → performance_type.code — NOT NULL — 유형 코드 (performance_type.code 참조)
  • action_name — VARCHAR(100) — NOT NULL — 액션명
  • description — TEXT — 액션 상세 설명
  • sort_order — INTEGER — 유형 내 표시 순서
  • is_active — BOOLEAN — NOT NULL — 사용 여부 (삭제 대신 비활성화)
  • created_at — TIMESTAMPTZ — 등록 시각