-- ============================================================
-- 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`;