28 lines
1.7 KiB
SQL
28 lines
1.7 KiB
SQL
-- ============================================================
|
|
-- Migration: user 테이블에 UTM 5컬럼 + registration_tracked_at 추가
|
|
-- Date: 2026-07-23
|
|
-- Description: Meta 픽셀/Conversions API 전환 추적 확장
|
|
-- 1) registration_tracked_at: CompleteRegistration 전환 이벤트의
|
|
-- "계정당 최초 1회 발화" 판정용 (first_video_created_at과 동일 패턴)
|
|
-- - NULL: 아직 가입 전환 이벤트가 발화되지 않은 계정
|
|
-- - NOT NULL: 발화 완료 (값 = 추적 시점)
|
|
-- 2) utm_source/medium/campaign/content/term: 광고 유입 경로 보존
|
|
-- 가입 시점 first-touch UTM을 기록 (Meta 리포트와 내부 DB 대조용)
|
|
-- registration_tracked_at 기록과 같은 원자적 UPDATE에서 함께 저장됨
|
|
-- 관련 코드: app/video/api/routers/v1/tracking.py, app/utils/meta_capi.py
|
|
-- ============================================================
|
|
|
|
ALTER TABLE `user`
|
|
ADD COLUMN `registration_tracked_at` DATETIME NULL
|
|
COMMENT '가입 전환 추적 일시 (Meta CompleteRegistration 전환 이벤트 1회 발화 판정용)' AFTER `first_video_created_at`,
|
|
ADD COLUMN `utm_source` VARCHAR(255) NULL
|
|
COMMENT '유입 매체 (예: meta, google, naver)' AFTER `registration_tracked_at`,
|
|
ADD COLUMN `utm_medium` VARCHAR(255) NULL
|
|
COMMENT '유입 방식 (예: paid_social, cpc)' AFTER `utm_source`,
|
|
ADD COLUMN `utm_campaign` VARCHAR(255) NULL
|
|
COMMENT '캠페인 이름' AFTER `utm_medium`,
|
|
ADD COLUMN `utm_content` VARCHAR(255) NULL
|
|
COMMENT '광고 소재 구분 (A/B 테스트용)' AFTER `utm_campaign`,
|
|
ADD COLUMN `utm_term` VARCHAR(255) NULL
|
|
COMMENT '검색 키워드' AFTER `utm_content`;
|