도움말

1. 로그인 후 우상단 + 새 사이트 만들기 클릭
2. 사이트 주소(영어) 입력 → 마음에 드는 테마 선택
3. 가게 이름·첫 화면 문구·배너 이미지 입력 (모두 선택, 빈 칸은 테마 기본값 사용)
4. 왼쪽 상단 배포하기 클릭하면 30초~2분 안에 라이브

1. vercel.com 가입 (구글/깃허브 계정 가능, 무료)
2. 로그인 후 vercel.com/account/tokens 로 이동
3. Create Token 클릭
4. 이름은 자유롭게, Scope 는 본인 계정(Personal) 선택, 만료(Expiration)는 원하는 대로
5. 발급된 토큰을 복사해서 우리 로그인 페이지에 붙여넣기

+ 새 사이트 만들기 화면은 5단계로 구성됩니다.

1. 사이트 주소 — 영어 소문자/숫자/하이픈만 사용. 입력한 값이 [주소].vercel.app 의 일부가 됩니다.
2. 테마 선택 — 카테고리 탭이나 검색으로 찾을 수 있어요. 카드 우하단 "미리보기" 로 다른 탭에서 확인 가능.
3. 사이트 정보 — 가게 이름(헤더/푸터에 표시), 사이트 제목(브라우저 탭/검색 결과), 사이트 설명(검색 결과 미리보기).
4. 첫 화면 문구 — 메인 헤드라인, 부연 설명, 행동 유도 버튼 글자/링크. 모두 선택이며 빈 칸은 테마 기본값.
5. 배너 이미지 — 광고 트래픽에 노출할 배너. URL 키 조건이 일치할 때만 표시됨. 자세한 동작은 아래 "배너" 섹션 참고.

내 사이트 또는 사이트 상세에서 수정 / 다시 배포 버튼을 누르세요. 이전에 입력한 값이 그대로 채워져 나오므로 바꿀 부분만 수정 후 배포하면 됩니다.

배너는 특정 URL 조건일 때만 노출되는 영역입니다. 광고로 들어온 사용자에게만 보여주고 싶을 때 사용합니다.

• 키만 설정 (값 비움) — URL 에 그 키가 있으면 노출.
  예) 키 = promo → yoursite.com?promo 또는 yoursite.com?promo=anything 일 때 노출
• 키+값 모두 설정 — 정확히 일치할 때만 노출 (광고 채널별 분기).
  예) 키 = utm_source, 값 = facebook → ?utm_source=facebook 일 때만
• 매치 시 배너만 단독 노출 토글 — 켜면 메뉴·본문 모두 숨기고 배너 이미지만 화면 가득. 광고 크리에이티브 단독 노출에 유용.
• 열 수 1~5 — 가로로 몇 개씩 나열할지. 이미지가 더 많으면 다음 줄로 자동 줄바꿈.

배너 이미지는 비율을 유지한 채 자연 크기 그대로 표시됩니다. 잘림이나 늘어남이 없습니다. 다만 그리드의 같은 줄에 있는 이미지들은 비슷한 비율로 만드시면 보기 좋습니다.

• 가로형 광고 배너: 1200×628 (페이스북 표준), 1600×900 권장
• 정방형: 1080×1080 (인스타 피드 호환)
• 세로형: 1080×1350 (인스타 4:5)
• 모바일 풀스크린: 1080×1920

파일 형식은 JPG / PNG / WebP / SVG 모두 가능. 외부 이미지 호스팅 (imgur, S3, CDN 등) 의 직접 링크를 입력하시면 됩니다.

배포 마법사의 외부 스크립트 섹션에서 GA / GTM / Meta Pixel 같은 트래킹 코드를 사이트에 직접 삽입할 수 있습니다. 최대 5개까지 추가 가능, 각각 헤더 / 바디 하단 위치를 동시에 선택할 수 있습니다.

1. 외부 서비스(GA, GTM 등)에서 발급받은 코드를 그대로 복사
2. 마법사의 + 스크립트 추가 클릭 → 코드 textarea 에 붙여넣기
3. 위치 선택:
   • 헤더 — 페이지 가장 상단에서 바로 실행 (GA, GTM 권장)
   • 바디 하단 — 본문 다음, 페이지 로딩 영향 최소화 (Hotjar 등)
   • 둘 다 선택 가능 (필요한 경우)
4. 배포하면 사이트에 적용됨. 재배포로 언제든 수정/삭제 가능

⚠ 외부 서비스에서 발급받은 신뢰할 수 있는 코드만 붙여넣으세요. 입력한 코드는 검증 없이 사이트에 그대로 실행됩니다.

한 스크립트당 최대 4 KB. 일반적인 GA / GTM / Meta Pixel 코드는 보통 0.5~1 KB 수준이라 충분합니다.

본인이 소유한 도메인(가비아·후이즈 등에서 산 도메인)을 사이트에 연결할 수 있습니다. 사이트 상세 페이지의 "커스텀 도메인" 섹션에서 추가하시면 됩니다.

1. 사이트 상세 → 커스텀 도메인 입력 (예: example.com 또는 shop.example.com)
2. 도메인 추가 클릭
3. 화면에 표시되는 DNS 레코드를 본인 도메인 등록 업체에 추가
4. 다시 검증 클릭 (또는 30초마다 자동 검증)
5. 검증 완료 → 자동으로 SSL 인증서 발급 (무료, 자동 갱신)

기본 가이드

• 대표 도메인 (example.com) → A 레코드 / 호스트 @ / 값 76.76.21.21
• 서브 도메인 (www.example.com, shop.example.com) → CNAME 레코드 / 값 cname.vercel-dns.com
• 소유 검증 → Vercel 이 요구하는 TXT 레코드 (화면에 정확한 값이 표시됩니다)

1. my.gabia.com 로그인 → "도메인" 메뉴
2. 해당 도메인 클릭 → "DNS 정보" 또는 "DNS 관리툴"
3. "레코드 수정" 또는 "+ 추가" 버튼으로 새 레코드 추가
4. 우리 화면에 표시된 유형 / 호스트 / 값 그대로 입력 → 저장
5. 변경 사항 적용에 5~10분 정도 걸립니다

1. whois.co.kr 로그인 → "내정보" → "도메인 관리"
2. 해당 도메인 → "네임서버/DNS 변경"
3. DNS 레코드 관리 페이지에서 "추가" 클릭
4. 유형(A/CNAME/TXT), 호스트, 값을 그대로 입력 → 저장

1. dash.cloudflare.com 로그인 → 해당 도메인 클릭
2. 좌측 "DNS" → "Records" 탭
3. "Add record" 클릭 → 유형 선택 후 입력
4. 중요: A 레코드의 "Proxy status" 는 DNS only (회색 구름) 로 설정. 주황색이면 SSL 충돌이 날 수 있습니다.

Hobby (무료) 플랜 으로 시작 가능합니다. 자영업 랜딩페이지 수준에서는 보통 무료 한도 안에서 충분합니다.

• 월 100GB 대역폭 (방문자 수 기준 약 수십만)
• SSL 인증서 자동 발급 무료
• 커스텀 도메인 무제한 (단, 동시에 활성 가능한 프로젝트 수 제한 있음)
• 비상업적 사용 권장 — 상업적/대규모는 Pro 플랜 ($20/월~)

정확한 한도/요금은 vercel.com/pricing 에서 확인하세요.

사이트 상세 페이지 우상단의 사이트 삭제 버튼으로 완전히 삭제할 수 있습니다.

사이트 상세 페이지의 설정 내보내기 버튼으로 가장 최근 배포 설정을 JSON 파일로 내려받을 수 있습니다.

• 백업 / 다른 환경에 옮길 때 참고용
• 테마 키, 가게 이름, 첫 화면 문구, 배너 설정 모두 포함
• JSON 파일 그대로 복원 기능은 아직 없음 (참고 자료)

기본은 토큰 붙여넣기 방식만 동작합니다. "Sign in with Vercel" 버튼을 활성화하려면 Vercel 통합 앱을 한 번 등록해야 합니다.

1. vercel.com/dashboard/integrations/console 에서 Create Integration 클릭
2. Redirect URL 에 https://<플랫폼-도메인>/api/auth/vercel/callback 추가
3. 발급된 Client ID, Client Secret, 통합 Slug 복사
4. 플랫폼 서버의 apps/web/.env.local 또는 환경변수에 4개 모두 설정:

   VERCEL_OAUTH_INTEGRATION_SLUG=ads-multi-web
   VERCEL_OAUTH_CLIENT_ID=oac_xxx
   VERCEL_OAUTH_CLIENT_SECRET=xxx
   VERCEL_OAUTH_REDIRECT_URI=https://<도메인>/api/auth/vercel/callback

5. 플랫폼 재시작 → 로그인 페이지에 "▲ Vercel 계정으로 로그인" 버튼 자동 노출

이 플랫폼은 SQLite 를 사용하므로 영구 디스크가 필요합니다. Vercel Functions 같은 휘발성 환경엔 그대로 못 띄웁니다.

• VPS (Hetzner/DigitalOcean 등) — 가장 단순, 직접 관리
• Railway / Fly.io / Render — Git push 만으로 배포, 영구 디스크 지원
• Vercel + Postgres/Turso — DB 어댑터 교체 필요 (현재 코드 그대로는 불가)

여기서 답을 못 찾으셨다면 운영자에게 문의해주세요.