feat: 관리자 패널 방문자 분석 페이지 추가 (GA4 Data API 연동)

- /admin/analytics 페이지 신규 추가
  - 일별 방문자 추이 바 차트 (7일/30일/90일 전환)
  - 오늘/이번주/기간별 요약 카드
  - 유입 경로 (채널별 비율 바)
  - 기기 유형 분포 (PC/모바일/태블릿)
  - 상위 페이지 조회수
- GET /api/admin/analytics 라우트 신규 추가 (@google-analytics/data)
- 사이드바에 방문자 분석 메뉴 추가
- 카페24 리뉴얼 견적 비교 SVG 에셋 추가 (public/marketing/quote-cafe24.svg)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-31 02:10:06 +09:00
parent bb4e53369f
commit 9af12d94c0
7 changed files with 1789 additions and 13 deletions

View File

@@ -0,0 +1,353 @@
'use client';
import { useEffect, useState, useCallback } from 'react';
type RangeKey = '7' | '30' | '90';
interface Summary {
users: number;
sessions: number;
pageviews: number;
}
interface AnalyticsData {
summary: {
today: Summary;
yesterday: Summary;
week: Summary;
period: Summary;
};
daily: Array<{ date: string; users: number; sessions: number; pageviews: number }>;
topPages: Array<{ page: string; views: number; users: number }>;
sources: Array<{ channel: string; sessions: number }>;
devices: Array<{ device: string; sessions: number }>;
}
const RANGE_LABELS: Record<RangeKey, string> = {
'7': '최근 7일',
'30': '최근 30일',
'90': '최근 90일',
};
const CHANNEL_KO: Record<string, string> = {
'Organic Search': '검색 (유기)',
'Direct': '직접 방문',
'Organic Social': '소셜 미디어',
'Referral': '외부 링크',
'Paid Search': '검색 광고',
'Email': '이메일',
'Unassigned': '미분류',
};
const DEVICE_KO: Record<string, string> = {
'desktop': 'PC',
'mobile': '모바일',
'tablet': '태블릿',
};
const CHANNEL_COLORS: Record<string, string> = {
'Organic Search': '#22c55e',
'Direct': '#3b82f6',
'Organic Social': '#a855f7',
'Referral': '#f59e0b',
'Paid Search': '#ef4444',
'Email': '#06b6d4',
'Unassigned': '#64748b',
};
function fmt(n: number) {
if (n >= 1000) return (n / 1000).toFixed(1) + 'k';
return n.toString();
}
function fmtDate(yyyymmdd: string) {
const m = yyyymmdd.slice(4, 6);
const d = yyyymmdd.slice(6, 8);
return `${parseInt(m)}/${parseInt(d)}`;
}
// 인라인 막대 차트
function BarChart({ data }: { data: AnalyticsData['daily'] }) {
const max = Math.max(...data.map((d) => d.users), 1);
const w = 600;
const h = 160;
const padL = 36;
const padR = 12;
const padT = 12;
const padB = 32;
const chartW = w - padL - padR;
const chartH = h - padT - padB;
const barW = Math.max(2, chartW / data.length - 2);
// Y축 눈금
const ticks = [0, Math.ceil(max / 2), max];
return (
<svg viewBox={`0 0 ${w} ${h}`} className="w-full" style={{ height: 160 }}>
{/* Y 눈금선 */}
{ticks.map((t) => {
const y = padT + chartH - (t / max) * chartH;
return (
<g key={t}>
<line x1={padL} y1={y} x2={w - padR} y2={y} stroke="#1e293b" strokeWidth={1} />
<text x={padL - 4} y={y + 4} textAnchor="end" fontSize={10} fill="#475569">
{fmt(t)}
</text>
</g>
);
})}
{/* 막대 + X 레이블 */}
{data.map((d, i) => {
const x = padL + (i / data.length) * chartW + (chartW / data.length - barW) / 2;
const barH = Math.max(2, (d.users / max) * chartH);
const y = padT + chartH - barH;
const showLabel = data.length <= 14 || i % Math.ceil(data.length / 10) === 0;
return (
<g key={d.date}>
<rect x={x} y={y} width={barW} height={barH} rx={2} fill="#3b82f6" opacity={0.85} />
{showLabel && (
<text
x={x + barW / 2}
y={h - 4}
textAnchor="middle"
fontSize={9}
fill="#475569"
>
{fmtDate(d.date)}
</text>
)}
<title>{`${fmtDate(d.date)}: ${d.users}`}</title>
</g>
);
})}
</svg>
);
}
// 유입 경로 가로 바
function SourceBar({ channel, sessions, total }: { channel: string; sessions: number; total: number }) {
const pct = total > 0 ? (sessions / total) * 100 : 0;
const color = CHANNEL_COLORS[channel] ?? '#64748b';
return (
<div className="flex items-center gap-3">
<div className="w-28 text-xs text-slate-400 truncate flex-shrink-0">
{CHANNEL_KO[channel] ?? channel}
</div>
<div className="flex-1 bg-slate-800 rounded-full h-2 overflow-hidden">
<div
className="h-2 rounded-full transition-all duration-700"
style={{ width: `${pct}%`, backgroundColor: color }}
/>
</div>
<div className="text-xs text-slate-300 w-12 text-right flex-shrink-0">{sessions.toLocaleString()}</div>
<div className="text-xs text-slate-500 w-10 text-right flex-shrink-0">{pct.toFixed(1)}%</div>
</div>
);
}
function StatCard({
label, value, sub, trend,
}: {
label: string;
value: number;
sub?: string;
trend?: number; // 양수: 증가, 음수: 감소
}) {
return (
<div className="bg-slate-800/60 border border-slate-700/50 rounded-xl p-4">
<p className="text-slate-400 text-xs font-medium mb-1">{label}</p>
<p className="text-white text-2xl font-bold">{value.toLocaleString()}</p>
{sub && <p className="text-slate-500 text-xs mt-0.5">{sub}</p>}
{trend !== undefined && (
<p className={`text-xs mt-1 font-medium ${trend >= 0 ? 'text-emerald-400' : 'text-red-400'}`}>
{trend >= 0 ? '▲' : '▼'} {Math.abs(trend).toFixed(0)}% vs
</p>
)}
</div>
);
}
export default function AnalyticsPage() {
const [range, setRange] = useState<RangeKey>('30');
const [data, setData] = useState<AnalyticsData | null>(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
const load = useCallback(async (r: RangeKey) => {
setLoading(true);
setError(null);
try {
const res = await fetch(`/api/admin/analytics?range=${r}`);
const json = await res.json();
if (!res.ok) throw new Error(json.error ?? '데이터 로드 실패');
setData(json);
} catch (e) {
setError(e instanceof Error ? e.message : '오류가 발생했습니다.');
} finally {
setLoading(false);
}
}, []);
useEffect(() => {
load(range);
}, [range, load]);
const todayTrend =
data && data.summary.yesterday.users > 0
? ((data.summary.today.users - data.summary.yesterday.users) / data.summary.yesterday.users) * 100
: undefined;
const totalSessions = data?.sources.reduce((s, c) => s + c.sessions, 0) ?? 0;
return (
<div className="p-4 md:p-6 space-y-6">
{/* 헤더 */}
<div className="flex items-center justify-between flex-wrap gap-3">
<div>
<h1 className="text-white text-xl font-bold"> </h1>
<p className="text-slate-400 text-sm mt-0.5">Google Analytics 4 </p>
</div>
{/* 기간 선택 */}
<div className="flex gap-1 bg-slate-800 rounded-lg p-1">
{(Object.keys(RANGE_LABELS) as RangeKey[]).map((r) => (
<button
key={r}
onClick={() => setRange(r)}
className={`px-3 py-1.5 rounded-md text-sm font-medium transition-all ${
range === r
? 'bg-blue-600 text-white'
: 'text-slate-400 hover:text-white'
}`}
>
{RANGE_LABELS[r]}
</button>
))}
</div>
</div>
{/* 에러 / 설정 안내 */}
{error && (
<div className="bg-red-900/30 border border-red-700/40 rounded-xl p-4 text-sm text-red-300 space-y-2">
<p className="font-semibold"> </p>
<p>{error}</p>
{(error.includes('GOOGLE_SERVICE_ACCOUNT_JSON') || error.includes('GA4_PROPERTY_ID')) && (
<div className="mt-3 bg-slate-900/50 rounded-lg p-3 text-slate-300 space-y-1 text-xs font-mono">
<p className="text-slate-400 font-sans font-normal mb-2"> (.env.local + Vercel):</p>
<p>GOOGLE_SERVICE_ACCOUNT_JSON=&#123; JSON &#125;</p>
<p>GA4_PROPERTY_ID=_속성ID</p>
</div>
)}
</div>
)}
{loading && !error && (
<div className="flex items-center justify-center py-20">
<div className="w-8 h-8 border-2 border-blue-500 border-t-transparent rounded-full animate-spin" />
</div>
)}
{data && !loading && (
<>
{/* 요약 카드 */}
<div className="grid grid-cols-2 lg:grid-cols-4 gap-3">
<StatCard
label="오늘 방문자"
value={data.summary.today.users}
sub={`세션 ${data.summary.today.sessions.toLocaleString()}`}
trend={todayTrend}
/>
<StatCard
label="이번 주 방문자"
value={data.summary.week.users}
sub={`페이지뷰 ${data.summary.week.pageviews.toLocaleString()}`}
/>
<StatCard
label={`${RANGE_LABELS[range]} 방문자`}
value={data.summary.period.users}
sub={`세션 ${data.summary.period.sessions.toLocaleString()}`}
/>
<StatCard
label={`${RANGE_LABELS[range]} 페이지뷰`}
value={data.summary.period.pageviews}
sub={`방문당 ${data.summary.period.users > 0 ? (data.summary.period.pageviews / data.summary.period.users).toFixed(1) : 0} 페이지`}
/>
</div>
{/* 일별 추이 차트 */}
<div className="bg-slate-900 border border-slate-700/50 rounded-xl p-5">
<h2 className="text-white font-semibold text-sm mb-4">
<span className="text-slate-500 font-normal ml-1">( )</span>
</h2>
{data.daily.length > 0 ? (
<BarChart data={data.daily} />
) : (
<p className="text-slate-500 text-sm text-center py-8"> </p>
)}
</div>
<div className="grid grid-cols-1 lg:grid-cols-2 gap-4">
{/* 유입 경로 */}
<div className="bg-slate-900 border border-slate-700/50 rounded-xl p-5">
<h2 className="text-white font-semibold text-sm mb-4"> </h2>
{data.sources.length > 0 ? (
<div className="space-y-3">
{data.sources.slice(0, 7).map((s) => (
<SourceBar
key={s.channel}
channel={s.channel}
sessions={s.sessions}
total={totalSessions}
/>
))}
</div>
) : (
<p className="text-slate-500 text-sm text-center py-6"> </p>
)}
</div>
{/* 기기 + 상위 페이지 */}
<div className="space-y-4">
{/* 기기 분포 */}
<div className="bg-slate-900 border border-slate-700/50 rounded-xl p-5">
<h2 className="text-white font-semibold text-sm mb-3"> </h2>
<div className="flex gap-3">
{data.devices.map((d) => {
const pct = totalSessions > 0 ? ((d.sessions / totalSessions) * 100).toFixed(0) : '0';
const icons: Record<string, string> = { desktop: '🖥', mobile: '📱', tablet: '⬜' };
return (
<div key={d.device} className="flex-1 bg-slate-800/60 rounded-lg p-3 text-center">
<p className="text-xl">{icons[d.device] ?? '?'}</p>
<p className="text-white font-bold text-lg mt-1">{pct}%</p>
<p className="text-slate-400 text-xs">{DEVICE_KO[d.device] ?? d.device}</p>
<p className="text-slate-500 text-xs">{d.sessions.toLocaleString()} </p>
</div>
);
})}
</div>
</div>
{/* 상위 페이지 */}
<div className="bg-slate-900 border border-slate-700/50 rounded-xl p-5">
<h2 className="text-white font-semibold text-sm mb-3"> </h2>
<div className="space-y-2">
{data.topPages.slice(0, 6).map((p, i) => (
<div key={p.page} className="flex items-center gap-2 text-sm">
<span className="text-slate-600 w-4 text-right flex-shrink-0">{i + 1}</span>
<span className="flex-1 text-slate-300 truncate font-mono text-xs">{p.page}</span>
<span className="text-blue-400 text-xs flex-shrink-0">{p.views.toLocaleString()}</span>
</div>
))}
</div>
</div>
</div>
</div>
<p className="text-slate-600 text-xs text-right">
Google Analytics 4 · 24~48
</p>
</>
)}
</div>
);
}

View File

@@ -66,6 +66,16 @@ const NAV_ITEMS = [
</svg>
),
},
{
href: '/admin/analytics',
label: '방문자 분석',
icon: (
<svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2}
d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
</svg>
),
},
];
interface AdminSidebarProps {

View File

@@ -83,6 +83,16 @@ const ASSETS = [
service: '홈페이지 제작',
price: '스타터 50만원~',
},
{
file: '/marketing/quote-cafe24.svg',
name: '카페24 리뉴얼 견적 비교표',
desc: '3옵션 가격 비교 — 숨고 견적 발송용',
size: '1200 × 700',
platform: '숨고 견적',
color: '#3b82f6',
service: '커머스 개발',
price: '150~450만원',
},
];
const CHECKLIST_ITEMS = {

View File

@@ -0,0 +1,137 @@
import { NextResponse } from 'next/server';
import { cookies } from 'next/headers';
import { verifyAdminTokenNode } from '@/lib/admin-auth';
import { BetaAnalyticsDataClient } from '@google-analytics/data';
export const runtime = 'nodejs';
function getClient() {
const raw = process.env.GOOGLE_SERVICE_ACCOUNT_JSON;
if (!raw) throw new Error('GOOGLE_SERVICE_ACCOUNT_JSON 환경변수가 설정되지 않았습니다.');
const credentials = JSON.parse(raw);
return new BetaAnalyticsDataClient({ credentials });
}
function getPropertyId() {
const id = process.env.GA4_PROPERTY_ID;
if (!id) throw new Error('GA4_PROPERTY_ID 환경변수가 설정되지 않았습니다.');
return id;
}
export async function GET(request: Request) {
// 관리자 인증
const cookieStore = await cookies();
const token = cookieStore.get('admin_token')?.value;
if (!token || !verifyAdminTokenNode(token)) {
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
}
const { searchParams } = new URL(request.url);
const range = searchParams.get('range') ?? '30'; // 7, 30, 90
const days = parseInt(range);
try {
const client = getClient();
const propertyId = getPropertyId();
const startDate = `${days}daysAgo`;
// 병렬로 3개 리포트 요청
const [trendRes, pagesRes, sourcesRes] = await Promise.all([
// 1. 일별 방문자 추이
client.runReport({
property: `properties/${propertyId}`,
dateRanges: [{ startDate, endDate: 'today' }],
dimensions: [{ name: 'date' }],
metrics: [{ name: 'activeUsers' }, { name: 'sessions' }, { name: 'screenPageViews' }],
orderBys: [{ dimension: { dimensionName: 'date' }, desc: false }],
}),
// 2. 상위 페이지
client.runReport({
property: `properties/${propertyId}`,
dateRanges: [{ startDate, endDate: 'today' }],
dimensions: [{ name: 'pagePath' }],
metrics: [{ name: 'screenPageViews' }, { name: 'activeUsers' }],
orderBys: [{ metric: { metricName: 'screenPageViews' }, desc: true }],
limit: 10,
}),
// 3. 유입 경로 + 기기
client.runReport({
property: `properties/${propertyId}`,
dateRanges: [{ startDate, endDate: 'today' }],
dimensions: [{ name: 'sessionDefaultChannelGroup' }, { name: 'deviceCategory' }],
metrics: [{ name: 'sessions' }, { name: 'activeUsers' }],
orderBys: [{ metric: { metricName: 'sessions' }, desc: true }],
limit: 20,
}),
]);
// 오늘 / 어제 / 이번 주 / 기간 합계
const summaryRes = await client.runReport({
property: `properties/${propertyId}`,
dateRanges: [
{ startDate: 'today', endDate: 'today' },
{ startDate: 'yesterday', endDate: 'yesterday' },
{ startDate: '7daysAgo', endDate: 'today' },
{ startDate: startDate, endDate: 'today' },
],
metrics: [{ name: 'activeUsers' }, { name: 'sessions' }, { name: 'screenPageViews' }],
});
// --- 파싱 ---
const summary = {
today: { users: 0, sessions: 0, pageviews: 0 },
yesterday: { users: 0, sessions: 0, pageviews: 0 },
week: { users: 0, sessions: 0, pageviews: 0 },
period: { users: 0, sessions: 0, pageviews: 0 },
};
const keys = ['today', 'yesterday', 'week', 'period'] as const;
summaryRes[0].rows?.forEach((row, i) => {
const key = keys[i];
if (key) {
summary[key] = {
users: parseInt(row.metricValues?.[0]?.value ?? '0'),
sessions: parseInt(row.metricValues?.[1]?.value ?? '0'),
pageviews: parseInt(row.metricValues?.[2]?.value ?? '0'),
};
}
});
const daily = (trendRes[0].rows ?? []).map((row) => ({
date: row.dimensionValues?.[0]?.value ?? '',
users: parseInt(row.metricValues?.[0]?.value ?? '0'),
sessions: parseInt(row.metricValues?.[1]?.value ?? '0'),
pageviews: parseInt(row.metricValues?.[2]?.value ?? '0'),
}));
const topPages = (pagesRes[0].rows ?? []).map((row) => ({
page: row.dimensionValues?.[0]?.value ?? '',
views: parseInt(row.metricValues?.[0]?.value ?? '0'),
users: parseInt(row.metricValues?.[1]?.value ?? '0'),
}));
// 채널별 집계
const channelMap: Record<string, number> = {};
const deviceMap: Record<string, number> = {};
(sourcesRes[0].rows ?? []).forEach((row) => {
const channel = row.dimensionValues?.[0]?.value ?? 'Unknown';
const device = row.dimensionValues?.[1]?.value ?? 'Unknown';
const sessions = parseInt(row.metricValues?.[0]?.value ?? '0');
channelMap[channel] = (channelMap[channel] ?? 0) + sessions;
deviceMap[device] = (deviceMap[device] ?? 0) + sessions;
});
const sources = Object.entries(channelMap)
.map(([channel, sessions]) => ({ channel, sessions }))
.sort((a, b) => b.sessions - a.sessions);
const devices = Object.entries(deviceMap)
.map(([device, sessions]) => ({ device, sessions }))
.sort((a, b) => b.sessions - a.sessions);
return NextResponse.json({ summary, daily, topPages, sources, devices });
} catch (err) {
const msg = err instanceof Error ? err.message : '알 수 없는 오류';
return NextResponse.json({ error: msg }, { status: 500 });
}
}